Skip to main content
Glama
sbs
by rodnm

mcp-sbs-peru

Un servidor MCP para que Claude responda con las cifras oficiales de la Superintendencia de Banca, Seguros y AFP del Perú (SBS): morosidad y solvencia de bancos y cajas, participación de mercado, comisiones y rentabilidad de las AFP, y ranking de aseguradoras. Cada respuesta cita el boletín, el periodo y la URL del Excel de la SBS, así que cualquiera puede comprobarla.

Ejemplos: «¿Qué banco tiene la menor morosidad?», «¿Qué AFP cobra menos comisión?», «¿Quién vende más SOAT?», «ROE de las cajas municipales en agosto de 2026».

¿Sirve? El resultado en un gráfico

Aciertos de Claude Haiku en 10 preguntas sobre cifras oficiales de la SBS: solo memoria 0 de 10, búsqueda web 2 de 10, MCP de la SBS 10 de 10

Le hicimos a Claude (modelo Haiku) 10 preguntas con respuesta oficial conocida, sacada de los Excel de la SBS:

  • Sin herramientas, solo con lo que aprendió al entrenarse, acertó 0 de 10. Las 10 veces dijo que no sabía.

  • Buscando en internet acertó 2 de 10: las dos cifras de AFP que repiten las noticias.

  • Con este MCP acertó 10 de 10, y cada respuesta trae el link del Excel de la SBS de donde salió.

El detalle de cada pregunta y por qué falló cada modo está en informe.md.

Related MCP server: LATAM-MCP

Instalar

Necesitan uv y Claude Code. Dos comandos, sin clonar nada:

uv tool install git+https://github.com/rodnm/mcp-sbs-peru     # instala el comando mcp-sbs-peru
claude mcp add --scope user sbs -- mcp-sbs-peru               # lo conecta a Claude Code en todos sus proyectos

Abran claude en cualquier carpeta: /mcp debe mostrar sbs conectado. Si la terminal no encuentra el comando mcp-sbs-peru, corran una vez uv tool update-shell y abran una terminal nueva. Los Excel que baja quedan en la caché de su usuario (%LOCALAPPDATA%\mcp-sbs-peru en Windows, ~/.cache/mcp-sbs-peru en Linux y macOS). Pueden cambiar la carpeta con la variable MCP_SBS_DATOS.

Para

Comando

Actualizar a lo último

uv tool upgrade mcp-sbs-peru y reiniciar Claude Code (los MCP arrancan con la sesión)

Fijar una versión

uv tool install git+https://github.com/rodnm/mcp-sbs-peru@v0.1.0 (cambien el número para pasar a otra). Con una versión fijada, upgrade no la mueve: para volver a lo último, repitan el uv tool install sin @...

Desinstalar

claude mcp remove --scope user sbs y uv tool uninstall mcp-sbs-peru

Desde el código (para el curso o para colaborar)

git clone https://github.com/rodnm/mcp-sbs-peru
cd mcp-sbs-peru
uv run pytest -q -m "not live"     # pruebas sin internet: deben pasar todas
claude                             # acepten los servidores de .mcp.json (sbs y fetch)

Dentro del repositorio, .mcp.json ya conecta sbs (corriendo uv run server.py) y fetch. Para actualizar esta copia: git pull.

Qué trae

Herramienta

Para qué

indicadores

Morosidad, ROE, ROA, solvencia, liquidez y eficiencia de bancos, financieras, cajas municipales, cajas rurales y empresas de créditos

ranking

Créditos, depósitos o patrimonio por entidad, con participación de mercado; para bancos, también por tipo de crédito

afp_comisiones

Comisión sobre el saldo, prima de seguro, aporte y descuento total de cada AFP

afp_valor_cuota

Valor cuota diario por AFP y fondo (0 a 3), con su variación

afp_rentabilidad

Rentabilidad nominal y real, acumulada o anualizada, a 1, 2, 3… años

seguros_ranking

Primas netas por aseguradora: total, por ramo o por riesgo (SOAT, vehículos, vida…)

seguros_indicadores

Solvencia, siniestralidad, ROE, liquidez y gestión de cada aseguradora

listar_reportes, ultimo_periodo, reporte

Encontrar y leer cualquier otro boletín de la SBS, fila por fila

Recurso o prompt

En Claude Code

sbs://reporte/{codigo}

@sbs:sbs://reporte/B-2401: ficha del boletín y su último mes publicado

comparar_entidades

/mcp__sbs__comparar_entidades bancos

comparar_afp

/mcp__sbs__comparar_afp 2

De dónde salen los datos

Tema

Detalle

Fuente

Los boletines estadísticos que la SBS publica en intranet2.sbs.gob.pe/estadistica/financiera/{año}/{Mes}/{CÓDIGO}-{mm}{año}.XLS. Se descargan tal cual y Python hace las cuentas

Rezago

