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
Sign-in is OAuth — no API key copy-paste needed.
- Sign up at butterbase.ai.
- 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.
- 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
License
MIT
1---2name: butterbase-skills3description: Claude Code plugin for Butterbase — 30+ guided skills and auto-configured MCP for the AI-native backend-as-a-service.4license: MIT5---6
7# Butterbase Skills
8
9Claude Code plugin for **[Butterbase](https://butterbase.ai)** — an AI-native backend-as-a-service with Postgres, auth, storage, serverless functions, an AI gateway, RAG, realtime, and durable objects.
10
11This plugin gives Claude deep knowledge of Butterbase's 40+ MCP tools, ships 30+ guided skills, and auto-configures the MCP server connection.
12
13## What you get
14
15- **Auto-configured MCP server** — `.mcp.json` points Claude at `https://api.butterbase.ai/mcp` with your `BUTTERBASE_API_KEY`. All Butterbase tools available immediately.
16- **Always-on context** — `CLAUDE.md` teaches Claude Butterbase's environment, branding, tool shape, and core workflow.
17- **Guided journey** — `/butterbase-skills:journey` walks any idea from brainstorm → plan → schema → auth → functions → deploy → optional hackathon submission.
18- **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.
19
20## Install
21
22```bash
23# Add the marketplace
24claude plugin marketplace add https://github.com/butterbase-ai/butterbase-skills
25
26# Install the plugin
27claude plugin install butterbase
28```
29
30## Setup
31
32Sign-in is OAuth — no API key copy-paste needed.
33
341. **Sign up** at [butterbase.ai](https://butterbase.ai).
352. **Install the MCP server across every detected client:**
36 ```bash
37 npx @butterbase/cli mcp install
38 ```
39 The cli walks Claude Code, Cursor, VS Code, JetBrains, Codex, Gemini CLI, and the rest, and prints per-client OAuth hints.
403. **Trigger OAuth once per client.** In Claude Code: restart, then run `/mcp` (or `claude mcp login butterbase`).
41
42## Headline skills
43
44| Skill | What it does |
45|-------|--------------|
46| `/butterbase-skills:journey` | End-to-end orchestrator — idea → deployed app |
47| `/butterbase-skills:build-app` | Build a complete app from scratch |
48| `/butterbase-skills:schema-design` | Design Postgres schemas with the declarative DSL |
49| `/butterbase-skills:auth-setup` | Configure OAuth providers, JWT, service keys |
50| `/butterbase-skills:function-dev` | Develop and deploy serverless functions |
51| `/butterbase-skills:deploy-frontend` | Deploy React / Next.js / static to a live URL |
52| `/butterbase-skills:debug-rls` | Debug Row-Level Security access issues |
53| `/butterbase-skills:rag-dev` | Build a RAG knowledge base with semantic search |
54| `/butterbase-skills:durable-objects` | Stateful per-key actors (chat rooms, multiplayer, rate limiters) |
55| `/butterbase-skills:realtime` | WebSocket subscriptions for live database changes |
56| `/butterbase-skills:integrations` | Composio toolkits — email, Slack, GitHub, Notion, Linear, CRM |
57| `/butterbase-skills:payments` | Stripe Connect via `manage_billing` — subscriptions, marketplace splits |
58| `/butterbase-skills:substrate` | Per-user agent memory backend (entities, decisions, action ledger) |
59
60See [`CLAUDE.md`](./CLAUDE.md) and the [`skills/`](./skills/) directory for the full set.
61
62## Supported AI assistants
63
64- **Claude Code** (primary) — installed via the plugin marketplace command above; `npx @butterbase/cli mcp install` also covers it.
65- **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.
66- 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`](https://www.npmjs.com/package/@butterbase/mcp).
67
68## Related
69
70- **[@butterbase/mcp](https://www.npmjs.com/package/@butterbase/mcp)** — stdio MCP server for non-Claude-Code clients
71- **[@butterbase/sdk](https://www.npmjs.com/package/@butterbase/sdk)** — TypeScript SDK for app code
72- **[@butterbase/cli](https://www.npmjs.com/package/@butterbase/cli)** — CLI for local dev and project scaffolding
73- **[butterbase-oss](https://github.com/butterbase-ai/butterbase-oss)** — open-source backend runtime
74
75## License
76
77MIT
butterbase-ai