Artifyde MCP server

artifyde-mcp

A permanent home for your agent's HTML artifacts — over MCP.

Your agent turns out real, finished work as rendered HTML: dashboards, prototypes, reports, decks. Normally those are disposable — a localhost link that dies, a file in a folder, gone on the next run. This Model Context Protocol server gives each one a permanent home on Artifyde: a stable link anyone can open, share, mark up, and version on every re-publish — without your agent leaving its MCP host.

It wraps the Artifyde API, so any MCP-capable client (Claude Desktop, Claude Code, Cursor, and others) can publish and manage artifacts directly.

Install

The server runs over stdio and is launched with npx, so there's nothing to install globally. Add it to your MCP host's config.

Claude Code

claude mcp add artifyde --scope user -e ARTIFYDE_TOKEN=vk_your_login_token -- npx -y artifyde-mcp

If you already use the artifyde CLI, pull the token straight from its store instead of pasting it:

claude mcp add artifyde --scope user \
  -e ARTIFYDE_TOKEN="$(jq -r '.servers["https://artifyde.com"].token' ~/.config/artifyde/config.json)" \
  -- npx -y artifyde-mcp

--scope user makes it available in every project; drop it to add for the current project only. Restart Claude Code (or run /mcp) to see the tools.

Claude Desktop

Install the one-click bundle: download artifyde-mcp.mcpb from the latest release and open it (Settings → Extensions), then paste your token in the extension's settings. Or add the JSON block below to claudedesktopconfig.json.

OpenAI Codex

codex mcp add artifyde --env ARTIFYDE_TOKEN=vk_your_login_token -- npx -y artifyde-mcp

Or in ~/.codex/config.toml (shared by the Codex CLI and IDE extension):

[mcp_servers.artifyde]
command = "npx"
args = ["-y", "artifyde-mcp"]

[mcp_servers.artifyde.env]
ARTIFYDE_TOKEN = "vk_your_login_token"

Cursor / other MCP hosts

Any host that takes an mcpServers JSON block:

{
  "mcpServers": {
    "artifyde": {
      "command": "npx",
      "args": ["-y", "artifyde-mcp"],
      "env": {
        "ARTIFYDE_TOKEN": "vk_your_login_token"
      }
    }
  }
}

Authentication

Set one credential in env:

• ARTIFYDETOKEN — a per-user login token (vk…). Get one by installing the CLI (npm i -g artifyde-cli), running artifyde login, and copying the token from ~/.config/artifyde/config.json. This is the recommended option: the server acts as you.
• ARTIFYDEAPIKEY — an admin shared-owner key (for programmatic/agent identities on self-hosted instances). A bearer token wins if both are set.

Without a credential the server still starts and can read public pages; publishing and private access require one.

By default the server talks to the hosted instance at https://artifyde.com. Point it elsewhere (e.g. a self-hosted or preview instance) with ARTIFYDEURL**.

Tools

Shortened. The full README is on GitHub.