Search Series
search_seriesFinds Brazilian Central Bank SGS series IDs from natural-language queries, with optional category filters and live catalog search, so you can retrieve the correct time-series data.
Instructions
Find BCB-SGS series ids from natural language.
Searches the bundled curated dictionary (151 key Brazilian macro series, with Portuguese and English aliases) and, optionally, the official BCB catalog. Always call this before get_series() when you do not know the id.
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": {
"query": "<query>"
},
"name": "search_series"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | Free-text search, e.g. 'unemployment', 'selic', 'desemprego', 'consumer prices', 'public debt', 'credito'. | |
| category | No | Optional dictionary category filter, e.g. 'inflation', 'labor', 'external_sector', 'fiscal', 'credit', 'activity'. | |
| max_results | No | Maximum number of matches to return (1..500). | |
| include_online | No | Also query the live BCB-SGS catalog (English names). Set to false for an offline, dictionary-only search. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||