# TiDB Cloud — MCP server on 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.

By: mcp.ai · official
Page: https://mcp.ai/tidb_cloud

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_tidb_cloud?ms=1787291340000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/tidb_cloud/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/tidb_cloud/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/tidb_cloud/skill.md
Postman collection (v2.1): https://mcp.ai/tidb_cloud/postman.json

## Tools
- tidb_cloud_get_cluster(view?: string, cluster_id: string, service_tier: string) — Get details for one Starter/Essential instance or Dedicated cluster by ID.
- tidb_cloud_get_monthly_bill(billed_month: string) — Return the TiDB Cloud organization bill for one calendar month.
- tidb_cloud_list_audit_logs(keyword?: string, end_time?: string, page_size?: integer, start_time?: string, next_cursor?: string, audit_event_types?: string) — Search TiDB Cloud organization audit logs by time range, event type, or keyword and return one page of results.
- tidb_cloud_list_branches(page_size?: integer, cluster_id: string, next_cursor?: string) — List database branches for a TiDB Cloud Starter or Essential instance. Returns one page and a continuation cursor.
- tidb_cloud_list_clusters(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[]) — List TiDB Cloud Starter/Essential instances or Dedicated clusters, with product-specific filters. Returns one page and a continuation cursor.
- tidb_cloud_list_data_app_deployments(page_size?: integer, data_app_id: string, next_cursor?: string) — List one page of deployments and deployment status for a TiDB Cloud Data Service application, plus a continuation cursor.
- tidb_cloud_list_data_apps(page_size?: integer, project_id: string, next_cursor?: string) — List TiDB Cloud Data Service applications in a project, returning one page and a continuation cursor.
- tidb_cloud_list_import_tasks(order_by?: string, page_size?: integer, cluster_id: string, next_cursor?: string, service_tier: string) — 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.
- tidb_cloud_list_organization_members(email?: string, roles?: string[], order_by?: string, statuses?: string[], page_size?: integer, project_id?: string, instance_id?: string, next_cursor?: string) — List one page of TiDB Cloud organization members with optional identity, assignment, role, and status filters, plus a continuation cursor.
- tidb_cloud_list_regions(skip?: integer, page_size?: integer, project_id?: string, next_cursor?: string, service_tier: string, cloud_provider?: string) — List regions available for Starter/Essential or Dedicated clusters, optionally filtering Dedicated regions. Returns one page and a continuation cursor.

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

## Links
Docs: https://mcp.ai/docs/mcps/tidb_cloud
Website: https://mcp.ai/mcps/tidb_cloud