Describe dataset
describe_datasetRead-only
The full dictionary for ONE downloadable dataset: description plus every column's type, nullability and plain-English meaning. Pass a name from list_datasets. Open — no key needed. For the fields the query tools accept, use list_fields.
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": {
"asset": "<asset>"
},
"name": "describe_dataset"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| asset | Yes | Dataset name, as returned by `list_datasets`. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Dataset name, exactly as `list_datasets` reports it. | |
| note | No | Optional "how to use this" callout. | |
| title | Yes | Human-friendly title, e.g. "Order-flow OHLCV (1-minute)". | |
| cadence | Yes | How frequently the data is sampled, e.g. "1-minute bars". | |
| summary | Yes | One-line intuitive summary — the catalog card. | |
| category | Yes | Presentation category, e.g. `raw-tiles` or `forecast-layer`. | |
| keywords | No | Per-dataset discovery keywords (schema.org keywords on the web). | |
| temporal | No | Machine-readable timestamp/interval contract: what the label marks and how to join without leaking the future. Defaulted so snapshots predating the field still deserialize. | |
| use_case | No | One-line "what you'd use it for" (buyer-intent) copy. | |
| seo_title | No | Keyword-first SEO title tag (web `<title>`). Defaulted so older snapshots without the field still deserialize. | |
| description | Yes | Longer prose — the dictionary page header. | |
| column_count | Yes | Number of documented columns. | |
| column_groups | Yes | Columns, grouped for presentation, in schema order. | |
| direct_answer | No | 40-60 word keyword-first lead answer — the definitional "what is this" blurb, and the strongest AI-citation extraction target. Defaulted for forward/backward compatibility with snapshots predating the field. |