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.

Sin MCP	Con BVL Peru MCP
Abrir bvl.com.pe, navegar entre pestañas	Solo le preguntas a Claude
Cambiar entre vistas para ver sectores	"Dame las mineras peruanas hoy"
Descargar Excel para calcular ratios	"¿Cuál es la liquidez histórica de BCP?"
Buscar PDFs de memorias anuales	"Dame la memoria 2024 de Credicorp"
Calcular volatilidad y drawdown manual	"¿Qué tan volátil fue CREDITC1 este año?"
Buscar fechas de corte de dividendos	"¿Cuándo cobro el próximo dividendo de BCP?"
Leer hechos de importancia uno por uno	"Resume los hechos de importancia de BCP del mes"

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)

Tool	Descripción	Costo USD
search	Busca empresas por nombre o ticker. Devuelve resultados con id, title, text y url.	$0.001
fetch	Detalle completo de una empresa por su ticker (ej: CREDITC1).	$0.0005
list_sectors	Lista los 9 sectores de la BVL con sus códigos.	$0.0001
get_market_overview	Resumen completo del mercado (todas las cotizaciones).	$0.002
get_quotes_by_sector	Cotizaciones filtradas por sector específico.	$0.001
search_companies	Búsqueda nativa de la API BVL (alternativa a search).	$0.001
get_company_quote	Cotización por código BVL numérico exacto.	$0.0005

🏢 Información corporativa (3 tools)

Tool	Descripción	Costo USD
get_company_info	Ficha corporativa completa: razón social, RUC, dirección, fundación, composición accionaria, directorio y gerencia.	$0.002
get_issuer_affiliates	Estructura del grupo económico: subsidiarias y consolidadores.	$0.0005
get_annual_reports	Memorias anuales, reportes ESG, gobierno corporativo y grupo económico con URLs descargables a los PDFs.	$0.001

💰 Dividendos y eventos corporativos (2 tools)

Tool	Descripción	Costo USD
get_company_value	Historial de dividendos (efectivo y acción liberada) con fechas de corte/entrega + última cotización.	$0.002
get_corporate_actions	Hechos de Importancia (disclosures regulatorios): reportes, M&A, calificación de riesgo, etc, con URLs a PDFs.	$0.001

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

Tool	Descripción	Costo USD
get_share_history	Precios cierre diarios para 1-20 tickers en hasta 5 años + métricas (variación, volatilidad, drawdown, tendencia).	$0.002
get_share_candles	Velas OHLCV + volumen (PEN/USD/acciones) para 1 ticker + métricas avanzadas (VWAP, gaps, días alcistas, etc.).	$0.002

📑 Estados financieros y ratios (2 tools)

Tool	Descripción	Costo USD
get_financial_statements	Balance General, Estado de Resultados, Cambios en Patrimonio o Flujos de Efectivo parseados por sección con totales y cambio % vs período anterior.	$0.002
get_financial_ratios	Ratios oficiales por año: Liquidez, Solvencia, Deuda/Patrimonio, ROE, Rentabilidad, Valor en libros — con interpretación y tendencia YoY.	$0.001

---

¿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

Código	Descripción
CB	Bancos y financieras
CM	Mineras
CI	Industriales
CP	Servicios públicos
CG	Agrario
CD	Diversas
CS	Seguros
CA	Administradoras de fondos de pensiones (AFP)
FI	Fondos de inversión

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:

Código	Formato	Para qué tools sirve
companyCode	Numérico (ej: 12000 para BCP)	get_company_info, get_company_value, get_annual_reports, get_company_quote
rpjCode	Alfanumérico (ej: B80005 para BCP)	get_corporate_actions, get_financial_statements, get_financial_ratios, get_issuer_affiliates
nemonico (ticker)	Alfanumérico (ej: CREDITC1)	get_share_history, get_share_candles, fetch

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?

Plan Apify	Costo	Qué incluye
Free	$0/mes	$5 de crédito gratis, ~3,000-5,000 consultas mixtas
Starter	$49/mes	Para uso intensivo o producción
Pay-per-event	$0.0001 – $0.002 por consulta	Solo pagas cuando se ejecuta una tool con éxito

Estimación de gasto

Uso	Costo mensual estimado
Inversor casual (5 consultas/día)	~$0.20
Trader activo (50 consultas/día)	~$2
Análisis intensivo (200+ consultas/día)	~$8–15
Análisis fundamental profundo de 50 empresas (1 vez)	~$3–5

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

Consulta	Tool	Costo
"Búscame BCP"	search	$0.001
"Detalle de BCP"	get_company_info	$0.002
"Ratios financieros históricos"	get_financial_ratios	$0.001
"Balance general Q1 2026"	get_financial_statements	$0.002
"Dividendos de los últimos 5 años"	get_company_value	$0.002
"Hechos de importancia del mes"	get_corporate_actions	$0.001
"Performance del último año + métricas"	get_share_candles	$0.002
Análisis full de BCP	7 tools	$0.011

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

Problema	Solución
"Tools no aparecen"	Verifica que la URL incluya /mcp y que el token sea válido.
"Connection timeout" en primer uso	Cold start de Apify (~2-5 seg). Reintenta.
"Server not initialized"	Tu cliente MCP no está siguiendo el handshake. Reconecta el MCP.
Resultados vacíos en cotizaciones	La BVL no tiene cotizaciones del día (fin de semana o feriado peruano). Prueba con today: false para ver la última cotización disponible.
"No encontré la empresa con rpjCode XXX"	Asegúrate que el rpjCode empieza con letra (ej: B80005). El companyCode es numérico (12000). Usa get_company_info para resolver de uno a otro.
Análisis comparativo de muchas empresas sin datos	Algunos tickers extranjeros cross-listed (Apple, Adobe) no tienen EE.FF. en BVL. Limita la comparación a empresas peruanas.
Error 401 / "access denied"	Tu token de Apify expiró o fue revocado. Genera uno nuevo en Apify Console.

---

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