Your AI assistant connects to Butterbase through MCP. That connection lets the assistant manage your entire backend — creating apps, evolving schemas, configuring authentication, managing storage, deploying functions, and more — using structured tools instead of manual work.
The Model Context Protocol (MCP) is a standard for connecting AI assistants to external tools and data sources. When you connect Butterbase via MCP, your assistant gains access to 37+ structured tools for managing your backend.
Add this to your MCP configuration:
"args" : [ " -y " , " @anthropic-ai/mcp-server-butterbase " ],
"BUTTERBASE_API_KEY" : " bb_sk_your_key_here " ,
"BUTTERBASE_API_URL" : " https://api.butterbase.ai "
Follow the same pattern — add the MCP server configuration to your editor’s MCP settings file.
If your environment connects to a hosted MCP endpoint, include your API key as a Bearer token in the Authorization header:
Authorization: Bearer bb_sk_your_key_here
The MCP endpoint is available at:
Method Path Purpose GET, POST, DELETE /mcp Streamable HTTP MCP session
Tool What it does init_app Create a new backend app. You supply a name; you receive the app id and API base URL. list_apps List all apps you have access to with their metadata. delete_app Permanently delete an app and its database. This is irreversible. get_app_config Read an app’s current configuration (CORS origins, JWT settings, storage limits). update_cors Set the list of allowed origins for browser requests to your app’s API. update_jwt_config Configure access token lifetime and refresh token lifetime. generate_service_key Generate a bb_sk_ prefixed API key for programmatic access.
Tool What it does get_schema Read the current database schema for an app. apply_schema Apply a declarative schema. Set dry_run: true to preview. dry_run_schema Preview SQL statements without executing. list_migrations View the history of all schema migrations.
Tool What it does select_rows Query table rows with filtering, sorting, pagination. insert_row Insert a row into a table.
Tool What it does configure_oauth_provider Register a social sign-in provider. get_oauth_config List all configured OAuth providers. update_oauth_provider Modify an existing OAuth provider. delete_oauth_provider Remove an OAuth provider. enable_rls Enable row-level security on a table. create_policy Create a custom RLS policy. create_user_isolation_policy Quick user isolation setup. get_rls_policies List active RLS policies. delete_rls_policy Remove RLS from a table. query_audit_logs Search authentication audit logs.
Tool What it does generate_upload_url Get a presigned upload URL. generate_download_url Get a presigned download URL. get_storage_objects List all files for an app. delete_storage_object Delete a file from storage.
Tool What it does deploy_function Deploy a TypeScript/JavaScript function. list_functions List all deployed functions. invoke_function Test-invoke a deployed function. delete_function Delete a deployed function. update_function_env Update environment variables. get_function_logs View invocation logs.
Tool What it does create_frontend_deployment Create a deployment and get an upload URL. start_frontend_deployment Start a deployment after uploading. list_frontend_deployments View deployment history. set_frontend_env Configure environment variables for builds.
Tool What it does configure_realtime Enable realtime on tables. get_realtime_config View current realtime configuration.
Tool What it does submit_suggestion Submit feedback or bug reports. butterbase_docs Read the documentation by topic.
You can generate API keys through the dashboard on the API Keys page, or using the generate_service_key MCP tool. Keys are prefixed with bb_sk_ and provide full access to your apps and data.
