An official Model Context Protocol (MCP) server for tacobase. Point Cursor, Claude, Claude Code, Windsurf, Copilot, or any MCP-capable AI at your tacobase instance and let it manage schema, query data, and run SQL — all through natural language.

"Create a tasks collection with a title and completed field." Done. No dashboard. No copy-paste. Just vibes and tacos. 🌮

Table of Contents

• What it can do
• Setup
• Using with Cursor
• Using with Claude Desktop
• Using with Claude Code
• Using with Windsurf
• Collection types
• Pro tip
• Related packages

What it can do

| Tool | What your AI can say | |---|---| | tacobase_describe_project | "What's in my database?" — full schema dump, call first in every session | | tacobase_list_collections | "List all my collections." | | tacobase_get_collection | "Show me the schema for posts." | | tacobase_create_collection | "Create a comments collection with body (text) and author (text)." | | tacobase_update_collection | "Rename posts to articles." | | tacobase_delete_collection | "Delete the drafts collection." 🌶️ | | tacobase_query_records | "Show me the last 10 published posts." | | tacobase_create_record | "Seed 5 example posts for me." | | tacobase_update_record | "Mark task abc123 as completed." | | tacobase_delete_record | "Delete that duplicate record." | | tacobase_run_sql | "Run: SELECT count() FROM posts WHERE published = true"* |

Setup

Build from source:

cd packages/mcp-server
npm install
npm run build

You'll need:

• TACOBASE_URL — your instance URL (e.g. https://myapp.tacobase.dev or http://localhost:3000)
• TACOBASE_ADMIN_API_KEY — admin API key from the tacobase dashboard

Using with Cursor

1. Open Cursor Settings (Cmd/Ctrl + ,)
2. Go to Features → MCP
3. Click + Add new MCP server
4. Fill it in:

Type:    command
Name:    tacobase
Command: node
Args:    /absolute/path/to/tacobase/packages/mcp-server/dist/index.js
Env:
  TACOBASE_URL=https://myapp.tacobase.dev
  TACOBASE_ADMIN_API_KEY=tbk_admin_xxxxxxxx

5. Save. Status should go green.

Now ask Cursor: "Create a tasks collection with a title (text) and completed (boolean) field" — it'll do it.

Using with Claude Desktop

Add to claude_desktop_config.json (Claude Desktop → Settings → Developer → Edit Config):

{
  "mcpServers": {
    "tacobase": {
      "command": "node",
      "args": ["/absolute/path/to/tacobase/packages/mcp-server/dist/index.js"],
      "env": {
        "TACOBASE_URL": "https://myapp.tacobase.dev",
        "TACOBASE_ADMIN_API_KEY": "tbk_admin_xxxxxxxx"
      }
    }
  }
}

Restart Claude Desktop to apply.

Using with Claude Code

Add to your project's .claude/mcp.json:

{
  "mcpServers": {
    "tacobase": {
      "command": "node",
      "args": ["/absolute/path/to/tacobase/packages/mcp-server/dist/index.js"],
      "env": {
        "TACOBASE_URL": "https://myapp.tacobase.dev",
        "TACOBASE_ADMIN_API_KEY": "tbk_admin_xxxxxxxx"
      }
    }
  }
}

Using with Windsurf

Add to your Windsurf MCP config (~/.codeium/windsurf/mcp_config.json):

{
  "mcpServers": {
    "tacobase": {
      "command": "node",
      "args": ["/absolute/path/to/tacobase/packages/mcp-server/dist/index.js"],
      "env": {
        "TACOBASE_URL": "https://myapp.tacobase.dev",
        "TACOBASE_ADMIN_API_KEY": "tbk_admin_xxxxxxxx"
      }
    }
  }
}

Restart Windsurf to apply.

Collection types

| Type | Storage | Use when | |---|---|---| | flexible | JSONB — schema-free | Prototyping, variable-structure data | | strict | Typed SQL columns | Production data with enforced schema |

Strict field types: text · integer · bigint · boolean · jsonb · timestamptz · uuid · numeric · real

Pro tip

Tell your AI to call tacobase_describe_project first. It returns a full schema dump — every collection, every field, every type. Your AI knows exactly what's in the kitchen before it starts cooking.

Related packages

| Package | Description | |---|---| | @tacobase/client | Core SDK — CRUD, auth, realtime, storage | | @tacobase/react | React hooks — useAuth, useCollection, useRealtime | | @tacobase/cli | CLI — taco init, taco dev, taco typegen | | @tacobase/taco | Drop-in AI context — installs client + writes TACOBASE.md |

tacobase.dev · docs · github

License

MIT