read_series
Retrieves a time series for one concept and entity across a date window from cached local data or routed registry sources, including source provenance and coverage gaps.
Instructions
Read a series for one concept x entity over [start, end].
Local concepts (numeric concept_id): serves the stored cache only,
highest-ranked source per point, ordered by date. It NEVER dispatches
upstream — an empty window is a coverage fact reported as such, not a
failure. Use read for a point read (cache + live dispatch) or
fetch to force a refresh of one point.
Registry-only indicators (semantic_code / native_code as concept_id):
the window is routed transparently through the indicator's source
database read channel (same response shape; entity carries the
region/country/city when the channel needs one). Provenance travels in
each point's source_used.
scope (optional): restrict this call to a named retrieval scope —
out-of-scope indicators return 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_series"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | window end, inclusive | |
| scope | No | optional named retrieval scope | |
| start | No | window start, inclusive ('YYYY-MM-DD'; a bare 'YYYY' works) | |
| entity | No | region / country / city name for registry-only reads | |
| entity_id | No | entity id — local reads | |
| fill_gaps | No | fetch the missing intervals of this window (price concepts only, additive — never overwrites a stored value) | |
| concept_id | Yes | concept (local numeric id, or registry semantic_code) | |
| entity_type | No | entity type (country, stock, fund, ...) — local reads |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||