describe_column
Inspect a column's data type, nullability, default, description, and both outgoing and incoming foreign keys using its fully qualified name (schema.table.column).
Instructions
Use this when you need to drill into one column by its three-part qualified name (e.g. public.orders.user_id). Returns data type, nullability, default, LLM description, and BOTH join directions — outgoing FKs (this column joins out) and incoming FKs (which tables reference this column). Use describe_table instead when you want the whole table at once. Common composition: chain describe_table to describe_column to map a column's full role across schema.
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": {
"qualified_name": "<qualified_name>"
},
"name": "describe_column"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| qualified_name | Yes | Postgres `schema.table.column` qualified name (e.g. `public.orders.user_id`). Three dot-separated parts. Call `describe_table` first if you only know the table and need to discover its columns. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| status | Yes | ||
| data | No | ||
| error | No | ||
| confidence | No | ||
| provenance | No | ||
| follow_up_hints | No | ||
| degradation_reason | No | ||
| charter_version | No | 1.2 |