# Artfct MCP server

> Lets AI agents publish, search, and cite shared artifacts like HTML, reports, and documentation within a collaborative workspace.

- Repository: https://github.com/rubybear-lgtm/artfct
- Page: https://hostedmcp.org/servers/rubybear-lgtm/artfct
- Transport: remote
- Stars: 0
- Latest version: 1.0.0

## Install

### Claude Code

```sh
claude mcp add --transport http artfct https://artfct.dev/mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "artfct": {
      "url": "https://artfct.dev/mcp"
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "artfct": {
      "type": "http",
      "url": "https://artfct.dev/mcp"
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"artfct","type":"http","url":"https://artfct.dev/mcp"}'
```

### Codex

```sh
codex mcp add artfct --url https://artfct.dev/mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.artfct]
url = "https://artfct.dev/mcp"
```

### Gemini CLI

```sh
gemini mcp add -s user --transport http artfct https://artfct.dev/mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "artfct": {
      "url": "https://artfct.dev/mcp",
      "type": "http"
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `APP_DEBUG` | no | no |  |
| `APP_ENV` | no | no |  |
| `APP_KEY` | no | no |  |
| `APP_URL` | no | no |  |
| `MCP_LIVE_BASE_URL` | no | no |  |
| `MCP_LIVE_EXPECTED_ORG_A` | no | no |  |
| `MCP_LIVE_EXPECTED_ORG_B` | no | no |  |
| `MCP_LIVE_PRIVATE_ARTIFACT_A` | no | no |  |
| `MCP_LIVE_TOKEN_A` | no | no |  |
| `MCP_LIVE_TOKEN_B` | no | no |  |
| `VITE_APP_NAME` | no | no |  |
| `VITE_WORKER_URL` | no | no |  |
| `WORKOS_API_KEY` | no | no |  |
| `WORKOS_CLIENT_ID` | no | no |  |
| `WORKOS_REDIRECT_URL` | no | no |  |

## Tools (15)

- `deploy_artifact`
- `search_artifacts`
- `read_artifact`
- `list_artifacts`
- `get_artifact`
- `get_guidance`
- `delete_artifact`
- `get_connection`
- `get_usage`
- `list_collections`
- `create_collection`
- `add_collection_artifact`
- `remove_collection_artifact`
- `delete_collection`
- `set_avatar`

## FAQ

### How do I connect my AI tool to Artfct?

Add the hosted MCP server address to your tool and approve the browser sign-in. Verified tools include Claude Code, Codex, OpenCode, and Antigravity.

### What kind of files can be published as artifacts?

You can publish interactive HTML, multi-file bundles (up to 500 files and 8 MB), reports, markdown docs, tables, and mockups.

### Can I search for artifacts created by my teammates?

Yes, you can search previously deployed artifacts by meaning using the search_artifacts tool, and browse them by owner, sharing, or kind.
