bcrp-mcp
This server lets you search and retrieve official BCRP time series and compare Peru with other countries using World Bank indicators.
Search BCRP series by keywords, with optional frequency and result limit, returning series codes, names, frequency, and start dates.
Download BCRP series data for a given code and date range, including the source URL.
Summarize a BCRP series over a period: first/last value, change, percent variation, average, maximum, and minimum.
Compare countries on annual World Bank indicators such as GDP growth, inflation, unemployment, GDP per capita, exports, or debt, returning year-by-country data, averages, rankings, and source URL.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@bcrp-mcp ¿Cuál fue la inflación de Lima a 12 meses en setiembre de 2026?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
bcrp-mcp · Un MCP con las series oficiales del BCRP
Servidor MCP hecho con FastMCP 4 que le da a Claude acceso a las 17,167 series estadísticas del Banco Central de Reserva del Perú (BCRP) y, para el contexto regional, a los indicadores del Banco Mundial. Las cuentas las hace Python, no el modelo: cada cifra sale de una llamada que se puede repetir y viene con la URL de su fuente.
Proyecto hecho en el diplomado de QLab de la PUCP, como tarea de la sesión 04 del curso
Data Science con Python
(el enunciado original está en ENUNCIADO.md). Los resultados están en informe.md.

Qué expone
Tipo | Nombre | Qué hace |
Herramienta |
| Busca códigos de serie por palabras en el catálogo del BCRP. Primero muestra las series al día y al final las viejas o descontinuadas |
Herramienta |
| Descarga los datos de una serie (diaria, mensual, trimestral o anual) con la URL de la fuente. Avisa si la serie no llega al periodo pedido |
Herramienta |
| Primero, último, cambio, variación %, promedio, máximo y mínimo, para que el modelo no calcule a mano |
Herramienta |
| Variación interanual, respecto al periodo anterior o acumulada en el año, promedio anual, índice base 100 y valores reales (deflactados con el IPC de Lima) |
Herramienta |
| Gráfico de hasta 5 series con estilo de publicación, guardado en |
Herramienta |
| Excel con los datos alineados por periodo y una hoja de metadatos, en |
Herramienta |
| Herramienta propia. Compara al Perú con otros países en PBI, inflación, desempleo, PBI per cápita, exportaciones o deuda, con la API del Banco Mundial |
Recurso |
| La ficha de una serie: nombre, categoría, frecuencia, inicio y última actualización |
Prompt |
| Pide un informe breve que cite el código y el periodo de cada cifra |
Prompt |
| Nota de coyuntura macro para economistas: inflación, tasa de referencia, PBI, tipo de cambio, términos de intercambio, reservas y crédito, con gráfico |
Ninguna de las dos APIs pide clave.
Para economistas
Las transformaciones coinciden con las cifras del BCRP.
transformar("PN38705PM", "var_interanual", ...)da la misma inflación a 12 meses que publica el BCRP (PN01273PM), yvar_acumuladada la misma variación acumulada (PN01272PM). Las pruebas lo verifican.realdeflacta con el IPC de Lima (PN38705PM, dic. 2021 = 100) y expresa los valores a precios del periodobase. Sibasees un año, usa el promedio de ese año. En series trimestrales o anuales, el deflactor es el promedio de los meses, y solo se usa si los meses están completos.En series diarias, como el tipo de cambio, las variaciones interanuales y acumuladas y los valores reales se calculan sobre el promedio de cada mes.
Avisos. La herramienta avisa si se transforma una serie que ya es una tasa (por ejemplo, la variación interanual de una var%), si el último año de un promedio anual está incompleto, si se deflacta un monto en dólares con el IPC peruano o si la serie está descontinuada.
Gráficos. Nunca usan dos ejes Y: las series con distinta unidad van en paneles separados y las tasas comparten panel. El último dato de cada serie se rotula al final de su línea. El pie cita los códigos y la fecha.

