Butterbase Ai

io.github.butterbase-aiPublished by GitHub account butterbase-aiv1.0.0Updated Oct 24, 2026

Butterbase MCP server — manage your backend: schemas, auth, functions, storage, RAG, deploys.

VerifiedStreamable HTTPWeb executableDatabasesCloud & InfrastructureDeveloper Tools

Overview

AI-generated overview

Official Butterbase MCP server that lets an assistant manage a Butterbase backend: schemas, auth, functions, storage, RAG, frontends and deploys.

What you can do
  • Create, configure, move, clone and delete apps, regions and environment variables
  • Manage database schemas and migrations, and select, insert or seed rows
  • Configure auth, users, OAuth, people and row-level security
  • Deploy, invoke and manage functions, storage buckets, KV, realtime and durable objects
  • Deploy frontends and previews, manage RAG content and run RAG queries
  • Manage AI gateway and agents, repos, integrations, billing, API keys and audit logs
When to use it
Useful when you build or operate an app on Butterbase and want an assistant to handle backend setup and changes from the chat client instead of the dashboard. Also fits teams that want schema, auth, function and deploy work done conversationally.
Requirements
A Butterbase account and API key (bb_sk_...) supplied as BUTTERBASE_API_KEY, or as an Authorization bearer header for the hosted endpoint. Runs locally via npx @butterbase/mcp or as a remote streamable HTTP endpoint; OAuth is declared as required. Network access to Butterbase.
Before you install
The API key grants broad backend control, so treat it as a secret and keep it out of shared configs. Many tools write, deploy, pause, clone or delete resources, including apps, schemas, functions, storage and API keys, and billing and integrations tools can affect spending. The optional Office capability needs an explicit org_id and returns confirmation receipts that a human owner must review in the browser.

Installation

In SourceWeft

  1. Open Butterbase Ai in the dashboard and add it to a workspace.
  2. Connect the required credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.butterbase-ai%2Fmcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

{
  "mcpServers": {
    "butterbase-ai": {
      "type": "http",
      "url": "https://api.butterbase.ai/mcp"
    }
  }
}

README

@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

bash
npx @butterbase/mcp

Or install globally:

bash
npm install -g @butterbase/mcpbutterbase-mcp

Configure

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

json
{  "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:

json
{  "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.

Source: services/mcp-server/README.md at commit 473c69b

Tools

0
This server asks you to sign in, so SourceWeft could not read its tools without an account and has not indexed them. What a connected account sees can depend on that account and its permissions.

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts