BCB BR MCP

Servidor MCP para dados econômicos do Banco Central do Brasil (BCB) — Selic, IPCA, taxas de câmbio, PIB e mais de 150 séries temporais para agentes de IA.

GitHub

Prueba este MCPPatrocinado

Documentación

Banco Central do Brasil (BCB) — Servidor MCP de Séries Temporais SGS

Leia em Português

Servidor MCP (Model Context Protocol) para o Banco Central do Brasil (BCB): séries temporais SGS (SGS/BCB), a pesquisa de expectativas de mercado Focus (servida pela API OData Olinda) e taxas de câmbio PTAX.

Consulte indicadores econômicos e financeiros como Selic (taxa de juros), IPCA (inflação), taxas de câmbio, PIB e muito mais, diretamente de assistentes de IA como Claude.

Se você achar este projeto útil, considere dar uma estrela no GitHub. Isso ajuda outras pessoas a descobrirem o projeto!

Recursos: 17 ferramentas (habilidades) · 3 recursos · 3 prompts — tudo o que um cliente MCP precisa para consultar o Banco Central do Brasil: séries temporais SGS/BCB, a pesquisa de expectativas de mercado Focus e taxas de câmbio PTAX.

Veja em ação

Pergunte ao seu assistente, em português simples:

"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

As respostas vêm ao vivo da API SGS do Banco Central do Brasil — números exatos com procedência, não valores adivinhados a partir de dados de treinamento.

Recursos

Dados históricos - Consulte valores de séries temporais por código com filtros de data
Valores mais recentes - Obtenha os N valores mais recentes de qualquer série
Metadados - Informações detalhadas sobre as séries (frequência, fonte, etc.)
Catálogo de séries populares - 135 indicadores econômicos verificados junto à fonte, organizados por categoria
Busca inteligente - Encontre séries por palavra-chave (insensível a acentos)
Indicadores atuais - Valores mais recentes para os principais indicadores econômicos
Períodos longos, tratados - A API do BCB limita séries diárias a uma janela de 10 anos (HTTP 406) e recusa janelas abertas; as solicitações são fatiadas, buscadas e mescladas automaticamente, então uma consulta diária de 15 anos simplesmente funciona
Harmonização de frequência - Reamostre uma série para mensal, trimestral ou anual com uma convenção explícita, incluindo composição geométrica para séries que já são variações percentuais (IPCA mensal em IPCA anual)
Cálculo de variação - Variação percentual entre períodos com estatísticas
Comparação de séries - Compare múltiplas séries no mesmo período, com um aviso quando suas periodicidades diferem
Pesquisa Focus - Expectativas de mercado (média, mediana, desvio padrão, mínimo, máximo, respondentes) para IPCA, PIB, câmbio e mais, por horizonte mensal/trimestral/anual ou inflação móvel de 12/24 meses, além da Selic por reunião do Copom
Taxas de câmbio PTAX - Cotações oficiais de fechamento para qualquer moeda que o BCB publique, em um único dia ou intervalo de datas

📖 Artigo (em português): Séries do Banco Central: como consultar o SGS, a Focus e a PTAX sem cair nas armadilhas — os três limites da API medidos ao vivo, séries de nível vs. taxa, os escopos da Focus e o que a ODbL exige. Também publicado no site, em português e inglês: sidneybissoli.com.

Ferramentas Disponíveis

