BCB BR MCP

Banco Central de Brasil (BCB) - MCP

Leer en portugués

Servidor MCP (Model Context Protocol) para los datos de series temporales del Banco Central de Brasil (Banco Central do Brasil, BCB) (SGS/BCB).

Consulta indicadores económicos y financieros como Selic (tasa de interés), IPCA (inflación), tipos de cambio, PIB y más, directamente desde asistentes de IA como Claude.

Si encuentras útil este proyecto, considera darle una estrella en GitHub. ¡Ayuda a que otros descubran el proyecto!

Capacidades: 15 herramientas (skills) · 3 recursos · 3 prompts — todo lo que un cliente MCP necesita para consultar el Banco Central de Brasil: series temporales SGS/BCB, la encuesta de expectativas de mercado Focus y los tipos de cambio PTAX.

Véalo en acción

Pregunte a su asistente, en portugués sencillo:

• "Qual a taxa Selic atual?" → bcb_indicadores_atuais
• "Mostre o IPCA mês a mês em 2024." → bcb_serie_valores
• "Qual foi a variação do dólar nos últimos 12 meses?" → bcb_variacao
• "O que o mercado espera do IPCA em 2027?" → bcb_focus_expectativas
• "Qual a Selic esperada na próxima reunião do Copom?" → bcb_focus_selic
• "Qual foi a PTAX de fechamento do euro na sexta?" → bcb_cambio_cotacao

Las respuestas provienen en vivo de la API SGS del Banco Central de Brasil: cifras exactas con procedencia, no números adivinados a partir de datos de entrenamiento.

Características

• Datos históricos - Consulta valores de series temporales por código con filtros de fecha
• Valores más recientes - Obtén los N valores más recientes de cualquier serie
• Metadatos - Información detallada sobre las series (frecuencia, fuente, etc.)
• Catálogo de series populares - 139 indicadores económicos verificados contra la fuente, organizados por categoría
• Búsqueda inteligente - Encuentra series por palabra clave (insensible a acentos)
• Indicadores actuales - Valores más recientes de los principales indicadores económicos
• Períodos largos, resueltos - La API del BCB limita las series diarias a una ventana de 10 años (HTTP 406) y rechaza ventanas abiertas; las solicitudes se dividen, obtienen y fusionan automáticamente, por lo que una consulta diaria de 15 años simplemente funciona
• Armonización de frecuencia - Remuestrea una serie a mensual, trimestral o anual con una convención explícita, incluida la capitalización geométrica para series que ya son cambios porcentuales (IPCA mensual a IPCA anual)
• Cálculo de variación - Cambio porcentual entre períodos con estadísticas
• Comparación de series - Compara múltiples series en el mismo período, con una advertencia cuando sus periodicidades difieren
• Encuesta Focus - Expectativas de mercado (media, mediana, desviación estándar, mín., máx., encuestados) para IPCA, PIB, FX y más, por horizonte mensual/trimestral/anual o inflación móvil de 12/24 meses, además de Selic por reunión del Copom
• Tipos de cambio PTAX - Cotizaciones oficiales de cierre para cualquier moneda que publique el BCB, un solo día o rango de fechas

Herramientas Disponibles

