Butterbase Skills MCP Server

Butterbase Skills

Claude Code plugin for Butterbase — the AI-Native Backend-as-a-Service.

This plugin gives Claude deep knowledge of Butterbase's nearly 40 MCP tools, guides you through common workflows, and auto-configures the MCP server connection.

Installation

claude plugin marketplace add https://github.com/butterbase-ai/butterbase-skills
claude plugin install butterbase-skills@butterbase-skills

Setup

Sign-in is OAuth — no API key copy-paste needed.

1. Sign up at butterbase.ai.

2. Install the MCP server across every detected client with one command:

   npx @butterbase/cli mcp install
   

   This walks Claude Code, Cursor, VS Code, JetBrains, Codex, Gemini CLI, and the rest, and prints per-client OAuth follow-up hints.

3. Trigger OAuth once per client. In Claude Code: restart, then run /mcp (or claude mcp login butterbase). The cli's output covers every other client.

The plugin auto-loads its skills and CLAUDE.md context as soon as Claude Code starts. All tools are available immediately after consent.

Available Skills

Skills are namespaced by the plugin name, e.g. butterbase-skills:build-app.

Building blocks

Skill	Description	Example prompts
butterbase-skills:build-app	Build a complete app from scratch	"Build me a blog with auth and comments"
butterbase-skills:schema-design	Design database schemas	"Design a schema for an e-commerce app"
butterbase-skills:deploy-frontend	Deploy frontends to live URLs	"Deploy my React app to production"
butterbase-skills:debug-rls	Debug Row-Level Security	"Users are seeing each other's data"
butterbase-skills:function-dev	Develop serverless functions	"Create a cron job to clean up expired sessions"
butterbase-skills:auth-setup	OAuth providers, auth hooks, JWT lifetimes, service keys	"Add Google and GitHub sign-in"
butterbase-skills:storage	File uploads/downloads, presigned URLs, storage ACLs	"Let users upload profile pictures"
butterbase-skills:realtime	WebSocket subscriptions, presence, multiplayer state	"Show new messages live without refreshing"
butterbase-skills:durable-objects	Stateful per-key actors (rooms, rate limiters, long-running agents)	"Build a multiplayer game room"
butterbase-skills:ai	AI gateway: chat, embeddings, models, defaults, BYOK, usage	"Summarize each post with an LLM"
butterbase-skills:rag-dev	Knowledge bases, document ingestion, semantic search, Q&A	"Let users ask questions about our docs"
butterbase-skills:agents	Declarative LLM/tool-graph agents, MCP servers, access controls	"Create a support agent that can look up orders"
butterbase-skills:meetings	Meeting bots that join, record, and transcribe Zoom/Meet/Teams/Webex calls	"Build a sales-call notetaker"
butterbase-skills:integrations	Third-party SaaS (email, SMS, Slack, calendar, CRM, ...) via built-in integrations	"Send a welcome email when someone signs up"
butterbase-skills:payments	Stripe Connect payments through manage_billing	"Charge users a monthly subscription"
butterbase-skills:substrate	Read/write the per-user agent-memory substrate	"Remember my customers across apps"
butterbase-skills:migrations	Move an app between regions, check, abort, or reverse a move	"Move my app to the EU region"
butterbase-skills:templates	Publish, browse, and clone public app templates	"Publish my app as a template"
butterbase-skills:contributing	Contribute to Butterbase	"How do I add a new MCP tool?"

Guided journey

butterbase-skills:journey takes an idea all the way to a deployed app, running these stages in order. Each stage can also be run on its own.

