Bunstation MCP

Build websites and apps from a prompt, edit files, publish, and check credits and usage.

Documentation

Bunstation MCP

Remote MCP server for Bunstation. It lets an AI agent build websites and apps from a prompt, edit and commit project files, publish builds, and read credits, invoices, and usage for the signed-in account.

  • URL: https://api.bunstation.com/mcp
  • Transport: Streamable HTTP (stateless, POST only)
  • Auth: OAuth 2.1 with dynamic client registration, scope mcp. The first connection opens Bunstation sign-in.
  • Protected resource metadata: https://api.bunstation.com/.well-known/oauth-protected-resource/mcp

The server is hosted by Bunstation. There is nothing to install or run locally.

Connect

Claude Code

claude mcp add --transport http bunstation https://api.bunstation.com/mcp

Claude (claude.ai and desktop)

Settings β†’ Connectors β†’ Add custom connector, then paste https://api.bunstation.com/mcp.

Cursor

Install the Bunstation Cursor plugin, or add this to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "bunstation": {
      "url": "https://api.bunstation.com/mcp"
    }
  }
}

VS Code

code --add-mcp '{"name":"bunstation","type":"http","url":"https://api.bunstation.com/mcp"}'

Other clients

Any client that supports remote Streamable HTTP servers with OAuth works. Clients that only speak stdio can use mcp-remote:

{
  "mcpServers": {
    "bunstation": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.bunstation.com/mcp"]
    }
  }
}

Tools

Projects

ToolDescription
projects_createCreate a project from a prompt and start building it. Stack is vite or nextjs, model is an OpenRouter model id. At most 3 projects per request.
projects_listList the user's projects, newest activity first.
projects_getGet one project.
projects_updateRename a project or change the model used for later messages.
projects_publishPublish a successful build on a bunstation.app subdomain.
projects_generation_stopStop the generation running on a project.
projects_chat_getRead the recent conversation, generation status, and queued follow-ups.
projects_builds_listList recent builds, newest first.
projects_builds_logRead the build log for a commit.

Templates

ToolDescription
templates_listList public templates from the app library, optionally by category.
templates_useCopy a template into a new project without starting a prompt build.

Files and changes

Edits are staged as uncommitted changes until projects_changes_commit. Reads include uncommitted changes.

ToolDescription
projects_files_listList file paths in a project.
projects_files_readRead a text file.
projects_files_searchSearch text in a project.
projects_files_createStage a new text file.
projects_files_updateStage a full replacement of a text file.
projects_files_deleteStage deletion of a file.
projects_changes_listList uncommitted changes.
projects_changes_commitCommit every pending change.
projects_changes_discardDrop one uncommitted change.

Media

ToolDescription
projects_media_listList files in the project media library.
projects_media_readPreview a media file. Images up to 4 MB are returned so the model can see them.
projects_media_uploadReturn a one-time curl command that uploads local files to the media library. The token expires in 10 minutes.

Account

ToolDescription
account_credits_getCredit balance and current plan.
account_invoices_listList invoices, newest first.
account_invoices_getGet one invoice and its hosted Stripe URL.
account_usage_getToken usage for this_week, this_month, or all_time.

Example prompts

  • "Create a landing page for my bakery with a menu and contact form."
  • "List my Bunstation projects and show the build log for the newest one."
  • "Change the hero heading in my portfolio project, commit it, and publish."
  • "How many credits do I have left this month?"

Support

Email hi@bunstation.com or open an issue in this repository.

License

MIT