Herramienta	Descripción
bcb_serie_valores	Consulta valores de series por código y rango de fechas; divide ventanas largas automáticamente y puede armonizar la serie a una frecuencia más gruesa
bcb_serie_ultimos	Obtén los últimos N valores de una serie (cualquier N: se evita el límite de 20 del sistema upstream)
bcb_serie_metadados	Obtén metadatos de la serie (nombre, frecuencia, categoría, último valor)
bcb_series_populares	Lista series populares agrupadas por categoría
bcb_buscar_serie	Busca series por nombre o descripción (insensible a acentos)
bcb_indicadores_atuais	Valores más recientes: Selic, IPCA, USD/BRL, IBC-Br
bcb_variacao	Calcula la variación porcentual entre fechas o los últimos N períodos
bcb_comparar	Compara de 2 a 5 series en el mismo período con clasificación
bcb_focus_expectativas	Expectativas de la encuesta Focus para un indicador, horizonte como parámetro (mensual, trimestral, anual, inflación móvil 12m/24m); indicador top5
bcb_focus_selic	Expectativas Focus para la tasa Selic, por reunión del Copom (formato R1/2026)
bcb_focus_referencias	Qué indicadores y fechas de referencia publica realmente la encuesta Focus, desglosado por alcance (los cinco horizontes más selic, cuyo eje es la reunión del Copom): el conjunto de indicadores difiere según el alcance (9 mensuales frente a 26 anuales)
bcb_cambio_cotacao	Cotización PTAX para una moneda (USD por defecto), un solo día o rango de fechas
bcb_cambio_moedas	Monedas con cotizaciones publicadas por el BCB

Recursos

Catálogos de referencia que el servidor expone como recursos MCP (datos contextuales de solo lectura que los clientes pueden adjuntar):

URI	Descripción
bcb://series/populares	Catálogo de 139 series económicas verificadas del BCB, organizadas por categoría (JSON)
bcb://series/categorias	Lista de categorías disponibles en el catálogo de series (JSON)
bcb://series/principais	Códigos de los indicadores más utilizados: Selic, IPCA, USD/BRL, PIB, etc. (JSON)

Prompts

Plantillas listas para usar que el servidor proporciona como prompts MCP:

Prompt	Descripción
indicadores_atuais	Consulta los principales indicadores económicos de Brasil (Selic, IPCA, USD/BRL, IBC-Br)
panorama_economico	Genera una visión general completa de la economía brasileña
comparar_inflacao	Compara los principales índices de inflación de Brasil (IPCA, IGP-M, INPC) en los últimos 12 meses

Instalación

Mediante Smithery (recomendado)

Visita bcb-br-mcp en Smithery y sigue las instrucciones de instalación para tu cliente MCP.

Mediante URL (Claude.ai, Claude Desktop, cualquier cliente MCP)

Usa el endpoint HTTP directamente, sin necesidad de instalación:

https://bcb.sidneybissoli.com/mcp

El nombre de host heredado https://bcb.sidneybissoli.workers.dev sigue funcionando, al igual que la ruta anterior POST /: los clientes configurados antes de que el endpoint se trasladara a /mcp se reescriben de forma transparente, por lo que nada de lo que funcionaba ha dejado de funcionar. Las nuevas configuraciones deben usar la URL anterior.

Mediante npx (Claude Desktop)

Añade a tu archivo de configuración de Claude Desktop:

Windows: %APPDATA%\Claude\claude_desktop_config.json

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "bcb-br": {
      "command": "npx",
      "args": ["-y", "bcb-br-mcp"]
    }
  }
}

Mediante instalación global

npm install -g bcb-br-mcp

{
  "mcpServers": {
    "bcb-br": {
      "command": "bcb-br-mcp"
    }
  }
}

Ejemplos de uso

Obtener la tasa Selic actual

What is the current Selic interest rate?
→ Uses bcb_indicadores_atuais

Historial del IPCA para 2024

Show me the monthly IPCA for 2024
→ Uses bcb_serie_valores with code 433, dataInicial 2024-01-01, dataFinal 2024-12-31

Listar indicadores de inflación

What inflation series are available?
→ Uses bcb_series_populares with category "Inflação"

Buscar series del tipo de cambio USD

Search for series related to the dollar
→ Uses bcb_buscar_serie with term "dolar" (works without accents)

Calcular la variación USD/BRL

What was the USD/BRL variation over the last 12 months?
→ Uses bcb_variacao with code 1 and periodos 12

Comparar IPCA, IGP-M e INPC

Compare IPCA, IGP-M, and INPC in 2024
→ Uses bcb_comparar with codes [433, 189, 188], dataInicial 2024-01-01, dataFinal 2024-12-31