Cada boletín sale después de cerrar el mes: AFP unas 2 semanas, seguros 3, bancos y cajas 4 a 5. Sin periodo, las herramientas usan el último publicado

Unidades

Indicadores en %. Montos en miles de soles, como los muestra el Excel. En los rankings de seguros la celda guarda soles y el Excel muestra miles, así que el servidor divide entre 1000

Cita

«Fuente: SBS», el título y código del boletín, el periodo y la URL del archivo. No encontramos una licencia publicada para estos datos

Límites que conviene saber

  • No incluye las tasas de interés por entidad de Retasas. La SBS solo las publica en www.sbs.gob.pe, que les responde a los programas con un desafío anti-robots. Este servidor no intenta pasarlo. Lo más cercano que publica la SBS por entidad es el indicador «Ingresos financieros anualizados / activo productivo promedio» (indicadores con indicador="rendimiento"). Si necesitan Retasas, lo correcto es pedirle a la SBS un acceso abierto.

  • Uso respetuoso. Un pedido por segundo como máximo, sumando todos los servidores que corran en la máquina (cada sesión de Claude Code levanta uno), y caché en datos/. Si la SBS responde una página web en vez de un Excel, el servidor se detiene y lo dice.

  • Información, no asesoría. Las cifras son las publicadas por la SBS. Elegir AFP, banco o seguro es una decisión de cada uno.

Pruebas y evaluación

uv run pytest -q                                  # todas; las marcadas live bajan los Excel reales de la SBS
uv run evaluar.py --modos memoria web mcp         # 10 preguntas a Claude (Haiku) sin herramientas, con web y con el MCP

preguntas.csv trae, para cada pregunta, la cifra oficial y la celda del Excel donde comprobarla. Los resultados y su análisis están en informe.md.

Origen

Proyecto de la sesión 04, «MCP: Claude conectado a tus datos», del curso Data Science con Python (d2cml-ai/Data-Science-Python). El curso proponía un MCP del BCRP; este repositorio lo lleva a la SBS. evaluar.py y el estilo de las pruebas vienen del proyecto del curso.

Autoría: Rodrigo Norabuena, en coautoría con Claude (Anthropic). El código se publica con licencia MIT. Los datos son de la SBS: cítenla como fuente.

Available Tools

10 tools
afp_comisionesAfp ComisionesA
Read-only

Comisión sobre el saldo, prima de seguro, aporte obligatorio y descuento total de cada AFP, en %.

Úsenla para «¿qué AFP cobra menos?» o «¿cuánto me descuentan del sueldo?». periodo: "AAAA-MM" del devengue; por defecto el último publicado. "columnas" trae el nombre oficial de cada campo.

Inputs: periodo. Returns: object

afp_rentabilidadAfp RentabilidadA
Read-only

Rentabilidad nominal y real (%) de cada AFP para un fondo, a 1, 2, 3... años, según la SBS.

Úsenla para «¿qué AFP rindió más en el fondo 2?» o «rentabilidad real a 10 años del fondo 3». fondo: 0, 1, 2 o 3. tipo: "anualizada" (por año, para comparar plazos) o "acumulada" (total del periodo). plazo: "1 año", "5 años"...; por defecto todos. periodo: "AAAA-MM"; por defecto el último publicado.

Inputs: fondo (required), tipo, plazo, periodo. Returns: object

afp_valor_cuotaAfp Valor CuotaA
Read-only

Valor cuota diario (en soles) de cada AFP para un fondo, y su variación % entre la primera y la última fecha.

Úsenla para «¿cuánto vale la cuota del fondo 2 de Integra?» o «¿cuánto rindió el fondo 1 en setiembre?». fondo: 0, 1, 2 o 3. desde y hasta: "AAAA-MM-DD" (sin hasta, solo ese día; si no fue hábil, el anterior). afp: "Habitat", "Integra", "Prima" o "Profuturo"; por defecto todas. Para rangos de más de tres meses solo baja el primer y el último mes. La SBS publica cada mes unas dos semanas después de que termina.

Inputs: desde (required), fondo (required), afp, hasta. Returns: object

indicadoresIndicadoresA
Read-only

Compara entidades financieras con los indicadores oficiales de la SBS, de mayor a menor.

Úsenla para «¿qué banco tiene menor morosidad?», «ROE de las cajas municipales» o «solvencia de las financieras». tipo_entidad: "bancos", "financieras", "cajas municipales", "cajas rurales" o "empresas de creditos" (antes edpymes). indicador: "morosidad", "roe", "roa", "solvencia", "liquidez", "eficiencia", "rendimiento" (ingresos financieros / activo productivo, lo más parecido a una tasa promedio que publica la SBS por entidad) o palabras del nombre oficial; sin indicador devuelve la lista de indicadores y entidades. periodo: "AAAA-MM"; por defecto el último publicado. Valores en porcentaje salvo que el nombre diga otra cosa; "total" es el del sistema.

Inputs: tipo_entidad (required), periodo, indicador. Returns: object

