- MCP backends:
cockroachdb-toolboxfor any cluster through MCP Toolbox, andcockroachdb-cloudfor the managed CockroachDB Cloud MCP Server. Additional backends, including the CockroachDB MCP Server for self-hosted clusters, can be added manually. - Cluster management tools: the
ccloudCLI for cluster lifecycle, backups, disaster recovery, networking, and audit tasks, which agents call directly through the shell. - SQL client tools: list schemas and tables, inspect cluster and database details, and run SQL. SQL through MCP Toolbox is read-only unless write mode is enabled; the Cloud MCP Server provides separate write tools governed by your CockroachDB Cloud permissions.
- Agents and skills: skills across operational domains in every plugin, plus specialized DBA, Developer, and Operator agents in the Claude Code and Cursor plugins.
- Safety protections: In the Claude Code and Codex plugins, built-in safety hooks block dangerous statements. In the Cursor plugin, safety and best-practice rules steer the model away from risky behavior.
Prerequisites
The official CockroachDB plugins come bundled with the following MCP servers, which have their own requirements:- The
cockroachdb-toolboxserver works with any self-hosted or Cloud cluster. It requires MCP Toolbox for Databases v1.0.0 or later on yourPATH, and a running CockroachDB cluster it can reach. On macOS or Linux, install Toolbox withbrew install mcp-toolbox. For Windows and other platforms, refer to the plugin repository’s installation instructions. - The
cockroachdb-cloudserver requires a CockroachDB Cloud account. There is no local server to set up, but the server requires OAuth sign-in to CockroachDB Cloud in every tool. In Claude Code, run/mcpand select the server to sign in. In Cursor, the server signs in with OAuth through your browser. In Codex, no configuration is needed beyond the OAuth sign-in, and the server can reach the clusters that your CockroachDB Cloud role allows.
Install the Claude Code plugin
Install the CockroachDB plugin from the Claude marketplace, or run the following in Claude Code:Install the Cursor plugin
Install the CockroachDB plugin from the Cursor marketplace, or run the following in Cursor:Install the Codex plugin
The CockroachDB plugin for the OpenAI Codex CLI is listed on the ChatGPT and Codex plugin listing. To install, add the plugin marketplace and the plugin:/hooks in a Codex session and trust the two CockroachDB safety hooks.

