sidneybissoli avatar

Banco Central do Brasil (BCB) — SGS Time Series MCP Server

sidneybissoli/bcb-br-mcp

Connects Claude directly to Brazil's Central Bank time series API (SGS/BCB) with eight tools for querying economic data. Pull historical values for 150+ indicators across interest rates, inflation, exchange rates, GDP, employment, credit, and fiscal metrics. Search by keyword, compare multiple series over the same period, calculate percentage variations, or grab current snapshots of Selic, IPCA, USD/BRL, and IBC-Br. Includes a built-in catalog organized by category so you don't need to memorize series codes. Useful if you're building financial models, tracking Brazilian macroeconomic trends, or need programmatic access to official central bank data without scraping.

GitHub stars
11
tools
17
transport
STDIO, HTTP
last updated
Oct 28, 2026

Install

From registry metadata
$ npx add-mcp https://bcb.sidneybissoli.com/mcp --name bcb-br-mcp

Run in your terminal. add-mcp asks which agents to add it to (Claude Code, Codex, Cursor and more). Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add --transport http bcb-br-mcp https://bcb.sidneybissoli.com/mcp

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 17 tools

Verified live against the running server on Nov 6, 2026.

bcb_serie_valoresConsulta o histórico de valores de UMA série temporal do BCB pelo código SGS, opcionalmente limitado por um intervalo de datas (dataInicial/dataFinal). Quando usar: para obter a série histórica completa ou uma janela de datas específica. Quando NÃO usar: para apenas os pontos...5 params

Consulta o histórico de valores de UMA série temporal do BCB pelo código SGS, opcionalmente limitado por um intervalo de datas (dataInicial/dataFinal). Quando usar: para obter a série histórica completa ou uma janela de datas específica. Quando NÃO usar: para apenas os pontos...

Parameters* required
agregacaostring
Como agregar os valores de cada período quando `frequencia` é informada. `ultimo` (padrão) serve a nível de preço, taxa e índice; `soma` a fluxo; `acumulada` a séries que JÁ SÃO variação percentual...one of ultimo · primeiro · media · soma · acumuladadefault: ultimo
codigo*number
Código da série no SGS/BCB (ex: 433 para IPCA mensal, 11 para Selic)
dataFinalstring
Data final no formato yyyy-MM-dd ou dd/MM/yyyy (opcional)
dataInicialstring
Data inicial no formato yyyy-MM-dd ou dd/MM/yyyy (opcional)
frequenciastring
Opcional: reamostra a série para esta frequência antes de responder (só agrega para períodos MAIORES; pedir frequência mais fina que a da série é recusado). Útil para comparar séries de periodicida...one of mensal · trimestral · anual
bcb_serie_ultimosObtém as últimas N observações de UMA série temporal do BCB (mais recentes primeiro a partir do fim da série). Quando usar: para ver os dados mais recentes sem precisar calcular datas (ex.: últimos 12 meses do IPCA). Quantidade entre 1 e 1000 (padrão 10). Quando NÃO usar: para...2 params

Obtém as últimas N observações de UMA série temporal do BCB (mais recentes primeiro a partir do fim da série). Quando usar: para ver os dados mais recentes sem precisar calcular datas (ex.: últimos 12 meses do IPCA). Quantidade entre 1 e 1000 (padrão 10). Quando NÃO usar: para...

Parameters* required
codigo*number
Código da série no SGS/BCB
quantidadenumber
Quantidade de valores a retornar (1-1000, padrão: 10). A API do BCB tem teto de 20 no endpoint nativo; acima disso o servidor busca por janela de datas e devolve os N últimos.default: 10
bcb_serie_metadadosObtém a descrição de UMA série do BCB (nome, periodicidade, categoria, fonte e último valor), sem trazer a série histórica. Quando usar: para confirmar o que uma série representa e com que frequência é publicada antes de consultar os dados. Quando NÃO usar: para os valores em...1 params

Obtém a descrição de UMA série do BCB (nome, periodicidade, categoria, fonte e último valor), sem trazer a série histórica. Quando usar: para confirmar o que uma série representa e com que frequência é publicada antes de consultar os dados. Quando NÃO usar: para os valores em...