Ferramenta	Descrição
`bcb_serie_valores`	Consulte valores de séries por código e intervalo de datas; fatia janelas longas automaticamente e pode harmonizar a série para uma frequência mais grossa
`bcb_serie_ultimos`	Obtenha os últimos N valores de uma série (qualquer N — o limite upstream de 20 é contornado)
`bcb_serie_metadados`	Obtenha metadados da série (nome, frequência, categoria, último valor)
`bcb_series_populares`	Liste séries populares agrupadas por categoria
`bcb_buscar_serie`	Busque séries por nome ou descrição (insensível a acentos, E entre palavras; palavras comuns resolvidas para a redação do BCB, e a resposta informa isso)
`bcb_indicadores_atuais`	Valores mais recentes: Selic, IPCA, USD/BRL, IBC-Br
`bcb_variacao`	Variação percentual de uma série em um período: variação de nível para séries de nível, acumulação composta para séries que já são taxas período a período (IPCA, IGP-M, INPC…); `analise.metodo` informa qual
`bcb_comparar`	Compare 2 a 5 séries no mesmo período com classificação (mesma regra de nível/composição por série, declarada em `metodo`)
`bcb_focus_expectativas`	Expectativas da pesquisa Focus para um indicador, horizonte como parâmetro (mensal, trimestral, anual, inflação móvel de 12m/24m); flag `top5`
`bcb_focus_selic`	Expectativas da Focus para a taxa Selic, por reunião do Copom (formato R1/2026)
`bcb_focus_referencias`	Quais indicadores e datas de referência a pesquisa Focus realmente publica, detalhados por escopo (os cinco horizontes mais `selic`, cujo eixo é a reunião do Copom) — o conjunto de indicadores difere por escopo (9 mensais vs 26 anuais)
`bcb_cambio_cotacao`	Cotação PTAX para uma moeda (USD por padrão), em um único dia ou intervalo de datas
`bcb_cambio_moedas`	Moedas com cotações publicadas pelo BCB
`search`	Contrato OpenAI Deep Research: busca no catálogo de séries (curado + índice do portal de dados abertos) e retorna `{ id, title, url }` — veja ChatGPT (Deep Research)
`fetch`	Contrato OpenAI Deep Research: retorna uma série como documento legível com sua URL pública canônica

Recursos

Catálogos de referência que o servidor expõe como recursos MCP (dados contextuais somente leitura que os clientes podem anexar):

URI	Descrição
`bcb://series/populares`	Catálogo de 135 séries econômicas verificadas do BCB, organizado por categoria (JSON)
`bcb://series/categorias`	Lista de categorias disponíveis no catálogo de séries (JSON)
`bcb://series/principais`	Códigos dos indicadores mais usados — Selic, IPCA, USD/BRL, PIB, etc. (JSON)

Prompts

Modelos prontos que o servidor fornece como prompts MCP:

Prompt	Descrição
`indicadores_atuais`	Consulte os principais indicadores econômicos do Brasil (Selic, IPCA, USD/BRL, IBC-Br)
`panorama_economico`	Gere uma visão geral completa da economia brasileira
`comparar_inflacao`	Compare os principais índices de inflação do Brasil (IPCA, IGP-M, INPC) nos últimos 12 meses

Instalação

Via Smithery (recomendado)

Visite bcb-br-mcp no Smithery e siga as instruções de instalação para o seu cliente MCP.

Via URL (Claude.ai, Claude Desktop, qualquer cliente MCP)

Use o endpoint HTTP diretamente, sem necessidade de instalação:

https://bcb.sidneybissoli.com/mcp

O hostname legado https://bcb.sidneybissoli.workers.dev continua funcionando, assim como a rota mais antiga POST / — clientes configurados antes do endpoint mudar para /mcp são reescritos de forma transparente, então nada que funcionava parou de funcionar. Novas configurações devem usar a URL acima.

Via npx (Claude Desktop)

Adicione ao seu arquivo de configuração do 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"]
    }
  }
}

Via instalação global

npm install -g bcb-br-mcp

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

ChatGPT (Deep Research)

O deep research do ChatGPT (e conhecimento da empresa, e fluxos de trabalho de pesquisa via Responses API) só usa um servidor MCP que exponha exatamente search e fetch — este servidor expõe, além das bcb_* ferramentas. Aponte o conector para o endpoint hospedado, sem necessidade de chave:

https://bcb.sidneybissoli.com/mcp

search classifica a consulta contra o catálogo de séries — as 135 séries curadas mais as milhares indexadas do Portal de Dados Abertos — e retorna { id, title, url } (os ids são sgs:<code>); fetch retorna a série como Markdown legível (nome, categoria, frequência, unidade, último valor) com a URL pública canônica, que é o que o ChatGPT cita: a página do conjunto de dados em dadosabertos.bcb.gov.br quando a série tem uma, caso contrário a consulta pública SGS para suas observações mais recentes (o SGS não tem página por série). Ambos carregam o mesmo bloco de procedência que todas as outras ferramentas. No modo desenvolvedor do ChatGPT (Configurações → Segurança e login → Modo desenvolvedor), qualquer ferramenta é chamável — as ferramentas bcb_* continuam sendo as recomendadas para dados.

