BVL Peru MCP Server

Cotizaciones en tiempo real 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. 7 tools para consultar cotizaciones, sectores, búsquedas y detalles de empresas listadas en la bolsa peruana — todo desde lenguaje natural, sin abrir el sitio de la BVL.

---

¿Qué hace BVL Peru MCP Server?

En lugar de entrar a bvl.com.pe, navegar entre pestañas y buscar empresas a mano, le preguntas a tu asistente:

"¿Cuánto cerró Credicorp hoy en la BVL?" "Dame las cotizaciones del sector minero peruano." "Compara el rendimiento de Volcan y Alicorp esta semana."

El MCP consulta la API pública de BVL, formatea los datos para tu asistente y los devuelve listos para que te 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, buscar empresa	Solo le preguntas a Claude
Cambiar entre pestañas para ver sectores	"Dame las mineras peruanas hoy"
Copiar cotizaciones a una hoja Excel manual	"Dame el resumen del mercado de hoy"
Buscar tickers para encontrar empresas	"¿Qué empresa tiene el ticker AENZAC1?"
Comparar empresas en distintas páginas	"Compara Credicorp y Buenaventura"

Una sola pregunta. Datos en tiempo real desde la BVL.

---

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 7 tools quedan disponibles automáticamente. Funciona con Claude Code, Claude Desktop, Claude.ai, ChatGPT, Cursor, Windsurf y cualquier cliente compatible con MCP.

---

¿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."

"¿Qué hay en el sector agrario hoy?"

Búsqueda y detalle

"Busca empresas que tengan 'volcan' en su nombre."

"Dame el detalle completo de ALICORC1."

"¿Qué información tienes sobre AENZA?"

Análisis comparativo

"Compara el rendimiento de las 3 empresas mineras más importantes."

"¿Cuál de los bancos peruanos subió más hoy?"

---

Tools disponibles

Tool	Descripción	Costo USD
search	Busca empresas por nombre o ticker. Devuelve lista resumida.	$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

---

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ó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)      |
|  +-----------------------------+  |
|  |  7 tools                    |  |
|  |  Stateless transport        |  |
|  |  Pay-per-event monetization |  |
|  +-----------------------------+  |
+----------------+------------------+
                 | HTTPS
                 v
       dataondemand.bvl.com.pe
       (API pública oficial)

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.

---

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 cotizaciones, no escribe nada.
• ✅ 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	Costo	Qué incluye
Free	$0/mes	$5 de crédito gratis, ~5,000 consultas
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

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

Ejemplo de sesión

Consulta	Tool	Costo
"Lista sectores BVL"	list_sectors	$0.0001
"Búscame Credicorp"	search	$0.001
"Detalle de CREDITC1"	fetch	$0.0005
Total		$0.0016

---

Ejemplo de respuesta

Tú: "Dame las cotizaciones del sector bancario peruano hoy."

Claude (usando este MCP):

Sector Bancos y Financieras (CB) — BVL, 6 May 2026

CREDITC1  Credicorp Ltd.            S/. 152.50  (+1.2%)
BAP       Credicorp Ltd. (ADR)      US$ 187.30  (+0.8%)
BBVAC1    BBVA Continental          S/. 4.85    (-0.4%)
SCOTIAC1  Scotiabank Perú           S/. 32.40   (=)
INTERC1   InterBank                 S/. 28.10   (+0.7%)

Top performer: CREDITC1 (+1.2%)
Worst:         BBVAC1 (-0.4%)

---

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	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.
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 usarlo para análisis históricos? Este MCP solo expone cotizaciones actuales/recientes. Para histórico, mira otros endpoints de BVL no incluidos aquí.

¿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.

¿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

---

Categorías: AI, MCP servers, Finance, Latin America, Stock Market, Peru