Parameters* required
codigo*number
Código da série no SGS/BCB
bcb_series_popularesLista o catálogo interno curado de 135 séries econômicas do BCB com seus códigos, agrupadas por categoria (Juros, Inflação, Câmbio, Atividade Econômica, Emprego, Fiscal, Setor Externo, Crédito, Agregados Monetários, Poupança); aceita filtro por categoria. Quando usar: para nav...1 params

Lista o catálogo interno curado de 135 séries econômicas do BCB com seus códigos, agrupadas por categoria (Juros, Inflação, Câmbio, Atividade Econômica, Emprego, Fiscal, Setor Externo, Crédito, Agregados Monetários, Poupança); aceita filtro por categoria. Quando usar: para nav...

Parameters* required
categoriastring
Filtrar por categoria: Juros, Inflação, Câmbio, Atividade Econômica, Emprego, Fiscal, Setor Externo, Crédito, Agregados Monetários, Poupança, Índices de Mercado, Expectativas
bcb_buscar_serieBusca séries do BCB por palavra-chave (ou pelo código) em DUAS camadas: o catálogo curado local de 135 séries verificadas contra a origem, que vem primeiro e com `fonteNome` dizendo se o nome é transcrito do portal do BCB ou herdado, e o índice do Portal de Dados Abertos do BC...2 params

Busca séries do BCB por palavra-chave (ou pelo código) em DUAS camadas: o catálogo curado local de 135 séries verificadas contra a origem, que vem primeiro e com `fonteNome` dizendo se o nome é transcrito do portal do BCB ou herdado, e o índice do Portal de Dados Abertos do BC...

