• DATA
  • AUDIT
  • REPORT
  • HUMAN

How to inspect TiDB Cloud cluster topology with your AI

Connect your AI client to TiDB Cloud once. From then on, you can query your cluster configurations through a chat interface.

Ask AI about this page

Short answer

How can I check my TiDB Cloud cluster setup via chat?

Your AI uses the list_clusters tool to pull configuration data from your TiDB Cloud account. You'll get specific details on node setups and cluster topology without opening the TiDB console. This breakdown shows you how it works.

The outcomes

What you get from your AI

The AI acts as a direct interface for your cloud infrastructure data.

DATA

Live cluster details

The AI pulls current configuration data from your Dedicated clusters. You get the exact node setup and topology you asked for.

AUDIT

Configuration checks

Verify that your cluster settings match your requirements. Your AI compares what is actually running against your specific questions.

REPORT

Summary of nodes

Get a clean breakdown of your cluster's architecture. The AI organizes the raw data into a readable format for you.

HUMAN

Manual adjustments

The AI can read your topology but cannot change it. You still handle all scaling or configuration changes in the TiDB Cloud console.

The workflow

What your AI does when the request arrives.

The AI bridges the gap between your chat window and the TiDB Cloud API.

  1. Fetch cluster data

    The AI reaches out to your TiDB Cloud account to find all active clusters.

    list_clusters

  2. Parse topology

    It looks through the returned data to find the specific node and configuration details you requested.

    list_clusters

  3. Filter specifics

    The AI narrows down the list to only show the Dedicated clusters or specific nodes you're asking about.

    list_clusters

  4. Present findings

    The agent translates the technical JSON response into a plain English explanation of your cluster setup.

    list_clusters

Try it

Copy these to start.

Use these prompts to begin inspecting your clusters.

Starting points

These are just starting points. Swap out the cluster names or specific configuration types to match your actual environment.

TiDB Cloud Connector

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

Connector linkhttps://edge.vinkius.com/vk_preview_sCYmPCgCjJyrcB49kPJ4COY6MnStt3VtJanpO1K0/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 — TiDB Cloud capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "tidb-cloud-serverless-distributed-sql-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_sCYmPCgCjJyrcB49kPJ4COY6MnStt3VtJanpO1K0/mcp"
    }
  }
}
Copy into chat04

  • List all my TiDB Cloud clusters so I can see what's running.

  • Show me the topology for my 'production-db' Dedicated cluster.

  • What is the current node setup for my largest cluster?

  • Check the configuration of my clusters and tell me if any are Serverless.

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

Start here

Connect TiDB Cloud once, then ask.

Follow the link to connect your account. Your credentials stay encrypted, and you can immediately start chatting with your clusters in your preferred AI client.

Connect TiDB Cloud to your AI

FAQ

How this task behaves

  • 01

    Can my AI change my cluster settings?

    No. The AI can only read data using the list_clusters tool. It cannot modify, delete, or scale your clusters.

  • 02

    Does the AI see my actual database data?

    No. The AI only sees the cluster metadata and topology. It does not have access to the rows or tables inside your databases.

  • 03

    Can I use this with Claude or Cursor?

    Yes. Any MCP-compatible client like Claude, Cursor, or Windsurf can use this once you connect it.

  • 04

    How often does the AI see updates to my cluster?

    The AI sees the data at the moment you ask the question. It does not provide a continuous live stream of changes unless you ask again.

  • 05

    What happens if I have hundreds of clusters?

    The AI will use the list_clusters tool to pull the full list, but it is most efficient when you ask about specific cluster names.

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

Connect TiDB Cloud to Claude, Cursor, ChatGPT & more