list_concepts
List and filter data concepts by query, entity type, or concept family, with pagination, to discover variables and verified indicator entries for reading.
Instructions
List concepts (Variables) with their concept family; optionally filtered.
Paginated: rows are ordered by (entity_type, code, id) and a page returns at
most limit rows (clamped to 1000). Page with increasing offset until
a page comes back shorter than limit — that enumerates the full catalog
even when one entity type exceeds the per-call cap.
The catalog also serves verified entries of the unified indicator registry
(world_bank / gta_panel / china_city_panel / fd_open_data mirror sources).
Registry rows are appended after the native rows, ordered by
(domain, semantic_code); they carry additive native_code and
source_db fields, so an entry is findable by either identifier, and a
read_via hint naming the domain tool that serves its values. Reading
a registry-only indicator: pass its semantic_code (or native_code) as
concept_id to read / read_series — the read routes
transparently through the indicator's source-database read channel.
Entries whose semantic_code duplicates a non-deprecated native concept
code are deduped (native row wins); deprecated legacy rows never shadow a
verified entry.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_concepts"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | page size, 1..1000 (default 500) | |
| query | No | optional case-insensitive substring matched against code / name_en / name_zh (and native_code on registry rows); default None = unfiltered | |
| offset | No | rows to skip (default 0) | |
| entity_type | No | restrict to one entity type (country, stock, ...) — registry rows carry no entity type and are excluded by this filter | |
| concept_family | No | restrict to one concept family id (GDP, Population, ...) — registry rows carry no family and are excluded by this filter |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |