mcp-bcentral-chile

MCP server para la Base de Datos Estadísticos (BDE) del Banco Central de Chile (sistema SIETE): UF, UTM, IPC, TPM, tipo de cambio, IMACEC, PIB y miles de series económicas. Libre, gratuito y open-source.

Qué cubre

• Series de tiempo de la API oficial del BCCh (si3.bcentral.cl/SieteRestWS): hasta 30 series por consulta, con rango de períodos (AAAA, AAAA-MM o AAAA-MM-DD según la frecuencia).
• Metadatos oficiales de cada serie (descripción, frecuencia, unidad) para verificar que un código existe.
• Catálogo local de las series más usadas (UF, UTM, USD, EUR, IPC, TPM, IMACEC, PIB, desempleo…).

Herramientas

Tool	Qué hace
bcentral_serie_datos	Observaciones de 1 a 30 series en un rango (JSON estructurado + tabla Markdown)
bcentral_serie_info	Descripción oficial, frecuencia y última observación de una serie
bcentral_series_populares	Catálogo local de series más usadas (sin red ni clave)

Conexión

Cloudflare (recomendado):

https://bcentral-mcp.kumocloud.cl/mcp

Requiere configurar la clave privada del API BDE en el Worker:

npx wrangler secret put BCENTRAL_API_KEY

Cómo obtener esa clave (es un proceso de 3 pasos):

1. Regístrate con usuario y contraseña en https://si3.bcentral.cl/Siete/es/Siete/API (sección Registrarse).
2. Inicia sesión — el propio sitio dice: "Para activar las credenciales debe iniciar sesión". Las credenciales del API se activan al entrar.
3. Dentro del portal, copia tu clave privada (la cadena alfanumérica que el sitio te muestra para el Web Service — no es tu contraseña). Esa cadena es BCENTRAL_API_KEY.

Local (STDIO):

set BCENTRAL_API_KEY=tu_clave
npm run build
npm start

Ejemplos

• bcentral_serie_datos con timeseries: "UF", first: "2024-01-01", last: "2024-12-31" → la UF de todo el año.
• bcentral_serie_datos con timeseries: "UF,UTM,IPC,TPM" → indicadores juntos.
• bcentral_serie_info con timeseries: "IMACEC" → verificar que el código existe y qué mide.

Límites y notas

• Máximo 30 series por consulta (límite oficial del BCCh). El error te dice cuándo dividir.
• Los períodos se expresan en el formato de frecuencia de la serie: 2024 (anual), 2024-01 (mensual), 2024-01-15 (diaria).
• Si una serie no devuelve observaciones, verifica el código con bcentral_serie_info; el catálogo completo se busca en si3.bcentral.cl/Siete/es/Siete/Series.
• El servidor cachea las respuestas 15 minutos y limita el ritmo de consultas para no abusar del BCCh.

Desarrollar

npm install
npm test        # tests unitarios sin red
npm run build   # tsc
npm run verify  # verificación contra la API real (requiere BCENTRAL_API_KEY en el entorno)
npm run deploy  # wrangler deploy

Licencia

MIT — los datos pertenecen al Banco Central de Chile; el código de este servidor es libre.