Catálogo de series (139)

El catálogo curado contiene 139 series, cada una verificada contra la fuente el 2026-08-13.

El campo fonteNome de cada entrada indica de dónde proviene su nombre:

• portal (82 series) — el nombre se transcribe del conjunto de datos de la serie en el Portal de Datos Abiertos del BCB, y unidade lleva la unidad de medida publicada.
• medido (57 series) — la serie no tiene conjunto de datos en el portal, por lo que el nombre se hereda; lo que se verificó contra la fuente es su periodicidad y orden de magnitud.

La periodicidad es siempre la medida (a partir del espaciado entre observaciones), nunca una etiqueta heredada. Las expectativas de mercado no están aquí: usa bcb_focus_expectativas.

Intereses (14)

Código	Nombre	Periodicidad	Fuente del nombre
11	Taxa de juros - Selic	Diaria	portal
432	Taxa de juros - Meta Selic definida pelo Copom	Diaria	portal
1178	Taxa de juros - Selic anualizada base 252	Diaria	portal
4189	Taxa de juros - Selic acumulada no mês anualizada base 252	Mensual	portal
4390	Taxa de juros - Selic acumulada no mês	Mensual	portal
12	Taxa de juros - CDI diária	Diaria	medido
4389	Taxa de juros - CDI anualizada base 252	Diaria	medido
4391	Taxa de juros - CDI acumulada no mês	Mensual	medido
4392	Taxa de juros - CDI acumulada no mês anualizada	Mensual	medido
226	Taxa Referencial (TR) - diária	Diaria	medido
7811	Taxa Referencial (TR) - mensal	Mensual	medido
7812	Taxa Referencial (TR) - anualizada	Mensual	medido
256	Taxa de Juros de Longo Prazo (TJLP)	Mensual	medido
253	Taxa de juros - CDB pré-fixado - 30 dias	Diaria	medido

Inflación (28)

Código	Nombre	Periodicidad	Fuente del nombre
433	IPCA - Variação mensal	Mensual	medido
13522	IPCA - Variação acumulada em 12 meses	Mensual	medido
7478	IPCA-15 - Variação mensal	Mensual	medido
10764	IPCA-E - Variação mensal	Mensual	medido
16121	Índice nacional de preços ao consumidor - Amplo (IPCA) - Núcleo por exclusão - ex2	Mensual	portal
16122	Índice nacional de preços ao consumidor - Amplo (IPCA) - Núcleo de dupla ponderação	Mensual	portal
11426	Índice nacional de preços ao consumidor - Amplo (IPCA) - Núcleo médias aparadas sem suavização	Mensual	portal
11427	Índice nacional de preços ao consumidor - Amplo (IPCA) - Núcleo por exclusão - Sem monitorados e alimentos no domicílio	Mensual	portal
10841	Índice de Preços ao Consumidor-Amplo (IPCA) - Bens não-duráveis	Mensual	portal
10842	Índice de Preços ao Consumidor-Amplo (IPCA) - Bens semi-duráveis	Mensual	portal
10843	Índice de Preços ao Consumidor-Amplo (IPCA) - Duráveis	Mensual	portal
10844	Índice de Preços ao Consumidor-Amplo (IPCA) - Serviços	Mensual	portal
4449	Índice nacional de preços ao consumidor-Amplo (IPCA) - Preços monitorados - Total	Mensual	portal
11428	Índice nacional de preços ao consumidor - Amplo (IPCA) - Itens livres	Mensual	portal
188	INPC - Variação mensal	Mensual	medido
189	IGP-M - Variação mensal	Mensual	medido
7447	IGP-10 - Variação mensal	Mensual	medido
7448	IGP-M - 1ª prévia	Mensual	medido
7449	IGP-M - 2ª prévia	Mensual	medido
190	IGP-DI - Variação mensal	Mensual	medido
7450	IPA-M - Variação mensal	Mensual	medido
225	IPA-DI - Geral - Variação mensal	Mensual	medido
7459	IPA-DI - Produtos industriais	Mensual	medido
7460	IPA-DI - Produtos agrícolas	Mensual	medido
191	IPC-DI - Variação mensal	Mensual	medido
193	IPC-Fipe - Variação mensal	Mensual	medido
17679	IPC-3i - Variação mensal	Mensual	medido
17680	IPC-C1 - Variação mensal	Mensual	medido

