• LOGS
  • AUDIT
  • SUMMARY
  • HUMAN

How to track cluster operations with your AI

Connect CockroachDB Cloud to your AI client once. After that, you can query your cluster's history without opening the console.

Ask AI about this page

Short answer

How can I see my CockroachDB Cloud cluster history?

Your AI uses the list_cluster_operations tool to pull a log of recent scaling and upgrade events. You get a clear timeline of what changed and when. This breakdown shows you how to pull those logs.

The outcomes

What you get from your AI

The AI handles the data retrieval so you can focus on the impact of changes.

LOGS

Operation history

The AI pulls a list of recent events from your clusters. You see exactly which scaling or upgrade actions occurred.

AUDIT

Change tracking

Identify when a cluster was resized or upgraded. This helps you correlate performance shifts with specific cluster changes.

SUMMARY

Event timelines

The AI organizes raw operation data into a readable sequence. You get a chronological view of your cluster's lifecycle.

HUMAN

Manual intervention

The AI only reads operation history. You still need to log into the CockroachDB Cloud console to trigger new scaling events or manual upgrades.

The workflow

What your AI does when the request arrives.

The AI acts as a bridge between your chat interface and your database infrastructure.

  1. Fetch operation logs

    The AI reaches into your CockroachDB Cloud account to find recent activity.

    list_cluster_operations

  2. Filter events

    It narrows down the list to find specific scaling or upgrade actions you asked about.

    list_cluster_operations

  3. Organize data

    The AI sorts the retrieved operations into a logical order for your review.

    list_cluster_operations

  4. Report findings

    The AI presents the final list of cluster changes directly in your chat window.

    list_cluster_operations

Try it

Copy these to start.

Use these prompts to get moving immediately.

Starting points

Swap out the cluster names or timeframes to match your specific setup.

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

  • List the recent cluster operations for my production cluster.

  • Show me all scaling events that happened in the last 24 hours.

  • Did any clusters undergo an upgrade recently?

  • Summarize the most recent cluster operations for my dev environment.

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

Start here

Connect CockroachDB Cloud once, then ask.

Follow the link to connect your account. Your credentials stay encrypted, and you can start chatting with your cluster data immediately.

Connect CockroachDB Cloud to your AI

FAQ

How this task behaves

  • 01

    Can my AI trigger a cluster upgrade?

    No. The AI can only list existing operations; it cannot execute new scaling or upgrade commands.

  • 02

    Can the AI delete my clusters?

    No. This MCP only provides read access to operation history.

  • 03

    How far back can the AI see?

    The AI can see whatever history is returned by the list_cluster_operations tool.

  • 04

    Do I need to keep the CockroachDB console open?

    No. Once connected, you can perform these checks entirely within your AI client.

  • 05

    Can the AI change my cluster size?

    No. The AI can report that a size change happened, but it cannot perform the change itself.

  • More questions about CockroachDB Cloud? The Connector page answers them. See everything the CockroachDB Cloud Connector can do

Connect CockroachDB Cloud to Claude, Cursor, ChatGPT & more