# artifact-site

Publishes agent-generated HTML pages, reports, and static builds to your server or the cloud. It adds versioned links, full-text search, and access controls.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 23
- Author: lexmount
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/lexmount/artifact-site
- Updated: 2026-10-10
- HTML: https://affpapa.org/en/nevibecode/mcp/artifact-site

## What it does

This server gives coding agents a dedicated workspace to store outputs instead of leaving them buried across chat sessions or local folders. Agents push finished files directly through the MCP interface or the `@artifact-site/cli` utility. The platform accepts static HTML pages, compiled `dist/` folders, ZIP archives, PDF documents, and Office files like DOCX or PPTX.

The server hosts finished assets only. It does not run application backends or handle build steps, so projects must be compiled beforehand. Rendered web pages live in a sandboxed frame with no access to user session data. If a page connects to external APIs, you must configure an origin allowlist. Viewing Office files online requires a running Gotenberg instance, and scanned documents lack automatic OCR.

You can host the platform yourself using Docker 24+ and the Compose plugin 2.24+ via `make build up`, or rely on the hosted cloud instance. The system logs version history with rollback capabilities, and controls file access through passwords or enterprise OIDC providers.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://artifact-site.app.lexmount.com/mcp`
- Environment variables: `ARTIFACT_SITE_URL`, `ARTIFACT_SITE_TOKEN` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http artifact-site https://artifact-site.app.lexmount.com/mcp
```

2. **Platform CLI**
```bash
claude mcp add --env ARTIFACT_SITE_URL=<ARTIFACT_SITE_URL> --env ARTIFACT_SITE_TOKEN=<ARTIFACT_SITE_TOKEN> --transport stdio artifact-site -- npx -y @artifact-site/cli
```
Replace <…> with your own values

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add artifact-site --url https://artifact-site.app.lexmount.com/mcp
```

2. **Platform CLI**
```bash
codex mcp add artifact-site --env ARTIFACT_SITE_URL=<ARTIFACT_SITE_URL> --env ARTIFACT_SITE_TOKEN=<ARTIFACT_SITE_TOKEN> -- npx -y @artifact-site/cli
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "artifact-site": {
            "url": "https://artifact-site.app.lexmount.com/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "artifact-site": {
            "command": "npx",
            "args": [
                "-y",
                "@artifact-site/cli"
            ],
            "env": {
                "ARTIFACT_SITE_URL": "<ARTIFACT_SITE_URL>",
                "ARTIFACT_SITE_TOKEN": "<ARTIFACT_SITE_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "artifact-site": {
            "type": "http",
            "url": "https://artifact-site.app.lexmount.com/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "artifact-site": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@artifact-site/cli"
            ],
            "env": {
                "ARTIFACT_SITE_URL": "<ARTIFACT_SITE_URL>",
                "ARTIFACT_SITE_TOKEN": "<ARTIFACT_SITE_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http artifact-site https://artifact-site.app.lexmount.com/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e ARTIFACT_SITE_URL=<ARTIFACT_SITE_URL> -e ARTIFACT_SITE_TOKEN=<ARTIFACT_SITE_TOKEN> artifact-site npx -y @artifact-site/cli
```
Replace <…> with your own values

## When to use it
- publish static dist/ builds and ZIP archives with shareable links
- organize agent-generated HTML pages and PDF reports in a unified workspace
- preserve revision history and roll back changes to published documents
- search across uploaded team documentation and reports

## Example prompts
- Publish the generated dist folder to artifact-site and give me the link.
- Find the latest sales report on artifact-site and update its text content.
- Upload summary.pdf and set up password-protected access for the team.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md