Exemplos de Uso

Obtenha a taxa Selic atual

What is the current Selic interest rate?
→ Uses bcb_indicadores_atuais

Histórico do 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

Liste indicadores de inflação

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

Busque séries de taxa de câmbio USD

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

Calcule a variação USD/BRL

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

Compare 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 Séries (135)

O catálogo curado contém 135 séries, cada uma verificada junto à fonte em 2026-08-13 (4 séries descontinuadas da FGV foram removidas em 2026-08-23).

O campo fonteNome em cada entrada informa de onde vem seu nome:

portal (82 séries) — o nome é transcrito do conjunto de dados da série no Portal de Dados Abertos do BCB, e unidade carrega a unidade de medida publicada.
medido (53 séries) — a série não tem conjunto de dados no portal, então o nome é herdado; o que foi verificado junto à fonte é sua periodicidade e ordem de grandeza.

A periodicidade é sempre a medida (a partir do espaçamento entre observações), nunca um rótulo herdado. Expectativas de mercado não estão aqui — use bcb_focus_expectativas.

Juros (14)

Código	Nome	Periodicidade	Fonte do nome
11	Taxa de juros - Selic	Diária	`portal`
432	Taxa de juros - Meta Selic definida pelo Copom	Diária	`portal`
1178	Taxa de juros - Selic anualizada base 252	Diária	`portal`
4189	Taxa de juros - Selic acumulada no mês anualizada base 252	Mensal	`portal`
4390	Taxa de juros - Selic acumulada no mês	Mensal	`portal`
12	Taxa de juros - CDI diária	Diária	`medido`
4389	Taxa de juros - CDI anualizada base 252	Diária	`medido`
4391	Taxa de juros - CDI acumulada no mês	Mensal	`medido`
4392	Taxa de juros - CDI acumulada no mês anualizada	Mensal	`medido`
226	Taxa Referencial (TR) - diária	Diária	`medido`
7811	Taxa Referencial (TR) - mensal	Mensal	`medido`
7812	Taxa Referencial (TR) - anualizada	Mensal	`medido`
256	Taxa de Juros de Longo Prazo (TJLP)	Mensal	`medido`
253	Taxa de juros - CDB pré-fixado - 30 dias	Diária	`medido`

Inflação (28)

Código	Nombre	Periodicidad	Fuente del nombre
433	IPCA - Variación mensual	Mensual	`medido`
13522	IPCA - Variación acumulada en 12 meses	Mensual	`medido`
7478	IPCA-15 - Variación mensual	Mensual	`medido`
10764	IPCA-E - Variación mensual	Mensual	`medido`
16121	Índice nacional de precios al consumidor - Amplio (IPCA) - Núcleo por exclusión - ex2	Mensual	`portal`
16122	Índice nacional de precios al consumidor - Amplio (IPCA) - Núcleo de doble ponderación	Mensual	`portal`
11426	Índice nacional de precios al consumidor - Amplio (IPCA) - Núcleo de medias recortadas sin suavización	Mensual	`portal`
11427	Índice nacional de precios al consumidor - Amplio (IPCA) - Núcleo por exclusión - Sin monitoreados y alimentos en el domicilio	Mensual	`portal`
10841	Índice de Precios al Consumidor-Amplio (IPCA) - Bienes no duraderos	Mensual	`portal`
10842	Índice de Precios al Consumidor-Amplio (IPCA) - Bienes semiduraderos	Mensual	`portal`
10843	Índice de Precios al Consumidor-Amplio (IPCA) - Duraderos	Mensual	`portal`
10844	Índice de Precios al Consumidor-Amplio (IPCA) - Servicios	Mensual	`portal`
4449	Índice nacional de precios al consumidor-Amplio (IPCA) - Precios monitoreados - Total	Mensual	`portal`
11428	Índice nacional de precios al consumidor - Amplio (IPCA) - Artículos libres	Mensual	`portal`
188	INPC - Variación mensual	Mensual	`medido`
189	IGP-M - Variación mensual	Mensual	`medido`
7447	IGP-10 - Variación mensual	Mensual	`medido`
7448	IGP-M - 1ª previsión	Mensual	`medido`
7449	IGP-M - 2ª previsión	Mensual	`medido`
190	IGP-DI - Variación mensual	Mensual	`medido`
7450	IPA-M - Variación mensual	Mensual	`medido`
225	IPA-DI - General - Variación mensual	Mensual	`medido`
7459	IPA-DI - Productos industriales	Mensual	`medido`
7460	IPA-DI - Productos agrícolas	Mensual	`medido`
191	IPC-DI - Variación mensual	Mensual	`medido`
193	IPC-Fipe - Variación mensual	Mensual	`medido`
17679	IPC-3i - Variación mensual	Mensual	`medido`
17680	IPC-C1 - Variación mensual	Mensual	`medido`

