smartifacts

MCP server for Smartifacts — let your coding agent upload HTML artifacts to your team's Smartifacts instance and get back a shareable, org-restricted link.

Local images, CSS, and JS referenced by the HTML are automatically inlined before upload, so artifacts render correctly without needing to host separate files.

Install

Point it at your deployed Smartifacts instance. In Claude Code:

claude mcp add smartifacts -- npx smartifacts@latest --url https://your-instance.workers.dev

For other MCP clients (Cursor, Codex, etc.):

{
  "mcpServers": {
    "smartifacts": {
      "command": "npx",
      "args": ["-y", "smartifacts@latest", "--url", "https://your-instance.workers.dev"]
    }
  }
}

The first tool call opens your browser for a one-time Google sign-in. After that, the token is cached locally for 90 days.

Tools

upload_artifact

Upload an HTML file and get a shareable link.

| Parameter | Required | Description | |-----------|----------|-------------| | file_path | yes | Path to the HTML file | | title | no | Short title for the dashboard and link previews. Falls back to the HTML <title> or <h1>. | | description | no | One-line summary so the artifact is recognizable later without opening it. |

Local assets (<img src="logo.png">, <link href="style.css">, <script src="app.js">, CSS url()) are resolved from the HTML file's directory and embedded automatically. Assets that are missing, oversized (>2 MB), or outside the file's directory tree are skipped with a warning.

update_artifact

Replace an existing artifact's HTML content, keeping the same link.

| Parameter | Required | Description | |-----------|----------|-------------| | artifact_id | yes | ID of the artifact to update | | file_path | yes | Path to the new HTML file |

list_artifacts

List your uploaded artifacts. No parameters.

delete_artifact

Delete an artifact.

| Parameter | Required | Description | |-----------|----------|-------------| | artifact_id | yes | ID of the artifact to delete |

Deploying Smartifacts

This package is the MCP server (the agent-side client). It talks to a Smartifacts instance that an admin deploys once for the org. See the main repo for deployment instructions.

License

MIT