TiDB Cloud (Serverless Distributed SQL) Connector for AI agents.
4 live capabilities
Manage your distributed SQL infrastructure and cloud database resources from your workspace.
Waiting for input…
Why people use TiDB Cloud (Serverless Distributed SQL)
TiDB Cloud for Distributed SQL Infrastructure Management
This Connector puts that data directly into your AI client. Instead of hunting through a web UI, you just ask your agent to show you the projects or check the status of your TiDB X instances. You get a clean summary of your infrastructure without ever leaving your primary workspace.
What Vinkius changes
You get a direct voice command interface for your TiDB Cloud infrastructure.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
Finding Project IDs for New Environments
A developer needs to know which project ID to use for a new staging environment.
- Real-world use case 02
Verifying Production Instance Tiers
A DBA needs to verify if the Premium tier instances are active in the production project.
- Real-world use case 03
Auditing Cluster Topology for Reports
A DevOps engineer is writing a status report and needs to know how many dedicated clusters are active.
Complete set · 4capabilities
The complete TiDB Cloud (Serverless Distributed SQL) capability set.
These are the exact actions your AI can choose when you ask it to work with TiDB Cloud (Serverless Distributed SQL).
01—04
4 capabilities in this set.
Part of 4 available through TiDB Cloud (Serverless Distributed SQL).
- 01 Capability
Get project
Fetches specific details for a single project to help you verify IDs and metadata. Use this to grab the exact info needed for scripts.
- 02 Capability
List clusters
Lists Dedicated clusters in a project to give you a clear view of your high-performance database topology. It's great for quick audits.
- 03 Capability
List instances
Retrieves the TiDB X instances in a project to check which tiers are currently active. It provides a clear look at your running resources.
- 04 Capability
List projects
Shows the projects in your organization so you can see your entire portfolio at once. This helps you quickly find the right project ID for your current task.
Set up in minutes
One URL. Then ask TiDB Cloud (Serverless Distributed SQL) to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use TiDB Cloud (Serverless Distributed SQL) from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_sCYmPCgCjJyrcB49kPJ4COY6MnStt3VtJanpO1K0/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it TiDB Cloud (Serverless Distributed SQL), and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable TiDB Cloud (Serverless Distributed SQL) for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_sCYmPCgCjJyrcB49kPJ4COY6MnStt3VtJanpO1K0/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the TiDB Cloud (Serverless Distributed SQL) URL.
- Step 03
Save and start
Save the connection and enable TiDB Cloud (Serverless Distributed SQL) in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"tidb-cloud-serverless-distributed-sql": {
"url": "https://edge.vinkius.com/vk_preview_sCYmPCgCjJyrcB49kPJ4COY6MnStt3VtJanpO1K0/mcp"
}
}
} - Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using TiDB Cloud (Serverless Distributed SQL)
Open Agent mode in chat and ask: "Using TiDB Cloud (Serverless Distributed SQL), help me...". 4 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"tidb-cloud-serverless-distributed-sql": {
"url": "https://edge.vinkius.com/vk_preview_sCYmPCgCjJyrcB49kPJ4COY6MnStt3VtJanpO1K0/mcp"
}
}
} - Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using TiDB Cloud (Serverless Distributed SQL)
Ask Copilot: "Using TiDB Cloud (Serverless Distributed SQL), help me...". 4 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"tidb-cloud-serverless-distributed-sql": {
"url": "https://edge.vinkius.com/vk_preview_sCYmPCgCjJyrcB49kPJ4COY6MnStt3VtJanpO1K0/mcp"
}
}
} - Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using TiDB Cloud (Serverless Distributed SQL)
Open Cascade and ask: "Using TiDB Cloud (Serverless Distributed SQL), help me...". 4 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"tidb-cloud-serverless-distributed-sql": {
"url": "https://edge.vinkius.com/vk_preview_sCYmPCgCjJyrcB49kPJ4COY6MnStt3VtJanpO1K0/mcp"
}
}
} - Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using TiDB Cloud (Serverless Distributed SQL)
Ask Cline: "Using TiDB Cloud (Serverless Distributed SQL), help me...". 4 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add tidb-cloud-serverless-distributed-sql --transport http "https://edge.vinkius.com/vk_preview_sCYmPCgCjJyrcB49kPJ4COY6MnStt3VtJanpO1K0/mcp" - Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using TiDB Cloud (Serverless Distributed SQL)
Ask Claude: "Using TiDB Cloud (Serverless Distributed SQL), show me...". 4 tools are ready
Where the request belongs
Work TiDB Cloud can move forward.
This is for the database engineer who's tired of tab-switching between their IDE and the cloud console to check instance statuses. It's for the DevOps person who needs to audit resource distribution across multiple projects quickly.
Database Administrator
Audits cluster distributions and project structures during maintenance windows without manual navigation.
Backend Engineer
Verifies instance availability and project IDs directly from the coding environment to ensure environment parity.
DevOps Engineer
Automates the discovery of cloud resources for documentation or status reporting across the organization.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsOceanBase
Enterprise distributed relational database. manage clusters, tenants, and databases via AI.
Nile (PostgreSQL for Multi-Tenant Apps)
Manage tenant-aware databases via Nile. provision B2B tenants, monitor DB metrics, and audit user access.
CockroachDB Cloud
Manage distributed SQL clusters via CockroachDB Cloud. track clusters, monitor nodes, and audit network allowlists directly from any AI agent.
PlanetScale
Provision, branch, and manage serverless MySQL databases dynamically via AI.
Aiven
Manage Aiven cloud infrastructure. provision databases, manage projects, and monitor services directly from your AI agent.
Tencent CloudBase / 腾讯云开发 TCB
China's dominant serverless platform. orchestrate cloud functions, databases, and storage via AI.
Bring your own AI
Change the model, client or framework. Keep TiDB Cloud connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about TiDB Cloud.
The practical details behind the request, access and result.
Can the TiDB Cloud MCP run SQL queries?
No, this Connector is for infrastructure management. You can't run queries, but you can see your projects and instances.
Does the TiDB Cloud MCP work with Cursor?
Yes, you can connect it to Cursor to check your database clusters and project IDs while you code.
How do I use the TiDB Cloud MCP to see my instances?
Just ask your agent to list instances in a specific project, and it will show you the tiers and statuses.
Can the TiDB Cloud MCP help with project IDs?
Yes, it can fetch specific project details so you don't have to hunt for them in the web console.
Is the TiDB Cloud MCP for distributed SQL?
Yes, it works with TiDB Cloud distributed SQL and helps you monitor your resource allocation.
Do I need my API keys for the TiDB Cloud MCP?
You'll need your Public and Private API keys from your TiDB Cloud account to connect the Connector to your agent.
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.
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.
Does this capability allow me to delete or create new clusters?
No. The current version of the TiDB Cloud Connector is focused on discovery and inspection (read-only operations) such as list_projects, get_project, and list_clusters to ensure safe infrastructure monitoring.
One connection away
Give your agent a direct line to TiDB Cloud.
Connect TiDB Cloud once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available