Pricing

Rating

Developer

Actor stats

Categories

Share

BVL Peru MCP Server

Datos financieros completos de la Bolsa de Valores de Lima para Claude, ChatGPT y cualquier asistente compatible con MCP.

Conecta tu asistente de IA a la BVL en 2 minutos. 16 tools para consultar cotizaciones, dividendos, estados financieros, ratios, memorias anuales, hechos de importancia y mucho más — todo desde lenguaje natural, sin abrir el sitio de la BVL.

¿Qué hace BVL Peru MCP Server?

En lugar de navegar bvl.com.pe pestaña por pestaña, le preguntas a tu asistente:

"¿Cuánto cerró Credicorp hoy en la BVL?" "¿Cuál es el ROE de BCP en los últimos 4 años?" "¿Cuándo pagó BCP su último dividendo y cuánto fue?" "Dame las cotizaciones del sector minero peruano." "¿Qué hechos de importancia publicó BCP este mes?" "Compara el rendimiento de Volcan y Alicorp en los últimos 3 años." "Dame la memoria anual 2024 de Alicorp."

El MCP consulta la API oficial de BVL, formatea los datos con métricas calculadas (volatilidad, drawdown, ROI, ratios financieros, etc.) y los devuelve listos para que tu asistente los explique. No necesitas API key de la BVL ni cuenta especial — los datos son públicos.

Una pregunta. Análisis financiero profundo y datos reales.

Quick Start — Conectar en 2 minutos

Paso 1: Obtén tu Apify API Token

Ve a Apify Console → Settings → Integrations y copia tu Personal API token (empieza con apify_api_...).

Si no tienes cuenta, crea una en https://apify.com — el plan Free incluye $5 de crédito mensual, suficiente para miles de consultas.

Paso 2: Conecta el MCP a tu asistente

Pega esta URL en tu cliente MCP, reemplazando TU_TOKEN por el de Paso 1:

https://benevolent-xylographe--bvl-peru-mcp.apify.actor/mcp?token=TU_TOKEN

Paso 3: Pregunta lo que quieras

"Lista los sectores de la Bolsa de Valores de Lima"

Listo. Las 16 tools quedan disponibles automáticamente. Funciona con Claude Code, Claude Desktop, Claude.ai, ChatGPT, Cursor, Windsurf y cualquier cliente compatible con MCP.

Tools disponibles (16)

📈 Cotizaciones y mercado (7 tools)

🏢 Información corporativa (3 tools)

💰 Dividendos y eventos corporativos (2 tools)

📊 Análisis técnico — históricos y métricas (2 tools)

📑 Estados financieros y ratios (2 tools)

¿Qué le puedes preguntar?

Cotizaciones del día

"¿Cuáles son las cotizaciones de hoy en la BVL?" "¿Cuánto está Credicorp ahora?" "Dame el resumen del mercado bursátil peruano."

Por sector

"Muéstrame todas las empresas mineras de la BVL." "Cotizaciones del sector bancario peruano."

Análisis fundamental

"¿Cuál es el ROE histórico de BCP?" "¿Cómo evolucionó el patrimonio de BCP en los últimos años?" "Compará la solvencia de BCP vs Interbank." "¿Qué dice el balance general de BCP del último trimestre?"

Dividendos

"¿Cuándo paga BCP su próximo dividendo?" "¿Tengo derecho a cobrar el dividendo de Credicorp si compro hoy?" "Historial de dividendos de BVN en los últimos 5 años." "¿Cuál es el yield de BCP basado en sus dividendos recientes?"

Análisis técnico

"¿Qué tan volátil ha sido CREDITC1 este año?" "¿Cuál fue el max drawdown de BVN en los últimos 3 años?" "Compará el rendimiento de los 3 bancos peruanos más grandes." "¿En qué día tuvo BCP el mayor volumen de los últimos 30 días?" "Dame el VWAP de CREDITC1 del último mes."

Hechos de importancia y disclosures

"¿Qué publicó BCP en hechos de importancia este mes?" "Dame el último reporte de calificación de riesgo de BCP." "¿BCP anunció M&A recientes?" "Resume los acuerdos del último directorio de BCP."

Memorias y reportes anuales

"Dame la memoria anual 2024 de BCP." "¿Qué reportes de sostenibilidad ESG tiene BCP?" "Analiza el reporte de buen gobierno corporativo de Alicorp." "Compará las memorias 2022 vs 2025 de Credicorp."

Estructura corporativa

"¿Quiénes son los directores de BCP?" "¿Quién es el gerente general de Credicorp?" "¿Quién es el mayor accionista de BCP?" "¿Qué subsidiarias tiene el grupo Credicorp?"

