---
title: "TiDB Cloud integration for LuumenAI"
url: "https://www.luumen.ai/integrations/tidb-cloud/"
entity: SoftwareIntegration
category: "Databases & data platforms"
audience: "SRE, DevOps, platform engineering, IT operations"
---

# TiDB Cloud integration for LuumenAI

Read your TiDB Cloud clusters, bills, audit logs, and Data Service apps

## What LuumenAI can do with TiDB Cloud

LuumenAI connects to TiDB Cloud with an API token and exposes 10 tools (10 read-only). Every tool is read-only, so it can answer questions from TiDB Cloud but cannot change anything in it. Read actions still follow the configured access and approval policy.

## Key facts

- Authentication: API token
- Tools available: 10 tools (10 read-only)
- Deployment: scoped as part of your Pilot, Platform, or Managed rollout
- Category: Databases & data platforms

## About TiDB Cloud with LuumenAI

Ask about your TiDB Cloud estate and get an answer from the control plane. List Starter, Essential, and Dedicated clusters or pull details on one. Check import task progress, branches, and Data Service deployments. Review the monthly organization bill, org members, and audit logs. Read-only, over an API key.

## Example tools

Read-only (10 in total):

- `TIDB_CLOUD_GET_CLUSTER` — Get details for one Starter/Essential instance or Dedicated cluster by ID.
- `TIDB_CLOUD_GET_MONTHLY_BILL` — Return the TiDB Cloud organization bill for one calendar month.
- `TIDB_CLOUD_LIST_AUDIT_LOGS` — Search TiDB Cloud organization audit logs by time range, event type, or keyword and return one page of results.
- `TIDB_CLOUD_LIST_BRANCHES` — List database branches for a TiDB Cloud Starter or Essential instance.
- `TIDB_CLOUD_LIST_CLUSTERS` — List TiDB Cloud Starter/Essential instances or Dedicated clusters, with product-specific filters.
- `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.
- `TIDB_CLOUD_LIST_DATA_APPS` — List TiDB Cloud Data Service applications in a project, returning one page and a continuation cursor.
- `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.

## Frequently asked questions

### How does LuumenAI connect to TiDB Cloud?

Authorize once with API token. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.

### Can LuumenAI change things in TiDB Cloud on its own?

No. Every one of the 10 tools is read-only, so LuumenAI can answer questions from TiDB Cloud but cannot change anything in it. Read actions still follow the configured access and approval policy.

### Is there an audit trail?

Every call to TiDB Cloud is recorded with the actor, the input, and the result.

Full page: https://www.luumen.ai/integrations/tidb-cloud/