Tipo de cambio (13)

Código	Nombre	Periodicidad	Fuente del nombre
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 (promedio)	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)

Código	Nombre	Periodicidad	Fuente del nombre
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)

Código	Nombre	Periodicidad	Fuente del nombre
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)

Código	Nombre	Periodicidad	Fuente del nombre
4503	Deuda Neta del Sector Público (% PIB) - Total - Gobierno Federal y Banco Central	Mensual	`portal`
4513	Deuda Neta del Sector Público (% PIB) - Total - Sector público consolidado	Mensual	`portal`
4505	Deuda Neta del Sector Público (% PIB) - Total - Banco Central	Mensual	`portal`
4536	Deuda neta 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)

Código	Nombre	Periodicidad	Fuente del nombre
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)

Código	Nome	Periodicidade	Fonte do nome
20539	Saldo da carteira de crédito - Total	Mensal	`portal`
20540	Saldo da carteira de crédito - Pessoas jurídicas - Total	Mensal	`portal`
20541	Saldo da carteira de crédito - Pessoas físicas - Total	Mensal	`portal`
20542	Saldo da carteira de crédito com recursos livres - Total	Mensal	`portal`
20570	Saldo da carteira de crédito com recursos livres - Pessoas físicas - Total	Mensal	`portal`
20592	Saldo da carteira de crédito com recursos livres - Pessoas físicas - Outros créditos livres	Mensal	`portal`
20615	Saldo da carteira de crédito com recursos direcionados - Pessoas físicas - Financiamento agroindustrial com recursos do BNDES	Mensal	`portal`
20631	Concessões de crédito - Total	Mensal	`portal`
20665	Concessões de crédito com recursos livres - Pessoas físicas - Cheque especial	Mensal	`portal`
20714	Taxa média de juros das operações de crédito - Total	Mensal	`portal`
20716	Taxa média de juros das operações de crédito - Pessoas físicas - Total	Mensal	`portal`
20740	Taxa média de juros das operações de crédito com recursos livres - Pessoas físicas - Total	Mensal	`portal`
20749	Taxa média de juros das operações de crédito com recursos livres - Pessoas físicas - Aquisição de veículos	Mensal	`portal`
20772	Taxa média de juros das operações de crédito com recursos direcionados - Pessoas físicas - Financiamento imobiliário com taxas de mercado	Mensal	`portal`
25497	Taxa média mensal de juros das operações de crédito com recursos direcionados - Pessoas físicas - Financiamento imobiliário com taxas de mercado	Mensal	`portal`
20783	Spread médio das operações de crédito - Total	Mensal	`portal`
20785	Spread médio das operações de crédito - Pessoas físicas - Total	Mensal	`portal`
20786	Spread médio das operações de crédito com recursos livres - Total	Mensal	`portal`
21082	Inadimplência da carteira de crédito - Total	Mensal	`portal`
21084	Inadimplência da carteira de crédito - Pessoas físicas - Total	Mensal	`portal`
21085	Inadimplência da carteira de crédito com recursos livres - Total	Mensal	`portal`
21128	Inadimplência da carteira de crédito com recursos livres - Pessoas físicas - Cartão de crédito parcelado	Mensal	`portal`
21129	Inadimplência da carteira de crédito com recursos livres - Pessoas físicas - Cartão de crédito total	Mensal	`portal`
13685	Inadimplência da carteira de crédito das instituições financeiras sob controle privado - Total	Mensal	`portal`
29033	Comprometimento de renda das famílias com juros da dívida com o Sistema Financeiro Nacional - Com ajuste sazonal (RNDBF)	Mensal	`portal`
29034	Comprometimento de renda das famílias com o serviço da dívida com o Sistema Financeiro Nacional - Com ajuste sazonal (RNDBF)	Mensal	`portal`
29035	Comprometimento de renda das famílias com o serviço da dívida com o Sistema Financeiro Nacional exceto crédito habitacional - Com ajuste sazonal (RNDBF)	Mensal	`portal`
29036	Comprometimento de renda das famílias com amortização da dívida com o Sistema Financeiro Nacional - Com ajuste sazonal (RNDBF)	Mensal	`portal`
29037	Endividamento das famílias com o Sistema Financeiro Nacional em relação à renda acumulada dos últimos doze meses (RNDBF)	Mensal	`portal`
29038	Endividamento das famílias com o Sistema Financeiro Nacional exceto crédito habitacional em relação à renda acumulada dos últimos 12 meses (RNDBF)	Mensal	`portal`

