# TiDB Cloud MCP for AI Agents AI Agent Connect

> TiDB Cloud MCP lets you manage your distributed SQL infrastructure through your AI agent. You can list projects, check instance tiers, and inspect dedicated clusters without leaving your workspace. It connects your TiDB Cloud account to any MCP-compatible client to handle cloud resource discovery and metadata fetching for your database environment.

## Overview
- **Category:** databases
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_sCYmPCgCjJyrcB49kPJ4COY6MnStt3VtJanpO1K0/ai-agent-connect
- **Tags:** tidb, distributed-sql, serverless-database, cloud-database, database-management

## Description

Managing distributed SQL infrastructure usually feels like a chore of clicking through nested menus in a cloud console. You have to keep track of project IDs, verify which instances are actually running in specific regions, and cross-reference cluster types across different environments. This Connector changes that by letting your AI agent do the heavy lifting. Instead of hunting for information, you just ask your agent to show you what's live. It pulls the project metadata and instance details directly from your TiDB Cloud account so you can stay focused on the actual database architecture. When you need to audit your resource allocation or verify a specific project's setup, you just talk to your agent. It's a much faster way to get a pulse on your cloud environment, and it fits right into the workflow you're already using. You can find this in the Vinkius catalog, which lets you connect once to your favorite AI client and access a huge range of tools in one place. This means you can stop worrying about which console you need to be in or which specific ID you need to copy into your terminal. You get a direct line to your cloud resources, making it way easier to keep your infrastructure organized and visible while you're actually doing the work.

## Tools

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

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

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

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

## Prompt Examples

**Prompt:** 
```
List all my projects.
```

**Response:** 
```
I've retrieved your projects. You have 3 active projects:

| Project Name | ID | Status |
| :--- | :--- | :--- |
| Production-DB | 101 | Active |
| Staging-Env | 102 | Active |
| Analytics-Data | 103 | Active |

Which one would you like to inspect?
```

**Prompt:** 
```
Show me all TiDB X instances in project 101.
```

**Response:** 
```
In project 101, I found 2 instances:

* **Serverless Starter**: Located in us-east-1 (Running)
* **Premium**: Located in eu-west-1 (Running)

Both instances are currently healthy.
```

**Prompt:** 
```
Get the details for dedicated clusters in project 103.
```

**Response:** 
```
Checking dedicated clusters for project 103... 

I found one Dedicated cluster:
* **Name**: Analytics-Main
* **Nodes**: 3 TiKV nodes, 2 TiDB nodes
* **Status**: Healthy and active.
```

## Capabilities

### List organizational projects
Get a complete list of all projects in your account to see your full portfolio.

### Fetch project details
Pull specific metadata and IDs for a single project to use in your automation.

### View TiDB X instances
See every active instance in a project to check which tiers are currently running.

### Inspect dedicated clusters
Get a clear view of your high-performance database topology and cluster health.

### Retrieve cloud metadata
Fetch the specific details needed for deeper infrastructure monitoring and reporting.

## Use Cases

### Finding Project IDs for New Environments
A developer needs to know which project ID to use for a new staging environment. They ask the agent to list the projects, and it returns the IDs instantly.

### Verifying Production Instance Tiers
A DBA needs to verify if the Premium tier instances are active in the production project. The agent uses list_instances to confirm the status of the TiDB X instances.

### Auditing Cluster Topology for Reports
A DevOps engineer is writing a status report and needs to know how many dedicated clusters are active. The agent calls list_clusters to provide a count and overview of the topology.

### Fetching Metadata for Migration Scripts
An engineer needs to verify the specific metadata of a project for a migration script. They ask the agent to get the details for that specific project ID.

## Benefits

- Stop tab-switching between your IDE and the TiDB Cloud console by using list_projects to see everything in one place.
- Speed up environment setup by using get_project to quickly grab the IDs you need for automation scripts.
- Get an instant pulse on your production environment by using list_instances to check which tiers are running.
- Audit your high-performance database topology in seconds with list_clusters instead of manual navigation.
- Reduce human error during resource discovery by letting your agent fetch accurate project metadata directly from the source.

## How It Works

The bottom line is you get a direct voice command interface for your TiDB Cloud infrastructure.

1. Subscribe to this Connector on Vinkius.
2. Enter your TiDB Cloud Public and Private API Keys.
3. Ask your AI client to list projects or check your cluster status.

## Frequently Asked Questions

**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` 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 Connector is focused on discovery and inspection (read-only operations) such as `list_projects`, `get_project`, and `list_clusters` to ensure safe infrastructure monitoring.