Download PDFMarkdown Version
ClaudeChatGPTPerplexityGeminiMicrosoft CopilotRaycastMeta AIGrokZ.aiQwenKimi
DeepSeekMistralCursorVS CodeWindsurfJetBrainsClineLovableVercel AI SDKLangChain

Use TiDB Cloud with your AI.

Connect your account once and let the AI you already use work with it, without building another integration. Manage TiDB Cloud infrastructure. list projects, inspect clusters, and monitor serverless instances directly from your AI agent.

Included with plan

Ask AI about this Connector

Developed, maintained, and hosted by Vinkius.

MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED

Waiting for input…

Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.

ChatGPTClaudeCursorPerplexityGeminiMicrosoft CopilotRaycastMeta AI

Complete set · 4 capabilities

The complete TiDB Cloud capability set.

These are the exact actions your AI can choose when you ask it to work with TiDB Cloud.

Capability set01 / 01

01-04

4 capabilities in this set.

Part of 4 available through TiDB Cloud.

  1. 01

    List instances

    Retrieve all TiDB X instances within a project

  2. 02

    List projects

    List all accessible projects in your organization

  3. 03

    Get project

    Retrieve details for a specific project

  4. 04

    List clusters

    Retrieve all Dedicated clusters within a project

Observed, not estimated

844ms average. Fast in production.

TiDB Cloud is checked daily against the live service.

Daily averagePeak 1009ms
Aug 20Today
Fastest day
678ms
Slowest day
1009ms
14-day trend
Slowing+10%

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 4 capabilities arrive ready to run.

Preview access · not provider authentication

The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of TiDB Cloud, so you can see the experience inside your AI.

It does not authenticate your account with TiDB Cloud. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.

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"
    }
  }
}
  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Step-by-step instructions for each client are in the guide. How to connect

FAQ

Questions TiDB Cloud owners ask.

  • 01

    Can I see both serverless and dedicated clusters with this server?

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

  • 02

    How do I get the ID of a specific project to query its instances?

    You can run the list_projects capability first. It will return a list of all accessible projects along with their unique IDs, which you can then use in list_instances or list_clusters.

  • 03

    Does this capability allow me to delete or create new clusters?

    No. The current version of the TiDB Cloud MCP server is focused on discovery and inspection (read-only operations) such as list_projects, get_project, and list_clusters to ensure safe infrastructure monitoring.

Explore

More in Databases

Suggestions