Agregados Monetários (8)

Código	Nome	Periodicidade	Fonte do nome
1788	BM - Base monetária restrita (saldo em final de período)	Mensal	`portal`
1833	Base Monetária Ampliada (saldo em final de período)	Mensal	`portal`
27788	Meios de pagamento - M1 (média dos dias úteis do mês) - Novo	Mensal	`portal`
27789	Meios de pagamento - Papel moeda em poder do público (saldo em final de período) - Novo	Mensal	`portal`
27790	Meios de pagamento - Depósitos à vista (saldo em final de período) - Novo	Mensal	`portal`
27791	Meios de pagamento - M1 (saldo em final de período) - Novo	Mensal	`portal`
27815	Meios de pagamento amplos - M4 (saldo em final de periodo) - Novo	Mensal	`portal`
7530	Comportamento monetário - Comportamento do público - C	Mensal	`portal`

Poupança (2)

Código	Nome	Periodicidade	Fonte do nome
25	Depósitos de poupança até 03.05.2012 - Rentabilidade no período	Diária	`portal`
195	Depósitos de poupança a partir de 04.05.2012 - Rentabilidade no período	Diária	`portal`

O catálogo completo legível por máquina é servido como o recurso bcb://series/populares e por bcb_series_populares. Milhares de outras séries são acessíveis através de bcb_buscar_serie, que também consulta o índice do Portal de Dados Abertos do BCB.

Encontrando Outras Séries

O banco de dados SGS contém mais de 18.000 séries temporais. Para encontrar códigos de outras séries:

Visite o Portal SGS do BCB
Pesquise a série desejada
Anote o código da série
Use esse código com as ferramentas deste servidor

Pergunte com suas palavras, não as do BCB

bcb_buscar_serie corresponde às suas palavras, todas elas (E), contra o catálogo curado (135 séries: nome e categoria) e os slugs de conjuntos de dados do portal de dados abertos do BCB (3.579 séries identificadas por código). Acentos já eram ignorados; a palavra não era. Medido em ambas as camadas em 2026-09-16, corrigido desde 1.12.0: a palavra cotidiana é expandida para a do próprio BCB, e a resposta informa isso em notasVocabulario; resultados zero vêm com uma saída.

você pergunta	resultados antes (curado / portal)	o BCB escreve	resultados
`déficit`, `superávit`	0 / 0	resultado primário, resultado nominal	1 / 26, 0 / 22
`calote`	0 / 0	inadimplência	6 / 484
`juros básicos`	0 / 0	Selic	5 / 7
`desemprego`	0 / 0	desocupação	1 / 0
`arrecadação`, `gasto`	0 / 0	receita, despesa	2 / 8, 0 / 8
`investimento estrangeiro`	0 / 0	investimento direto	1 / 12
`conta corrente`	0 / 0	transações correntes	1 / 5

Apenas pares medidos entram na tabela (src/vocabulario.ts): a palavra que você pergunta ausente em ambas as camadas, a palavra do BCB presente. O que o BCB não publica sob nenhum desses nomes fica de fora e ainda retorna zero — salário mínimo, ibovespa, bitcoin, meta de inflação — porque um alias para uma série que não existe promete o que a fonte não tem; e empréstimo não é mapeado para crédito de propósito (o portal já responde com 45 conjuntos de dados; o mapeamento os afogaria em 2.000). A mesma tabela alimenta o índice de Deep Research search.

Detalhes Técnicos

Robustez

