busabase — Claude Code MCP server: what it does, how to install
Connects AI assistants to an agent-focused database where every modification generates a diff and a reviewable change request.
claude mcp add --transport http busabase https://busabase.com/api/mcpWhat busabase does
Busabase gives AI assistants a dedicated workspace and structured database layer. It prevents silent table overwrites. Every mutation turns into an explicit ChangeRequest containing a diff and an explanatory message. When the client holds direct write access, the patch applies immediately. Otherwise, operations pause until an operator inspects and approves them.
The server communicates via Streamable HTTP across two environments. Local installs connect to http://localhost:15419/api/mcp without credentials. Remote workspaces use https://busabase.com/api/mcp, relying on browser-based OAuth or a static Bearer token passed in $BUSABASE_API_KEY.
Failing to start a new chat after authentication leaves the client without its tool definitions. The session must be restarted so the environment registers the newly approved catalog.
What it helps with
- submit database modifications as diff-backed change requests
- pause unprivileged agent writes for manual team review
- inspect bases and records across Streamable HTTP endpoints
- scaffold workspace applications with bounded permission scopes
Example prompts for the agent
- List all bases in my Busabase workspace and inspect the latest rows.
- Propose a ChangeRequest to update schema properties in our workspace.
- Create a workspace application using the Busabase app creator skill.
How to install busabase
Platform CLI: remote server
claude mcp add --transport http busabase https://busabase.com/api/mcpPlatform CLI: remote server
codex mcp add busabase --url https://busabase.com/api/mcpConfig file
{
"mcpServers": {
"busabase": {
"url": "https://busabase.com/api/mcp"
}
}
}Config file
{
"servers": {
"busabase": {
"type": "http",
"url": "https://busabase.com/api/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http busabase https://busabase.com/api/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about busabase
How to install busabase in Claude Code?
Run claude mcp add --transport http busabase https://busabase.com/api/mcp. Once authorized, open a new conversation so the assistant loads the tool catalog.
What does busabase do?
It hooks agents into the Busabase engine using Streamable HTTP. All data writes surface as reviewable diffs, preventing unmonitored database rewrites.
What authentication is needed for cloud access?
The hosted address https://busabase.com/api/mcp requires a $BUSABASE_API_KEY Bearer token or completed browser OAuth authorization.
