Butterbase Ai

@butterbase/mcp

The official Model Context Protocol server for Butterbase — manage schemas, auth, functions, storage, RAG, realtime, and deploys on Butterbase from any MCP-capable client (Claude Code, Claude Desktop, Cursor, Windsurf, etc.).

Install

npx @butterbase/mcp

Or install globally:

npm install -g @butterbase/mcpbutterbase-mcp

Configure

Add to your MCP client config (.mcp.json, claude_desktop_config.json, etc.):

{  "mcpServers": {    "butterbase": {      "command": "npx",      "args": ["-y", "@butterbase/mcp"],      "env": {        "BUTTERBASE_API_KEY": "bb_sk_your_key_here"      }    }  }}

Get an API key at butterbase.ai.

Hosted alternative

Prefer to skip the local install? Butterbase also runs a hosted MCP endpoint:

{  "mcpServers": {    "butterbase": {      "url": "https://api.butterbase.ai/mcp",      "headers": {        "Authorization": "Bearer ${BUTTERBASE_API_KEY}"      }    }  }}

What you can do

The available tools depend on the server's enabled capabilities, including:

• Apps & regions — init_app, manage_app (actions: list/delete/pause/get_config/update_access_mode/secure/update_cors/set_visibility/preview_clone_env_vars/clone/get_clone_job/find_templates/set_clone_webhook/link_substrate/unlink_substrate/set_substrate_autopropagate/move/move_status/teardown_source_replica/get_env/update_env/publish_template_release/list_template_releases/get_template_release/check_template_updates/update_from_template), list_regions
• Schema — manage_schema, manage_migrations
• Auth — manage_auth_config, manage_auth_users, manage_oauth, manage_people
• Data — select_rows, insert_row, seed_database
• Functions — deploy_function, invoke_function, manage_function
• Storage & KV — manage_storage, manage_kv
• Frontends & previews — create_frontend_deployment, manage_frontend, manage_edge_ssr, manage_preview, promote_preview
• RAG — manage_rag_content, rag_query
• Realtime & Durable Objects — manage_realtime, manage_durable_objects
• AI gateway & agents — manage_ai, manage_agents
• RLS — manage_rls
• Repo — manage_repo
• Integrations & billing — manage_integrations, list_partner_apis, manage_billing
• API keys & audit logs — manage_api_keys, query_audit_logs
• Docs, suggestions & hackathons — butterbase_docs, submit_suggestion, prep_and_submit_hackathon_entry
• Office (optional cloud capability) — manage_office provides 44 organization-scoped actions for Ask, conversations, decisions, lifecycle controls, business records, curated agent memory, routines, cadence and paginated records. Read butterbase_docs with topic: "office" first. Every call needs an explicit org_id and platform credential; no app is selected. Enable/pause/resume/approve return confirmation receipts for the initiating owner to review in the browser. Agents must show the URL and observe the outcome, never confirm it themselves. OSS-only installations may omit this tool. See the Office client reference.

See the Butterbase docs for the full list.

License

Apache-2.0 © NetGPT Inc.