Parameters* required
limitenumber
Máximo de séries a devolver (1-100, padrão: 20). `totalEncontradas` traz o total antes do corte.default: 20
termo*string
Termo de busca (mínimo 2 caracteres) ou o código da série. Vários termos são combinados com E, sem distinção de acento; a palavra de todo dia é traduzida para a do BCB (déficit→resultado primário,...
bcb_indicadores_atuaisAtalho que retorna, em uma única chamada, o valor mais recente dos principais indicadores da economia brasileira: Selic (meta do Copom), IPCA mensal, IPCA acumulado 12 meses, dólar comercial de venda (série diária) e IBC-Br. Não recebe parâmetros. Quando usar: para um panorama...

Atalho que retorna, em uma única chamada, o valor mais recente dos principais indicadores da economia brasileira: Selic (meta do Copom), IPCA mensal, IPCA acumulado 12 meses, dólar comercial de venda (série diária) e IBC-Br. Não recebe parâmetros. Quando usar: para um panorama...

No parameters. Call it with no arguments.

bcb_variacaoCalcula a variação percentual de UMA série no período, mais estatísticas descritivas. Para série de NÍVEL (dólar, Selic, dívida, produção) é a variação entre o primeiro e o último ponto; para série que JÁ É uma variação por período (IPCA 433, INPC 188, IGP-M 189 e demais índic...4 params

Calcula a variação percentual de UMA série no período, mais estatísticas descritivas. Para série de NÍVEL (dólar, Selic, dívida, produção) é a variação entre o primeiro e o último ponto; para série que JÁ É uma variação por período (IPCA 433, INPC 188, IGP-M 189 e demais índic...

Parameters* required
codigo*number
Código da série no SGS/BCB
dataFinalstring
Data final (yyyy-MM-dd ou dd/MM/yyyy). Se não informada, usa o último valor disponível.
dataInicialstring
Data inicial (yyyy-MM-dd ou dd/MM/yyyy). Se não informada, usa o primeiro valor disponível.
periodosnumber
Alternativa: calcular variação dos últimos N períodos (ignora datas se informado). Acima de 20 o servidor busca por janela de datas, porque o endpoint nativo do BCB tem esse teto.
bcb_compararCompara de 2 a 5 séries temporais no MESMO período (dataInicial e dataFinal obrigatórias), calculando a variação percentual de cada uma e ordenando-as num ranking (maior para menor variação). Série de nível entra pela variação entre as pontas; série que já é variação por perío...5 params

Compara de 2 a 5 séries temporais no MESMO período (dataInicial e dataFinal obrigatórias), calculando a variação percentual de cada uma e ordenando-as num ranking (maior para menor variação). Série de nível entra pela variação entre as pontas; série que já é variação por perío...

Parameters* required
agregacaostring
Como agregar os valores de cada período quando `frequencia` é informada. `ultimo` (padrão) serve a nível de preço, taxa e índice; `soma` a fluxo; `acumulada` a séries que JÁ SÃO variação percentual...one of ultimo · primeiro · media · soma · acumuladadefault: ultimo
codigos*array
Array com 2 a 5 códigos de séries para comparar
dataFinal*string
Data final (yyyy-MM-dd ou dd/MM/yyyy)
dataInicial*string
Data inicial (yyyy-MM-dd ou dd/MM/yyyy)
frequenciastring
Opcional: reamostra a série para esta frequência antes de responder (só agrega para períodos MAIORES; pedir frequência mais fina que a da série é recusado). Útil para comparar séries de periodicida...one of mensal · trimestral · anual
bcb_correlacaoCalcula a correlação estatística entre 2 a 5 séries temporais do BCB no MESMO período (dataInicial e dataFinal obrigatórias), par a par. Quando usar: para medir se dois indicadores se movem juntos (ex.: dólar e Selic, IPCA e IGP-M). Quando NÃO usar: para comparar a variação de...7 params

Calcula a correlação estatística entre 2 a 5 séries temporais do BCB no MESMO período (dataInicial e dataFinal obrigatórias), par a par. Quando usar: para medir se dois indicadores se movem juntos (ex.: dólar e Selic, IPCA e IGP-M). Quando NÃO usar: para comparar a variação de...

Parameters* required
agregacaostring
Como agregar os valores de cada período quando `frequencia` é informada. `ultimo` (padrão) serve a nível de preço, taxa e índice; `soma` a fluxo; `acumulada` a séries que JÁ SÃO variação percentual...one of ultimo · primeiro · media · soma · acumuladadefault: ultimo
basestring
`nivel` correlaciona os valores; `variacao` correlaciona a mudança percentual de um ponto para o seguinte. Prefira `variacao` quando as duas séries têm tendência: o nível de duas séries crescentes...one of nivel · variacaodefault: nivel
codigos*array
Array com 2 a 5 códigos de séries para correlacionar par a par
dataFinal*string
Data final (yyyy-MM-dd ou dd/MM/yyyy)
dataInicial*string
Data inicial (yyyy-MM-dd ou dd/MM/yyyy)
frequenciastring
Opcional: reamostra a série para esta frequência antes de responder (só agrega para períodos MAIORES; pedir frequência mais fina que a da série é recusado). Útil para comparar séries de periodicida...one of mensal · trimestral · anual
metodostring
`pearson` mede relação linear entre os valores; `spearman` mede relação monótona entre os postos (com posto médio nos empates) e é o adequado quando a relação não é reta ou quando uma das séries fi...one of pearson · spearmandefault: pearson
bcb_deflacionarConverte uma série NOMINAL do BCB em valores REAIS (moeda constante), descontando a inflação do período — a diferença entre 'o salário mínimo subiu 46% desde 2020' e 'o salário mínimo subiu 5% em poder de compra'. Quando usar: sempre que valores em reais de épocas diferentes f...7 params

Converte uma série NOMINAL do BCB em valores REAIS (moeda constante), descontando a inflação do período — a diferença entre 'o salário mínimo subiu 46% desde 2020' e 'o salário mínimo subiu 5% em poder de compra'. Quando usar: sempre que valores em reais de épocas diferentes f...

Parameters* required
agregacaostring
Como agregar os valores de cada período quando `frequencia` é informada. `ultimo` (padrão) serve a nível de preço, taxa e índice; `soma` a fluxo; `acumulada` a séries que JÁ SÃO variação percentual...one of ultimo · primeiro · media · soma · acumuladadefault: ultimo
codigo*number
Código da série NOMINAL a deflacionar (ex.: 1619 para salário mínimo)
dataFinal*string
Data final (yyyy-MM-dd ou dd/MM/yyyy)
dataInicial*string
Data inicial (yyyy-MM-dd ou dd/MM/yyyy)
frequenciastring
Opcional: reamostra a série para esta frequência antes de responder (só agrega para períodos MAIORES; pedir frequência mais fina que a da série é recusado). Útil para comparar séries de periodicida...one of mensal · trimestral · anual
indicestring
Índice de preços usado como deflator: IPCA (433), INPC (188) ou IGP-M (189)one of ipca · inpc · igpmdefault: ipca
mesBasestring
Mês em cujos preços os valores serão expressos, no formato yyyy-MM. Sem ele, usa o último mês publicado do índice — isto é, 'em reais de hoje'.
bcb_focus_expectativasConsulta as expectativas de mercado do boletim Focus para UM indicador, com o horizonte como parâmetro: mensal, trimestral, anual, inflação nos próximos 12 meses e nos próximos 24 meses. Devolve média, mediana, desvio padrão, mínimo, máximo e número de respondentes por data de...8 params

Consulta as expectativas de mercado do boletim Focus para UM indicador, com o horizonte como parâmetro: mensal, trimestral, anual, inflação nos próximos 12 meses e nos próximos 24 meses. Devolve média, mediana, desvio padrão, mínimo, máximo e número de respondentes por data de...

Parameters* required
dataFinalstring
Fim da janela de COLETA (yyyy-MM-dd ou dd/MM/yyyy). Padrão: hoje.
dataInicialstring
Início da janela de COLETA (yyyy-MM-dd ou dd/MM/yyyy). Padrão: 30 dias antes do fim.
horizonte*string
mensal, trimestral e anual usam `referencia`; inflacao_12m e inflacao_24m são rolantes e não usamone of mensal · trimestral · anual · inflacao_12m · inflacao_24m
indicador*string
Indicador exatamente como a fonte publica (ex.: 'IPCA', 'IGP-M', 'PIB Total', 'Câmbio'). Veja bcb_focus_referencias.
limitenumber
Máximo de coletas a devolver (1-500, padrão 50)default: 50
referenciastring
Alvo da expectativa: MM/yyyy (mensal), T/yyyy (trimestral) ou yyyy (anual). Obrigatória nesses três; proibida nos rolantes.
suavizadaboolean
Só nos horizontes rolantes: série suavizada (true) ou não suavizada (false)
top5boolean
Expectativas do Top 5 (as cinco instituições mais assertivas) em vez do consenso; existe nos cinco horizontesdefault: false
bcb_focus_selicConsulta as expectativas de mercado do Focus para a taxa Selic, organizadas pela REUNIÃO do Copom (formato R1/2026 = 1ª reunião de 2026). Devolve média, mediana, desvio padrão, mínimo, máximo e número de respondentes por data de coleta. Quando usar: para 'o que o mercado esper...5 params

Consulta as expectativas de mercado do Focus para a taxa Selic, organizadas pela REUNIÃO do Copom (formato R1/2026 = 1ª reunião de 2026). Devolve média, mediana, desvio padrão, mínimo, máximo e número de respondentes por data de coleta. Quando usar: para 'o que o mercado esper...

Parameters* required
dataFinalstring
Fim da janela de COLETA (yyyy-MM-dd ou dd/MM/yyyy). Padrão: hoje.
dataInicialstring
Início da janela de COLETA (yyyy-MM-dd ou dd/MM/yyyy). Padrão: 30 dias antes do fim.
limitenumber
Máximo de coletas a devolver (1-500, padrão 50)default: 50
reuniaostring
Reunião do Copom no formato R1/2026 (opcional; sem ela, todas as reuniões da janela)
top5boolean
Expectativas do Top 5 em vez do consensodefault: false
bcb_focus_referenciasLista, POR ESCOPO, os indicadores e as referências que o Focus efetivamente publica, para você usar o texto EXATO em bcb_focus_expectativas e em bcb_focus_selic. Escopo = os cinco horizontes de bcb_focus_expectativas mais 'selic', que não é horizonte: o eixo dela é a reunião d...2 params

Lista, POR ESCOPO, os indicadores e as referências que o Focus efetivamente publica, para você usar o texto EXATO em bcb_focus_expectativas e em bcb_focus_selic. Escopo = os cinco horizontes de bcb_focus_expectativas mais 'selic', que não é horizonte: o eixo dela é a reunião d...

Parameters* required
escopostring
Restringe a descoberta a um escopo (opcional). 'selic' descobre as reuniões do Copom para bcb_focus_selic; os demais são os horizontes de bcb_focus_expectativas.one of mensal · trimestral · anual · inflacao_12m · inflacao_24m · selic
indicadorstring
Filtrar por um indicador específico, para ver em quais escopos ele existe (opcional)
bcb_cambio_cotacaoConsulta a cotação PTAX de uma moeda contra o real, em um dia específico ou num intervalo de datas. Padrão: dólar americano (USD). Devolve compra, venda, data/hora e tipo de boletim; para moedas não-dólar devolve também a paridade contra o USD, com a origem qualificada. Quando...5 params

Consulta a cotação PTAX de uma moeda contra o real, em um dia específico ou num intervalo de datas. Padrão: dólar americano (USD). Devolve compra, venda, data/hora e tipo de boletim; para moedas não-dólar devolve também a paridade contra o USD, com a origem qualificada. Quando...

Parameters* required
datastring
Dia específico (yyyy-MM-dd ou dd/MM/yyyy). Não combine com dataInicial/dataFinal.
dataFinalstring
Fim do intervalo (yyyy-MM-dd ou dd/MM/yyyy). Padrão: hoje.
dataInicialstring
Início do intervalo (yyyy-MM-dd ou dd/MM/yyyy). Padrão: 7 dias antes do fim.
limitenumber
Máximo de boletins a devolver (1-1000, padrão 100)default: 100
moedastring
Símbolo da moeda (ex.: USD, EUR, GBP, JPY). Padrão: USD.default: USD
bcb_cambio_moedasLista as moedas com cotação publicada pelo Banco Central, com símbolo, nome e tipo, e aceita um termo para filtrar. Quando usar: para descobrir o símbolo correto antes de chamar bcb_cambio_cotacao (é a causa mais comum de cotação vazia). Quando NÃO usar: para valores de cotaçã...1 params

Lista as moedas com cotação publicada pelo Banco Central, com símbolo, nome e tipo, e aceita um termo para filtrar. Quando usar: para descobrir o símbolo correto antes de chamar bcb_cambio_cotacao (é a causa mais comum de cotação vazia). Quando NÃO usar: para valores de cotaçã...

Parameters* required
termostring
Filtro por símbolo ou nome (ex.: 'EUR', 'libra'). Opcional.
searchSearches the Banco Central do Brasil time series (SGS: interest rates, inflation, exchange rates, credit, fiscal and external sector — the curated catalog plus the open data portal index) catalog and returns up to 10 matching documents as { id, title, url }, ordered by relevan...1 params

Searches the Banco Central do Brasil time series (SGS: interest rates, inflation, exchange rates, credit, fiscal and external sector — the curated catalog plus the open data portal index) catalog and returns up to 10 matching documents as { id, title, url }, ordered by relevan...

Parameters* required
query*string
Termos de busca em linguagem natural ou palavras-chave (acentos e caixa são ignorados)
fetchReturns the full document for an id obtained from `search`, as { id, title, text, url, metadata }: `text` is the readable content (Markdown) and `url` the canonical public page to cite. Companion of `search` in the OpenAI Deep Research contract, over the Banco Central do Brasi...1 params

Returns the full document for an id obtained from `search`, as { id, title, text, url, metadata }: `text` is the readable content (Markdown) and `url` the canonical public page to cite. Companion of `search` in the OpenAI Deep Research contract, over the Banco Central do Brasi...

Parameters* required
id*string
Identificador de um documento devolvido por `search`

Sponsors

Readme

Banco Central do Brasil (BCB) — SGS Time Series MCP Server


View the full README on GitHub

Details

Repository
github.com/sidneybissoli/bcb-br-mcp
Website
bcb.sidneybissoli.com
Package
bcb-br-mcp
Transport
STDIO, HTTP
Registry
MCP registry, active
Resources
3
Prompts
3
Tools verified
Nov 6, 2026

More from sidneybissoli