Tipos de cambio (13)

Code	Name	Periodicity	Name source
1	Tipo de cambio - Libre - Dólar estadounidense (venta) - diario	Diaria	portal
10813	Tipo de cambio - Libre - Dólar estadounidense (compra)	Diaria	portal
3698	Tipo de cambio - PTAX - Dólar estadounidense (venta)	Mensual	medido
3697	Tipo de cambio - PTAX - Dólar estadounidense (compra)	Mensual	medido
3695	Tipo de cambio - PTAX - Dólar estadounidense (media)	Mensual	medido
21619	Tipo de cambio - Euro (venta)	Diaria	medido
21620	Tipo de cambio - Euro (compra)	Diaria	medido
21623	Tipo de cambio - Libra esterlina (venta)	Diaria	medido
21624	Tipo de cambio - Libra esterlina (compra)	Diaria	medido
21621	Tipo de cambio - Yen (venta)	Diaria	medido
21622	Tipo de cambio - Yen (compra)	Diaria	medido
21625	Tipo de cambio - Franco suizo (venta)	Diaria	medido
21626	Tipo de cambio - Franco suizo (compra)	Diaria	medido

Actividad Económica (21)

Code	Name	Periodicity	Name source
4380	PIB mensual - Valores corrientes (R$ millones)	Mensual	medido
4381	PIB acumulado en el año - Valores corrientes (R$ millones)	Mensual	medido
4382	PIB acumulado de los últimos 12 meses - Valores corrientes (R$ millones)	Mensual	medido
4385	PIB mensual en US$ (millones)	Mensual	medido
4386	PIB acumulado en el año en US$ (millones)	Mensual	medido
7324	PIB anual en US$ (millones)	Anual	medido
24363	Índice de Actividad Económica del Banco Central - IBC-Br	Mensual	portal
24364	Índice de Actividad Económica del Banco Central (IBC-Br) - con ajuste estacional	Mensual	portal
29601	Índice de Actividad Económica del Banco Central (IBC-Br) Agropecuaria	Mensual	portal
29602	Índice de Actividad Económica del Banco Central (IBC-Br) Agropecuaria - con ajuste estacional	Mensual	portal
29603	Índice de Actividad Económica del Banco Central (IBC-Br) Industria	Mensual	portal
29604	Índice de Actividad Económica del Banco Central (IBC-Br) Industria - con ajuste estacional	Mensual	portal
29605	Índice de Actividad Económica del Banco Central (IBC-Br) Servicios	Mensual	portal
29606	Índice de Actividad Económica del Banco Central (IBC-Br) Servicios - con ajuste estacional	Mensual	portal
22103	Exportación de bienes y servicios - Trimestral	Trimestral	medido
22104	Importación de bienes y servicios - Trimestral	Trimestral	medido
22109	Consumo de los hogares - Trimestral	Trimestral	medido
22110	Consumo del gobierno - Trimestral	Trimestral	medido
22111	Formación bruta de capital fijo - Trimestral	Trimestral	medido
21859	Producción industrial - General - Variación mensual	Mensual	medido
21862	Utilización de la capacidad instalada - Industria	Mensual	medido

Empleo (4)

Code	Name	Periodicity	Name source
24369	Tasa de desocupación - PNAD Continua	Mensual	medido
24380	Ingreso medio real habitual - Todos los trabajos	Mensual	medido
24381	Masa de ingreso real habitual	Mensual	medido
28561	CAGED - Saldo de empleos formales	Mensual	medido

Fiscal (7)

