BCB BR

You can run the BCB BR MCP Server to access Brazil’s Central Bank time series data through convenient MCP-compatible tools. It lets you query historical series, fetch the latest values, view metadata, search series by term, and compare multiple indicators, making it easy to build powerful AI assistants and analytics workflows.

How to use

You interact with the server through an MCP client. Start the server using one of the supported runtime configurations, then call its tools to fetch data such as Selic, IPCA, exchange rates, GDP, and more. Typical patterns include requesting the latest values for a single series, retrieving a time window for a code, or comparing several series in the same period. The server exposes a set of named tools that you invoke from your MCP client, and it handles data retrieval from the Central Bank API with clear error messages in Portuguese when issues arise.

How to install

Prerequisites: you need Node.js version 18.0.0 or newer installed on your system.

Choose one of the MCP runtime options shown below. The first option runs the MCP via npx, which installs the package on demand. The second option installs the package globally and runs it directly.

{
  "mcpServers": {
    "bcb_br_npx": {
      "command": "npx",
      "args": ["-y", "bcb-br-mcp"]
    }
  }
}

If you prefer a persistent global installation, run the global install command and configure MCP to use the bundled executable.

npm install -g bcb-br-mcp

{
  "mcpServers": {
    "bcb_br_local": {
      "command": "bcb-br-mcp",
      "args": []
    }
  }
}

Additional setup notes

No authentication is required for the public API. The server communicates with the Central Bank’s open data endpoints to fetch series data. If you need to adjust the runtime behavior, you can rely on the standard MCP configuration to point your client at the available server definitions.

Tools and usage patterns

The server exposes a collection of tools to perform common data operations. You can call these tools from your MCP client to retrieve data without writing custom integration logic.

Available tools

bcb_serie_valores

Query the values of a series by code within a specified date range.

bcb_serie_ultimos

Retrieve the most recent N values of a specific series.

bcb_serie_metadados

Return metadata for a series, including frequency and source.

bcb_series_populares

List popular series grouped into categories for quick access.

bcb_buscar_serie

Search Series by name or description, with accent-insensitive matching.

bcb_indicadores_atuais

Fetch the latest values for key indicators like Selic, IPCA, and Dólar.

bcb_variacao

Calculate percentage variation between two dates or across the last N periods.

bcb_comparar

Compare up to five series within the same period and generate a ranking.