Vinkius
TiDB Cloud

TiDB Cloud MCP for AI. Inventory projects, clusters, and instances instantly.

Claude Claude
ChatGPT ChatGPT
Cursor Cursor
Gemini Gemini
Windsurf Windsurf
VS Code VS Code
JetBrains JetBrains
Vercel Vercel
See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

TiDB Cloud (Serverless Distributed SQL) MCP on Cursor AI Code EditorTiDB Cloud (Serverless Distributed SQL) MCP on Claude Desktop AppTiDB Cloud (Serverless Distributed SQL) MCP on OpenAI Agents SDKTiDB Cloud (Serverless Distributed SQL) MCP on Visual Studio CodeTiDB Cloud (Serverless Distributed SQL) MCP on GitHub Copilot AI AgentTiDB Cloud (Serverless Distributed SQL) MCP on Google Gemini AITiDB Cloud (Serverless Distributed SQL) MCP on Lovable AI DevelopmentTiDB Cloud (Serverless Distributed SQL) MCP on Mistral AI AgentsTiDB Cloud (Serverless Distributed SQL) MCP on Amazon AWS Bedrock

How this MCP server connects to your AI agent

TiDB Cloud (Serverless Distributed SQL) MCP Server lets you manage your entire database infrastructure through chat. You can list every project, check specific cluster details, and pull a full inventory of all TiDB X instances across different tiers—all without opening the web console.

What AI agents can do with TiDB Cloud (Serverless Distributed SQL) Automation

Get project

Retrieves detailed information for a single specified project.

List clusters

Gets a list of all dedicated database clusters within a specific project.

List instances

Pulls an inventory of all TiDB X instances running inside your projects.

+ 1 more capabilities included
List all organizational projects

Retrieves a full list of every accessible project within your TiDB Cloud organization.

Get specific project details

Fetches detailed metadata and IDs for one specified project using its name or ID.

List all database instances

Retrieves a complete inventory of every TiDB X instance (Starter, Essential, Premium) housed across your projects.

Inspect dedicated clusters

Lists and provides details on dedicated cluster topologies for high-performance database inspection.

Included with Plan

Waiting for input…

AI Agent

What AI agents can do with TiDB Cloud (Serverless Distributed SQL) MCP Server: 4 Tools for DB Ops

These four tools let your AI client manage resource scoping by listing projects, getting details, cataloging instances, and inspecting dedicated clusters.

Make your AI actually useful.

Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.

Start using TiDB Cloud (Serverless Distributed SQL) on Vinkius

Get Project

Retrieves detailed information for a single specified project.

List Clusters

Gets a list of all dedicated database clusters within a specific project.

List Instances

Pulls an inventory of all TiDB X instances running inside your projects.

List Projects

Returns a list of every project accessible in your entire organization.

Security and governance baked right in.

Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.

Claude AI

Claude AI

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.

2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL:

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.

3

Start a conversation

Open a new chat. The TiDB Cloud integration is available immediately — no restart needed.

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
Start building

Make Your AI Do More

Start with TiDB Cloud (Serverless Distributed SQL), then connect any of our 5,100+ other servers whenever your AI needs more. One click, no limits.

  • Use this MCP plus 5,100+ 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
TiDB Cloud MCP server cover

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by TiDB 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

Your data is protected. See how we built it.

Built on the Model Context Protocol (MCP) for 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 connection provides 4 powerful capabilities that interface natively with Claude, ChatGPT, Cursor, and other compatible AI platforms. No middleware. No custom integration required.

Trying to inventory a cloud database feels like clicking through three different tabs., Solved with Vinkius AI Gateway

Today, checking your environment is tedious. You open the dashboard, click 'Projects' just to get a list of IDs. Then you have to switch tabs for 'Instances,' and then maybe into another section for 'Dedicated Clusters.' It’s a multi-step process that forces context switching and copy-pasting.

With this MCP Server, those steps vanish. You tell your agent what you need—say, 'List all projects and their instances.' The tool handles the full workflow behind the scenes, giving you structured data right in your chat window. It's instant resource mapping.

TiDB Cloud (Serverless Distributed SQL) MCP Server: Get project metadata instantly.

Manual auditing requires jumping between the Project view, the Instance list, and the Cluster details. You waste time verifying if a resource exists before you can even start your analysis.

Now, use `get_project` or `list_projects`. Your agent pulls that metadata directly to your client. The data is where it needs to be: right here.

What your AI can actually do with this

