README.md
Access Brazilian Central Bank economic and financial time series data
BCB BR MCP Server
MCP (Model Context Protocol) server for accessing the Brazilian Central Bank's time series data (SGS/BCB).
Query economic and financial indicators such as Selic (interest rate), IPCA (inflation), exchange rates, GDP, and more, directly from AI assistants like Claude.
If you find this project useful, please consider giving it a star on GitHub. It helps others discover the project!
Features
- Historical data - Query time series values by code with date filters
- Latest values - Get the most recent N values of any series
- Metadata - Detailed information about series (frequency, source, etc.)
- Popular series catalog - 150+ economic indicators organized in 12 categories
- Smart search - Find series by keyword (accent-insensitive)
- Current indicators - Latest values for key economic indicators
- Variation calculation - Percentage change between periods with statistics
- Series comparison - Compare multiple series over the same period
Available Tools
| Tool | Description |
|---|---|
bcb_serie_valores |
Query series values by code and date range |
bcb_serie_ultimos |
Get the last N values of a series |
bcb_serie_metadados |
Get series metadata (name, frequency, source) |
bcb_series_populares |
List popular series grouped by category |
bcb_buscar_serie |
Search series by name or description (accent-insensitive) |
bcb_indicadores_atuais |
Latest values: Selic, IPCA, USD/BRL, IBC-Br |
bcb_variacao |
Calculate percentage variation between dates or last N periods |
bcb_comparar |
Compare 2 to 5 series over the same period with ranking |
Installation
Via Smithery (recommended)
Visit bcb-br-mcp on Smithery and follow the installation instructions for your MCP client.
Via URL (Claude.ai, Claude Desktop, any MCP client)
Use the HTTP endpoint directly, no installation required:
https://bcb.sidneybissoli.workers.dev
Via npx (Claude Desktop)
Add to your Claude Desktop configuration file:
Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"bcb-br": {
"command": "npx",
"args": ["-y", "bcb-br-mcp"]
}
}
}
Via global install
npm install -g bcb-br-mcp
{
"mcpServers": {
"bcb-br": {
"command": "bcb-br-mcp"
}
}
}
Usage Examples
Get the current Selic rate
What is the current Selic interest rate?
→ Uses bcb_indicadores_atuais
IPCA history for 2024
Show me the monthly IPCA for 2024
→ Uses bcb_serie_valores with code 433, dataInicial 2024-01-01, dataFinal 2024-12-31
List inflation indicators
What inflation series are available?
→ Uses bcb_series_populares with category "Inflação"
Search for USD exchange rate series
Search for series related to the dollar
→ Uses bcb_buscar_serie with term "dolar" (works without accents)
Calculate USD/BRL variation
What was the USD/BRL variation over the last 12 months?
→ Uses bcb_variacao with code 1 and periodos 12
Compare IPCA, IGP-M, and INPC
Compare IPCA, IGP-M, and INPC in 2024
→ Uses bcb_comparar with codes [433, 189, 188], dataInicial 2024-01-01, dataFinal 2024-12-31
Series Catalog (150+)
The server includes a catalog of 150+ series organized in 12 categories.
Interest Rates
| Code | Description |
|---|---|
| 11 | Selic rate - monthly accumulated |
| 432 | Selic rate - annualized (base 252) |
| 1178 | Selic target rate (Copom) |
| 12 | CDI daily rate |
| 4389 | CDI annualized (base 252) |
| 226 | Reference Rate (TR) - daily |
| 256 | Long-Term Interest Rate (TJLP) |
Inflation (30+ series)
| Code | Description |
|---|---|
| 433 | IPCA - Monthly change |
| 13522 | IPCA - 12-month accumulated |
| 7478 | IPCA-15 - Monthly change |
| 188 | INPC - Monthly change |
| 189 | IGP-M - Monthly change |
| 190 | IGP-DI - Monthly change |
| 7447 | IGP-10 - Monthly change |
| 10841-10850 | IPCA by group (Food, Housing, Transportation, etc.) |
| 4 |
Tools (8)
bcb_serie_valoresQuery series values by code and date rangebcb_serie_ultimosGet the last N values of a seriesbcb_serie_metadadosGet series metadata (name, frequency, source)bcb_series_popularesList popular series grouped by categorybcb_buscar_serieSearch series by name or description (accent-insensitive)bcb_indicadores_atuaisLatest values: Selic, IPCA, USD/BRL, IBC-Brbcb_variacaoCalculate percentage variation between dates or last N periodsbcb_compararCompare 2 to 5 series over the same period with rankingConfiguration
claude_desktop_config.json
{"mcpServers": {"bcb-br": {"command": "npx", "args": ["-y", "bcb-br-mcp"]}}}Try it
→What is the current Selic interest rate?
→Show me the monthly IPCA inflation data for 2024.
→Search for series related to the US dollar exchange rate.
→What was the USD/BRL variation over the last 12 months?
→Compare the performance of IPCA, IGP-M, and INPC inflation indices in 2024.