# Butterbase

AI-native, open-source backend-as-a-service with a built-in Model Context Protocol server.

- Repository: https://github.com/butterbase-ai/butterbase (3034 stars)
- Category: Engineering
- License: Apache-2.0
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add butterbase-ai/butterbase --skill butterbase -g -a claude-code -y`
Codex: `npx skills add butterbase-ai/butterbase --skill butterbase -g -a codex -y`
Cursor: `npx skills add butterbase-ai/butterbase --skill butterbase -g -a cursor -y`
Gemini CLI: `npx skills add butterbase-ai/butterbase --skill butterbase -g -a gemini-cli -y`

## Description

AI-native, open-source backend-as-a-service with a built-in Model Context Protocol server. Postgres, auth, storage, functions, AI gateway.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Butterbase

**AI-native, open-source backend-as-a-service** with a built-in Model Context Protocol (MCP) server. Postgres data plane, auth, storage, serverless functions, AI gateway, RAG, realtime, and durable objects, all drivable by an AI agent via MCP tools.

This repo ships the open-source runtime. The managed offering at [butterbase.ai](https://butterbase.ai) adds multi-region orchestration, billing, and ops.

## What the MCP server can do

Nearly 40 tools across the platform's surface area, including:

- **Apps & regions**, `init_app`, `manage_app` (actions: list/delete/pause/get_config/update_access_mode/secure/update_cors/set_visibility/preview_clone_env_vars/clone/get_clone_job/find_templates/set_clone_webhook/link_substrate/unlink_substrate/move/move_status/teardown_source_replica), `list_regions`
- **Schema**, `manage_schema` (declarative DSL, dry-run diffs), `manage_migrations`
- **Auth**, `manage_auth_config`, `manage_auth_users`, `manage_oauth`
- **Data**, `select_rows`, `insert_row`, `seed_database`
- **Functions**, `deploy_function`, `invoke_function`, `manage_function`
- **Storage**, `manage_storage` (presigned URLs, ACLs)
- **Frontends**, `create_frontend_deployment`, `manage_frontend`, `manage_edge_ssr`
- **RAG**, `manage_rag_content`, `rag_query`
- **Realtime & Durable Objects**, `manage_realtime`, `manage_durable_objects`
- **AI gateway**, `manage_ai` (chat, embeddings, BYOK)
- **Row-Level Security**, `manage_rls`
- **Integrations**, `manage_integrations` (Composio: email, Slack, GitHub, Notion, Linear, CRM)
- **Billing**, `manage_billing` (Stripe Connect)
- **KV, API keys, audit logs**, and more

## Install

### Option 1, Claude Code plugin (recommended)

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

The rest: https://github.com/butterbase-ai/butterbase/blob/HEAD//SKILL.md