read
Fetch concept values for an entity across dates, resolving concepts to ranked sources with cache and failover; optionally return all source rows for comparison.
Instructions
Read a concept for an entity over dates (read-through cache + ranked dispatch).
Local concepts: concept_id is the numeric id; entity_type/entity_id/dates
are required; source pins the read (and any dispatch) to one source;
all_sources returns every held row per date, best-ranked first, without
dispatching — for cross-source comparison.
Registry-only indicators (catalog rows with id=None): pass the
semantic_code (or native_code) as concept_id — the read is routed
transparently through the indicator's source-database read channel and
returns the same row shape; entity carries the region/country/city
name when the channel needs one (world_bank requires it). Provenance
travels in source_used.
scope (optional): restrict this call to a named retrieval scope — an
indicator outside the scope returns an explicit out-of-scope response;
the reserved name unscoped forces the full corpus.
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": {
"concept_id": "<concept_id>"
},
"name": "read"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dates | No | ||
| scope | No | ||
| entity | No | ||
| source | No | ||
| entity_id | No | ||
| concept_id | Yes | ||
| all_sources | No | ||
| entity_type | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |