Butterbase Skills

Claude Code plugin for Butterbase — an AI-native backend-as-a-service with Postgres, auth, storage, serverless functions, an AI gateway, RAG, realtime, and durable objects.

This plugin gives Claude deep knowledge of Butterbase's nearly 40 MCP tools, ships 39 guided skills and 34 slash commands, and auto-configures the MCP server connection.

What you get

• Auto-configured MCP server — .mcp.json points Claude at https://api.butterbase.ai/mcp with your BUTTERBASE_API_KEY. All Butterbase tools available immediately.
• Always-on context — CLAUDE.md teaches Claude Butterbase's environment, branding, tool shape, and core workflow.
• Guided journey — /butterbase-skills:journey walks any idea from brainstorm → plan → schema → auth → functions → deploy → optional hackathon submission.
• Per-capability skills — schema-design, auth-setup, function-dev, deploy-frontend, debug-rls, storage, rag-dev, realtime, durable-objects, ai, migrations, substrate, integrations, payments, and more.

Install

# Add the marketplace
claude plugin marketplace add https://github.com/butterbase-ai/butterbase-skills

# Install the plugin
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:

   npx @butterbase/cli mcp install
   

   The cli walks Claude Code, Cursor, VS Code, JetBrains, Codex, Gemini CLI, and the rest, and prints per-client OAuth hints.
3. Trigger OAuth once per client. In Claude Code: restart, then run /mcp (or claude mcp login butterbase).

Headline skills

Skill	What it does
/butterbase-skills:journey	End-to-end orchestrator — idea → deployed app
/butterbase-skills:build-app	Build a complete app from scratch
/butterbase-skills:schema-design	Design Postgres schemas with the declarative DSL
/butterbase-skills:auth-setup	Configure OAuth providers, JWT, service keys
/butterbase-skills:function-dev	Develop and deploy serverless functions
/butterbase-skills:deploy-frontend	Deploy React / Next.js / static to a live URL
/butterbase-skills:debug-rls	Debug Row-Level Security access issues
/butterbase-skills:rag-dev	Build a RAG knowledge base with semantic search
/butterbase-skills:durable-objects	Stateful per-key actors (chat rooms, multiplayer, rate limiters)
/butterbase-skills:realtime	WebSocket subscriptions for live database changes
/butterbase-skills:integrations	Composio toolkits — email, Slack, GitHub, Notion, Linear, CRM
/butterbase-skills:payments	Stripe Connect via manage_billing — subscriptions, marketplace splits
/butterbase-skills:substrate	Per-user agent memory backend (entities, decisions, action ledger)

See CLAUDE.md and the skills/ directory for the full set.

Supported AI assistants

• Claude Code (primary) — installed via the plugin marketplace command above; npx @butterbase/cli mcp install also covers it.
• Claude Desktop / Cursor / VS Code / JetBrains / Codex / Gemini CLI / others — npx @butterbase/cli mcp install writes the right config for each, then a single /mcp (or the client's equivalent) launches the OAuth flow in your browser.
• Any other MCP-capable client can connect to https://api.butterbase.ai/mcp directly — the server advertises OAuth 2.1 via the standard .well-known/oauth-protected-resource metadata. Or run the MCP server locally via @butterbase/mcp.

Related

• @butterbase/mcp — stdio MCP server for non-Claude-Code clients
• @butterbase/sdk — TypeScript SDK for app code
• @butterbase/cli — CLI for local dev and project scaffolding
• butterbase-oss — open-source backend runtime

License

MIT