You don't gotta open up a console or click through ten different dashboards to manage your TiDB Cloud setup anymore. Just connect your AI client, and your agent handles all the dirty work of talking directly to your database infrastructure. This server gives you command-line access to everything running in your organization.

If you need an overview, start by getting a full map of where your resources live. You can run list_projects to see every single project accessible across your entire TiDB Cloud account. That's your master list. Once you know which environment you’re dealing with, you use get_project to pull the detailed metadata and specific IDs for any one project by its name or ID.

This gives you a deep dive into that environment’s setup without leaving the chat window.

When it comes to your actual data stores, checking inventory is simple but crucial. Running list_instances pulls up a complete count of every TiDB X instance—you're talking Starter, Essential, and Premium tiers—that you've got running inside all those projects. This single call gives you the full scope of what’s active right now.

You won't miss a thing.

For performance-critical stuff, you need to inspect the cluster topology. You use list_clusters to get a list and details on dedicated database clusters within a specific project. These are your high-performance setups; this tool lets you check their status and structure quickly for auditing or planning upgrades. It's key for understanding how your core data is actually laid out.

The whole point here is that you bypass the UI friction. Instead of clicking through menus, your agent uses these tools to extract precise information: it gets the project names needed for scripting, pulls specific resource counts from list_instances, or maps out the physical structure using list_clusters. It streamlines checking whether a particular instance needs patching or if a whole project's metadata is up-to-date.

You simply tell your agent what you need to know—like "Show me all Premium instances in Project Alpha"—and it runs the necessary sequence of calls and spits out the actionable data right here. You’ll save yourself hours of clicking around in the web console just managing IDs, checking resource allocation across multiple environments, or confirming that every single required cluster is online and healthy.

Built · Hosted · Managed by Vinkius TiDB Cloud - Manage Distributed SQL Projects & Clusters
Server ID 019e5d60-aee9-73c7-b222-0c40f1513e50
Vinkius Inspector
Compliance Grade F
Score 3.6/100
Vinkius Inspector Badge — Score 3.6/100

Questions you might have

How do I list all the projects using the get_project tool? +

You don't use get_project to list everything; that tool requires a specific ID. To see all available scopes, you must run list_projects. That function gives you the full organizational overview first.

Can I find out every single running instance with list_instances? +

Yes, list_instances pulls a complete inventory of all TiDB X instances—regardless of whether they're Starter or Premium. It gives you the full picture in one call.

What is the difference between list_clusters and list_instances? +

They track different things. list_instances handles individual database nodes (the X instances). list_clusters focuses specifically on grouping those resources into a high-performance Dedicated cluster topology.

Does this MCP Server help me check project details? +

Absolutely. Use the get_project tool and provide the specific Project ID you need. It retrieves all relevant metadata for that single, specified environment.

What credentials do I need to use the list_projects tool? +

You must provide both your TiDB Cloud Public and Private API Keys when setting up the server. These keys allow your AI agent to authenticate against your account, ensuring you only see resources you have access to.

If I run list_clusters for a project, but no dedicated clusters exist, what response should I expect? +

The tool returns a specific, non-error message stating that zero clusters were found. This clear output allows your agent to proceed with other tasks without assuming failure.

When using list_instances, can I filter the results by database tier (e.g., Premium)? +

Yes, you pass a scope parameter to refine instance retrieval. This allows you to pull data only for specific tiers—like Starter or Essential—without processing unrelated records.

Are there any rate limits when calling list_projects? +

The server adheres strictly to TiDB Cloud’s API rate limits. If you exceed the allowed number of calls, your agent will receive a standard 429 error code until your usage window resets.

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 tool 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 tool 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.

Built & Managed by Vinkius 30s setup 4 tools

We've already built the connector for TiDB Cloud. Just plug in your AI agents and start using Vinkius.

No hosting. No infrastructure. No complex setup.
All 4 tools are live and waiting. You're up and running in seconds.

Vinkius runs on Claude Claude
Vinkius runs on ChatGPT ChatGPT
Vinkius runs on Cursor Cursor
Vinkius runs on Gemini Gemini
Vinkius runs on Windsurf Windsurf
Vinkius runs on VS Code VS Code
Vinkius runs on JetBrains JetBrains
Vinkius runs on Vercel Vercel
+ other MCP clients

Vinkius gives your AI agents access to the full catalog of app connectors, all fully managed, secure, and enterprise-ready. One subscription, every tool you need.

Zero hosting required Full MCP catalog included Enterprise-grade security Auto-updated by Vinkius

Built, hosted, and secured by Vinkius. You just connect and go.