• STATUS
  • NODES
  • DETAILS
  • HUMAN

How to monitor cluster health with your AI

Connect CockroachDB Cloud once. After that, your agent handles the heavy lifting of checking node status and cluster health on demand.

Ask AI about this page

Short answer

How do I check my CockroachDB cluster health with AI?

Your agent uses the CockroachDB Cloud MCP to pull live data on individual nodes and overall cluster status. You get immediate answers without digging through the cloud console. Here is how it works.

The outcomes.

Where your data lands.

The AI translates raw cloud data into clear answers for you.

STATUS

Cluster health checks

The AI checks the overall state of your environment. You get a clear view of whether the cluster is healthy.

NODES

Node-level visibility

The AI looks at every node in the cluster. You'll see exactly which nodes are active or failing.

DETAILS

Cloud configuration

The AI pulls specific cloud details for your cluster. This gives you the context needed to understand your setup.

HUMAN

Manual intervention

The AI flags the issues it finds. You still have to log in to the CockroachDB console to fix any problems.

The workflow

What your AI does when the request arrives.

Your agent acts as a direct interface to your CockroachDB Cloud environment.

  1. Fetch cloud info

    The AI pulls the current cloud configuration for your cluster to establish context.

    get_cluster_cloud_details

  2. List all nodes

    The AI retrieves a full list of nodes to see what's running in your cluster.

    list_cluster_nodes

  3. Identify issues

    The AI compares node status against the cluster details to find any unhealthy components.

    list_cluster_nodesget_cluster_cloud_details

  4. Summarize health

    The AI presents a plain English summary of the cluster's current state.

    list_cluster_nodes

Try it

Copy these to start.

Paste these into your chat to begin.

Starting points

These are starting points. Replace the cluster names with your actual CockroachDB Cloud identifiers.

CockroachDB Cloud Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_lXJMfvTxkQ8roFLANT9KKH5ZXboI6KmNc6teoSqs/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — CockroachDB Cloud capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "cockroachdb-cloud-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_lXJMfvTxkQ8roFLANT9KKH5ZXboI6KmNc6teoSqs/mcp"
    }
  }
}
Copy into chat04

  • What is the health status of my production-cluster?

  • List all nodes in my dev-cluster and tell me if any are down.

  • Show me the cloud details for my main-cluster.

  • Are any nodes currently failing in my cluster-alpha?

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect CockroachDB Cloud once, then ask.

Connect your account via the link below. Your credentials stay encrypted on our side, and you can start using the tools immediately in your preferred client.

Connect CockroachDB Cloud to your AI

FAQ

How this task behaves.

  • 01

    Can the AI fix my cluster?

    No. The AI can only read status and details. It cannot change settings or fix nodes.

  • 02

    Can the AI see my database tables?

    No. The tools only access cluster and node metadata, not the data inside your tables.

  • 03

    Does the AI need my login password?

    No. You connect through Vinkius, which manages the connection securely. Your agent never sees your raw credentials.

  • 04

    Can I use this with Cursor or Claude?

    Yes. Any MCP-compatible client works once you've connected the MCP.

  • 05

    Is the health data real-time?

    Yes. The AI pulls fresh data from the cloud API every time you ask a question.

  • More questions about CockroachDB Cloud? See everything the CockroachDB Cloud Connector can do

Connect CockroachDB Cloud to Claude, Cursor, ChatGPT & more