BCRP MCP

Servidor Model Context Protocol (MCP) para consultar BCRPData, la base oficial de estadísticas económicas del Banco Central de Reserva del Perú (BCRP).

Permite a clientes MCP y agentes de IA consultar tipos de cambio, tasas de interés, reservas internacionales, liquidez, crédito, commodities, bolsa y PBI. La API del BCRP es pública: no se necesita API key ni registro.

Instalación rápida

Se requiere Python 3.11 o posterior.

Con uvx (recomendado para clientes MCP)

uvx bcrp-mcp

Con pip

python -m pip install bcrp-mcp
bcrp-mcp

La instalación también proporciona el CLI bcrp:

bcrp --help
bcrp catalog search "tipo de cambio"
bcrp series latest PD04637PD --n 5

Desde el código fuente

git clone https://github.com/JOSETRA44/BCRP-mcp.git
cd BCRP-mcp
uv sync
uv run bcrp-mcp

Configuración en clientes MCP

El servidor usa transporte stdio. Con uvx, la configuración es la misma en Claude Desktop, Claude Code, Cursor y otros clientes compatibles:

{
  "mcpServers": {
    "bcrp": {
      "command": "uvx",
      "args": ["bcrp-mcp"]
    }
  }
}

En VS Code + GitHub Copilot (.vscode/mcp.json):

{
  "servers": {
    "bcrp": {
      "type": "stdio",
      "command": "uvx",
      "args": ["bcrp-mcp"]
    }
  }
}

Herramientas MCP

Ejemplos de preguntas:

¿Cuál es el tipo de cambio actual en Perú?
Compara la tasa de referencia y las reservas internacionales desde 2020.
Obtén un snapshot de los principales indicadores de la economía peruana.

CLI

El comando bcrp usa la misma lógica que el servidor MCP y admite salida para terminal o automatización:

bcrp series describe PD04637PD
bcrp series latest PD04637PD PD12301MD --n 5
bcrp series get PN00196MM --start 2020-1 --end 2024-12
bcrp catalog categories
bcrp macro snapshot

Opciones útiles:

bcrp series latest PD04637PD --n 5 --json
bcrp series latest PD04637PD --n 5 --ascii --no-color

Los formatos de período dependen de la frecuencia: diario DD-MM-YYYY, mensual YYYY-M, trimestral YYYY-Q y anual YYYY. Las series de una misma consulta deben tener la misma frecuencia, salvo bcrp_get_series_long.

Configuración opcional

Todos los valores tienen valores predeterminados razonables y pueden definirse con variables de entorno o un archivo .env:

No se configura ninguna credencial: BCRPData es de acceso abierto.

Desarrollo

uv sync
uv run pytest -q
uv run python -m build

El proyecto usa src/ layout, Hatchling para construir el paquete y publica dos entry points: bcrp-mcp (servidor) y bcrp (CLI).

Publicación

Las versiones se publican mediante GitHub Actions al crear un release de GitHub. El workflow .github/workflows/publish.yml ejecuta las pruebas, construye los artefactos y publica en PyPI usando Trusted Publishing (OIDC); no requiere un token de PyPI almacenado en secretos.

Datos y licencia

Los datos provienen de BCRPData. Consulte sus condiciones de uso.

MIT — consulte LICENSE.

Documentación del proyecto

• CHANGELOG.md: historial de cambios.
• CONTRIBUTING.md: guía para contribuir.
• SECURITY.md: reporte de vulnerabilidades.
• server.json: metadatos para el registro MCP.