Related MCP server: BCRP MCP Server
Instalación
Necesitas uv y Claude Code.
git clone https://github.com/LuisGuevaraVega/bcrp-mcp && cd bcrp-mcp
uv run pytest -q # 20 passed; la primera vez baja el catálogo del BCRP (~7 MB) a datos/
claude # aprueba los servidores bcrp y fetch de .mcp.jsonPara usarlo en otro proyecto: claude mcp add bcrp -- uv run --directory /ruta/a/bcrp-mcp server.py.
Manual de uso en Claude
No hace falta saber los códigos ni el nombre de las herramientas: pregunta como le preguntarías a un analista. Claude busca la serie en el catálogo, trae el dato y te dice de dónde salió. Si quieres comprobar qué hizo, abre el detalle de las llamadas o pídele «muéstrame el código de serie y la URL».
1. Preguntar por un dato
¿Cuál fue la inflación de Lima a 12 meses en setiembre de 2026?
Claude busca la serie con buscar_series, consulta el dato con serie y responde con el valor, el código de la serie
(PN01273PM) y el periodo. Para que acierte a la primera:
Di el periodo exacto («setiembre de 2026», «el promedio de 2025»). Si no dices el periodo, Claude usa el último dato publicado.
Di la medida que quieres: nivel, variación mensual, variación a 12 meses, promedio o fin de periodo. El BCRP tiene muchas series con nombres parecidos.
Si ya sabes el código, dáselo: «usa PN01207PM».
2. Pedir cálculos
Claude no hace las cuentas a mano: se las pide a las herramientas, que las calculan en Python.
Si quieres… | Pídelo así | Herramienta |
Cambio, promedio, máximo o mínimo de un periodo | «¿Cuánto subió el tipo de cambio en 2026 y cuál fue su máximo?» |
|
Variación interanual o acumulada | «Variación interanual del precio del cobre, mes a mes, en 2026» |
|
Promedio anual | «Promedio anual del tipo de cambio de 2020 a 2025» |
|
Índice base 100 | «Pon el oro y el cobre en índice, base enero de 2025 = 100» |
|
Valores reales | «El crédito en soles a precios de 2025» |
|
Comparar al Perú con otros países | «¿Creció el Perú más que Chile y Colombia desde 2015?» |
|
3. Hacer gráficos
Grafica la inflación, la subyacente y la tasa de referencia desde 2023, y sombrea 2025.
El PNG se guarda en salidas/. Claude te da la ruta del archivo y, como también recibe la imagen, puede comentarla.
Puedes pedir:
Hasta 5 series por gráfico. Si tienen unidades distintas, como dólares y soles, cada una va en su propio panel.
Una transformación, por ejemplo «en variación interanual» o «en índice base 100». Sirve para comparar series de escalas distintas en un solo panel.
Un título propio y periodos sombreados, como una recesión o un ciclo de alzas de la tasa.
4. Llevar los datos a Excel
Pásame a Excel el tipo de cambio, las reservas y la tasa de referencia de 2025 a hoy.
El .xlsx se guarda en salidas/. Tiene una hoja con las series alineadas por periodo (las de distinta frecuencia
van en hojas separadas) y una hoja de metadatos con el nombre, la unidad, la transformación y la URL de cada serie.
También puedes pedirlo transformado: «…en variación interanual».
5. Atajos: @ para fichas y / para informes
@bcrp:bcrp://serie/PN01273PM ¿desde cuándo hay datos de esta serie?adjunta la ficha de la serie: nombre, frecuencia, inicio y última actualización./mcp__bcrp__informe "precio de la plata"escribe un informe breve con cifras y fuentes. Pon el tema entre comillas si tiene varias palabras: Claude Code separa los argumentos por espacios./mcp__bcrp__coyuntura 2026-09escribe una nota de coyuntura macro con inflación, tasa de referencia, PBI, tipo de cambio, términos de intercambio, reservas y crédito, más un gráfico.
6. Lee los avisos
Las herramientas agregan un aviso cuando algo merece cuidado, y Claude debería mencionarlo:
«El último dato es de…»: la serie no llega al periodo pedido. Puede ser el rezago normal de publicación (el IPC sale a inicios del mes siguiente) o una serie que ya no se actualiza: pide otra.
«La serie está descontinuada»: pide su reemplazo.
«La serie ya es una tasa»: calcular la variación interanual de una variación % rara vez tiene sentido. Pide la serie en niveles.
«Su promedio es parcial»: el último año todavía no termina.
Archivos
Archivo | Qué es |
| El servidor MCP |
| Las 8 pruebas del curso, sin cambios |
| 12 pruebas de |
| Un gráfico de ejemplo hecho con |
| Donde |
| Los servidores |
| 12 preguntas con la cifra oficial (8 del curso y 4 propias) |
| Hace cada pregunta a Claude ( |
| La corrida con web y la corrida base (memoria contra MCP) |
| Genera |
| El informe de la evaluación |
Licencia
MIT. Los datos son del BCRP y del Banco Mundial.
Available Tools
4 toolsbuscar_seriesBuscar SeriesARead-only
Busca series del BCRP por palabras: todas deben aparecer en la categoría, el grupo o el nombre.
Ejemplos: "ipc 12 meses", "tipo de cambio interbancario venta", "reservas internacionales netas", "tasa de referencia", "cobre precio". frecuencia: "Diaria", "Mensual", "Trimestral" o "Anual". Devuelve el código, el nombre completo, la frecuencia y desde cuándo hay datos. Si no hay resultados, prueben con menos palabras.
Inputs: texto (required), limite, frecuencia. Returns: result
comparar_paisesComparar PaisesARead-only
Compara al Perú con otros países en un indicador anual del Banco Mundial (el BCRP solo tiene datos del Perú).
Úsenla cuando la pregunta compare países o pida contexto regional: "¿creció el Perú más que Chile?", "inflación de la Alianza del Pacífico". indicador: "pbi" (crecimiento real %), "inflacion" (IPC %), "desempleo" (% de la fuerza laboral), "pbi_per_capita" (US$ corrientes), "exportaciones" (% del PBI), "deuda" (deuda del gobierno central, % del PBI), o un código del Banco Mundial como "NY.GDP.MKTP.KD.ZG". paises: códigos ISO3 separados por comas. Devuelve una tabla año por país, el promedio y el ranking del periodo, y la URL de la fuente.
Inputs: desde, hasta, paises, indicador. Returns: object
resumenResumenARead-only
Resume una serie del BCRP en un periodo: primer y último valor, cambio, variación %, promedio, máximo y mínimo.
Úsenla siempre que la pregunta pida una variación, un promedio o un extremo, en vez de calcular a mano. Mismas fechas que serie. Ejemplo: resumen("PD04638PD", "2026-01-01", "2026-10-15").
Inputs: desde (required), hasta (required), codigo (required). Returns: object
serieSerieARead-only
Descarga los datos de una serie del BCRP entre dos fechas, con la URL de la fuente.
Usen primero buscar_series para conseguir el código. Fechas: "2025-01" para series mensuales, "2026-10-01" para diarias, "2025-T1" para trimestrales y "2025" para anuales (un año suelto también vale). Ejemplo: serie("PN01273PM", "2025-01", "2025-12"). Para variaciones o promedios usen resumen.
Inputs: desde (required), hasta (required), codigo (required). Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool targets a distinct step: search for codes (buscar_series), fetch raw time series (serie), compute statistics (resumen), and cross-country comparison (comparar_paises). The descriptions explicitly chain them (use buscar_series first, use resumen for variations), leaving no plausible misselection.
Two tools use verb_noun (buscar_series, comparar_paises) while two are bare nouns (serie, resumen), mixing conventions within a small set. Names are still readable and Spanish-consistent, but the pattern is not predictable from one tool to the next.
Four tools is a lean, well-scoped surface for a single data source, and each tool earns its place in the search→fetch→summarize→compare workflow. It is slightly thin—no bulk multi-series fetch or metadata/category listing—but not a mismatch.
Core lifecycle is covered: discovery, raw retrieval, aggregation, and international context, with clear dead-end avoidance via the search-first hint. Minor gaps remain—no way to fetch multiple BCRP series in one call or list available categories/frequencies directly.
Maintenance
Related MCP Connectors
Macro data for AI agents: GDP, inflation, unemployment and more (World Bank, US BLS). No keys.
Macro data for AI agents: GDP, inflation, unemployment and more (World Bank, US BLS). No keys.
Official statistics for AI agents: Eurostat, World Bank, OECD, IMF and WHO data for 150+ countries.
Premium live data from S&P Global, FRED, OECD & more, plus web search, in one call.
Related MCP Servers
- AlicenseAqualityDmaintenanceProvides access to over 5,000 macroeconomic indicators from the Banco Central de Reserva del Perú (BCRP) statistical database. It enables AI agents to search for indicators, fetch time-series data, and generate professional economic charts.410 PyPI1MIT
- AlicenseAqualityBmaintenanceEnables AI agents to access economic statistics from the Central Reserve Bank of Peru, including exchange rates, interest rates, and GDP, without requiring an API key.7MIT
- AlicenseAqualityBmaintenanceEnables Claude to access free official financial and economic data from SEC EDGAR, U.S. Treasury, FRED, and the World Bank, including XBRL financial statements, key metrics, filings, insider trades, 13F portfolios, market prices, and macroeconomic series.20MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to query cross-country macroeconomic and financial statistics, including GDP, inflation, fiscal balance, debt, exchange rates, trade, and balance-of-payments data for comparison and time-series analysis.94 npmMIT