Skip to main content
Watch: I Built an AI App Without Leaving Databricks

Databases - official CockroachDB server

CockroachDB Cloud MCP server

Managed MCP server built into CockroachDB Cloud that lets AI tools list clusters, explore live schemas and run SQL against clusters in a CockroachDB Cloud organization. Connections can cover every cluster the user or service account can access, or be scoped to one cluster with an mcp-cluster-id header. CockroachDB hosts it at https://cockroachlabs.cloud/mcp with OAuth or API key auth.

Last verified 12 tools4 sources

Install

Terminal
claude mcp add cockroachdb-cloud https://cockroachlabs.cloud/mcp --transport http
Terminal
codex mcp add cockroachdb-cloud --url https://cockroachlabs.cloud/mcp
JSON
"mcpServers": {
     "cockroachdb-cloud": {
       "url": "https://cockroachlabs.cloud/mcp"
     }
}

VS Code

JSON
"servers": {
     "cockroachdb-cloud": {
       "type": "http",
       "url": "https://cockroachlabs.cloud/mcp"
     }
}

Tools

list_clusters
List all accessible clusters.
get_cluster
Get detailed cluster information.
list_databases
List databases in the cluster.
list_tables
List tables in a database.
get_table_schema
Get detailed schema for a table.
select_query
Execute a SELECT statement.
explain_query
Execute an EXPLAIN statement.
show_statement
Execute a SHOW statement.
show_running_queries
List currently executing queries.
create_database
Create a new database.
create_table
Create a new table.
insert_rows
Insert rows into a table.

As documented on October 17, 2026. A running server reports its current list through tools/list.

Notes and caveats

  • Hosted only, no public repo or package.
  • Cloud release notes list the MCP server as GA in the April 2026 highlights on Basic, Standard and Advanced; Codex client support (June 2026) and the OAuth apps page for MCP redirect URLs (May 2026, Advanced only) are labelled Preview.
  • OAuth is recommended; the API key option uses a service account key sent as an Authorization: Bearer header.
  • The user or service account needs the Cluster Admin, Cluster Operator or Cluster Data Accessor role.
  • Custom OAuth clients may need their redirect URL allowlisted by an Organization Admin.
  • Limits: one SQL statement per call, 20 second query timeout, 10 KiB responses, default LIMIT 25 rows (max 10,000), and no access to system, crdb_internal, pg_catalog, information_schema or pg_extension schemas.
  • Docs also give Cline config and a Cloud Console one-click install for Cursor and GitHub Copilot.

FAQ

What does the CockroachDB Cloud MCP server do?

Managed MCP server built into CockroachDB Cloud that lets AI tools list clusters, explore live schemas and run SQL against clusters in a CockroachDB Cloud organization. Connections can cover every cluster the user or service account can access, or be scoped to one cluster with an mcp-cluster-id header. The vendor documents 12 tools, including list_clusters, get_cluster, list_databases and list_tables.

How do I add the CockroachDB Cloud MCP server to Claude Code?

Run claude mcp add cockroachdb-cloud https://cockroachlabs.cloud/mcp --transport http, copied from CockroachDB's docs. This page also has snippets for Codex, Cursor and VS Code.

Does the CockroachDB Cloud MCP server need authentication?

Yes, OAuth or API key. Transport: Streamable HTTP. Status: GA, last checked October 17, 2026.

Sources

Last verified against 4 CockroachDB pages, then re-checked independently.

Newsletter

New MCP servers, the week they ship

One email per week. New official MCP servers, the coding tools that support them and how developers wire them up.