blimp-mcp

MCP server for blimp — let coding agents (Claude Code, Cursor, Claude Desktop, …) publish and manage single-page HTML sites and get back a shareable https://{slug}.blimp.page URL.

Communicates over stdio. No infra credentials needed — HTML is posted inline over HTTPS to the blimp REST API.

Configure

Add the server to your agent's MCP config. It's distributed on npm, so npx fetches and runs it on demand — no clone or build step:

{
  "mcpServers": {
    "blimp": {
      "command": "npx",
      "args": ["-y", "blimp-mcp@latest"],
      "env": {
        "BLIMP_API_URL": "https://api.blimp.page/api/v1",
        "BLIMP_TOKEN": "blimp_xxx"
      }
    }
  }
}

• BLIMP_API_URL — your blimp REST base. Either the custom API domain (https://api.blimp.page/api/v1) or the direct Convex endpoint (https://<deployment>.convex.site/api/v1).
• BLIMP_TOKEN — a workspace-scoped token (starts with blimp_), created at /dashboard/tokens. Shown once — save it on creation.

Requires Node.js 18 or newer.

Tools

| Tool | Description | | --- | --- | | publish_site | Create a site from inline html, a local filePath, or a files map (multi-file; must include index.html). Returns { id, slug, url }. | | update_site | Partial update of content or metadata. Pass null to password/expiresInDays to clear them. | | delete_site | Delete a site by slug or id. | | list_sites | List sites in the workspace (filter by status). | | download_site | Download a site's files — inline, to a local destDir, or as a .zip. |

Optional fields on publish/update: custom slug (3–64 chars, [a-z0-9-]), title, password gate, and expiresInDays (auto-deletes after N days).

License

MIT