CockroachDB Cloud MCP. Audit nodes, network rules, and operations from chat.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
CockroachDB Cloud. Manage your distributed SQL infrastructure directly from any AI agent. You can list all clusters, check node health, audit network rules, and review management operations without opening the cloud console.
Get full visibility into your globally-scalable database setup and security metadata, all in natural conversation.
What your AI agents can do
Get cluster cloud details
Gets detailed information for a specific CockroachDB cluster.
Get my cockroach profile
Retrieves information about the authenticated user or organization.
List cluster nodes
Lists all nodes that belong to a specific cluster.
Retrieves specific details for a single CockroachDB cluster.
Retrieves a list of all CockroachDB Cloud clusters in your account.
Lists every node within a specified cluster to check its current health and status.
Provides a log of recent management operations, such as upgrades or scaling events, for a cluster.
Lists the network allowlist rules for a specific cluster to verify allowed connections.
Lists the Customer Managed Keys (CMKs) used to encrypt cluster data.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
CockroachDB Cloud MCP Server: 8 Tools for Distributed SQL
Use these tools to list clusters, audit nodes, check network rules, and manage metadata for your CockroachDB Cloud deployments.
019d7575get cluster cloud details
Gets detailed information for a specific CockroachDB cluster.
019d7575get my cockroach profile
Retrieves information about the authenticated user or organization.
019d7575list cluster nodes
Lists all nodes that belong to a specific cluster.
019d7575list cluster operations
Lists recent management operations, like scaling or upgrades, for a cluster.
019d7575list cockroach clusters
Lists every CockroachDB Cloud cluster in your account.
019d7575list encryption keys
Lists Customer Managed Keys (CMKs) used to encrypt a cluster.
019d7575list network allowlist
Lists the network allowlist rules for a specified cluster.
019d7575list supported cloud providers
Lists the cloud providers that CockroachDB Cloud supports.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with CockroachDB Cloud, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
CockroachDB Cloud MCP Server - Manage Distributed SQL
Need to manage your distributed SQL setup without opening the cloud console? Hook up your CockroachDB Cloud account to your AI agent. You can run diagnostics, check cluster status, and audit changes just by talking to it. It gives you full visibility into your globally-scalable database setup and security metadata, all through natural conversation.
Listing Clusters and Metadata
Use list_cockroach_clusters to pull a list of every CockroachDB Cloud cluster you own. For more detail on one cluster, run get_cluster_cloud_details to get its full information. You can also see which cloud providers CockroachDB Cloud supports using list_supported_cloud_providers. Getting your own account details is easy; run get_my_cockroach_profile to check your user or organization info.
Checking Infrastructure Health
To check a cluster's health, list_cluster_nodes lists all the nodes belonging to a specific cluster. You can audit changes with list_cluster_operations, which shows a log of recent management actions, like upgrades or scaling. You've got to keep it secure, so run list_network_allowlist to check the network rules for any cluster.
You can also review the encryption keys used by the cluster using list_encryption_keys to list all Customer Managed Keys (CMKs).
Deep Dive into Security and Operations
If you need to review the network allowlist rules for a specific cluster, you run list_network_allowlist. To see all the keys protecting your data, you'll use list_encryption_keys for the CMKs. To track what's been done to a cluster, list_cluster_operations shows recent management events like scaling or upgrades. You can get the full rundown on a single cluster with get_cluster_cloud_details.
How CockroachDB Cloud MCP Works
- 1 Subscribe to the server and provide your CockroachDB Cloud API Secret Key.
- 2 Ask your AI client a question like, 'What are my clusters?'
- 3 The agent runs the necessary tools and presents the requested data, like cluster names and regions, in plain text.
The bottom line is you manage complex, globally-distributed databases using simple natural language prompts.
Who Is CockroachDB Cloud MCP For?
The DevOps engineer who's tired of clicking through multiple cloud consoles to check a single cluster's health. The security admin who needs to confirm network access rules without logging into the web UI. If your job involves maintaining highly available, distributed data stores, this is for you.
Monitors cluster health and reviews operation history using natural language prompts instead of dashboard clicks.
Audits network allowlists and regional cluster distribution without needing to open the cloud provider's console.
Quickly looks up encryption key metadata and connectivity rules straight from their chat interface.
Verifies cloud provider availability and monitors cluster lifecycle events across different regions.
What Changes When You Connect
- See the full list of your clusters instantly. The
list_cockroach_clusterstool gives you a bird's-eye view of all your deployments, including their provider and region. - Confirm cluster health on the fly. Use
list_cluster_nodesto check every node's status without navigating through a dashboard. It's a quick status check. - Audit changes immediately.
list_cluster_operationsshows you exactly when scaling or upgrades happened and who triggered the action, keeping a clean record. - Verify network access instantly.
list_network_allowlistshows the rules for a cluster, letting you confirm if a specific IP range is allowed without messing with firewall rules. - Manage security visibility. You can use
list_encryption_keysto list CMKs, confirming which keys protect your cluster data right from your chat interface.
Real-World Use Cases
Debugging a Connection Timeout
A developer gets a connection timeout error. Instead of checking the firewall console, they ask their agent to run list_network_allowlist. If the agent finds missing rules, they know the issue is connectivity, not code. Then they run get_cluster_cloud_details to confirm the cluster's active region.
Pre-Scaling Audit
A platform engineer needs to prove the cluster is ready for a massive traffic spike. They first run list_cockroach_clusters to confirm the main cluster exists. Next, they use list_cluster_operations to check the history, making sure the last few scaling events completed successfully before proceeding.
Security Compliance Check
The security team needs to audit data protection. They run list_encryption_keys to get a list of all Customer Managed Keys (CMKs) and then use list_network_allowlist to verify that only necessary IPs are listed for compliance reporting.
Onboarding a New Team
A new DBA needs to get up to speed. They use the agent to run list_supported_cloud_providers to see which cloud platforms are supported. Then they run get_my_cockroach_profile to confirm their own user permissions before touching any live cluster.
The Tradeoffs
Looking up everything manually
Logging into the cloud provider console, finding the cluster, clicking 'Networking,' opening the allowlist tab, then copying the IPs into a spreadsheet. This takes 15 minutes and involves 6 different browser tabs.
→
Ask your agent to run list_network_allowlist and paste the results. It gets you the rules and IPs in seconds, keeping you in your chat window.
Assuming status is fine
Seeing the cluster green in the dashboard and assuming nothing has changed. You miss a recent upgrade failure or a regional node issue.
→
Run list_cluster_operations to check the full audit log. This shows you the history of every major change, even if the current status looks fine.
Missing key context
Trying to diagnose a data access problem by only checking the cluster details. You ignore the encryption layer entirely.
→
Always check the security layer first. Run list_encryption_keys to confirm the CMKs are active, then check connectivity with list_network_allowlist.
When It Fits, When It Doesn't
Use this server if your job requires auditing, monitoring, or managing the infrastructure of distributed SQL clusters across multiple cloud providers. You need to know the state of the nodes, the rules, and the history of changes. You're checking infrastructure, not optimizing queries. Don't use this if you're troubleshooting application code bugs or if you only need to view a single table's contents—those are database-specific tools. If you just need to know the list of supported cloud providers, running list_supported_cloud_providers is the quickest way to check that specific boundary.
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by CockroachDB Cloud. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 8 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Checking a cluster's health used to mean opening 5 different dashboards.
Today, checking a cluster's health means navigating to the cloud provider console, finding the cluster ID, then opening tabs for 'Nodes,' 'Networking,' and 'Operations.' You spend time clicking, copying IDs, and switching contexts just to get a basic status report.
With the CockroachDB Cloud MCP Server, you just ask your agent, 'What's the status of Production-Main?' It runs `list_cluster_nodes` and `list_cockroach_clusters` and gives you a clean, consolidated status report right in the chat. Done.
The CockroachDB Cloud MCP Server lets you run `list_network_allowlist` from chat.
Before, confirming if a specific IP range was allowed required you to manually navigate to the network security settings for that cluster, find the allowlist, and cross-reference the IPs. It was slow and error-prone.
Now, you ask your agent to check the network allowlist. The agent runs `list_network_allowlist` and instantly gives you the list of rules and ranges. You get the data without ever touching the cloud console.
Common Questions About CockroachDB Cloud MCP
How do I check if my cluster is in a supported region using `list_supported_cloud_providers`? +
You run list_supported_cloud_providers to get the list of available cloud platforms. This tells you the boundaries of what the service can manage. It doesn't check your current cluster's region, but it tells you what regions are even possible.
Does `list_cluster_nodes` show me the CPU usage of a node? +
The list_cluster_nodes tool shows the node's current status (e.g., RUNNING, OFFLINE) and basic health. It focuses on status and connectivity, not granular resource metrics like CPU usage.
What is the difference between `list_cluster_operations` and `get_cluster_cloud_details`? +
get_cluster_cloud_details gives a snapshot of the cluster's current metadata (like its name and region). list_cluster_operations gives you a timeline of changes that have happened to the cluster, like when it was last scaled or upgraded.
Can I use `list_encryption_keys` to find out why my data is inaccessible? +
The list_encryption_keys tool shows you the Customer Managed Keys (CMKs) that protect the data. If the keys are listed, it confirms the data is encrypted; if you suspect an issue, you'll need to check operational logs using list_cluster_operations.
How do I find all my clusters at once? Use `list_cockroach_clusters`. +
Running list_cockroach_clusters gives you an immediate list of every cluster in your account. This is the starting point for any audit, letting you select a target cluster to check next.
How do I check the network rules for a specific cluster using `list_network_allowlist`? +
It shows the exact rules configured for the cluster. This list includes names, IP ranges, and whether the rule is active. You get a complete view of who can connect to your database.
What information does `get_my_cockroach_profile` provide? +
It pulls details about the authenticated user and the organization. You can verify your user ID, account status, and organizational metadata directly through the agent.
If I need to find all my clusters, should I use `list_cockroach_clusters` or `get_cluster_cloud_details`? +
list_cockroach_clusters gives you a comprehensive list of all clusters. Use get_cluster_cloud_details when you already know the cluster name and need its specific metrics.
Can I see the status of all nodes in a cluster through the agent? +
Yes! Use the list_cluster_nodes tool with the unique cluster ID. The agent will return a list of all nodes, their IP addresses, and their current health/operational state.
How do I check for recent scaling or upgrade events on my database? +
Use the list_cluster_operations tool. Your agent will fetch the management log for the cluster, showing you recent tasks, their progress, and whether they were successful.
Where do I find my CockroachDB Cloud API Secret Key? +
Log in to the CockroachDB Cloud Console, navigate to Access Management, and select API Keys. You can generate and copy a new Secret Key from that section.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
Nmap Online
Perform network discovery and security auditing via Nmap — track port scans, DNS lookups, and traceroutes directly from your AI agent.
Tenable
Manage Tenable Vulnerability Management scans, inspect cloud assets, and triage CVEs natively via your AI agent.
Veracode
Bring Veracode AppSec to your AI. Analyze source code flaws, extract application profiles, and track vulnerabilities conversationaly.
You might also like
Efí Pay (Gerencianet)
Generate dynamic Pix charges, issue traditional bank slips (boletos), and check your account balance via Efí Pay.
Lorem Ipsum Generator
Generate deterministic placeholder text by words, sentences, or paragraphs. When an AI writes filler text, it varies wildly every time — this engine delivers consistent, predictable lorem ipsum.
ChangeDetection.io
Monitor website changes automatically — track visual or text updates, manage watches, and receive alerts via any AI agent.