TiDB Cloud (Serverless Distributed SQL)

TiDB Cloud (Serverless Distributed SQL) MCP Connector for Claude

F

Manage TiDB Cloud infrastructure — list projects, inspect clusters, and monitor serverless instances directly from your AI agent.

4 tools Official Updated Jun 28, 2026 Official Vinkius Partner

Connect your TiDB Cloud account to any AI agent and manage your distributed SQL infrastructure through natural conversation.

What you can do

  • Project Overview — List all organizational projects and fetch metadata for specific environments to understand your resource allocation.
  • Instance Management — Retrieve all TiDB X instances (including Starter, Essential, and Premium tiers) housed within your projects.
  • Dedicated Clusters — List and inspect Dedicated clusters to get a clear view of your high-performance database topology.
  • Deep Metadata Access — Fetch specific project details and IDs required for deeper infrastructure automation and monitoring.

How it works

  1. Subscribe to this server
  2. Enter your TiDB Cloud Public and Private API Keys
  3. Start managing your distributed databases from Claude, Cursor, or any MCP-compatible client

Who is this for?

  • Database Administrators — quickly audit cluster distributions and project structures without navigating the web console.
  • Backend Engineers — verify instance availability and project IDs directly from the coding environment.
  • DevOps Teams — automate the discovery of cloud resources for documentation or status reporting.
tidbdistributed-sqlserverless-databasecloud-databasedatabase-management

4 tools expose this connector's capabilities to your AI agent.

get_project

Retrieve details for a specific project

list_clusters

Retrieve all Dedicated clusters within a project

list_instances

Retrieve all TiDB X instances within a project

list_projects

List all accessible projects in your organization

See how to talk to your AI agent using TiDB Cloud (Serverless Distributed SQL).

List all my TiDB Cloud projects.

I've retrieved your projects. You have 3 active projects: 'Production-DB' (ID: 101), 'Staging-Env' (ID: 102), and 'Analytics-Data' (ID: 103). Which one would you like to inspect?

Show me all TiDB X instances in project 101.

In project 101, I found 2 instances: a 'Serverless Starter' instance in us-east-1 and a 'Premium' instance in eu-west-1. Both are currently running.

Get the details for dedicated clusters in project 103.

Checking dedicated clusters for project 103... I found one Dedicated cluster named 'Analytics-Main' with 3 TiKV nodes and 2 TiDB nodes. It is healthy and active.

Yes. Use `list_instances` to see TiDB X instances (Serverless/Starter/Premium) and `list_clusters` to view your Dedicated cluster infrastructure.

Related Connectors