# Banco Central do Brasil (BCB) — SGS Time Series MCP Server

Connects AI clients to Central Bank of Brazil indicators: SGS time series, Focus market forecasts, and PTAX exchange rates.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 10
- Author: SidneyBissoli
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/SidneyBissoli/bcb-br-mcp
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/mcp/banco-central-do-brasil-bcb-sgs-time-series-mcp-server

## What it does

The server connects AI tools directly to Central Bank of Brazil endpoints. It provides 17 tools covering SGS time series, the Focus market survey, and official PTAX foreign exchange rates. Models can pull verified figures like the Selic benchmark rate or IPCA inflation.

Upstream API constraints are resolved automatically. The central bank blocks daily time series queries spanning over ten years with an HTTP 406 error. This server slices long intervals into smaller segments and merges the results. It also applies geometric compounding when resampling period rates, preserving inflation calculations.

You can connect to the hosted HTTP endpoint or run the package locally via `npx`. Running it locally requires Node.js.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://bcb.sidneybissoli.com/mcp`

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http bcb-br-mcp https://bcb.sidneybissoli.com/mcp
```

2. **Platform CLI**
```bash
claude mcp add banco-central-do-brasil-bcb-sgs-time-series-mcp-server -- npx -y bcb-br-mcp
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add banco-central-do-brasil-bcb-sgs-time-series-mcp-server --url https://bcb.sidneybissoli.com/mcp
```

2. **Platform CLI**
```bash
codex mcp add banco-central-do-brasil-bcb-sgs-time-series-mcp-server -- npx -y bcb-br-mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "banco-central-do-brasil-bcb-sgs-time-series-mcp-server": {
            "url": "https://bcb.sidneybissoli.com/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "banco-central-do-brasil-bcb-sgs-time-series-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "bcb-br-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "banco-central-do-brasil-bcb-sgs-time-series-mcp-server": {
            "type": "http",
            "url": "https://bcb.sidneybissoli.com/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "banco-central-do-brasil-bcb-sgs-time-series-mcp-server": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "bcb-br-mcp"
            ]
        }
    }
}
```

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http banco-central-do-brasil-bcb-sgs-time-series-mcp-server https://bcb.sidneybissoli.com/mcp
```

2. **Platform CLI**
```bash
gemini mcp add banco-central-do-brasil-bcb-sgs-time-series-mcp-server npx -y bcb-br-mcp
```

## When to use it
- fetch current figures for Selic interest rates and IPCA inflation
- pull daily time series spanning more than ten years without HTTP 406 errors
- inspect Focus market projections before Copom rate decisions
- retrieve official closing PTAX foreign exchange quotes

## Example prompts
- What are the latest Selic and IPCA indicators from the central bank?
- Show the PTAX USD exchange rate history over the past year.
- What are the market expectations for Selic at the upcoming Copom meeting according to the Focus survey?

## Similar
- [mcp-banco-do-brasil](https://affpapa.org/en/nevibecode/mcp/mcp-banco-do-brasil.md) — MCP server · ★ 274
- [cloud-monitoring-list-time-series-request](https://affpapa.org/en/nevibecode/skills/cloud-monitoring-list-time-series-request.md) — skill · 4100 installs
- [mcp-pix-bcb](https://affpapa.org/en/nevibecode/mcp/mcp-pix-bcb.md) — MCP server · ★ 274
- [Time Series Analysis](https://affpapa.org/en/nevibecode/skills/time-series-analysis.md) — skill · 605 installs
- [mcp-brasil-public-apis](https://affpapa.org/en/nevibecode/skills/mcp-brasil-public-apis.md) — skill · 872 installs
- [MCP Fiscal Brasil](https://affpapa.org/en/nevibecode/mcp/mcp-fiscal-brasil.md) — MCP server · ★ 375

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md