Análisis comparativo

"Compará la rentabilidad de los 3 bancos peruanos más grandes." "¿Cuál de los bancos peruanos tiene mejor ROE?" "¿Quién pagó más dividendos en los últimos 5 años: BCP o BBVA?"

Sectores soportados

Usa estos códigos como parámetro sector en get_quotes_by_sector.

Códigos vs RPJ: ¿cuál uso?

La BVL identifica empresas con DOS códigos distintos:

No te preocupes — el LLM normalmente se autoresuelve: empieza con search o get_market_overview, obtiene el companyCode, luego llama get_company_info para sacar el rpjCode y de ahí accede al resto. Solo necesitas decir el nombre o ticker de la empresa.

Cómo conectar desde cada cliente

Claude.ai (web)

1. https://claude.ai/settings/connectors → Add custom connector
2. URL: https://benevolent-xylographe--bvl-peru-mcp.apify.actor/mcp?token=TU_TOKEN
3. Authentication: None
4. Save

Claude Desktop

Edita el archivo de config:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
"mcpServers":{
"bvl-peru":{
"url":"https://benevolent-xylographe--bvl-peru-mcp.apify.actor/mcp?token=TU_TOKEN",
"transport":"http"
}
}
}

Reinicia Claude Desktop.

Claude Code (CLI)

claude mcp add bvl-peru \
--transport http \
--url"https://benevolent-xylographe--bvl-peru-mcp.apify.actor/mcp?token=TU_TOKEN"

Verifica con claude mcp list. Para evitar prompts de permiso por cada tool:

$claude /permissions

Y agrega mcp__bvl-peru__* al Allow list.

ChatGPT (Plus / Pro / Team / Enterprise)

1. Settings → Connectors → + Add custom connector
2. Name: BVL Peru
3. MCP Server URL: https://benevolent-xylographe--bvl-peru-mcp.apify.actor/mcp?token=TU_TOKEN
4. Authentication: None
5. Save

En cualquier chat, activa BVL Peru desde el ícono de tools.

Cursor IDE

Agrega a .cursor/mcp.json:

{
"mcpServers":{
"bvl-peru":{
"url":"https://benevolent-xylographe--bvl-peru-mcp.apify.actor/mcp?token=TU_TOKEN"
}
}
}

Windsurf

Settings → MCP → Add server con la URL de arriba.

VS Code (GitHub Copilot)

Agrega a .vscode/mcp.json:

{
"servers":{
"bvl-peru":{
"type":"http",
"url":"https://benevolent-xylographe--bvl-peru-mcp.apify.actor/mcp?token=TU_TOKEN"
}
}
}

Cómo funciona

Claude / ChatGPT / Cursor / etc.
|
| MCP (Streamable HTTP)
v
+-----------------------------------+
| BVL Peru MCP Server (Apify)|
| +-----------------------------+ |
||16 tools ||
|| Stateless transport ||
|| Pay-per-event monetization ||
| +-----------------------------+ |
+----------------+------------------+
| HTTPS
v
 dataondemand.bvl.com.pe
(API pública oficial)
|
v
 documents.bvl.com.pe
(PDFs de memorias y hechos)

Decisiones de diseño clave:

• Stateless: cada request es independiente, sin sesiones que se pierdan entre containers.
• Apify Standby: el actor se enciende solo cuando llega tráfico y se apaga después de 5 min sin uso. No pagas por idle.
• Cobro solo en éxito: si la API de BVL falla, no se te cobra el evento.
• Métricas precalculadas: las tools de análisis devuelven valores ya calculados (volatilidad, ROI, drawdown, gap, VWAP) listos para que el LLM no tenga que hacer cuentas.
• Leyendas embebidas: cada respuesta incluye legend explicando qué significa cada campo (tipos de beneficio, códigos HHII, ratios, etc.) para que el LLM no alucine interpretaciones.

Privacidad y seguridad

• ✅ No necesitas cuenta en BVL: usa solo endpoints públicos.
• ✅ No se guarda nada: los datos se consultan en tiempo real, nada persistido.
• ✅ Solo lectura: el actor solo consulta, no escribe nada en BVL.
• ✅ Tu token de Apify: solo lo usas para autenticarte con Apify, no se comparte con BVL ni con el creador del actor.

¿Cuánto cuesta?

Estimación de gasto

El plan Free de Apify regala $5/mes — alcanza para miles de consultas. Empieza sin pagar nada.

Ejemplo de sesión: análisis completo de una empresa

Por menos de 2 centavos de USD, due-diligence completo de una empresa BVL.

Ejemplo de respuesta

Tú: "¿Cómo está BCP financieramente? Dame un análisis completo."

