db_describe
Schema inspection, list tables, show schema, table structure, columns, types — describe the project database. With no table argument, lists visible managed and raw table names with table_planes metadata. Omitted plane prefers a declared managed table; plane:"raw" inspects a same-name raw table. With a table name, returns its column names, types, constraints, and row count.
Example:
// List all tables:
{ "project_id": "my-saas" }
// Describe one table:
{ "project_id": "my-saas", "table": "users" }
// Returns: [{ "name": "id", "type": "TEXT", "pk": true }, { "name": "email", "type": "TEXT", "notnull": true }, ...]Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"project_id": "<project_id>"
},
"name": "db_describe"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| plane | No | Optional database plane. The default lists both planes or prefers a declared managed table. | |
| table | No | Optional table name; an omitted value lists all tables. | |
| project_id | Yes | Project ID (UUID), subdomain, or slug — resolved server-side, no UUID lookup needed. 'default' also works when the account has exactly one project; multi-project accounts must name one (the error lists them). |