# mcp

The Butterbase MCP server gives your agent access to schemas, auth, functions, storage, RAG and deploys. Useful when your backend runs on Butterbase.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 3031
- Author: butterbase-ai
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/butterbase-ai/butterbase/tree/HEAD/services/mcp-server
- Updated: 2026-10-20
- HTML: https://affpapa.org/en/nevibecode/mcp/butterbase-ai-mcp

## What it does

The server exposes 38 tools: apps and regions, schemas and migrations, auth and OAuth, row operations, function deploys, storage and KV, frontends and previews, RAG, realtime, RLS, integrations and billing, API keys and audit logs. There is also `butterbase_docs` for reference and a way to submit suggestions. It works from Claude, Codex, Cursor, GitHub Copilot, Windsurf, Cline and Zed.

Two ways to run it. Locally with `npx @butterbase/mcp`, or globally via `npm install -g @butterbase/mcp` and the `butterbase-mcp` command. Or point your client at the hosted endpoint `https://api.butterbase.ai/mcp` and skip the local install.

\`BUTTERBASE_API_KEY` is required — without it the server cannot authenticate against Butterbase. Keys look like `bb_sk_...` and you get one at butterbase.ai, then pass it as an environment variable in your MCP client config.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://api.butterbase.ai/mcp`
- Environment variables: `BUTTERBASE_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI**
```bash
claude mcp add mcp -e BUTTERBASE_API_KEY=<BUTTERBASE_API_KEY> -- npx -y @butterbase/mcp
```
Replace <…> with your own values

2. **Platform CLI: remote server**
```bash
claude mcp add --transport http mcp-server https://api.butterbase.ai/mcp
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add mcp-server --url https://api.butterbase.ai/mcp
```

2. **Platform CLI**
```bash
codex mcp add mcp-server --env BUTTERBASE_API_KEY=<BUTTERBASE_API_KEY> -- npx -y @butterbase/mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp-server": {
            "url": "https://api.butterbase.ai/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "@butterbase/mcp"
            ],
            "env": {
                "BUTTERBASE_API_KEY": "<BUTTERBASE_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp-server": {
            "type": "http",
            "url": "https://api.butterbase.ai/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp-server": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@butterbase/mcp"
            ],
            "env": {
                "BUTTERBASE_API_KEY": "<BUTTERBASE_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http mcp-server https://api.butterbase.ai/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e BUTTERBASE_API_KEY=<BUTTERBASE_API_KEY> mcp-server npx -y @butterbase/mcp
```
Replace <…> with your own values

## When to use it
- create an app and pick a region
- run a schema migration and seed the database
- deploy a function and invoke it
- set up RLS and access rules
- load content into RAG and query it

## Example prompts
- List my Butterbase apps and show their config
- Deploy the `send_email` function and invoke it with test data
- Insert a row into the `users` table through Butterbase

## Similar
- [rabbitmq-development](https://affpapa.org/en/nevibecode/skills/rabbitmq-development.md) — skill · 1100 installs
- [logging-best-practices](https://affpapa.org/en/nevibecode/skills/mindrally-logging-best-practices.md) — skill · 791 installs
- [insforge-cli](https://affpapa.org/en/nevibecode/skills/insforge-cli.md) — skill · 60500 installs
- [convex-env](https://affpapa.org/en/nevibecode/skills/convex-env.md) — skill · 36000 installs
- [convex-launch-readiness](https://affpapa.org/en/nevibecode/skills/convex-launch-readiness.md) — skill · 35900 installs
- [elysiajs](https://affpapa.org/en/nevibecode/skills/elysiajs.md) — skill · 14000 installs

## Other versions with the same name
- [mcp · kubeshark](https://affpapa.org/en/nevibecode/mcp/kubeshark-mcp.md) — ★ 12109
- [mcp · medplum](https://affpapa.org/en/nevibecode/mcp/mcp.md) — ★ 2760
- [mcp · sceneview](https://affpapa.org/en/nevibecode/mcp/sceneview-mcp.md) — ★ 1348
- [mcp · buoy-gg](https://affpapa.org/en/nevibecode/mcp/buoy-gg-mcp.md) — ★ 691
- [mcp · decionis](https://affpapa.org/en/nevibecode/mcp/decionis-mcp.md) — ★ 671

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md