Skill	Description	Example prompts
butterbase-skills:journey	Orchestrates the full idea → plan → build → deploy flow	"I have an idea for an app"
butterbase-skills:journey-idea	Stage 1: one-question-at-a-time idea brainstorm	"I want to build something that..."
butterbase-skills:journey-plan	Stage 2: turn the idea into a concrete Butterbase plan	"Plan out the tables and auth"
butterbase-skills:journey-preflight	Verify account, MCP connection, API key, and app ID	"Am I set up to build?"
butterbase-skills:journey-docs	Prime the relevant Butterbase docs before building	—
butterbase-skills:journey-schema	Apply the plan's tables	—
butterbase-skills:journey-rls	Install the plan's RLS policies	—
butterbase-skills:journey-auth	Configure the plan's OAuth providers and auth hooks	—
butterbase-skills:journey-storage	Configure the plan's storage buckets and ACLs	—
butterbase-skills:journey-functions	Implement and deploy the plan's functions	—
butterbase-skills:journey-realtime	Enable realtime on the plan's tables	—
butterbase-skills:journey-durable	Deploy the plan's Durable Object classes	—
butterbase-skills:journey-ai	Configure the plan's AI gateway defaults	—
butterbase-skills:journey-rag	Create the plan's RAG collections and ingest seed docs	—
butterbase-skills:journey-agents	Build and deploy the plan's agents	—
butterbase-skills:journey-frontend	Scaffold and deploy the plan's frontend	—
butterbase-skills:journey-deploy	Smoke-test the deployed app	"Check my app actually works"
butterbase-skills:journey-substrate	Optional: link the app to your substrate	—
butterbase-skills:journey-templates	Optional: publish the app as a template	—
butterbase-skills:journey-submit	Optional: submit the app to a hackathon	"Submit my app to the hackathon"

Slash commands

The plugin also ships 34 slash commands (in commands/) that invoke the skills directly, e.g. /butterbase-skills:journey, /butterbase-skills:schema, /butterbase-skills:deploy, /butterbase-skills:idea, /butterbase-skills:submit.

What's Included

• .mcp.json — Auto-configures the Butterbase MCP server connection (HTTPS endpoint)
• CLAUDE.md — Always-on context: environment variables, workflows, patterns, documentation references
• 39 skills and 34 slash commands — Guided workflows for building, deploying, debugging, and contributing, plus the end-to-end journey

Local Development

If you're running the Butterbase monorepo locally, the MCP server URL defaults to http://localhost:4000/mcp. Set this in your environment:

export CONTROL_API_URL=http://localhost:4000

Office clients

Hosted Butterbase MCP may expose the optional manage_office tool with 44 organization-scoped actions. Call butterbase_docs with topic: "office" before using it. Office uses a platform credential and an explicit org_id; it does not need an app. Equivalent interfaces are butterbase office --org <uuid> and SDK OfficeClient.

Enable, pause, resume and approve return a saved browser confirmation receipt. Show confirmation_url to the initiating owner, who signs in and reviews one operation. Never confirm as an agent. Observe status using confirmation_id. Keep Ask's request key and exact conversation/turn IDs; retry the same intended write with the same key and observe admitted work without submitting another Ask. Disconnecting does not cancel server work. Inspect unknown outcomes before retrying. See the Office client reference.

Also Available

• @butterbase/sdk — TypeScript SDK for client-side and server-side use
• @butterbase/cli — CLI tool for project scaffolding and backend management
• butterbase_docs MCP tool — Call with any topic (auth, storage, functions, etc.) for comprehensive reference docs

License

MIT

Curated organization context uses agent-memories / SDK agentMemories; default agent retrieval searches only this category. Other business memory requires an explicit category read. Compact title/summary lists precede full entry reads; context never overrides rules or permissions. Amend/archive require the current revision. Private per-person memory remains deferred.

skills supports separate list/detail/version/run pages, draft/test/reject and owner-confirmed approve/enable/rollback/run. principles amend/retire proposes governed changes. settings reads cadence and proposes revision-guarded 10/15/30/60-minute intervals without resuming paused work. Every-loop skills follow admitted full timer/event sweeps within a shared ten-minute budget; unchanged checks and Ask/test/manual/scheduled turns do not create loops. Extra runs can spend credits.

records list / SDK records.list / MCP list_office_records reads bounded resource pages (25 default, 100 maximum). Preserve organization, resource and filters with next_cursor; loaded counts are not totals and cutoff pagination is not a transaction-wide snapshot. Read the Office reference for the complete 44-action contract and payloads.