Code	Name	Periodicity	Name source
4503	Deuda Líquida del Sector Público (% PIB) - Total - Gobierno Federal y Banco Central	Mensual	portal
4513	Deuda Líquida del Sector Público (% PIB) - Total - Sector público consolidado	Mensual	portal
4505	Deuda Líquida del Sector Público (% PIB) - Total - Banco Central	Mensual	portal
4536	Deuda líquida del gobierno general (% PIB)	Mensual	portal
4537	Deuda bruta del gobierno general (% PIB) - Metodología utilizada hasta 2007	Mensual	portal
5364	Ingreso total del gobierno central	Mensual	medido
5793	NFSP sin desvalorización cambiaria (% PIB) - Flujo acumulado en 12 meses - Resultado primario - Total - Sector público consolidado	Mensual	portal

Sector Externo (12)

Code	Name	Periodicity	Name source
3546	Reservas internacionales - Concepto liquidez - Total	Mensual	medido
13621	Reservas internacionales - Concepto caja - Total - diaria	Diaria	portal
22707	Balanza comercial - Balanza de Pagos - mensual - saldo	Mensual	portal
22708	Exportación de bienes - Balanza de Pagos - mensual	Mensual	portal
22709	Importación de bienes - Balanza de Pagos - mensual	Mensual	portal
22714	Bienes exportados bajo merchanting - exportaciones positivas - mensual	Mensual	portal
22701	Transacciones corrientes - mensual - saldo	Mensual	portal
22704	Balanza comercial y Servicios - mensual - saldo	Mensual	portal
22715	Bienes importados bajo merchanting - exportaciones negativas - mensual	Mensual	portal
22716	Balanza comercial - oro no monetario - Balanza de Pagos - mensual - saldo	Mensual	portal
22846	Renta secundaria - Demás sectores - Transferencias personales - mensual - ingreso	Mensual	portal
22885	Inversiones directas en el país - IDP - mensual - neto	Mensual	portal

Crédito (30)

Code	Name	Periodicity	Name source
20539	Saldo de la cartera de crédito - Total	Mensual	portal
20540	Saldo de la cartera de crédito - Personas jurídicas - Total	Mensual	portal
20541	Saldo de la cartera de crédito - Personas físicas - Total	Mensual	portal
20542	Saldo de la cartera de crédito con recursos libres - Total	Mensual	portal
20570	Saldo de la cartera de crédito con recursos libres - Personas físicas - Total	Mensual	portal
20592	Saldo de la cartera de crédito con recursos libres - Personas físicas - Otros créditos libres	Mensual	portal
20615	Saldo de la cartera de crédito con recursos dirigidos - Personas físicas - Financiamiento agroindustrial con recursos del BNDES	Mensual	portal
20631	Concesiones de crédito - Total	Mensual	portal
20665	Concesiones de crédito con recursos libres - Personas físicas - Cheque especial	Mensual	portal
20714	Tasa media de interés de las operaciones de crédito - Total	Mensual	portal
20716	Tasa media de interés de las operaciones de crédito - Personas físicas - Total	Mensual	portal
20740	Tasa media de interés de las operaciones de crédito con recursos libres - Personas físicas - Total	Mensual	portal
20749	Tasa media de interés de las operaciones de crédito con recursos libres - Personas físicas - Adquisición de vehículos	Mensual	portal
20772	Tasa media de interés de las operaciones de crédito con recursos dirigidos - Personas físicas - Financiamiento inmobiliario con tasas de mercado	Mensual	portal
25497	Tasa media mensual de interés de las operaciones de crédito con recursos dirigidos - Personas físicas - Financiamiento inmobiliario con tasas de mercado	Mensual	portal
20783	Spread medio de las operaciones de crédito - Total	Mensual	portal
20785	Spread medio de las operaciones de crédito - Personas físicas - Total	Mensual	portal
20786	Spread medio de las operaciones de crédito con recursos libres - Total	Mensual	portal
21082	Mora de la cartera de crédito - Total	Mensual	portal
21084	Mora de la cartera de crédito - Personas físicas - Total	Mensual	portal
21085	Mora de la cartera de crédito con recursos libres - Total	Mensual	portal
21128	Mora de la cartera de crédito con recursos libres - Personas físicas - Tarjeta de crédito parcelada	Mensual	portal
21129	Mora de la cartera de crédito con recursos libres - Personas físicas - Tarjeta de crédito total	Mensual	portal
13685	Mora de la cartera de crédito de las instituciones financieras bajo control privado - Total	Mensual	portal
29033	Compromiso de ingreso de los hogares con intereses de la deuda con el Sistema Financiero Nacional - Con ajuste estacional (RNDBF)	Mensual	portal
29034	Compromiso de ingreso de los hogares con el servicio de la deuda con el Sistema Financiero Nacional - Con ajuste estacional (RNDBF)	Mensual	portal
29035	Compromiso de ingreso de los hogares con el servicio de la deuda con el Sistema Financiero Nacional excepto crédito habitacional - Con ajuste estacional (RNDBF)	Mensual	portal
29036	Compromiso de ingreso de los hogares con amortización de la deuda con el Sistema Financiero Nacional - Con ajuste estacional (RNDBF)	Mensual	portal
29037	Endeudamiento de los hogares con el Sistema Financiero Nacional en relación con el ingreso acumulado de los últimos doce meses (RNDBF)	Mensual	portal
29038	Endeudamiento de los hogares con el Sistema Financiero Nacional excepto crédito habitacional en relación con el ingreso acumulado de los últimos 12 meses (RNDBF)	Mensual	portal