Claude (usando este MCP):

== BANCO DE CREDITO DEL PERU (CREDITC1)==
Sector: Bancos y Financieras (CB)
RUC: B80005
== Cotización actual ==
Precio: S/. 5.995(28/05/2026)
Cambio: +0.50%
High 52w: S/. 6.74
Low 52w: S/. 4.35
== Rendimiento histórico ==
1 año: +37.82%
Volatilidad anual: 28.14%
Max drawdown: 17.23% (15-30 Abr 2026)
Tendencia 30d: -7.11% (corrigiendo)
== Ratios financieros (2025)==
ROE: 49.94% (FUERTEMENTE AL ALZA +24% YoY) → excepcional
Solvencia: 9.37(saludable, en rango bancos)
Deuda/Patrimonio: 6.44(saneando -5.81% YoY)
Valor en libros: 210.57% (creó valor sobre capital aportado)
== Balance Q1 2026==
TOTAL ACTIVO: S/. 212,184 M (+4.41% vs cierre 2025)
TOTAL PASIVO: S/. 188,787 M (+7.32%)
TOTAL PATRIMONIO: S/. 23,397 M (-14.35%, post distribución)
== Próximos dividendos ==
S/. 0.4195 por acción aprobado el 31/03/2026
 ⚠️ Fecha de corte: 17/04/2026 (ya pasó)
 📅 Fecha de pago: 06/05/2026
== Eventos recientes (HHII)==
• 28/05: Informe de calificación de riesgo PCR
• 14/05: EE.FF. mensual a SBS (abril 2026)
• 05/05: Autorización SBS para adquirir Helm Bank USA ★
== Veredicto general ==
BCP en su mejor momento financiero: ROE excepcional, desapalancándose,
expansión internacional con Helm Bank, dividendo creciendo. Corrección
técnica reciente puede ser oportunidad si fundamentals se mantienen.

Una sola pregunta, 7 tools llamadas en cadena, análisis completo en segundos.

Troubleshooting

FAQ

¿Necesito cuenta en la BVL? No. Este MCP usa la API pública de dataondemand.bvl.com.pe. Solo necesitas cuenta en Apify (Free).

¿Funciona con ChatGPT? Sí. Los tools search y fetch están específicamente diseñados para cumplir el formato de OpenAI Custom Connectors.

¿Los datos son en tiempo real? Sí, cada consulta golpea la API de BVL en vivo. El parámetro today: true te da los datos del día actual; false te devuelve la última sesión cerrada.

¿Qué pasa si BVL está caído? El tool devuelve un error legible (ej: "BVL respondió 503"). No se cobra por errores.

¿Puedo analizar PDFs de memorias anuales o hechos de importancia? Sí. get_annual_reports y get_corporate_actions devuelven URLs directas a los PDFs en documents.bvl.com.pe. El LLM puede usar su tool de WebFetch para descargar y analizar el contenido.

¿Hasta qué año tengo histórico de cotizaciones? get_share_history y get_share_candles soportan hasta 5 años hacia atrás. get_company_value (dividendos) y get_annual_reports típicamente desde ~2003.

¿Cómo se calculan las métricas (volatilidad, ROI, drawdown)?

• Volatilidad anualizada: desviación estándar de retornos diarios × √252.
• Max drawdown: máxima caída pico-a-valle en el período.
• ROI: (close_final - close_inicial) / close_inicial.
• VWAP: precio promedio ponderado por volumen.
• Gap: (open - yesterdayClose) / yesterdayClose.

¿Soporta acciones extranjeras listadas en BVL? Sí. La BVL tiene cross-listing de empresas como Apple (AAPL), Adobe (ADBE), Barrick Mining (ABX), etc. Aparecen en get_market_overview y search, pero no tienen estados financieros ni memorias en BVL (esos están en SEC EEUU).

¿Quién hizo este MCP? JB Marfló — soyjb.com. Si tienes feedback, sugerencias o quieres reportar un bug, contáctame por ahí.

Sobre el creador

Hecho con ❤️ por JB Marfló — soyjb.com

Software developer interesado en el cruce entre IA, datos financieros y herramientas para el ecosistema peruano. Si tienes una idea para otro MCP de finanzas/data peruana, escríbeme.

Recursos

• Apify MCP Documentation
• MCP Protocol Specification
• Get your Apify API Token
• Claude.ai
• Claude Desktop
• BVL — sitio oficial
• SMV Perú — regulador de mercado

Categorías: AI, MCP servers, Finance, Latin America, Stock Market, Peru, Financial Analysis, Fundamental Analysis, Technical Analysis, ESG, Corporate Governance