showcase-mcp

Publish a self-contained static site from your agent and get back a stable, shareable link that's fast worldwide and inside mainland China — no deploy, no repo, callable from any project.

showcase-mcp is a tiny stdio MCP server. Drop it into your MCP client config with one secret (your publish token) and your agent gains two tools: showcase_publish and showcase_list.

Zero-config setup

Get a publish token from your dashboard at https://showcasemcp.com, then add this to your MCP client config (e.g. ~/.cursor/mcp.json):

{
  "mcpServers": {
    "showcase": {
      "command": "npx",
      "args": ["-y", "showcase-mcp"],
      "env": { "SHOWCASE_TOKEN": "sct_your_token_here" }
    }
  }
}

That's it — npx fetches and runs the latest version (no install, no absolute paths, works on any machine). The control plane defaults to production; the only thing you supply is your token.

Tools

• showcase_publish — publish (or republish) a site, returns the URL. Provide either html (a single self-contained page) or files (a multi-file bundle with a root index.html). Re-publishing with the same sourceKey replaces the content in place — the link never changes.
• showcase_list — list your live sites (URL, source_key, views, last update), so the agent can recover a sourceKey and republish instead of creating a duplicate.

Vendor every dependency. Visitors may be in mainland China, where external CDNs (unpkg / jsdelivr / cdnjs / Google Fonts / …) fail. Inline or bundle all libraries, fonts, CSS, and images and reference them by relative path.

Config (env)

| var | required | meaning | |---|---|---| | SHOWCASE_TOKEN | yes | your per-user publish token (sct_…), from the dashboard | | SHOWCASE_API_URL | no | control-plane base URL; defaults to the production host. Set it only to target a different deployment, e.g. http://127.0.0.1:8787 for local testing against wrangler dev |

Local development (this repo)

pnpm --filter showcase-mcp build      # esbuild → self-contained dist/index.js
pnpm --filter showcase-mcp smoke      # drives the built binary as a real MCP
                                      # server against a local control plane

The smoke expects the local control plane up on http://127.0.0.1:8787 (see the repo root README.md → "Run the local smoke") and uses the seeded P0a token by default.