name: butterbase-skills description: Claude Code plugin for Butterbase — 30+ guided skills and auto-configured MCP for the AI-native backend-as-a-service. license: MIT supported_assistants:

• claude-code
• claude-desktop homepage: https://butterbase.ai repository: https://github.com/butterbase-ai/butterbase-skills

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 40+ MCP tools, ships 30+ guided skills, 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

Setup

1. Get an API key — Sign up at butterbase.ai or generate one with the CLI:

   butterbase keys generate
   

2. Export it:

   export BUTTERBASE_API_KEY=bb_sk_your_key_here
   

3. Start Claude Code. The plugin auto-loads.

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
• Claude Desktop — point at the MCP endpoint manually via claude_desktop_config.json:

  {
    "mcpServers": {
      "butterbase": {
        "url": "https://api.butterbase.ai/mcp",
        "headers": { "Authorization": "Bearer ${BUTTERBASE_API_KEY}" }
      }
    }
  }
  

• Any other MCP-capable client can connect using the same URL + bearer auth, 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

Butterbase Skills

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

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

Installation

claude plugin add @butterbase/skills

Setup

1. Get an API key — Sign up at butterbase.ai or generate one with the CLI:

   butterbase keys generate
   

2. Set the environment variable:

   export BUTTERBASE_API_KEY=bb_sk_your_key_here
   

3. Start Claude Code — The plugin auto-configures the Butterbase MCP server connection. All 42+ tools are available immediately.

Available Skills

| Skill | Description | Example prompts | |-------|-------------|-----------------| | butterbase:build-app | Build a complete app from scratch | "Build me a blog with auth and comments" | | butterbase:schema-design | Design database schemas | "Design a schema for an e-commerce app" | | butterbase:deploy-frontend | Deploy frontends to live URLs | "Deploy my React app to production" | | butterbase:debug-rls | Debug Row-Level Security | "Users are seeing each other's data" | | butterbase:function-dev | Develop serverless functions | "Create a cron job to clean up expired sessions" | | butterbase:contributing | Contribute to Butterbase | "How do I add a new MCP tool?" |

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
• 6 skills — Guided workflows for building, deploying, debugging, and contributing

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

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