Agregados Monetarios (8)

Code	Name	Periodicity	Name source
1788	BM - Base monetaria restringida (saldo a fin de período)	Mensual	portal
1833	Base Monetaria Ampliada (saldo a fin de período)	Mensual	portal
27788	Medios de pago - M1 (promedio de los días hábiles del mes) - Nuevo	Mensual	portal
27789	Medios de pago - Papel moneda en poder del público (saldo a fin de período) - Nuevo	Mensual	portal
27790	Medios de pago - Depósitos a la vista (saldo a fin de período) - Nuevo	Mensual	portal
27791	Medios de pago - M1 (saldo a fin de período) - Nuevo	Mensual	portal
27815	Medios de pago amplios - M4 (saldo a fin de período) - Nuevo	Mensual	portal
7530	Comportamiento monetario - Comportamiento del público - C	Mensual	portal

Ahorro (2)

Code	Name	Periodicity	Name source
25	Depósitos de ahorro hasta 03.05.2012 - Rentabilidad en el período	Diaria	portal
195	Depósitos de ahorro a partir de 04.05.2012 - Rentabilidad en el período	Diaria	portal

El catálogo completo legible por máquina se sirve como el recurso bcb://series/populares y por bcb_series_populares. Miles de series adicionales son accesibles a través de bcb_buscar_serie, que también consulta el índice del Portal de Datos Abiertos del BCB.

Encontrar Otras Series

La base de datos SGS contiene más de 18,000 series de tiempo. Para encontrar códigos de otras series:

1. Visite el BCB SGS Portal
2. Busque la serie deseada
3. Anote el código de la serie
4. Use ese código con las herramientas de este servidor

Detalles Técnicos

Robustez

• Tiempo de espera: 30 segundos por solicitud (evita bloqueos)
• Reintento automático: 3 intentos con retroceso exponencial (1s, 2s, 4s) para fallos transitorios; los errores de cliente (4xx) no se reintentan, ya que son deterministas
• Manejo de errores: Mensajes de error claros

Trabajando con los límites del SGS

Medido contra la API en vivo, no inferido de la documentación:

• Una ventana de fechas de más de 10 años en una serie diaria se rechaza con HTTP 406, y también una ventana abierta (sin dataInicial, o sin fechas en absoluto). El límite se aplica a la ventana implícita: sin dataFinal la API asume hoy. Las solicitudes se dividen en ventanas de hasta 3 años, obtenidas con concurrencia limitada y fusionadas en orden de fechas sin duplicar las uniones; la respuesta lo informa en chunking. El corte es de 3 años en lugar de los 10 permitidos porque una ventana diaria de 10 años cuesta 10–20 s aguas arriba y puede cortarse alrededor de 30 s.
• dados/ultimos/N está limitado a 20 por la API, en todas las periodicidades. Por encima de 20, el servidor infiere la periodicidad de la serie y obtiene los datos por ventana de fechas en su lugar.
• No existe un endpoint de metadatos por serie (/metadados responde 404). La frecuencia se infiere del espaciado de las observaciones y se marca con periodicidadeInferida; la unidad de medida no está disponible de ninguna fuente.

Valores derivados

Cualquier cosa que este servidor calcula — variación, estadísticas descriptivas, series armonizadas — está marcada con derived: true y lleva una nota con las convenciones utilizadas. Las estadísticas provienen de @sbissoli/mcp-stats. Un valor publicado por el BCB siempre se devuelve textualmente; solo los valores calculados se redondean (a 4 decimales).

Búsqueda inteligente

bcb_buscar_serie busca en dos capas: el catálogo curado de 139 series verificadas (que ocupa el primer lugar, con los nombres declarados por la fuente) y el índice del Portal de Datos Abiertos del BCB, con miles de series identificadas por código. Los términos son insensibles a acentos y mayúsculas, y varios términos se combinan con AND:

• "inflacao" → encuentra "Inflação"
• "cambio" → encuentra "Câmbio"
• "ipca servicos" → ambos términos deben coincidir

El índice del portal se sirve desde una caché de 24 horas, renovada por la primera búsqueda después de que expire (una solicitud al portal, solo metadatos — códigos y nombres de series, nunca observaciones). Cada respuesta lleva catalogo.cobertura: el índice no es todo el SGS, por lo que no encontrar una serie aquí no es prueba de que no exista.

Fuente de datos y licencia

Datos obtenidos del Banco Central do Brasil (SGS / Olinda-Expectativas / PTAX), publicados bajo la Open Data Commons Open Database License (ODbL) v1.0 — https://opendatacommons.org/licenses/odbl/1-0/. Re-verificado contra la fuente el 2026-08-13: 4,259 de los 4,260 conjuntos de datos del portal declaran license_id: "odc-odbl". Esto no es CC0, CC BY ni dominio público — ODbL conlleva atribución, compartir-igual (en bases de datos derivadas) y cláusulas anti-DRM. Las respuestas de tipos de cambio pasan por el propio descargo de responsabilidad del BCB textualmente; las paridades entre divisas no son compiladas por el BCB — provienen de una agencia de información (Refinitiv) y son redistribuidas por el BCB, y las herramientas lo indican.

El código del propio servidor es MIT; los datos no lo son. Ver NOTICE.md.

Bloque de procedencia

