KosmoKrator

data

CockroachDB MCP Integration for Claude Code

Connect CockroachDB to Claude Code through the local KosmoKrator MCP gateway with scoped tools, credentials, and write policy.

7 functions 6 read 1 write Bearer token auth

Connect CockroachDB to Claude Code

Connect local KosmoKrator integrations to Claude Code through one scoped MCP gateway entry.

Add KosmoKrator as a stdio MCP server in the Claude Code project config and select the integrations that should be visible. The gateway is local, scoped to this integration, and starts with --write=deny so Claude Code can inspect read-capable tools without receiving write access by default.

CockroachDB MCP Config for Claude Code

Claude Code can launch the local kosmo binary directly from the project MCP config.

{
  "mcpServers": {
    "kosmokrator-cockroachdb": {
      "type": "stdio",
      "command": "kosmo",
      "args": [
        "mcp:serve",
        "--integration=cockroachdb",
        "--write=deny"
      ]
    }
  }
}

Run the Gateway Manually

kosmokrator mcp:serve --integration=cockroachdb --write=deny

Why Use KosmoKrator Here

Scoped tools

Expose only CockroachDB instead of a broad multi-service tool list.

Local credentials

Reuse credentials already configured for the KosmoKrator CLI and Lua runtime.

Write policy

Start read-only, then opt into ask or allow for trusted workspaces.

CockroachDB Tools Visible to Claude Code

Claude Code sees stable MCP tool names generated from the CockroachDB integration catalog.

MCP toolSource functionTypeDescription
integration__cockroachdb__cockroachdb_list_clusters cockroachdb.cockroachdb_list_clusters Read List all CockroachDB clusters in the organization. Returns cluster IDs, names, status, cloud provider, and regions.
integration__cockroachdb__cockroachdb_get_cluster cockroachdb.cockroachdb_get_cluster Read Get details for a specific CockroachDB cluster by ID. Returns full cluster information including configuration, nodes, and connection strings.
integration__cockroachdb__cockroachdb_create_cluster cockroachdb.cockroachdb_create_cluster Write Create a new CockroachDB cluster. Requires a name, cloud provider, and region configuration.
integration__cockroachdb__cockroachdb_list_databases cockroachdb.cockroachdb_list_databases Read List all databases in a CockroachDB cluster. Returns database names, sizes, and table counts.
integration__cockroachdb__cockroachdb_get_database cockroachdb.cockroachdb_get_database Read Get details for a specific database in a CockroachDB cluster. Returns table list, sizes, and configuration.
integration__cockroachdb__cockroachdb_list_users cockroachdb.cockroachdb_list_users Read List all SQL users in a CockroachDB cluster. Returns usernames and privileges.
integration__cockroachdb__cockroachdb_get_current_user cockroachdb.cockroachdb_get_current_user Read Get information about the current authenticated CockroachDB Cloud user, including email, name, and organization role.

Related CockroachDB Pages