# bcb-mcp

An MCP server for the time series of the Central Bank of Brazil (BCB-SGS), with a curated series dictionary, a local parquet cache and DuckDB SQL for LLM agents. It is the Python counterpart of the R package GetBCBData.

- **Ecosystem:** Python (PyPI)
- **Page URL:** https://www.msperlin.com/code/python/bcb-mcp
- **GitHub:** https://github.com/msperlin/bcb-mcp
- **PyPI:** https://pypi.org/project/bcb-mcp/
- **Monthly downloads:** 142
- **All-time downloads:** 142
- **GitHub stars:** 1
- **Last push:** 2026-11-10

## Installation

```bash
uvx bcb-mcp
```

```bash
pip install bcb-mcp
```

## Quickstart

```bash
# Run directly with uvx (recommended for MCP clients)
uvx bcb-mcp

# Or install from PyPI
pip install bcb-mcp
```

## MCP Client Configuration

```json
{
  "mcpServers": {
    "bcb": {
      "command": "uvx",
      "args": [
        "bcb-mcp"
      ]
    }
  }
}
```

## Citation

```bibtex
@manual{perlin_bcb_mcp,
  author = {Perlin, Marcelo S.},
  title = {bcb-mcp: An MCP server for the time series of the Central Bank of Brazil (BCB-SGS), with a curated series dictionary, a local parquet cache and DuckDB SQL for LLM agents. It is the Python counterpart of the R package GetBCBData.},
  year = {2026},
  note = {Python Model Context Protocol (MCP) server},
  url = {https://github.com/msperlin/bcb-mcp}
}
```
