Power your agent
Perintah milik penerbit sendiri. Bukan endpoint PlugMCP.
Host a copy with our keys and logs.
npx -y [email protected]Claude Code tidak punya tautan instal untuk perintah lokal. Salin perintah di bawah dan jalankan di terminal.
claude mcp add bcb-br-mcp -- npx -y bcb-br-mcp@1.19.0Jalankan di terminal.
{ "mcpServers": { "bcb-br-mcp": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}claude_desktop_config.json
URL remote atau perintah di mesin Anda? Perbedaan kedua cara instal
Jalankan di PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
BukaDari penerbit
MCP server for the Brazilian Central Bank (Banco Central do Brasil, BCB): SGS time series (Selic, IPCA, exchange rates, GDP and a curated catalogue of indicators), Focus market expectations, PTAX exchange rates and the Olinda open-data platform, with a pr
MCP (Model Context Protocol) server for the Brazilian Central Bank (Banco Central do Brasil, BCB): SGS time series (SGS/BCB), the Focus market-expectations survey (served over the Olinda OData API) and PTAX exchange rates.
Query economic and financial indicators such as Selic (interest rate), IPCA (inflation), exchange rates, GDP, and more, directly from AI assistants like Claude.
If you find this project useful, please consider giving it a star on GitHub. It helps others discover the project!
Capabilities: 17 tools (skills) · 3 resources · 3 prompts — everything an MCP client needs to query the Brazilian Central Bank: SGS/BCB time series, the Focus market-expectations survey and PTAX exchange rates.
Ask your assistant, in plain Portuguese:
bcb_indicadores_atuaisbcb_serie_valoresbcb_variacaobcb_focus_expectativasbcb_focus_selicbcb_cambio_cotacaoThe answers come live from the Brazilian Central Bank's SGS API — exact figures with provenance, not numbers guessed from training data.
📖 Article (in Portuguese): Séries do Banco Central: como consultar o SGS, a Focus e a PTAX sem cair nas armadilhas — the three API limits measured live, level vs. rate series, the Focus scopes, and what the ODbL requires. Also published on the site, in Portuguese and English: sidneybissoli.com.
Reference catalogs the server exposes as MCP resources (read-only contextual data that clients can attach):
Ready-made templates the server provides as MCP prompts:
Visit bcb-br-mcp on Smithery and follow the installation instructions for your MCP client.
Use the HTTP endpoint directly, no installation required:
https://bcb.sidneybissoli.com/mcp
The legacy hostname https://bcb.sidneybissoli.workers.dev keeps working, and so
does the older POST / route — clients configured before the endpoint moved to
/mcp are rewritten transparently, so nothing that used to work stopped working.
New setups should use the URL above.
Add to your Claude Desktop configuration file:
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"]
}
}
}
npm install -g bcb-br-mcp
{
"mcpServers": {
"bcb-br": {
"command": "bcb-br-mcp"
}
}
}
ChatGPT deep research (and company knowledge, and research workflows over the Responses API) only uses an MCP server that exposes exactly search and fetch — this server does, on top of the bcb_* tools. Point the connector at the hosted endpoint, no key required:
https://bcb.sidneybissoli.com/mcp
search ranks the query against the series catalog — the 135 curated series plus the thousands indexed from the Open Data Portal — and returns { id, title, url } (ids are sgs:<code>); fetch returns the series as readable Markdown (name, category, frequency, unit, latest value) with the canonical public URL, which is what ChatGPT cites: the dataset page on dadosabertos.bcb.gov.br when the series has one, otherwise the public SGS query for its latest observations (the SGS has no per-series page). Both carry the same provenance block as every other tool. In ChatGPT's developer mode (Settings → Security and login → Developer mode) any tool is callable — the bcb_* tools remain the ones to use for data.
What is the current Selic interest rate?
→ Uses bcb_indicadores_atuais
Show me the monthly IPCA for 2024
→ Uses bcb_serie_valores with code 433, dataInicial 2024-01-01, dataFinal 2024-12-31
What inflation series are available?
→ Uses bcb_series_populares with category "Inflação"
Search for series related to the dollar
→ Uses bcb_buscar_serie with term "dolar" (works without accents)
What was the USD/BRL variation over the last 12 months?
→ Uses bcb_variacao with code 1 and periodos 12
Compare IPCA, IGP-M, and INPC in 2024
→ Uses bcb_comparar with codes [433, 189, 188], dataInicial 2024-01-01, dataFinal 2024-12-31
The curated catalog holds 135 series, each verified against the source on 2026-08-13 (4 discontinued FGV series were removed on 2026-08-23).
The fonteNome field on every entry says where its name comes from:
portal (82 series) — the name is transcribed from the series' dataset on the
BCB Open Data Portal, and unidade carries the published unit of measure.medido (53 series) — the series has no dataset on the portal, so the name is
inherited; what was verified against the source is its periodicity and order of magnitude.Periodicity is always the measured one (from the spacing between observations), never an
inherited label. Market expectations are not here — use bcb_focus_expectativas.
The full machine-readable catalog is served as the bcb://series/populares resource and by
bcb_series_populares. Thousands of further series are reachable through bcb_buscar_serie,
which also queries the BCB Open Data Portal index.
The SGS database contains over 18,000 time series. To find codes for other series:
bcb_buscar_serie matches your words, all of them (AND), against the curated catalogue (135 series: name and category) and the dataset slugs of the BCB open-data portal (3,579 series identified by code). Accents were already ignored; the word was not. Measured over both layers on 2026-09-16, fixed since 1.12.0: the everyday word is expanded to the BCB's own, and the response says so in notasVocabulario; zero results come with a way out.
Only measured pairs enter the table (src/vocabulario.ts): the word you ask with absent from both layers, the BCB's word present. What the BCB does not publish under any of these names stays out and still returns zero — salário mínimo, ibovespa, bitcoin, meta de inflação — because an alias for a series that does not exist promises what the source does not have; and empréstimo is not mapped to crédito on purpose (the portal already answers it with 45 datasets; the mapping would drown them in 2,000). The same table feeds the Deep Research search index.
Measured against the live API, not inferred from documentation:
dataInicial, or no dates at all). The limit
applies to the implicit window: with no dataFinal the API assumes today.
Requests are sliced into windows of up to 3 years, fetched with bounded
concurrency and merged in date order without duplicating the seams; the response
reports it in chunking. The slice is 3 years rather than the allowed 10 because
a 10-year daily window costs 10–20 s upstream and may be cut off around 30 s.dados/ultimos/N is capped at 20 by the API, in every periodicity. Above 20,
the server infers the series' periodicity and fetches by date window instead./metadados answers 404). Frequency
is inferred from the spacing of the observations and flagged with
periodicidadeInferida; unit of measure is not available from any source.Anything this server computes — variation, descriptive statistics, harmonised
series — is marked derived: true and carries a note with the conventions used.
Statistics come from @sbissoli/mcp-stats.
A value published by the BCB is always returned verbatim; only computed values are
rounded (to 4 decimals).
bcb_buscar_serie searches two layers: the curated catalog of 135 verified series (which ranks first, with
the source of the name declared) and the index of the BCB Open Data Portal, with thousands of series
identified by code. Terms are accent- and case-insensitive, and several terms are combined with AND:
"inflacao" → finds "Inflação""cambio" → finds "Câmbio""ipca servicos" → both terms must matchThe portal index is served from a 24-hour cache, renewed by the first search after it expires (one request to
the portal, only metadata — series codes and names, never observations). Every answer carries
catalogo.cobertura: the index is not the whole SGS, so not finding a series here is not proof it does not
exist.
Data obtained from the Banco Central do Brasil (SGS / Olinda-Expectativas / PTAX), published under the
Open Data Commons Open Database License (ODbL) v1.0 — https://opendatacommons.org/licenses/odbl/1-0/.
Re-verified against the source on 2026-08-13: 4,259 of the portal's 4,260 datasets declare
license_id: "odc-odbl". This is not CC0, CC BY, or public domain — ODbL carries attribution,
share-alike (on derived databases) and anti-DRM clauses. Exchange-rate answers pass through the BCB's own
liability disclaimer verbatim; cross-currency parities are not compiled by the BCB — they come from an
information agency (Refinitiv) and are redistributed by the BCB, and the tools say so.
The server's own code is MIT; the data is not. See NOTICE.md. Privacy: no user data is logged, by either channel — see PRIVACY.md.
Every successful tool response carries a provenance block (portfolio contract v1.0) in two channels:
structuredContent.provenance + attribution (visible to the model) and a _meta mirror under
br.com.sidneybissoli.bcb/* (out of band, zero tokens). Each block names the source, the canonical URL that
reproduces the query, the data vintage, the real upstream extraction instant, and the licence.
Three details that are easy to get wrong and are handled here:
retrieved_at is the real extraction instant, not "now". The portal index is served from a 24-hour
cache, so a search answered from cache reports the instant the index was actually fetched — which can be a
day old, and is the legally relevant date.bcb_buscar_serie separates the BCB portal index from the
server's own curated catalogue; bcb_serie_metadados separates the live SGS reading from the catalogue;
bcb_cambio_cotacao separates BCB-compiled dollar rates from agency-sourced cross-currency parities.{data, valor}: the date of
a monthly, quarterly or annual series is the first day of the reference period, and some series arrive
already accumulated (year-to-date GDP 4381/4386; 12-month IPCA 13522, GDP 4382, primary balance 5793),
which only their name tells. The tool descriptions say so, and data_vintage is the span actually covered
— including on the four tools that compute across several series. Every value is the version the SGS
publishes at retrieved_at: the BCB revises series such as GDP and IBC-Br and the SGS keeps no
as-first-published copy, so this server cannot return one.Every release publishes, in its MCP Registry entry,
the sha256 of the surface this version serves (initialize, tools, resources, prompts) and which
methods answer without a credential. A surface change without a version bump fails the build;
the fingerprint in the registry lets a client check the same thing on its own side. Canonical
form and procedure: SPEC.md of @sbissoli/mcp-surface.
To check it yourself (Node 18+, no dependencies):
curl -sO https://raw.githubusercontent.com/SidneyBissoli/mcp-br-commons/main/packages/mcp-surface/exemplos/verify.mjs
node verify.mjs io.github.SidneyBissoli/bcb-br-mcp
git clone https://github.com/SidneyBissoli/bcb-br-mcp.git
cd bcb-br-mcp
npm install
npm run build
npm run dev
npm run dev:worker
Or use the MCP Inspector:
npx @modelcontextprotocol/inspector npm run dev
This server uses the Brazilian Central Bank's public API:
https://api.bcb.gov.br/dados/serie/bcdata.sgs.{code}/dadosbcb_focus_referencias: the parameter is now escopo, not horizonte, and the
response array is escopos. The scopes are the five horizons of
bcb_focus_expectativas plus selic — and selic is not a horizon: its
axis is the Copom meeting. Each block names the tool that consumes it. The
previous name implied selic was a queryable horizon of
bcb_focus_expectativas, which it is not. Never published to npm under the old
name.bcb_focus_expectativas, bcb_focus_selic, bcb_focus_referencias)
and PTAX exchange rates (bcb_cambio_cotacao, bcb_cambio_moedas), consolidated
by parameter rather than mirroring the source's ~18 OData resources.bcb_buscar_serie now queries the Open Data Portal index
(3,500+ series, 24-hour cache, metadata only) on top of the curated catalog, and
states the index's coverage instead of claiming a series does not exist.https://bcb.sidneybissoli.workers.dev)src/tools.ts (shared between stdio and HTTP)bcb_variacao for percentage variation calculationbcb_comparar for comparing multiple seriesContributions are welcome! Please:
git checkout -b feature/new-feature)git commit -m 'Add new feature')git push origin feature/new-feature)Two licences, and they are not the same thing.
Every successful response carries a provenance block with the source, the query URL, the data vintage, the real extraction instant and the licence. Exchange-rate answers pass the BCB disclaimer through verbatim, and non-USD parities are qualified as information-agency data (Refinitiv) redistributed by the BCB — not as data compiled by the Central Bank.
Details and obligations in NOTICE.md. Privacy: no user data is logged, by either channel — see PRIVACY.md.
Sidney da Silva Pereira Bissoli
MCP server for the Brazilian Central Bank (Banco Central do Brasil, BCB): SGS time series (Selic, IPCA, exchange rates, GDP and a curated catalogue of indicators), Focus market expectations, PTAX exch
{ "mcpServers": { "bcb-br-mcp": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}Ringkasan umum
MCP server for the Brazilian Central Bank (Banco Central do Brasil, BCB): SGS time series (Selic, IPCA, exchange rates, GDP and a curated catalogue of indicators), Focus market expectations, PTAX exchange rates and the Olinda open-data platform, with a pr
Tool
Belum ada daftar tool. Server remote mendapatkannya setelah pemeriksaan kesehatan pertama.
FAQ
Salin konfigurasi stdio untuk Cursor, Claude Desktop, Claude Code, atau VS Code di halaman ini. Konfigurasi ini memakai instalasi dari penerbit, bukan proxy PlugMCP.
Tidak ada variabel lingkungan wajib yang tercantum di catatan ini.
Bcb Br berjalan secara lokal melalui stdio.
Terakhir diperiksa 2026-11-11. MCP server for the Brazilian Central Bank (Banco Central do Brasil, BCB): SGS time series (Selic, IPCA, exchange rates, GDP and a curated catalogue of indicators), Focus market expectations, PTAX exchange rates and the Olinda open-data platform, with a pr