npm package · MCP
@tacobase/mcp-server
Official Model Context Protocol server for tacobase. Point Cursor, Claude, Claude Code, or Windsurf at your instance and manage everything via natural language.
terminal
npx @tacobase/mcp-server
Uses the Admin API key — keep it server-side only.
What your AI can do
All 10 MCP tools — just describe what you want in plain English.
| Tool | Say something like | What it does |
|---|---|---|
| tacobase_describe_project | "What's in my database?" | Full schema dump — call this first in every session. |
| tacobase_list_collections | "List all my collections." | Returns all collection names and field counts. |
| tacobase_create_collection | "Create a comments collection with body and author fields." | Creates a new collection with the specified schema. |
| tacobase_update_collection | "Rename posts to articles." | Renames or modifies an existing collection. |
| tacobase_delete_collection | "Delete the drafts collection." | Permanently deletes a collection and all its records. |
| tacobase_query_records | "Show me the last 10 published posts." | Query records with filters, sorting, and pagination. |
| tacobase_create_record | "Seed 5 example tasks for me." | Creates one or more records in a collection. |
| tacobase_update_record | "Mark task abc123 as completed." | Updates a specific record by ID. |
| tacobase_delete_record | "Delete that duplicate record." | Deletes a record by ID. |
| tacobase_run_sql | "SELECT count(*) FROM posts WHERE published = true" | Run raw SQL against the underlying database. |
Setup
Add to your MCP config. Requires your instance URL and Admin API key.
Cursor
.cursor/mcp.json{
"mcpServers": {
"tacobase": {
"command": "npx",
"args": ["@tacobase/mcp-server"],
"env": {
"TACOBASE_URL": "https://your-app.tacobase.dev",
"TACOBASE_ADMIN_API_KEY": "tbk_admin_..."
}
}
}
}Claude Desktop
~/Library/Application Support/Claude/claude_desktop_config.json{
"mcpServers": {
"tacobase": {
"command": "npx",
"args": ["@tacobase/mcp-server"],
"env": {
"TACOBASE_URL": "https://your-app.tacobase.dev",
"TACOBASE_ADMIN_API_KEY": "tbk_admin_..."
}
}
}
}Claude Code
terminalclaude mcp add tacobase \
-- npx @tacobase/mcp-server \
--env TACOBASE_URL=https://your-app.tacobase.dev \
--env TACOBASE_ADMIN_API_KEY=tbk_admin_...Admin key — server-side only
The MCP server uses TACOBASE_ADMIN_API_KEY which has full read/write access including schema changes. Never expose it in client-side code or commit it to git. Use a regular TACOBASE_API_KEY for application code.