Tempo limite: 30 segundos por solicitação (evita travamentos)
Repetição automática: 3 tentativas com backoff exponencial (1s, 2s, 4s) para falhas transitórias; erros de cliente (4xx) não são repetidos, pois são determinísticos
Tratamento de erros: Mensagens de erro claras

Contornando os limites do SGS

Medido contra a API ao vivo, não inferido da documentação:

Uma janela de datas acima de 10 anos em uma série diária é recusada com HTTP 406, assim como uma janela aberta (sem dataInicial, ou sem datas). O limite aplica-se à janela implícita: sem dataFinal a API assume hoje. As solicitações são divididas em janelas de até 3 anos, buscadas com concorrência limitada e mescladas em ordem de data sem duplicar as emendas; a resposta relata isso em chunking. A fatia é de 3 anos em vez dos 10 permitidos porque uma janela diária de 10 anos custa 10–20 s a montante e pode ser cortada em torno de 30 s.
dados/ultimos/N é limitado a 20 pela API, em todas as periodicidades. Acima de 20, o servidor infere a periodicidade da série e busca por janela de datas.
Não há endpoint de metadados por série (/metadados responde 404). A frequência é inferida do espaçamento das observações e sinalizada com periodicidadeInferida; a unidade de medida não está disponível em nenhuma fonte.

Valores derivados

Qualquer coisa que este servidor calcule — variação, estatísticas descritivas, séries harmonizadas — é marcada derived: true e carrega uma nota com as convenções usadas. As estatísticas vêm de @sbissoli/mcp-stats. Um valor publicado pelo BCB é sempre retornado literalmente; apenas valores calculados são arredondados (para 4 casas decimais).

Pesquisa Inteligente

bcb_buscar_serie pesquisa duas camadas: o catálogo curado de 135 séries verificadas (que classifica primeiro, com a fonte do nome declarada) e o índice do Portal de Dados Abertos do BCB, com milhares de séries identificadas por código. Os termos são insensíveis a acentos e maiúsculas/minúsculas, e vários termos são combinados com E:

"inflacao" → encontra "Inflação"
"cambio" → encontra "Câmbio"
"ipca servicos" → ambos os termos devem corresponder

O índice do portal é servido a partir de um cache de 24 horas, renovado pela primeira pesquisa após expirar (uma solicitação ao portal, apenas metadados — códigos e nomes de séries, nunca observações). Cada resposta carrega catalogo.cobertura: o índice não é o SGS inteiro, então não encontrar uma série aqui não é prova de que ela não existe.

Fonte de dados e licença

Dados obtidos do Banco Central do Brasil (SGS / Olinda-Expectativas / PTAX), publicados sob a Open Data Commons Open Database License (ODbL) v1.0 — https://opendatacommons.org/licenses/odbl/1-0/. Re-verificado contra a fonte em 2026-08-13: 4.259 dos 4.260 conjuntos de dados do portal declaram license_id: "odc-odbl". Isso não é CC0, CC BY ou domínio público — ODbL carrega atribuição, compartilhamento pela mesma licença (em bancos de dados derivados) e cláusulas anti-DRM. Respostas de taxas de câmbio passam pelo aviso de responsabilidade do próprio BCB literalmente; paridades entre moedas não são compiladas pelo BCB — elas vêm de uma agência de informações (Refinitiv) e são redistribuídas pelo BCB, e as ferramentas dizem isso.

O código do próprio servidor é MIT; os dados não são. Veja NOTICE.md. Privacidade: nenhum dado do usuário é registrado, por nenhum canal — veja PRIVACY.md.

Bloco de proveniência

