BCB BR MCP
@SidneyBissoli
MCP server for Brazilian Central Bank (BCB) economic data. Query 18,000+ time series including Selic, IPCA, exchange rates, GDP, employment, credit, and 150+ curated indicators via the SGS/BCB public API.
Overview
What is BCB BR MCP?
BCB BR MCP is a Model Context Protocol server providing access to the Brazilian Central Bank’s SGS time series data. It allows AI assistants to query economic and financial indicators such as the Selic rate, IPCA inflation, exchange rates, GDP, and more.
How to use BCB BR MCP?
Install via Smithery (recommended), use the HTTP endpoint (https://bcb.sidneybissoli.workers.dev), or run via npx with a Claude Desktop configuration. Eight tools are available: bcb_serie_valores, bcb_serie_ultimos, bcb_serie_metadados, bcb_series_populares, bcb_buscar_serie, bcb_indicadores_atuais, bcb_variacao, and bcb_comparar.
Key features of BCB BR MCP
- Historical time series values with date filtering
- Latest N values for any series
- Metadata (frequency, source) for each series
- Catalog of 150+ indicators in 12 categories
- Accent‑insensitive keyword search
- Variation percentage calculation with statistics
- Comparison of up to 5 series over the same period
Use cases of BCB BR MCP
- Ask “What is the current Selic rate?” to get the latest interest rate.
- Request “Show me monthly IPCA for 2024” to retrieve inflation history.
- Search for “inflation series” to list available inflation indicators.
- Query “USD/BRL variation over the last 12 months” for exchange rate change.
- Compare IPCA, IGP‑M, and INPC for a given year using a single command.
FAQ from BCB BR MCP
What are the runtime requirements?
Node.js version 18.0.0 or higher is required.
How can I find codes for series not in the catalog?
Visit the BCB SGS Portal, search for the desired series, and note its numeric code.
Does the search tool handle Portuguese accents?
Yes, the bcb_buscar_serie tool normalizes terms so that “inflacao” finds “Inflação” and similar.
What is the underlying API and is authentication needed?
The server uses the public BCB API at https://api.bcb.gov.br/dados/serie/bcdata.sgs.{code}/dados. No authentication is required.
What error handling does the server provide?
Requests have a 30‑second timeout, with automatic retry up to 3 times using exponential backoff (1s, 2s, 4s).
