// MCP TOOL REFERENCE

MCP TOOLS

47 tools from the Mcp MCP Server, categorised by risk level.

// ALL 47 MCP TOOLS

READ 10 tools

Read butterbase_docs Read comprehensive Butterbase documentation (local, no API calls). Available topics: - all: Complete doc... Read find_entities Search substrate entities by type and/or display-name fuzzy match. Returns a list of matching entities for... Read get_entity Get a substrate entity by id. Returns 404 if not found. Read list_attention_rule_firings List firing history for a substrate attention rule. Returns a paginated list of firing records for the giv... Read list_outbox List substrate outbox rows for the current user. Use to inspect pending/failed/dead-letter side-effect dis... Read list_regions List the regions an app can be created or moved to. Returns the live set of supported regions. Use this be... Read query_audit_logs Query audit events for an app — authentication, admin mutations, and function invocations. Returns a unifi... Read rag_query Query a RAG collection using natural language to retrieve relevant document chunks. Performs semantic sear... Read search_memory Full-text search across substrate institutional memory. Searches decisions, commitments, and learnings usi... Read teardown_source_replica Tear down the source replica kept after a completed app migration. After a move completes, the source regi...

WRITE 25 tools

Write approve_action Approve a substrate action that is waiting for human review. Use after a previous propose_action returned ... Write create_frontend_deployment Create a frontend deployment and get an upload URL. Upload your built frontend as a zip file to the returne... Write init_app Create a new backend app with isolated database and API endpoints. Returns: app_id, api_url, url (frontend... Write insert_row Insert a new row into a table using the auto-generated REST API. By default, this tool authenticates with ... Write manage_ai Use the app's AI gateway: chat, embeddings, list models, read/update config, read usage. Actions: - chat... Write manage_auth_config Manage authentication configuration for an app. Actions: - "configure_auth_hook": Configure a post-authe... Write manage_auth_users Manage end-user auth records for an app. Actions: - "list": Paginated list of app_users (id, email, pr... Write manage_billing Manage billing, plans, usage, and spending caps for the Butterbase platform account. This is a platform-sc... Write manage_edge_ssr Manage Edge SSR (Cloudflare Workers) deployments: prebuilt-zip flow, server-side build flow, list history. ... Write manage_frontend Manage frontend deployments, environment variables, and custom domains for a Butterbase app. Actions: - ... Write manage_integrations Manage third-party integrations for a Butterbase app (e.g., Gmail, Slack, Google Calendar). Actions: - "... Write manage_migrations Read and control in-flight app migrations. This complements move_app / move_app_status / teardown_source_r... Write manage_oauth Manage OAuth providers for end-user authentication (configure, get, update, delete). Actions: - "configu... Write manage_realtime Manage realtime WebSocket notifications for database tables. Actions: - "configure": Enable realtime bro... Write manage_rls Manage Row-Level Security (RLS): enable on tables, create/update/delete policies, list, and one-shot user i... Write manage_schema Manage the database schema: read current schema, apply changes, preview changes, and audit migration histor... Write move_app Migrate an app to a different region. Checks eligibility first, then enqueues the migration. Parameters: ... Write move_app_status Get the current status of an app migration. Parameters: - app_id: The app being migrated - migra... Write prep_and_submit_hackathon_entry Prep and submit your project to a Butterbase hackathon. Two-step flow. The tool resolves which hackathon y... Write propose_action Propose a write to the substrate. Use to record an entity, decision, commitment, or learning. Phase 0: eve... Write reject_action Reject a substrate action that is waiting for review. Use to discard a proposed action without executing i... Write retry_outbox Manually re-queue a failed or dead-letter substrate outbox row. Resets scheduled_at to now() and status to... Write seed_database Insert multiple rows into a table in a single call. Useful for seeding sample data, bootstrapping test fixt... Write select_rows Query rows from a table using the auto-generated REST API. By default, this tool authenticates with the pl... Write submit_suggestion Submit feedback, bug reports, or feature suggestions to the Butterbase platform team. Use this tool when y...

DESTRUCTIVE 10 tools

EXECUTE 2 tools

Execute deploy_function Deploy or update a serverless function with custom business logic. Example: Input: { app_id: "app_ab... Execute invoke_function Invoke a deployed function and return its full HTTP response. Example — POST with body: Input: { app...

// RUNNING THIS SERVER

The managed route: connect Mcp through the PolicyLayer gateway — every tool call above is checked against your policy before it runs, with a full audit log.

DIRECT INSTALL (UNMANAGED) npx -y @butterbase/mcp

// FAQ

How many tools does the Mcp MCP server have? +

The Mcp MCP server exposes 47 tools across 4 categories: Read, Write, Destructive, Execute.

How do I enforce policies on Mcp tools? +

Route the Mcp server through the PolicyLayer gateway. Define allow, deny, or approval rules per tool in the dashboard — they are enforced on every call before it reaches the server.

What risk categories do Mcp tools fall into? +

Mcp tools are categorised as Read (10), Write (25), Destructive (10), Execute (2). Each category has a recommended default policy.

Let agents act without letting them run wild.

Route your MCP servers through PolicyLayer and every tool call is checked against your policy before it runs — allow, deny, or require approval. Per-identity grants. Full audit log. Live in minutes.

SECURE YOUR MCP →

Free to start. No card required.

4,600+ MCP servers and 31,000+ tools scanned and risk-classified.