Cada respuesta exitosa de una herramienta lleva un bloque de procedencia (contrato de portafolio v1.0) en dos canales: structuredContent.provenance + attribution (visible para el modelo) y un espejo _meta bajo br.com.sidneybissoli.bcb/* (fuera de banda, cero tokens). Cada bloque nombra la fuente, la URL canónica que reproduce la consulta, la antigüedad de los datos, el instante real de extracción aguas arriba y la licencia.

Dos detalles que son fáciles de equivocar y que se manejan aquí:

• retrieved_at es el instante real de extracción, no "ahora". El índice del portal se sirve desde una caché de 24 horas, por lo que una búsqueda respondida desde la caché informa el instante en que el índice se obtuvo realmente — que puede tener un día de antigüedad, y es la fecha legalmente relevante.
• Un bloque por procedencia, nunca fusionado. bcb_buscar_serie separa el índice del portal del BCB del catálogo curado del propio servidor; bcb_serie_metadados separa la lectura en vivo del SGS del catálogo; bcb_cambio_cotacao separa las tasas de dólar compiladas por el BCB de las paridades entre divisas de fuentes de agencias.

Desarrollo

Requisitos

• Node.js >= 18.0.0

Configuración

git clone https://github.com/SidneyBissoli/bcb-br-mcp.git
cd bcb-br-mcp
npm install

Compilación

npm run build

Pruebas locales (stdio)

npm run dev

Pruebas locales (worker HTTP)

npm run dev:worker

O use el MCP Inspector:

npx @modelcontextprotocol/inspector npm run dev

API del BCB

Este servidor utiliza la API pública del Banco Central de Brasil:

• Endpoint base: https://api.bcb.gov.br/dados/serie/bcdata.sgs.{code}/dados
• Formato: JSON
• Autenticación: Ninguna (API pública)
• Documentación: BCB Open Data

Registro de cambios

v1.4.1

• bcb_focus_referencias: el parámetro ahora es escopo, no horizonte, y el array de respuesta es escopos. Los alcances son los cinco horizontes de bcb_focus_expectativas más selic — y selic no es un horizonte: su eje es la reunión del Copom. Cada bloque nombra el tool que lo consume. El nombre anterior implicaba que selic era un horizonte consultable de bcb_focus_expectativas, que no lo es. Nunca publicado en npm bajo el nombre anterior.

v1.4.0

• Tres APIs bajo un mismo contrato, 8 herramientas → 13. Encuesta de expectativas de mercado (bcb_focus_expectativas, bcb_focus_selic, bcb_focus_referencias) y tipos de cambio PTAX (bcb_cambio_cotacao, bcb_cambio_moedas), consolidados por parámetro en lugar de reflejar los ~18 recursos OData de la fuente.
• Búsqueda real. bcb_buscar_serie ahora consulta el índice del Portal de Datos Abiertos (más de 3,500 series, caché de 24 horas, solo metadatos) además del catálogo curado, y declara la cobertura del índice en lugar de afirmar que una serie no existe.
• Cada nombre de campo de Focus y PTAX verificado contra la API en vivo, incluido el recurso Top 5 Selic, que publica sus campos en un caso diferente al de los otros doce.
• Obligaciones ODbL incluidas con las herramientas de tipos de cambio: el descargo de responsabilidad del BCB se transmite textualmente, y las paridades que no son USD se califican como datos de terceros (Refinitiv) redistribuidos por el BCB.

v1.2.0

• Endpoint HTTP vía Cloudflare Workers (https://bcb.sidneybissoli.workers.dev)
• Publicado en Smithery.ai
• Refactorizado: la lógica de las herramientas se extrajo a src/tools.ts (compartida entre stdio y HTTP)

v1.1.0

• Nueva herramienta bcb_variacao para cálculo de variación porcentual
• Nueva herramienta bcb_comparar para comparar múltiples series
• Tiempo de espera de 30 segundos en las solicitudes
• Reintento automático con retroceso exponencial (3 intentos)
• Búsqueda normalizada (insensible a acentos)
• Estadísticas adicionales (máximo, mínimo, promedio, rango)

v1.0.0

• Lanzamiento inicial
• 6 herramientas básicas
• Catálogo con 139 series verificadas

Contribuciones

¡Las contribuciones son bienvenidas! Por favor:

1. Haga un fork del repositorio
2. Cree una rama de características (git checkout -b feature/new-feature)
3. Confirme sus cambios (git commit -m 'Add new feature')
4. Haga push a la rama (git push origin feature/new-feature)
5. Abra un Pull Request

Licencia

MIT - ver LICENSE para más detalles.

Autor

Sidney da Silva Pereira Bissoli

• GitHub: @SidneyBissoli
• Email: sbissoli76@gmail.com

Enlaces útiles

• BCB SGS Portal
• BCB Open Data
• Model Context Protocol
• MCP Registry
• Smithery: bcb-br-mcp
• npm: bcb-br-mcp