listar_reportesListar ReportesA
Read-only

Lista los boletines de la SBS que conoce este servidor, con su código y título oficial.

Úsenla cuando ninguna otra herramienta cubre la pregunta, para encontrar el código que luego se lee con reporte. sector: "bancos", "financieras", "cajas municipales", "cajas rurales", "empresas de creditos", "afp" o "seguros". texto: palabras del título, por ejemplo "liquidez", "morosidad" o "afiliados".

Inputs: texto, sector. Returns: result

rankingRankingA
Read-only

Ranking oficial de entidades por tamaño, con monto (miles de soles) y participación de mercado (%).

Úsenla para «¿cuál es el banco más grande?», «participación de las cajas municipales en depósitos» o «quién lidera los créditos a microempresas». tipo_entidad: "bancos", "financieras", "cajas municipales" o "cajas rurales". concepto: "creditos", "depositos" o "patrimonio"; para bancos también un tipo de crédito: "corporativos", "grandes empresas", "medianas empresas", "pequenas empresas", "microempresas", "hipotecarios", "consumo revolvente" o "consumo no revolvente". periodo: "AAAA-MM"; por defecto el último publicado.

Inputs: tipo_entidad (required), limite, periodo, concepto. Returns: object

reporteReporteA
Read-only

Lee cualquier boletín de la SBS fila por fila, con la columna (A, B, C...) de cada celda.

Úsenla cuando ninguna otra herramienta tiene el dato: balances (B-2201), liquidez (B-2340), afiliados AFP (FP-1201) u otro código de listar_reportes. filtro: palabras que debe tener la fila, por ejemplo "disponible" o "BBVA". hoja: nombre de la hoja; por defecto la primera (la respuesta trae la lista). Los valores son los guardados en cada celda: algunos boletines los muestran en miles con el formato del Excel, revisen el título.

Inputs: codigo (required), hoja, filtro, limite, +1 more. Returns: object

seguros_indicadoresSeguros IndicadoresA
Read-only

Indicadores oficiales de cada aseguradora: solvencia, siniestralidad, rentabilidad, liquidez y gestión.

Úsenla para «¿qué aseguradora tiene mayor ROE?» o «siniestralidad de Rímac». indicador: "roe", "roa", "siniestralidad", "liquidez", una sección como "solvencia" o palabras del nombre oficial; sin indicador devuelve la lista disponible. periodo: "AAAA-MM"; por defecto el último publicado.

Inputs: periodo, indicador. Returns: object

seguros_rankingSeguros RankingA
Read-only

Ranking de aseguradoras por primas netas (miles de soles) y participación de mercado (%).

Úsenla para «¿cuál es la aseguradora más grande?» o «¿quién vende más SOAT?». ramo: por defecto el total; también "ramos generales", "ramos de vida" o un riesgo como "soat", "vehiculos", "asistencia medica", "incendio", "terremoto", "vida individual", "vida en grupo", "renta de jubilacion" o "previsionales". periodo: "AAAA-MM" (acumulado del año a ese mes); por defecto el último publicado.

Inputs: ramo, limite, periodo. Returns: object

ultimo_periodoUltimo PeriodoA
Read-only

El último mes que la SBS publicó de un boletín, con la fecha en que lo actualizó y su URL.

Úsenla antes de responder «¿cuál es el dato más reciente?»: la SBS publica con rezago (AFP unas 2 semanas, seguros 3, bancos y cajas 4 a 5). Ejemplo: codigo="B-2401".

Inputs: codigo (required). Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 10 tools

    Disambiguation4/5

    Las herramientas tienen propósitos mayormente distintos y las descripciones aclaran cuándo usar ranking, indicadores, seguros_* o reporte como fallback. Aun así, hay solapamiento potencial entre indicadores/ranking y entre seguros_ranking/seguros_indicadores, que un agente podría confundir sin leer con cuidado.

    Naming Consistency3/5

    Todos los nombres usan snake_case, pero mezclan verbos (listar_reportes), sustantivos sueltos (indicadores, ranking, reporte) y prefijos de dominio (afp_*, seguros_*). La convención es legible pero no uniforme.

    Tool Count5/5

    Diez herramientas parecen bien ajustadas para cubrir reportes, rankings, indicadores, seguros y AFP. Cada herramienta tiene una función clara dentro del dominio y no se observa relleno evidente.

    Completeness4/5

    La superficie cubre listado de boletines, último periodo, rankings, indicadores, AFP, seguros y lectura cruda de reportes, lo que da salida a la mayoría de consultas. Faltan operaciones más directas de series temporales o metadatos, aunque reporte y los parámetros de periodo permiten sortearlas.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Provides 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.
      4
      10 PyPI
      1
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      MCP server for Peruvian public-data lookups including SUNAT RUC registrations, BCRP exchange rates, and SEACE tenders. Provides official open-data access through tools for Claude, Cursor, and other MCP clients.
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables 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.
      7
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables 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.
      20
      MIT