BCB BR MCP Server

Leia em Português

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.

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

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

Inflation (30+ series)

Exchange Rates (15+ series)

Economic Activity (25+ series)

Employment (10+ series)

Fiscal (10+ series)

External Sector (15+ series)

Credit (30+ series)

Monetary Aggregates

Savings

Market Indices

Expectations (Focus Survey)

Finding Other Series

The SGS database contains over 18,000 time series. To find codes for other series:

1. Visit the BCB SGS Portal

2. Search for the desired series

3. Note the series code

4. Use that code with this server's tools

Technical Details

Robustness

• Timeout: 30 seconds per request (prevents hanging)

• Auto-retry: 3 attempts with exponential backoff (1s, 2s, 4s)

• Error handling: Clear error messages

Smart Search

The bcb_buscar_serie tool normalizes search terms, allowing you to find series even without Portuguese accents:

• "inflacao" → finds "Inflação"

• "cambio" → finds "Câmbio"

• "credito" → finds "Crédito"

Development

Requirements

• Node.js >= 18.0.0

Setup

git clone https://github.com/SidneyBissoli/bcb-br-mcp.git
cd bcb-br-mcp
npm install

Build

npm run build

Local testing (stdio)

npm run dev

Local testing (HTTP worker)

npm run dev:worker

Or use the MCP Inspector:

npx @modelcontextprotocol/inspector npm run dev

BCB API

This server uses the Brazilian Central Bank's public API:

• Base endpoint: https://api.bcb.gov.br/dados/serie/bcdata.sgs.{code}/dados

• Format: JSON

• Authentication: None (public API)

• Documentation: BCB Open Data

Changelog

v1.2.0

• HTTP endpoint via Cloudflare Workers (https://bcb.sidneybissoli.workers.dev)

• Published on Smithery.ai

• Refactored: tool logic extracted to src/tools.ts (shared between stdio and HTTP)

v1.1.0

• New tool bcb_variacao for percentage variation calculation

• New tool bcb_comparar for comparing multiple series

• 30-second timeout on requests

• Auto-retry with exponential backoff (3 attempts)

• Normalized search (accent-insensitive)

• Additional statistics (max, min, average, range)

v1.0.0

• Initial release

• 6 basic tools

• Catalog with 150+ series

Contributing

Contributions are welcome! Please:

1. Fork the repository

2. Create a feature branch (git checkout -b feature/new-feature)

3. Commit your changes (git commit -m 'Add new feature')

4. Push to the branch (git push origin feature/new-feature)

5. Open a Pull Request

License

MIT - see LICENSE for details.

Author

Sidney da Silva Pereira Bissoli

• GitHub: @SidneyBissoli

• Email: sbissoli76@gmail.com

Useful Links

• BCB SGS Portal

• BCB Open Data

• Model Context Protocol

• MCP Registry

• Smithery: bcb-br-mcp

• npm: bcb-br-mcp