# TiDB Cloud — how to use (mcp.ai)

Connect your TiDB Cloud account and use 10 tools for databases straight from your AI agent. Connect with your own API key. Manage TiDB Cloud Starter, Essential, Dedicated, IAM, billing, and Data Service control-plane resources.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_tidb_cloud?ms=1787291280000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `tidb_cloud_get_cluster`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/tidb_cloud`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/tidb_cloud/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/tidb_cloud/get/cluster` — Get details for one Starter/Essential instance or Dedicated cluster by ID.
  - body: { view?: string, cluster_id: string, service_tier: string }
- `POST https://api.mcp.ai/api/tidb_cloud/get/monthly/bill` — Return the TiDB Cloud organization bill for one calendar month.
  - body: { billed_month: string }
- `POST https://api.mcp.ai/api/tidb_cloud/list/audit/logs` — Search TiDB Cloud organization audit logs by time range, event type, or keyword and return one page of results.
  - body: { keyword?: string, end_time?: string, page_size?: integer, start_time?: string, next_cursor?: string, audit_event_types?: string }
- `POST https://api.mcp.ai/api/tidb_cloud/list/branches` — List database branches for a TiDB Cloud Starter or Essential instance. Returns one page and a continuation cursor.
  - body: { page_size?: integer, cluster_id: string, next_cursor?: string }
- `POST https://api.mcp.ai/api/tidb_cloud/list/clusters` — List TiDB Cloud Starter/Essential instances or Dedicated clusters, with product-specific filters. Returns one page and a continuation cursor.
  - body: { skip?: integer, filter?: string, page_size?: integer, project_id?: string, region_ids?: string[], cluster_ids?: string[], next_cursor?: string, service_tier: string, cluster_states?: string[] }
- `POST https://api.mcp.ai/api/tidb_cloud/list/data/app/deployments` — List one page of deployments and deployment status for a TiDB Cloud Data Service application, plus a continuation cursor.
  - body: { page_size?: integer, data_app_id: string, next_cursor?: string }
- `POST https://api.mcp.ai/api/tidb_cloud/list/data/apps` — List TiDB Cloud Data Service applications in a project, returning one page and a continuation cursor.
  - body: { page_size?: integer, project_id: string, next_cursor?: string }
- `POST https://api.mcp.ai/api/tidb_cloud/list/import/tasks` — List one page of import tasks for a TiDB Cloud Starter/Essential instance or Dedicated cluster, including status, progress, source, timestamps, errors, and a continuation cursor.
  - body: { order_by?: string, page_size?: integer, cluster_id: string, next_cursor?: string, service_tier: string }
- `POST https://api.mcp.ai/api/tidb_cloud/list/organization/members` — List one page of TiDB Cloud organization members with optional identity, assignment, role, and status filters, plus a continuation cursor.
  - body: { email?: string, roles?: string[], order_by?: string, statuses?: string[], page_size?: integer, project_id?: string, instance_id?: string, next_cursor?: string }
- `POST https://api.mcp.ai/api/tidb_cloud/list/regions` — List regions available for Starter/Essential or Dedicated clusters, optionally filtering Dedicated regions. Returns one page and a continuation cursor.
  - body: { skip?: integer, page_size?: integer, project_id?: string, next_cursor?: string, service_tier: string, cloud_provider?: string }

## Example prompts
- "What can I do in TiDB Cloud?"
- "Show me a summary of my TiDB Cloud account"

## More
- Page: https://mcp.ai/tidb_cloud
- Agent spec (llms.txt): https://mcp.ai/tidb_cloud/llms.txt
- Postman collection: https://mcp.ai/tidb_cloud/postman.json