Toda resposta de ferramenta bem-sucedida carrega um bloco de proveniência (contrato de portfólio v1.0) em dois canais: structuredContent.provenance + attribution (visível para o modelo) e um espelho _meta sob br.com.sidneybissoli.bcb/* (fora de banda, zero tokens). Cada bloco nomeia a fonte, a URL canônica que reproduz a consulta, a safra dos dados, o instante real de extração a montante e a licença.

Dois detalhes fáceis de errar e tratados aqui:

retrieved_at é o instante real de extração, não "agora". O índice do portal é servido a partir de um cache de 24 horas, então uma pesquisa respondida do cache relata o instante em que o índice foi realmente buscado — que pode ter um dia, e é a data legalmente relevante.
Um bloco por proveniência, nunca mesclado. bcb_buscar_serie separa o índice do portal do BCB do catálogo curado do próprio servidor; bcb_serie_metadados separa a leitura ao vivo do SGS do catálogo; bcb_cambio_cotacao separa taxas de dólar compiladas pelo BCB de paridades entre moedas de fonte de agência.

Desenvolvimento

Requisitos

Node.js >= 18.0.0

Configuração

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

Build

npm run build

Teste local (stdio)

npm run dev

Teste local (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: Datos Abiertos del BCB

Registro de cambios

v1.4.1

bcb_focus_referencias: el parámetro ahora es escopo, no horizonte, y el arreglo 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, lo cual no es. Nunca se publicó en npm bajo el nombre anterior.

v1.4.0

Tres APIs bajo un mismo contrato, 8 herramientas → 13. Enfoque en la encuesta de expectativas de mercado (bcb_focus_expectativas, bcb_focus_selic, bcb_focus_referencias) y los 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 formato de mayúsculas distinto al de los otros doce.
Obligaciones ODbL incluidas con las herramientas de tipos de cambio: el aviso legal del BCB se transmite textualmente, y las paridades no denominadas en USD se califican como datos de terceros (Refinitiv) redistribuidos por el BCB.

v1.2.0

Endpoint HTTP mediante 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 el 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 135 series verificadas

Contribuciones

¡Las contribuciones son bienvenidas! Por favor:

Haga un fork del repositorio
Cree una rama de funcionalidad (git checkout -b feature/new-feature)
Confirme sus cambios (git commit -m 'Add new feature')
Envíe la rama (git push origin feature/new-feature)
Abra una Solicitud de Extracción (Pull Request)

Licencia

Dos licencias, y no son lo mismo.

Código: MIT — consulte LICENCIA.
Datos: del Banco Central do Brasil, bajo la Licencia de Base de Datos Abierta de Open Data Commons (ODbL) v1.0 — https://opendatacommons.org/licenses/odbl/1-0/. No es CC0, ni CC BY, ni dominio público: la ODbL exige atribución, tiene una cláusula de compartir igual en bases de datos derivadas, y una cláusula anti-DRM.

Cada respuesta exitosa incluye un bloque de procedencia con la fuente, la URL de consulta, la antigüedad de los datos, el instante real de extracción y la licencia. Las respuestas de tipos de cambio transmiten el aviso legal del BCB textualmente, y las paridades no denominadas en USD se califican como datos de agencias de información (Refinitiv) redistribuidos por el BCB — no como datos compilados por el Banco Central.

Detalles y obligaciones en NOTICE.md. Privacidad: no se registran datos de usuarios, por ninguno de los canales — consulte PRIVACY.md.

Autor

Sidney da Silva Pereira Bissoli

GitHub: @SidneyBissoli
Correo electrónico: sbissoli76@gmail.com

BCB BR MCP

Documentación

Banco Central do Brasil (BCB) — Servidor MCP de Séries Temporais SGS

Veja em ação

Recursos

Ferramentas Disponíveis

Recursos

Prompts

Instalação

Via Smithery (recomendado)

Via URL (Claude.ai, Claude Desktop, qualquer cliente MCP)

Via npx (Claude Desktop)

Via instalação global

ChatGPT (Deep Research)

Exemplos de Uso

Obtenha a taxa Selic atual

Histórico do IPCA para 2024

Liste indicadores de inflação

Busque séries de taxa de câmbio USD

Calcule a variação USD/BRL

Compare IPCA, IGP-M e INPC

Catálogo de Séries (135)

Juros (14)

Inflação (28)

Tipo de cambio (13)

Actividad Económica (21)

Empleo (4)

Fiscal (7)

Sector Externo (12)

Crédito (30)

Agregados Monetários (8)

Poupança (2)

Encontrando Outras Séries

Pergunte com suas palavras, não as do BCB

Detalhes Técnicos

Robustez

Contornando os limites do SGS

Valores derivados

Pesquisa Inteligente

Fonte de dados e licença

Bloco de proveniência

Desenvolvimento

Requisitos

Configuração

Build

Teste local (stdio)

Teste local (worker HTTP)

API del BCB

Registro de cambios

v1.4.1

v1.4.0

v1.2.0

v1.1.0

v1.0.0

Contribuciones

Licencia

Autor

Enlaces útiles