Butterbase MCP Server: Setup for Claude Code, Cursor and Other Apps

• Reads the Butterbase documentation

  Returns built-in docs on a topic such as auth, storage, functions or billing. It runs locally and makes no API call.

  Try: “Show me the Butterbase docs on storage.”

  Read · butterbase_docs

• Creates a new Butterbase backend app

  Creates an app with its own database and returns its ID and API address. You can pick a region.

  Try: “Create a new Butterbase app called todo-list.”

  Write · init_app

• Lists regions an app can live in

  Shows the regions you can create or move an app to.

  Try: “Which regions can I use for a new app?”

  Network · list_regions

• Lists, configures, pauses, clones or deletes apps

  Covers app settings such as CORS, access mode, visibility and environment variables. It can also pause an app, clone a template and permanently delete an app.

  Try: “List my apps and pause the staging one.”

  Delete · manage_app

• Moves an app to another region

  Checks the app is eligible, then queues a migration to the region you name.

  Try: “Move my app to eu-central-1.”

  Write · move_app

• Checks on a region move

  Returns the progress of a move you started.

  Try: “How is the move of my app going?”

  Network · move_app_status

• Removes the old copy after a move

  Decommissions the source-region copy kept after a completed move.

  Try: “Clean up the old replica after the move finished.”

  Delete · teardown_source_replica

• Inspects, cancels or reverses region moves

  Shows the active move, aborts one before cutover, or rolls a finished one back while the old copy exists.

  Try: “Abort the running migration for my app.”

  Write · manage_migrations

• Reads and changes your database schema

  Reads the schema, previews the SQL a change would run, applies a schema, and lists past changes.

  Try: “Preview adding a published column to posts, then apply it.”

  Write · manage_schema

• Reads rows from a table

  Queries a table with filters, sorting and paging.

  Try: “Show the 20 newest rows in the orders table.”

  Network · select_rows

• Adds one row to a table

  Inserts a single row into a table of your app.

  Try: “Add a todo called "buy milk".”

  Write · insert_row

• Adds many rows at once

  Inserts up to 100 rows across tables in one call. The docs say it bypasses row-level security.

  Try: “Seed the products table with ten sample items.”

  Write · seed_database

• Controls row-level security on tables

  Turns row-level security on, creates, updates and lists policies, and can delete one policy or all on a table.

  Try: “Make each user see only their own notes.”

  Delete · manage_rls

• Sets up social sign-in providers

  Adds, reads, changes or removes providers such as Google for your app's users.

  Try: “Configure Google sign-in for my app.”

  Delete · manage_oauth

• Sets sign-in token lifetimes, hooks and service keys

  Changes access and refresh token lifetimes, sets a function to run after sign-in, and generates a service API key.

  Try: “Make access tokens last 30 minutes.”

  Write · manage_auth_config

• Lists or deletes your app's end users

  Lists the people who signed up to your app, or deletes one by ID.

  Try: “List the latest users of my app.”

  Delete · manage_auth_users

• Lists or revokes platform API keys

  Shows your keys by prefix and revokes one by ID.

  Try: “Revoke the key I used for the demo.”

  Delete · manage_api_keys

• Searches audit logs

  Searches auth, admin and function audit logs.

  Try: “Show failed sign-ins from the last day.”

  Network · query_audit_logs

• Handles file uploads and downloads

  Returns signed upload and download links, lists and deletes files, and sets storage config.

  Try: “Give me an upload link for logo.png.”

  Delete · manage_storage

• Reads and writes the app's key-value store

  Sets exposure rules and reads, writes, scans and counts keys. It can also flush every key in the store, which needs a confirm flag.

  Try: “Show how many keys the KV store holds.”

  Delete · manage_kv

• Deploys a serverless function

  Uploads function code to your app and returns its address.

  Try: “Deploy a function that sends a welcome email.”

  Write · deploy_function

• Calls a deployed function

  Runs a function with the method and body you give and returns the full response.

  Try: “Call submit-inquiry with a test message.”

  Runs code · invoke_function

• Lists, deletes and debugs functions

  Lists functions, reads recent logs, updates environment variables and permanently deletes a function.

  Try: “Show the last 50 log lines of submit-inquiry.”

  Delete · manage_function

• Deploys a static website

  Starts a deployment of your front-end files to a live address.

  Try: “Deploy my built site to Butterbase.”

  Write · create_frontend_deployment

• Manages frontend deployments and domains

  Starts and lists deployments, sets environment values and configures a custom domain.

  Try: “Point my site at www.example.com.”

  Write · manage_frontend

• Manages edge-rendered sites

  Controls server-side rendered frontends that run at the edge.

  Try: “List my edge-rendered deployments.”

  Write · manage_edge_ssr

• Stores and fetches your app's code snapshots

  Pushes small sets of files (up to about 1 MB), lists snapshots and fetches the latest manifest. It can also wipe the repo.

  Try: “Push these files to my app repo.”

  Delete · manage_repo

• Manages documents for search

  Creates and deletes collections, ingests documents and checks their status.

  Try: “Create a collection called handbook and add this PDF.”

  Delete · manage_rag_content

• Searches your ingested documents

  Asks a question against a collection and returns the matching passages.

  Try: “What does the handbook say about refunds?”

  Network · rag_query

• Configures live updates

  Sets up realtime subscriptions for your app's tables.

  Try: “Turn on realtime for the messages table.”

  Write · manage_realtime

• Manages per-key stateful actors

  Creates and manages Durable Objects, small stateful workers kept per key.

  Try: “List the durable objects in my app.”

  Write · manage_durable_objects

• Uses the app's AI gateway

  Runs chat and embedding calls, lists models, and reads or changes the gateway config and usage.

  Try: “Ask the gateway to summarize this text.”

  Write · manage_ai

• Connects third-party services like Gmail or Slack

  Enables an integration, lists what is connected, and can run an action on one, such as sending an email.

  Try: “Send a Slack message through the connected workspace.”

  Write · manage_integrations

• Checks plan and usage, and adds credit

  Shows plan, usage and the monthly spending cap. It can also top up credit and raise the cap, each by an amount in USD cents you give, and open a Stripe billing portal link. The charge lands on the Butterbase account that owns the API key, and the server asks for no confirmation.

  Try: “What plan am I on and how much of my monthly spending cap have I used?”

  Write · manage_billing

• Sends feedback to the Butterbase team

  Submits a bug report, feature request or improvement note to the Butterbase team.

  Try: “Report that schema apply failed on enum defaults.”

  Write · submit_suggestion

• Submits a project to a Butterbase hackathon

  Resolves the hackathon, shows the required fields, then submits your entry.

  Try: “Submit my project to the hackathon.”

  Write · prep_and_submit_hackathon_entry

Watch out for

• It can permanently delete apps and data

  Tools can delete apps, users, functions, stored files and every key in the key-value store. The docs call app and function deletion irreversible. github.com

• It can add credit and raise spending caps

  manage_billing can top up your prepaid balance (topup) and raise the monthly spending cap (cap_raise) by any positive amount in cents. The money comes from the Butterbase account that owns the key, so you pay. The server code sends the call straight to Butterbase with no confirmation step and sets no limit of its own, so the only ceiling is your account. Use a key from an account you are happy to have an assistant spend from. github.com

• It can send messages through connected apps

  Once you connect Gmail or Slack, the integration tool can send email or messages as you. github.com

• Seeding bypasses row-level security

  The bulk insert tool writes with a platform role, so it ignores your row-level rules. github.com

Security advisories