What can you do with this server?

The BCB MCP server provides access to Brazilian Central Bank (BCB/SGS) economic and financial time series data through AI assistants via the Model Context Protocol, enabling querying, analysis, and comparison of key Brazilian economic indicators. * Query historical data (bcb_serie_valores): Retrieve time series values by code with optional date filters. * Get latest values (bcb_serie_ultimos): Fetch the most recent 1–1000 values of any series. * Access series metadata (bcb_serie_metadados): Get details such as name, frequency, category, and source. * Browse popular series (bcb_series_populares): List 150+ curated indicators across 12 categories (Interest Rates, Inflation, Exchange Rates, Economic Activity, Employment, Fiscal, External Sector, Credit, Monetary Aggregates, Savings, Market Indices, Expectations). * Search for series (bcb_buscar_serie): Find series by keyword with accent-insensitive search (e.g., "inflacao" matches "Inflação"). * Check current indicators (bcb_indicadores_atuais): Get the latest values for Selic, IPCA, USD/BRL (PTAX), and IBC-Br. * Calculate variations (bcb_variacao): Compute percentage changes between dates or over the last N periods, with stats like max, min, and average. * Compare multiple series (bcb_comparar): Analyze 2–5 series simultaneously over the same period with ranking. The server covers 18,000+ time series and includes 30-second timeouts, auto-retry with exponential backoff, and clear error handling.

Which integrations are available for this server?

Exposes search and fetch tools for OpenAI Deep Research workflows, enabling discovery of Brazilian Central Bank economic series from the curated catalog and open data index and retrieval of series as readable documents with canonical public URLs.

Banco Central do Brasil (BCB) — SGS MCP

by SidneyBissoli

Overview Schema Related Servers Score Discussions

TypeScript

Remote

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

npm version npm downloads node MCP Registry LobeHub GitHub stars GitHub Sponsors License: MIT AllMCPs Verified

Leia em Português

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.

See it in action

Ask your assistant, in plain Portuguese:

"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

The answers come live from the Brazilian Central Bank's SGS API — exact figures with provenance, not numbers guessed from training data.

Related MCP server: Financial Modeling Prep MCP Server

Features

Historical data - Query time series values by code with date filters
Latest values - Get the most recent N values of any series
Metadata - Detailed information about series (frequency, source, etc.)
Popular series catalog - 135 economic indicators verified against the source, organized by category
Smart search - Find series by keyword (accent-insensitive)
Current indicators - Latest values for key economic indicators
Long periods, handled - The BCB API caps daily series at a 10-year window (HTTP 406) and refuses open windows; requests are sliced, fetched and merged automatically, so a 15-year daily query just works
Frequency harmonisation - Resample a series to monthly, quarterly or annual with an explicit convention, including geometric compounding for series that already are percentage changes (monthly IPCA into annual IPCA)
Variation calculation - Percentage change between periods with statistics
Series comparison - Compare multiple series over the same period, with a warning when their periodicities differ
Focus survey - Market expectations (mean, median, std. deviation, min, max, respondents) for IPCA, GDP, FX and more, by monthly/quarterly/annual horizon or rolling 12/24-month inflation, plus Selic by Copom meeting
PTAX exchange rates - Official closing quotes for any currency the BCB publishes, single day or date range

📖 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.

Available Tools

Tool	Description
`bcb_serie_valores`	Query series values by code and date range; slices long windows automatically and can harmonise the series to a coarser frequency
`bcb_serie_ultimos`	Get the last N values of a series (any N — the upstream cap of 20 is worked around)
`bcb_serie_metadados`	Get series metadata (name, frequency, category, last value)
`bcb_series_populares`	List popular series grouped by category
`bcb_buscar_serie`	Search series by name or description (accent-insensitive)
`bcb_indicadores_atuais`	Latest values: Selic, IPCA, USD/BRL, IBC-Br
`bcb_variacao`	Percentage variation of one series over a period: level change for level series, compounded accumulation for series that are already period-on-period rates (IPCA, IGP-M, INPC…); `analise.metodo` says which
`bcb_comparar`	Compare 2 to 5 series over the same period with ranking (same level/compounding rule per series, declared in `metodo`)
`bcb_focus_expectativas`	Focus survey expectations for one indicator, horizon as a parameter (monthly, quarterly, annual, rolling 12m/24m inflation); `top5` flag
`bcb_focus_selic`	Focus expectations for the Selic rate, by Copom meeting (R1/2026 form)
`bcb_focus_referencias`	Which indicators and reference dates the Focus survey actually publishes, broken down per scope (the five horizons plus `selic`, whose axis is the Copom meeting) — the indicator set differs by scope (9 monthly vs 26 annual)
`bcb_cambio_cotacao`	PTAX quote for a currency (USD by default), single day or date range
`bcb_cambio_moedas`	Currencies with quotes published by the BCB
`search`	OpenAI Deep Research contract: searches the series catalog (curated + open data portal index) and returns `{ id, title, url }` — see ChatGPT (Deep Research)
`fetch`	OpenAI Deep Research contract: returns one series as a readable document with its canonical public URL

Resources

Reference catalogs the server exposes as MCP resources (read-only contextual data that clients can attach):

URI	Description
`bcb://series/populares`	Catalog of 135 verified BCB economic series, organized by category (JSON)
`bcb://series/categorias`	List of available categories in the series catalog (JSON)
`bcb://series/principais`	Codes of the most-used indicators — Selic, IPCA, USD/BRL, GDP, etc. (JSON)

Prompts

Ready-made templates the server provides as MCP prompts:

Prompt	Description
`indicadores_atuais`	Query Brazil's key economic indicators (Selic, IPCA, USD/BRL, IBC-Br)
`panorama_economico`	Generate a complete overview of the Brazilian economy
`comparar_inflacao`	Compare Brazil's main inflation indices (IPCA, IGP-M, INPC) over the last 12 months

Installation

Via Smithery (recommended)

Visit bcb-br-mcp on Smithery and follow the installation instructions for your MCP client.

Via URL (Claude.ai, Claude Desktop, any 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.

Via npx (Claude Desktop)

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"]
    }
  }
}

Via global install

npm install -g bcb-br-mcp

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

ChatGPT (Deep Research)

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.

Usage Examples

Get the current Selic rate

What is the current Selic interest rate?
→ Uses bcb_indicadores_atuais

IPCA history for 2024

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

List inflation indicators

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

Search for USD exchange rate series

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

Calculate USD/BRL variation

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

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

Series Catalog (135)

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.

Juros (14)

Code	Name	Periodicity	Name source
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)

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

Câmbio (13)

Code	Name	Periodicity	Name source
1	Taxa de câmbio - Livre - Dólar americano (venda) - diário	Diária	`portal`
10813	Taxa de câmbio - Livre - Dólar americano (compra)	Diária	`portal`
3698	Taxa de câmbio - PTAX - Dólar americano (venda)	Mensal	`medido`
3697	Taxa de câmbio - PTAX - Dólar americano (compra)	Mensal	`medido`
3695	Taxa de câmbio - PTAX - Dólar americano (média)	Mensal	`medido`
21619	Taxa de câmbio - Euro (venda)	Diária	`medido`
21620	Taxa de câmbio - Euro (compra)	Diária	`medido`
21623	Taxa de câmbio - Libra Esterlina (venda)	Diária	`medido`
21624	Taxa de câmbio - Libra Esterlina (compra)	Diária	`medido`
21621	Taxa de câmbio - Iene (venda)	Diária	`medido`
21622	Taxa de câmbio - Iene (compra)	Diária	`medido`
21625	Taxa de câmbio - Franco Suíço (venda)	Diária	`medido`
21626	Taxa de câmbio - Franco Suíço (compra)	Diária	`medido`

Atividade Econômica (21)

Code	Name	Periodicity	Name source
4380	PIB mensal - Valores correntes (R$ milhões)	Mensal	`medido`
4381	PIB acumulado no ano - Valores correntes (R$ milhões)	Mensal	`medido`
4382	PIB acumulado dos últimos 12 meses - Valores correntes (R$ milhões)	Mensal	`medido`
4385	PIB mensal em US$ (milhões)	Mensal	`medido`
4386	PIB acumulado no ano em US$ (milhões)	Mensal	`medido`
7324	PIB anual em US$ (milhões)	Anual	`medido`
24363	Índice de Atividade Econômica do Banco Central - IBC-Br	Mensal	`portal`
24364	Índice de Atividade Econômica do Banco Central (IBC-Br) - com ajuste sazonal	Mensal	`portal`
29601	Índice de Atividade Econômica do Banco Central (IBC-Br) Agropecuária	Mensal	`portal`
29602	Índice de Atividade Econômica do Banco Central (IBC-Br) Agropecuária - com ajuste sazonal	Mensal	`portal`
29603	Índice de Atividade Econômica do Banco Central (IBC-Br) Indústria	Mensal	`portal`
29604	Índice de Atividade Econômica do Banco Central (IBC-Br) Indústria - com ajuste sazonal	Mensal	`portal`
29605	Índice de Atividade Econômica do Banco Central (IBC-Br) Serviços	Mensal	`portal`
29606	Índice de Atividade Econômica do Banco Central (IBC-Br) Serviços - com ajuste sazonal	Mensal	`portal`
22103	Exportação de bens e serviços - Trimestral	Trimestral	`medido`
22104	Importação de bens e serviços - Trimestral	Trimestral	`medido`
22109	Consumo das famílias - Trimestral	Trimestral	`medido`
22110	Consumo do governo - Trimestral	Trimestral	`medido`
22111	Formação bruta de capital fixo - Trimestral	Trimestral	`medido`
21859	Produção industrial - Geral - Variação mensal	Mensal	`medido`
21862	Utilização da capacidade instalada - Indústria	Mensal	`medido`

Emprego (4)

Code	Name	Periodicity	Name source
24369	Taxa de desocupação - PNAD Contínua	Mensal	`medido`
24380	Rendimento médio real habitual - Todos os trabalhos	Mensal	`medido`
24381	Massa de rendimento real habitual	Mensal	`medido`
28561	CAGED - Saldo de empregos formais	Mensal	`medido`

Fiscal (7)

Code	Name	Periodicity	Name source
4503	Dívida Líquida do Setor Público (% PIB) - Total - Governo Federal e Banco Central	Mensal	`portal`
4513	Dívida Líquida do Setor Público (% PIB) - Total - Setor público consolidado	Mensal	`portal`
4505	Dívida Líquida do Setor Público (% PIB) - Total - Banco Central	Mensal	`portal`
4536	Dívida líquida do governo geral (% PIB)	Mensal	`portal`
4537	Dívida bruta do governo geral (% PIB) - Metodologia utilizada até 2007	Mensal	`portal`
5364	Receita total do governo central	Mensal	`medido`
5793	NFSP sem desvalorização cambial (% PIB) - Fluxo acumulado em 12 meses - Resultado primário - Total - Setor público consolidado	Mensal	`portal`

Setor Externo (12)

Code	Name	Periodicity	Name source
3546	Reservas internacionais - Conceito liquidez - Total	Mensal	`medido`
13621	Reservas internacionais - Conceito caixa - Total - diária	Diária	`portal`
22707	Balança comercial - Balanço de Pagamentos - mensal - saldo	Mensal	`portal`
22708	Exportação de bens - Balanço de Pagamentos - mensal	Mensal	`portal`
22709	Importação de bens - Balanço de Pagamentos - mensal	Mensal	`portal`
22714	Bens exportados sob merchanting - exportações positivas - mensal	Mensal	`portal`
22701	Transações correntes - mensal - saldo	Mensal	`portal`
22704	Balança comercial e Serviços - mensal - saldo	Mensal	`portal`
22715	Bens importados sob merchanting - exportações negativas - mensal	Mensal	`portal`
22716	Balança comercial - ouro não monetário - Balanço de Pagamentos - mensal - saldo	Mensal	`portal`
22846	Renda secundária - Demais setores - Transferências pessoais - mensal - receita	Mensal	`portal`
22885	Investimentos diretos no país - IDP - mensal - líquido	Mensal	`portal`

Crédito (30)

Code	Name	Periodicity	Name source
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)

Code	Name	Periodicity	Name source
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)

Code	Name	Periodicity	Name source
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`

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.

Finding Other Series

The SGS database contains over 18,000 time series. To find codes for other series:

Visit the BCB SGS Portal
Search for the desired series
Note the series code
Use that code with this server's tools

Technical Details

Robustness

Timeout: 30 seconds per request (prevents hanging)
Auto-retry: 3 attempts with exponential backoff (1s, 2s, 4s) for transient failures; client errors (4xx) are not retried, since they are deterministic
Error handling: Clear error messages

Working around the SGS limits

Measured against the live API, not inferred from documentation:

A date window over 10 years on a daily series is refused with HTTP 406, and so is an open window (no 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.
There is no per-series metadata endpoint (/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.

Derived values

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).

Smart Search

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 match

The 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 source and licence

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.

Provenance block

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.

Two 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.
One block per provenance, never merged. 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.

Development

Requirements

Node.js >= 18.0.0

Setup

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

Build

npm run build

Local testing (stdio)

npm run dev

Local testing (HTTP worker)

npm run dev:worker

Or use the MCP Inspector:

npx @modelcontextprotocol/inspector npm run dev

BCB API

This server uses the Brazilian Central Bank's public API:

Base endpoint: https://api.bcb.gov.br/dados/serie/bcdata.sgs.{code}/dados
Format: JSON
Authentication: None (public API)
Documentation: BCB Open Data

Changelog

v1.4.1

bcb_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.

v1.4.0

Three APIs under one contract, 8 tools → 13. Focus market-expectations survey (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.
Real search. 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.
Every Focus and PTAX field name verified against the live API, including the Top 5 Selic resource, which publishes its fields in a different case from the other twelve.
ODbL obligations shipped with the exchange-rate tools: the BCB disclaimer is passed through verbatim, and non-USD parities are qualified as third-party (Refinitiv) data redistributed by the BCB.

v1.2.0

HTTP endpoint via Cloudflare Workers (https://bcb.sidneybissoli.workers.dev)
Published on Smithery.ai
Refactored: tool logic extracted to src/tools.ts (shared between stdio and HTTP)

v1.1.0

New tool bcb_variacao for percentage variation calculation
New tool bcb_comparar for comparing multiple series
30-second timeout on requests
Auto-retry with exponential backoff (3 attempts)
Normalized search (accent-insensitive)
Additional statistics (max, min, average, range)

v1.0.0

Initial release
6 basic tools
Catalog with 135 verified series

Contributing

Contributions are welcome! Please:

Fork the repository
Create a feature branch (git checkout -b feature/new-feature)
Commit your changes (git commit -m 'Add new feature')
Push to the branch (git push origin feature/new-feature)
Open a Pull Request

License

Two licences, and they are not the same thing.

Code: MIT — see LICENSE.
Data: from the Banco Central do Brasil, under the Open Data Commons Open Database License (ODbL) v1.0 — https://opendatacommons.org/licenses/odbl/1-0/. Not CC0, not CC BY, not public domain: the ODbL requires attribution, has a share-alike clause on derived databases, and an anti-DRM clause.

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.

Author

Sidney da Silva Pereira Bissoli

GitHub: @SidneyBissoli
Email: sbissoli76@gmail.com

Useful Links

Available Tools

15 tools

bcb_buscar_serieA

Read-onlyIdempotent

Inspect

Busca séries do BCB por palavra-chave (ou pelo código) em DUAS camadas: o catálogo curado local de 139 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 BCB, com milhares de séries identificadas por código. Ignora acentos e maiúsculas ('inflacao' encontra 'Inflação'); vários termos são combinados com E ('ipca servicos'). Quando usar: para descobrir o código de uma série antes de consultar valores. Quando NÃO usar: para navegar tudo por categoria use bcb_series_populares; para valores use bcb_serie_valores. Retorna: termo, totalEncontradas, series (cada item com codigo, nome, origem — 'curado' ou 'indice' — e, no índice, dataset com a página do portal), catalogo (origem, obtidoEm, seriesIndexadas, cobertura) e, quando aplicável, observacao, avisos, mensagem e sugestao. Cobertura: o índice NÃO é o SGS inteiro, portanto não encontrar aqui não prova que a série não exista — o campo catalogo.cobertura diz isso explicitamente em toda resposta. Comportamento de rede: o índice é servido de cache com validade de 24 h e a renovação é feita pela primeira busca após o vencimento (uma requisição ao portal, ~1 s); as demais buscas não tocam a rede. Se o portal estiver fora, a busca degrada para o catálogo curado (ou para o último índice obtido) e sinaliza em avisos, sempre com a data de obtenção visível.

ParametersJSON Schema

Name	Required	Description	Default
`termo`	Yes	Termo de busca (mínimo 2 caracteres) ou o código da série. Vários termos são combinados com E.
`limite`	No	Máximo de séries a devolver (1-100, padrão: 20). `totalEncontradas` traz o total antes do corte.

Output Schema

ParametersJSON Schema

Name	Required	Description
`termo`	Yes	Termo pesquisado
`avisos`	No	Avisos de degradação (índice vencido ou indisponível)
`series`	Yes	Séries que correspondem ao termo — as do catálogo curado primeiro
`catalogo`	Yes	Proveniência do índice usado na busca
`mensagem`	No	Mensagem exibida quando nada é encontrado
`sugestao`	No	Sugestões de termos alternativos
`observacao`	No	Aviso de corte quando há mais resultados que `limite`
`provenance`	Yes	Um bloco por procedência que contribuiu com esta resposta (contrato v1.0; licenças nunca se fundem)
`attribution`	Yes	URLs canônicas das fontes desta resposta (lista de atribuição)
`totalEncontradas`	Yes	Quantidade de séries encontradas, antes do corte por `limite`

TDQS

A4.8/5.0

Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint=true, idempotentHint=true, openWorldHint=true and destructiveHint=false, establishing safety. The description goes far beyond these with rich behavioral disclosure: accent/case-insensitive matching, AND-combination semantics, 24h cache validity, network behavior (only first search after expiry touches network), degraded mode with fallback to curated catalog, and coverage caveat that the index is not the full SGS. No contradiction with annotations — the openWorldHint aligns perfectly with the 'not finding doesn't prove non-existence' warning.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is long but from-loaded with the core purpose and two-layer behavior first. Every sentence carries new information: search semantics, usage guidance, return format, coverage limitation, network behavior, degradation. Given the tool's genuine complexity (dual-source search, caching, fallbacks), the length is justified. Slight structural improvement possible by separating return-schema details (already covered by output schema) from usage guidance, but overall efficient.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With an output schema present and rich annotations (readOnly, idempotent, openWorld), the description still adds significant value: coverage limitation explicitly stated, network/caching behavior with timing, degradation path and signal mechanism (`avisos`), and search semantics not derivable from schema. For a dual-layer search tool with external dependency on the BCB portal, this is comprehensive and leaves no critical behavioral gap for the agent.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema covers both parameters at 100% (termo: min 2 chars, code or term, AND-combination; limite: 1-100, default 20), so baseline is 3. The description adds value by explaining search semantics beyond schema: accent/case insensitivity ('inflacao' finds 'Inflação'), the two-layer interpretation of results, and that `termo` accepts a code. A small gap: the caching/degradation behavior is stated at the tool level but not tied explicitly to how it affects `termo` results — minor, so 4 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Description opens with a specific verb+resource: 'Busca séries do BCB por palavra-chave (ou pelo código)' with a clear two-layer model (curated local catalog vs. BCB open data portal index). It actively distinguishes itself from siblings by naming bcb_series_populares and bcb_serie_valores for alternative use cases. This fully clarifies both what the tool does and how it differs from peers.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicit guidance is provided: 'Quando usar: para descobrir o código de uma série antes de consultar valores' and 'Quando NÃO usar: para navegar tudo por categoria use bcb_series_populares; para valores use bcb_serie_valores.' This names specific sibling alternatives, giving the agent precise decision criteria for tool selection.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

bcb_cambio_cotacaoA

Read-onlyIdempotent

Inspect

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 usar: para a cotação oficial de fechamento de um dia ou a série de um período curto. Quando NÃO usar: para a série histórica longa do dólar como série temporal do SGS use bcb_serie_valores (códigos 1 = livre venda, 3698 = PTAX venda, 3697 = PTAX compra, 3695 = PTAX média) — esta tool é a fonte primária do boletim, com compra e venda no mesmo registro; para descobrir o símbolo da moeda use bcb_cambio_moedas. Retorna: moeda, periodo (dataInicial, dataFinal, janelaPadrao), totalRegistros, cotacoes, disclaimer, qualificacaoParidade (só para moedas não-dólar), urlConsulta, consultadoEm e, quando aplicável, observacao. Sem datas, cobre os últimos 7 dias (para atravessar fim de semana e feriado). Fonte: PTAX / Cotações e boletins de câmbio do Banco Central do Brasil, via Olinda OData. A resposta repassa literalmente o disclaimer de responsabilidade do BCB, em disclaimer. Cotações existem só em dia útil com fechamento de câmbio. As paridades de moedas não-dólar vêm de agência de informação (Refinitiv), redistribuídas pelo BCB — não são apuradas pelo Banco Central.

ParametersJSON Schema

Name	Required	Description	Default
`data`	No	Dia específico (yyyy-MM-dd ou dd/MM/yyyy). Não combine com dataInicial/dataFinal.
`moeda`	No	Símbolo da moeda (ex.: USD, EUR, GBP, JPY). Padrão: USD.	USD
`limite`	No	Máximo de boletins a devolver (1-1000, padrão 100)
`dataFinal`	No	Fim do intervalo (yyyy-MM-dd ou dd/MM/yyyy). Padrão: hoje.
`dataInicial`	No	Início do intervalo (yyyy-MM-dd ou dd/MM/yyyy). Padrão: 7 dias antes do fim.

Output Schema

ParametersJSON Schema

Name	Required	Description
`moeda`	Yes
`periodo`	Yes
`cotacoes`	Yes
`disclaimer`	Yes	Disclaimer de responsabilidade do BCB, repassado literalmente
`observacao`	No
`provenance`	Yes	Um bloco por procedência que contribuiu com esta resposta (contrato v1.0; licenças nunca se fundem)
`attribution`	Yes	URLs canônicas das fontes desta resposta (lista de atribuição)
`urlConsulta`	Yes
`consultadoEm`	Yes
`totalRegistros`	Yes
`qualificacaoParidade`	No	Qualificação da origem das paridades não-dólar

TDQS

A4.6/5.0

Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint, openWorldHint, idempotentHint, and destructiveHint=false, so the read-only profile is clear. The description adds substantial behavioral context: the default 7-day window, business-day-only quotes, Refinitiv coverage for non-USD parities, BCB disclaimer passthrough, and the origin of the data. This goes well beyond the annotations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is longer than minimal, but it is well structured with clear sections: purpose, when to use, when not to use, return fields, source, and caveats. It is front-loaded and organized enough to scan, although the return field list is partially redundant given the existing output schema.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 5-parameter read-only query tool with a rich output schema and strong annotations, this description is complete enough. It covers default behavior, business-day limitations, the meaning of the data, the external source of non-USD parities, and when a sibling tool should be used instead.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema already has 100% parameter coverage with defaults, constraints, and format examples, so the baseline is 3. The description reinforces the default 7-day window and day-versus-range distinction, but most of that is already expressed in the schema; the description adds only modest contextual color for parameters.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description opens with a precise action ('Consulta a cotação PTAX de uma moeda contra o real') and clearly states the supported scope: a specific day or a date range. It also differentiates from siblings explicitly by naming bcb_serie_valores for long SGS series and bcb_cambio_moedas for currency symbol lookup.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description contains an explicit 'Quando usar' and 'Quando NÃO usar' section. It tells the agent exactly when to prefer this tool and when to use alternatives, including the specific SGS series codes for dollar—which is unusually clear guidance.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

bcb_cambio_moedasA

Read-onlyIdempotent

Inspect

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ção. Retorna: termo, totalMoedas, moedas (simbolo, nome, tipo), disclaimer, qualificacaoParidade, urlConsulta e consultadoEm. Fonte: PTAX / Cotações e boletins de câmbio do Banco Central do Brasil, via Olinda OData. A resposta repassa literalmente o disclaimer de responsabilidade do BCB, em disclaimer. Cotações existem só em dia útil com fechamento de câmbio.

ParametersJSON Schema

Name	Required	Description	Default
`termo`	No	Filtro por símbolo ou nome (ex.: 'EUR', 'libra'). Opcional.

Output Schema

ParametersJSON Schema

Name	Required	Description
`termo`	No	Termo aplicado no filtro; nulo quando não foi informado
`moedas`	Yes
`disclaimer`	Yes
`observacao`	No
`provenance`	Yes	Bloco de proveniência (contrato v1.0): fonte, URL, competência, extração e licença
`attribution`	Yes	URLs canônicas das fontes desta resposta (lista de atribuição)
`totalMoedas`	Yes
`urlConsulta`	Yes
`consultadoEm`	Yes
`qualificacaoParidade`	No

TDQS

A4.7/5.0

Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Beyond annotations (readOnlyHint, idempotentHint), the description adds context: the response includes a literal disclaimer from BCB, quotes only exist on business days, and the data source is PTAX via Olinda OData. These are meaningful behavioral details not present in annotations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is well-structured with clear sections (what, when, when-not, returns, source, caveats). Every sentence contributes useful information, and the essential use case is front-loaded.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The description covers all necessary context: the tool's purpose, return fields, source, usage caveats, and relationship to sibling tools. It is complete for a simple, single-parameter, read-only tool.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The single parameter 'termo' is fully described in the schema (100% coverage), and the description only restates that it filters without adding new semantic meaning. The baseline of 3 applies as the schema carries the burden.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool lists currencies with quotes from the Central Bank, including symbol, name, and type, and accepts a filter term. It distinguishes itself from the sibling bcb_cambio_cotacao by explicitly positioning it as a precursor to that tool, eliminating ambiguity.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description explicitly states when to use ('para descobrir o símbolo correto antes de chamar bcb_cambio_cotacao') and when not to use ('para valores de cotação'), naming the alternative tool. This provides direct, actionable guidance.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

bcb_compararA

Read-onlyIdempotent

Inspect

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íodo (IPCA, INPC, IGP-M mensais do catálogo; Selic/CDI acumulados no mês; poupança) entra pelo ACUMULADO encadeado do período — cada item diz em metodo qual conta foi feita, então "qual índice de preço subiu mais em 2024" é esta tool. Quando usar: para comparar/correlacionar a evolução de vários indicadores lado a lado. Quando NÃO usar: para uma única série use bcb_variacao. Retorna: periodo, totalSeries, seriesComDados, seriesComErro, ranking (cada item com posicao, codigo, nome, metodo, valorInicial, valorFinal, variacaoPercentual, maximo, minimo, media) e erros. Resiliente: séries sem dados no período, e séries de acumulado móvel (IPCA em 12 meses), são isoladas em erros sem invalidar a comparação. Periodicidades diferentes: comparar uma série diária com uma mensal alinha pontos que não são comparáveis, e a resposta avisa isso em aviso; informe frequencia (mensal|trimestral|anual) para harmonizar todas na mesma grade antes de comparar, escolhendo a convenção em agregacao. Janelas longas em séries diárias são fatiadas automaticamente (limite de 10 anos da API do BCB). Comportamento: consome a API pública SGS do Banco Central do Brasil — sem autenticação, chave de API ou cadastro, e sem limite de requisições divulgado (uso é best-effort). Em falha transitória ou timeout a chamada é repetida automaticamente (até 3 tentativas, backoff exponencial); persistindo o erro, retorna isError: true com mensagem em português (HTTP 404 = série inexistente ou sem dados no período solicitado). O resultado vem como JSON tanto em texto quanto em structuredContent (conforme o outputSchema); datas no formato dd/MM/yyyy e valores numéricos (ponto decimal).

ParametersJSON Schema

Name	Required	Description	Default
`codigos`	Yes	Array com 2 a 5 códigos de séries para comparar
`agregacao`	No	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 (IPCA mensal, por exemplo), compondo geometricamente — somar 12 variações mensais NÃO dá a inflação do ano.	ultimo
`dataFinal`	Yes	Data final (yyyy-MM-dd ou dd/MM/yyyy)
`frequencia`	No	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 periodicidades diferentes.
`dataInicial`	Yes	Data inicial (yyyy-MM-dd ou dd/MM/yyyy)

Output Schema

ParametersJSON Schema

Name	Required	Description
`aviso`	No	Presente quando as séries comparadas têm periodicidades diferentes e nenhuma harmonização foi pedida — os números do ranking, nesse caso, não são diretamente comparáveis entre si.
`erros`	Yes	Séries que não retornaram dados, com o motivo
`periodo`	Yes	Janela temporal comparada
`ranking`	Yes	Séries ordenadas pela variação percentual (maior para menor)
`derivacao`	Yes	Origem dos números calculados: o que é derivado, por qual motor e com quais convenções
`provenance`	Yes	Bloco de proveniência (contrato v1.0): fonte, URL, competência, extração e licença
`attribution`	Yes	URLs canônicas das fontes desta resposta (lista de atribuição)
`totalSeries`	Yes	Quantidade de séries solicitadas
`harmonizacao`	No	Presente quando `frequencia` foi informada: descreve a reamostragem aplicada. Valor DERIVADO — calculado por este servidor, não publicado pelo Banco Central.
`seriesComErro`	Yes	Quantidade de séries sem dados ou com erro
`seriesComDados`	Yes	Quantidade de séries com dados no período

TDQS

A5/5.0

Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Beyond readOnly/idempotent annotations, the description discloses automatic retries (3 attempts with exponential backoff), persistent error handling (isError with Portuguese message), HTTP 404 handling, JSON response format (both text and structuredContent), and special behavior for series that are already percentage changes (acumulada aggregation).

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is long but every sentence serves a purpose, with clear separation of sections (comparison logic, usage, error handling, return fields). No redundancy or filler; structure mirrors the tool's behavior logically.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

It explicitly lists all output fields (periodo, totalSeries, seriesComDados, seriesComErro, ranking) and ranking item properties (posicao, codigo, nome, metodo, etc.), includes data format (dd/MM/yyyy, decimal point), and explains edge cases like series without data in the period.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters5/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema descriptions are already detailed, but the description adds critical context: for 'acumulada' it warns that summing monthly variations does not yield annual inflation; for 'frequencia' it states only coarser periods are allowed; and it clarifies each agregacao option's applicability (price vs flow vs percentage). This exceeds schema coverage.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description explicitly states it compares 2-5 time series over the same period, calculates percentage variation, and orders them in a ranking. It also contrasts with bcb_variacao for single-series use, making its purpose unmistakable.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It provides clear when-to-use ('compare/correlate multiple indicators side by side') and when-not-to-use ('for a single series use bcb_variacao'). It also explains when to use frequencia and agregacao parameters, including limitations on frequency resampling.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

bcb_correlacaoA

Read-onlyIdempotent

Inspect

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 cada série lado a lado use bcb_comparar; para uma série só use bcb_variacao. Métodos: pearson (padrão) mede relação LINEAR entre os valores; spearman mede relação MONÓTONA entre os postos e é o adequado quando a relação não é reta ou quando uma série fica parada em platôs (taxa de juros entre reuniões do Copom). Base: nivel (padrão) correlaciona os valores; variacao correlaciona a mudança percentual de um ponto para o outro — prefira variacao quando as duas séries têm tendência (preço, índice, estoque), porque o nível de duas séries crescentes tem correlação alta só porque ambas crescem com o tempo. Retorna: periodo, metodo, base, series, alinhamento (datas cruzadas, completas e parciais), pares (cada um com codigoA/codigoB, coeficiente entre -1 e 1, n, descartados e interpretacao em prosa), erros e derivacao. Coeficiente que não pode ser calculado vem null com motivo — nunca 0, que significaria ausência medida de relação. Periodicidades diferentes são RECUSADAS, não avisadas: cruzar uma série diária com uma mensal por data casa só as datas coincidentes (cerca de 7 por ano) e produziria um coeficiente sobre esse punhado; informe frequencia para harmonizar todas na mesma grade antes de correlacionar. Correlação não estabelece causalidade. Comportamento: consome a API pública SGS do Banco Central do Brasil — sem autenticação, chave de API ou cadastro, e sem limite de requisições divulgado (uso é best-effort). Em falha transitória ou timeout a chamada é repetida automaticamente (até 3 tentativas, backoff exponencial); persistindo o erro, retorna isError: true com mensagem em português (HTTP 404 = série inexistente ou sem dados no período solicitado). O resultado vem como JSON tanto em texto quanto em structuredContent (conforme o outputSchema); datas no formato dd/MM/yyyy e valores numéricos (ponto decimal).

ParametersJSON Schema

Name	Required	Description	Default
`base`	No	`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 tem correlação alta só porque ambas crescem com o tempo.	nivel
`metodo`	No	`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 fica parada em platôs, como a Selic entre reuniões do Copom.	pearson
`codigos`	Yes	Array com 2 a 5 códigos de séries para correlacionar par a par
`agregacao`	No	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 (IPCA mensal, por exemplo), compondo geometricamente — somar 12 variações mensais NÃO dá a inflação do ano.	ultimo
`dataFinal`	Yes	Data final (yyyy-MM-dd ou dd/MM/yyyy)
`frequencia`	No	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 periodicidades diferentes.
`dataInicial`	Yes	Data inicial (yyyy-MM-dd ou dd/MM/yyyy)

Output Schema

ParametersJSON Schema

Name	Required	Description
`base`	Yes	Se o cálculo usou os valores ou as variações
`erros`	Yes	Séries que não retornaram dados, com o motivo
`pares`	Yes	Um item por par de séries
`metodo`	Yes	Método aplicado
`series`	Yes	Séries que entraram no cálculo
`periodo`	Yes	Janela temporal correlacionada
`derivacao`	Yes	Origem dos números calculados: o que é derivado, por qual motor e com quais convenções
`provenance`	Yes	Bloco de proveniência (contrato v1.0): fonte, URL, competência, extração e licença
`alinhamento`	Yes	Como as grades foram cruzadas. `completas` é o que efetivamente entra num coeficiente: datas em que TODAS as séries publicam. A distância entre `datas` e `completas` é a medida de quanto as séries não se sobrepõem.
`attribution`	Yes	URLs canônicas das fontes desta resposta (lista de atribuição)
`harmonizacao`	No	Presente quando `frequencia` foi informada: descreve a reamostragem aplicada. Valor DERIVADO — calculado por este servidor, não publicado pelo Banco Central.

TDQS

A5/5.0

Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No contradiction with annotations (readOnlyHint=true, idempotentHint=true, openWorldHint=true). The description adds substantial behavioral context beyond annotations: uses the public SGS API with no auth, no disclosed rate limits, best-effort; retries up to 3 times with exponential backoff on transient failures; returns isError: true with error messaging in Portuguese; HTTP 404 semantics; and critically explains that different periodicities are RECUSADAS rather than naively joined—before warning about the ~7 matched days/year data-snooping pitfall.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is long but every clause earns its place—it packs statistical warnings, API contract details, and edge-case behaviors into a scan-friendly structure that uses bold, uppercase emphasis, and colons effectively (e.g., 'nunca 0', 'RECUSADAS, não avisadas'). No fluff; the causational disclaimer 'Correlação não estabelece causalidade' is a single purposeful sentence.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a complex statistical tool, the description is fully complete: it covers the mathematical methods, the output contract (`periodo`, `metodo`, `base`, `series`, `alinhamento`, `pares` with `codigoA/B` and `coeficiente`), error semantics, retry behavior, date formats, and the important distinction between null-with-reason and 0. The outputSchema covers the return structure, so the description needn't duplicate it—yet it still explains what `descartados` and `derivacao` mean contextually.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters5/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Even though schema description coverage is 100%, the description adds meaningful semantics beyond what the schema provides. It explains WHY `spearman` is appropriate for plateau series (e.g., Selic), why `acumulada` uses geometric composition (because summing monthly IPCA variations is incorrect), and how `frequencia` harmonizes different periodicities. These are non-obvious statistical implications that the raw parameter docs alone cannot convey.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description opens with a specific verb+resource+scope construction: 'Calcula a correlação estatística entre ional 2 a 5 séries temporais do BCB no MESMO período... par a par.' This immediately differentiates it from siblings by naming the statistical operation, the 2-5 series constraint, the pairwise behavior, and the mandatory same-period requirement. It also explicitly names alternatives (bcb_comparar, bcb_variacao).

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Goes beyond vague guidance with a dedicated 'Quando usar' section (with concrete indicator examples like 'dólar e Selic, IPCA e IGP-M') and a 'Quando NÃO usar' section naming specific sibling tools. It even makes a methodological prescription—prefer `variacao` when series have trends because level-based correlation is spuriously high—which actively prevents misuse.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

bcb_deflacionarA

Read-onlyIdempotent

Inspect

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 forem comparados. Quando NÃO usar: para séries que já são percentuais, índices ou taxas (deflacionar uma taxa de juros não significa nada); para a série nominal crua use bcb_serie_valores. Índice: ipca (padrão), inpc ou igpm. Base: mesBase no formato yyyy-MM define em reais de que mês os valores são expressos; sem ele, usa o último mês publicado do índice ('em reais de hoje'). Retorna: serie, deflator (índice, código, cobertura), base, periodo, dados (cada ponto com valorNominal, valorReal e fator), variacao (a percentual nominal ao lado da real no mesmo período), derivacao e avisos. Limite da fonte: o SGS não publica número-índice, então o índice é reconstruído compondo as variações mensais — reconstrução conferida contra a própria fonte (diferença máxima de 0,0052 ponto percentual contra o acumulado oficial em 12 meses). Observação fora da cobertura do índice recebe valorReal: null, nunca um valor inventado; como o índice sai com defasagem, o mês corrente costuma cair nesse caso. Comportamento: consome a API pública SGS do Banco Central do Brasil — sem autenticação, chave de API ou cadastro, e sem limite de requisições divulgado (uso é best-effort). Em falha transitória ou timeout a chamada é repetida automaticamente (até 3 tentativas, backoff exponencial); persistindo o erro, retorna isError: true com mensagem em português (HTTP 404 = série inexistente ou sem dados no período solicitado). O resultado vem como JSON tanto em texto quanto em structuredContent (conforme o outputSchema); datas no formato dd/MM/yyyy e valores numéricos (ponto decimal).

ParametersJSON Schema

Name	Required	Description	Default
`codigo`	Yes	Código da série NOMINAL a deflacionar (ex.: 1619 para salário mínimo)
`indice`	No	Índice de preços usado como deflator: IPCA (433), INPC (188) ou IGP-M (189)	ipca
`mesBase`	No	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'.
`agregacao`	No	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 (IPCA mensal, por exemplo), compondo geometricamente — somar 12 variações mensais NÃO dá a inflação do ano.	ultimo
`dataFinal`	Yes	Data final (yyyy-MM-dd ou dd/MM/yyyy)
`frequencia`	No	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 periodicidades diferentes.
`dataInicial`	Yes	Data inicial (yyyy-MM-dd ou dd/MM/yyyy)

Output Schema

ParametersJSON Schema

Name	Required	Description
`base`	Yes	Mês em cujos preços os valores reais estão expressos
`dados`	Yes	Observações com o valor publicado e o valor em moeda constante
`serie`	Yes	Identificação da série nominal
`avisos`	No	Ressalvas sobre cobertura do índice ou mês base substituído
`periodo`	Yes
`chunking`	No	Presente quando a consulta foi fatiada em várias requisições à origem, por causa do limite de 10 anos por janela em séries diárias. As fatias são fundidas e ordenadas antes de responder.
`deflator`	Yes	Índice de preços usado e o intervalo que ele cobre
`variacao`	Yes	Variação percentual do período em moeda corrente ao lado da variação em moeda constante — é a comparação que a tool existe para entregar. `null` quando há menos de duas observações deflacionadas.
`derivacao`	Yes	Origem dos números calculados: o que é derivado, por qual motor e com quais convenções
`provenance`	Yes	Bloco de proveniência (contrato v1.0): fonte, URL, competência, extração e licença
`attribution`	Yes	URLs canônicas das fontes desta resposta (lista de atribuição)
`harmonizacao`	No	Presente quando `frequencia` foi informada: descreve a reamostragem aplicada. Valor DERIVADO — calculado por este servidor, não publicado pelo Banco Central.
`janelaAplicada`	No	Presente quando o período pedido estava aberto numa série diária e o servidor aplicou uma janela própria (a origem recusa janela aberta em série diária com HTTP 406).

TDQS

A5/5.0

Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Even with annotations describing readOnlyHint, openWorldHint, and idempotentHint as true, the description adds substantial value: it discloses the API endpoint (SGS), authentication-free usage, rate limits as 'best-effort', retry logic (3 attempts, exponential backoff), error semantics, and the reconstruction limitation with a quantified accuracy (0.0052 pp). This goes far beyond the annotations without contradicting them.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Despite its length, the description is densely informative with no fluff. Each sentence adds essential context: the nominal-vs-real distinction, parameter explanations, error handling, and limitations are all covered without repetition. The structure flows logically from what → when → how → edge cases.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the complexity of the tool (deflating series, handling frequency aggregation, dealing with index publication lags), the description thoroughly covers all necessary context: what the tool does, how to use it correctly, what the output fields mean, and what to expect in terms of failures and limitations. It also clearly separates the tool from its siblings, making it a complete guide.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters5/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Although schema description coverage is 100%, the description enriches parameter understanding: it clarifies that `indice` maps to specific index codes (IPCA=433), the meaning of `mesBase` default, and the semantics of `agregacao` with a crucial caution about not summing monthly variations. This guidance directly prevents misuse even though the schema already lists descriptions.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description starts with a clear, specific verb+resource: 'Converte uma série NOMINAL do BCB em valores REAIS (moeda constante)'. It distinguishes itself from siblings by explicitly naming alternatives like bcb_serie_valores for the raw nominal series, and provides a concrete real-world example. The distinction from sibling tools (including the when NOT to use case for percentage/index/rate series) is explicit and actionable.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Offers explicit 'Quando usar:' and 'Quando NÃO usar' sections, referencing the sibling bcb_serie_valores for the nominal case. It clearly explains the purpose of each parameter (índice, base, etc.) and provides behavioral nuances like the reconstruction limitation and how dates/out-of-coverage are handled, which directly informs when this tool is appropriate.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

bcb_focus_expectativasA

Read-onlyIdempotent

Inspect

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 coleta. Quando usar: para expectativa de IPCA, IGP-M, PIB, câmbio e afins em um mês, trimestre ou ano específico, ou para a inflação rolante. Quando NÃO usar: para expectativa de Selic por reunião do Copom use bcb_focus_selic; para o valor REALIZADO (não esperado) use bcb_serie_valores. Regras do contrato: referencia é obrigatória nos horizontes de calendário (mensal, trimestral, anual) e recusada nos rolantes; suavizada só vale nos rolantes; top5: true traz as expectativas das cinco instituições mais assertivas e existe nos cinco horizontes. Se não souber o texto exato do indicador ou da referência, chame bcb_focus_referencias primeiro — o conjunto de indicadores MUDA por horizonte, e pedir um indicador no horizonte em que a fonte não o publica é a causa mais comum de resposta vazia. Retorna: indicador, horizonte, base (consenso|top5), filtro (referencia, dataInicial, dataFinal, janelaPadrao, suavizada), totalRegistros, expectativas (array normalizado), urlConsulta, consultadoEm e, quando aplicável, observacao. Sem datas, a janela padrão é de 30 dias. Fonte: Expectativas de Mercado (Focus) do Banco Central do Brasil, via Olinda OData. O Focus é vintage por construção: coletadoEm é a data da coleta e referencia é o alvo da expectativa — a mesma referência aparece em muitas coletas, e é isso que permite ver a expectativa mudar no tempo. A contagem é feita do nosso lado porque a fonte ignora $count; e o filtro é obrigatório por construção porque consulta sem filtro não completa na origem. Microdados por instituição NÃO são expostos: a fonte desativou esse recurso por risco de quebra de confidencialidade.

ParametersJSON Schema

Name	Required	Description
`top5`	No	Expectativas do Top 5 (as cinco instituições mais assertivas) em vez do consenso; existe nos cinco horizontes
`limite`	No	Máximo de coletas a devolver (1-500, padrão 50)
`dataFinal`	No	Fim da janela de COLETA (yyyy-MM-dd ou dd/MM/yyyy). Padrão: hoje.
`horizonte`	Yes	mensal, trimestral e anual usam `referencia`; inflacao_12m e inflacao_24m são rolantes e não usam
`indicador`	Yes	Indicador exatamente como a fonte publica (ex.: 'IPCA', 'IGP-M', 'PIB Total', 'Câmbio'). Veja bcb_focus_referencias.
`suavizada`	No	Só nos horizontes rolantes: série suavizada (true) ou não suavizada (false)
`referencia`	No	Alvo da expectativa: MM/yyyy (mensal), T/yyyy (trimestral) ou yyyy (anual). Obrigatória nesses três; proibida nos rolantes.
`dataInicial`	No	Início da janela de COLETA (yyyy-MM-dd ou dd/MM/yyyy). Padrão: 30 dias antes do fim.

Output Schema

ParametersJSON Schema

Name	Required	Description
`base`	Yes
`filtro`	Yes	Filtro efetivamente aplicado na origem; nulo onde o parâmetro não foi informado
`horizonte`	Yes
`indicador`	Yes
`observacao`	No
`provenance`	Yes	Bloco de proveniência (contrato v1.0): fonte, URL, competência, extração e licença
`attribution`	Yes	URLs canônicas das fontes desta resposta (lista de atribuição)
`urlConsulta`	Yes	URL OData consultada, reproduzível no navegador
`consultadoEm`	Yes	Timestamp ISO 8601 da consulta
`expectativas`	Yes
`totalRegistros`	Yes	Coletas encontradas (contagem client-side)

TDQS

A4.6/5.0

Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Beyond the readOnlyHint, the description discloses important behaviors: the Focus is vintage by construction, the count is done server-side because the source ignores $count, the filter is mandatory because unfiltered queries never complete, and microdata are not exposed due to confidentiality. This gives the agent a full understanding of the tool's constraints.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is lengthy but well-structured with clear sections (Quando usar, Quando NÃO usar, Regras do contrato, Retorna). It front-loads the core purpose and every paragraph adds useful context; minor redundancy with schema is acceptable given the tool's complexity.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The description covers all relevant aspects: return fields, default 30-day window, data source, vintage semantics, server-side count, mandatory filter, and confidentiality limits. With an output schema present, this is more than sufficient for an agent to use the tool correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema already describes all parameters with 100% coverage, including the rules for referencia and suavizada. The description reinforces these rules but adds little new semantic detail beyond what the schema provides, though it does clarify the relationship between horizons and indicator availability.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description opens with a specific verb and resource: 'Consulta as expectativas de mercado do boletim Focus para UM indicador' and lists the five horizons. It explicitly distinguishes itself from siblings by naming bcb_focus_selic for Selic expectations and bcb_serie_valores for realized values.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description contains explicit 'Quando usar' and 'Quando NÃO usar' sections, naming alternative tools. It also advises to call bcb_focus_referencias first if uncertain about indicator text, which is crucial for avoiding empty responses.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

bcb_focus_referenciasA

Read-onlyIdempotent

Inspect

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 do Copom, e quem a consome é bcb_focus_selic. Cada bloco diz em tool quem o consome. Quando usar: antes da primeira consulta ao Focus, ou quando uma consulta volta vazia — a causa mais comum não é o dado faltar, é o indicador não existir NAQUELE escopo (a fonte publica 9 indicadores no mensal e 26 no anual: 'PIB Total', por exemplo, não existe no mensal) ou a referência estar num formato diferente do publicado. Quando NÃO usar: para os valores das expectativas em si. Sem escopo, consulta os seis e devolve tudo; com escopo, consulta só aquele. Retorna: escopos (para cada um: tool que o consome, formatoReferencia, exigeReferencia, temTop5, indicadores, referencias, urlConsulta e disponivel), mais indicadores e referencias como união de todos, janela, totalRegistros e consultadoEm. Se algum escopo não responder, os demais voltam mesmo assim, com falhas preenchido. Fonte: Expectativas de Mercado (Focus) do Banco Central do Brasil, via Olinda OData. O Focus é vintage por construção: coletadoEm é a data da coleta e referencia é o alvo da expectativa — a mesma referência aparece em muitas coletas, e é isso que permite ver a expectativa mudar no tempo. A contagem é feita do nosso lado porque a fonte ignora $count; e o filtro é obrigatório por construção porque consulta sem filtro não completa na origem. Microdados por instituição NÃO são expostos: a fonte desativou esse recurso por risco de quebra de confidencialidade.

ParametersJSON Schema

Name	Required	Description	Default
`escopo`	No	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.
`indicador`	No	Filtrar por um indicador específico, para ver em quais escopos ele existe (opcional)

Output Schema

ParametersJSON Schema

Name	Required	Description
`falhas`	No	Escopos que não responderam nesta consulta
`filtro`	No	Filtro pedido; nulo onde o parâmetro não foi informado
`janela`	Yes	Janela de coleta observada para montar as listas
`escopos`	Yes	Um bloco por escopo: regras do contrato mais o que a fonte publica nele
`observacao`	No
`provenance`	Yes	Bloco de proveniência (contrato v1.0): fonte, URL, competência, extração e licença
`attribution`	Yes	URLs canônicas das fontes desta resposta (lista de atribuição)
`indicadores`	Yes	União dos indicadores de todos os escopos consultados
`referencias`	Yes	União das referências de todos os escopos consultados
`consultadoEm`	Yes
`totalRegistros`	Yes
`observacaoFalhas`	No

TDQS

A5/5.0

Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint=true and destructiveHint=false, and the description adds substantial behavioral context: partial results with 'falhas' if some scope fails, the origin ignores '$count', unfiltered queries do not complete, and microdata by institution is intentionally not exposed. No contradictions.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is long but tightly structured and front-loaded. Each section earns its place: exact output purpose, usage timing, negative usage, parameter behavior, failure semantics, source context, and data-vintage explanation. It avoids fluff and uses formatting emphasis and clear transitions.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the presence of an output schema and annotations, the description still covers necessary non-schema context: when to call, scope semantics, failure resilience, counting/filtering constraints, source attribution, and the conceptual model of 'coletado' versus 'referencia'. It is complete for a discovery tool feeding bcb_focus_expectativas and bcb_focus_selic.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters5/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, but the description adds real meaning beyond the enum: it explains that 'selic' is not a horizon but the Copom meeting axis, that the other scopes map to the horizons of bcb_focus_expectativas, and that omitting 'escopo' returns everything while providing it restricts the query. It also explains the optional 'indicador' use case in the context of discovering which scopes contain it.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description opens with a specific verb+resource: 'Lista, POR ESCOPO, os indicadores e as referências que o Focus efetivamente publica' and immediately ties it to exact use in sibling tools. It clearly distinguishes this discovery tool from bcb_focus_expectativas and bcb_focus_selic.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It explicitly says when to use ('antes da primeira consulta ao Focus, ou quando uma consulta volta vazia'), when not to use ('Quando NÃO usar: para os valores das expectativas em si'), and names the alternatives that consume the result. This is exemplary usage guidance.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

bcb_focus_selicA

Read-onlyIdempotent

Inspect

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 espera da Selic na próxima reunião' ou a trajetória esperada de juros. Quando NÃO usar: para expectativa de Selic média de um ano civil use bcb_focus_expectativas com horizonte anual; para a Selic REALIZADA use bcb_serie_valores (códigos 432, 1178, 4390). É separada de bcb_focus_expectativas porque o eixo temporal é a reunião do Copom, não o calendário. Retorna: base (consenso|top5), filtro, totalRegistros, expectativas (com referencia = reunião), urlConsulta, consultadoEm e observacaoEixo. Sem datas, a janela padrão é de 30 dias. Fonte: Expectativas de Mercado (Focus) do Banco Central do Brasil, via Olinda OData. O Focus é vintage por construção: coletadoEm é a data da coleta e referencia é o alvo da expectativa — a mesma referência aparece em muitas coletas, e é isso que permite ver a expectativa mudar no tempo. A contagem é feita do nosso lado porque a fonte ignora $count; e o filtro é obrigatório por construção porque consulta sem filtro não completa na origem. Microdados por instituição NÃO são expostos: a fonte desativou esse recurso por risco de quebra de confidencialidade.

ParametersJSON Schema

Name	Required	Description
`top5`	No	Expectativas do Top 5 em vez do consenso
`limite`	No	Máximo de coletas a devolver (1-500, padrão 50)
`reuniao`	No	Reunião do Copom no formato R1/2026 (opcional; sem ela, todas as reuniões da janela)
`dataFinal`	No	Fim da janela de COLETA (yyyy-MM-dd ou dd/MM/yyyy). Padrão: hoje.
`dataInicial`	No	Início da janela de COLETA (yyyy-MM-dd ou dd/MM/yyyy). Padrão: 30 dias antes do fim.

Output Schema

ParametersJSON Schema

Name	Required	Description
`base`	Yes
`filtro`	Yes	Filtro efetivamente aplicado; `reuniao` é nula quando não foi informada
`observacao`	No
`provenance`	Yes	Bloco de proveniência (contrato v1.0): fonte, URL, competência, extração e licença
`attribution`	Yes	URLs canônicas das fontes desta resposta (lista de atribuição)
`urlConsulta`	Yes
`consultadoEm`	Yes
`expectativas`	Yes
`observacaoEixo`	No
`totalRegistros`	Yes

TDQS

A4.9/5.0

Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint, idempotentHint, and destructiveHint, lowering the bar. The description still adds significant behavioral context: the vintage nature of Focus, the meaning of coletadoEm versus referencia, the fact that $count is ignored (count computed locally), the mandatory filter due to source limitations, and the non-exposure of microdata for confidentiality. No contradictions with annotations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Although long, every sentence carries operational weight: purpose, return statistics, use exclusions, response fields, default window, source attribution, and the vintage data caveat. It is dense but efficient, with no filler or repetition of schema details.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a tool with five optional parameters, complex temporal semantics, and multiple siblings, the description fully explains the Copom meeting axis, the data collection window, the return structure (including 'base', 'filtro', 'referencia'), and source limitations. An output schema exists, so return values are covered by structured data; no additional enumeration needed.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the baseline is 3. The description adds value beyond the schema by explaining the default 30-day collection window, reinforcing the date format expectations, and clarifying that 'referencia' is the Copom meeting rather than the calendar year. This pushes it slightly above baseline.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description opens with a specific verb and resource: 'Consulta as expectativas de mercado do Focus para a taxa Selic' and clarifies the organizing axis ('organizadas pela REUNIÃO do Copom'). It explicitly distinguishes this tool from siblings by naming bcb_focus_expectativas (annual calendar) and bcb_serie_valores (realized Selic), and states why it is separate.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It provides explicit 'Quando usar' ('o que o mercado espera da Selic na próxima reunião') and 'Quando NÃO usar' with named alternatives and even series codes for bcb_serie_valores (432, 1178, 4390). This is exemplary guidance, exceeding the minimum expected.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

bcb_indicadores_atuaisA

Read-onlyIdempotent

Inspect

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 econômico rápido. Quando NÃO usar: para qualquer outra série, para dados históricos ou para escolher o período use bcb_serie_ultimos ou bcb_serie_valores. Retorna: consultadoEm (timestamp ISO 8601) e indicadores (array com indicador, codigo, data, valor — ou erro no item). Resiliente: cada indicador é buscado de forma independente, então a falha de um não derruba os demais. Comportamento: consome a API pública SGS do Banco Central do Brasil — sem autenticação, chave de API ou cadastro, e sem limite de requisições divulgado (uso é best-effort). Em falha transitória ou timeout a chamada é repetida automaticamente (até 3 tentativas, backoff exponencial); persistindo o erro, retorna isError: true com mensagem em português (HTTP 404 = série inexistente ou sem dados no período solicitado). O resultado vem como JSON tanto em texto quanto em structuredContent (conforme o outputSchema); datas no formato dd/MM/yyyy e valores numéricos (ponto decimal).

ParametersJSON Schema

Name	Required	Description	Default
No parameters

Output Schema

ParametersJSON Schema

Name	Required	Description
`provenance`	Yes	Bloco de proveniência (contrato v1.0): fonte, URL, competência, extração e licença
`attribution`	Yes	URLs canônicas das fontes desta resposta (lista de atribuição)
`indicadores`	Yes	Lista de indicadores com seus valores mais recentes
`consultadoEm`	Yes	Timestamp ISO 8601 da consulta

TDQS

A4.9/5.0

Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Beyond the annotations (read-only, idempotent), the description discloses valuable behavioral details: each indicator is fetched independently and partial failures do not crash the call, retries happen up to 3 times with exponential backoff, HTTP 404 is explained, and the response format is fully described. This greatly exceeds the annotation baseline.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is dense but well-organized, front-loading the core purpose, then moving through when to use, return shape, resilience, API details, and error behavior. Every sentence adds actionable information without padding.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a zero-parameter tool with an output schema, the description is exceptionally complete: it covers use cases, non-use cases, output timing, error semantics, retry behavior, external API dependency, and formatting. The agent has everything needed to select and invoke the tool correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The tool accepts no parameters and the input schema already clarifies this completely. The description reinforces this by stating 'Não recebe parâmetros' and adds value by detailing the returned fields, which is enough for a parameterless tool.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states this is a shortcut that returns the most recent values for key Brazilian economic indicators in a single call, naming each indicator. It also distinguishes itself from sibling tools by explicitly stating when not to use it and which alternatives to use instead.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides explicit 'Quando usar' guidance for a quick economic overview and explicit 'Quando NÃO usar' guidance, directing users to bcb_serie_ultimos or bcb_serie_valores for other series, historical data, or custom periods.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

bcb_serie_metadadosA

Read-onlyIdempotent

Inspect

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 si use bcb_serie_valores ou bcb_serie_ultimos. Retorna: codigo, nome, periodicidade, categoria, fonte, ultimoValor e URLs diretas da API (urlConsulta, urlUltimos10). Limite da fonte: a API do SGS NÃO publica endpoint de metadados por série — não há unidade de medida disponível. Nome e categoria vêm do catálogo curado do servidor (139 séries verificadas contra a origem) e, fora dele, a periodicidade é inferida do espaçamento das observações, sinalizada por periodicidadeInferida. Comportamento: consome a API pública SGS do Banco Central do Brasil — sem autenticação, chave de API ou cadastro, e sem limite de requisições divulgado (uso é best-effort). Em falha transitória ou timeout a chamada é repetida automaticamente (até 3 tentativas, backoff exponencial); persistindo o erro, retorna isError: true com mensagem em português (HTTP 404 = série inexistente ou sem dados no período solicitado). O resultado vem como JSON tanto em texto quanto em structuredContent (conforme o outputSchema); datas no formato dd/MM/yyyy e valores numéricos (ponto decimal).

ParametersJSON Schema

Name	Required	Description	Default
`codigo`	Yes	Código da série no SGS/BCB

Output Schema

ParametersJSON Schema

Name	Required	Description
`nome`	Yes	Nome da série
`fonte`	Yes	Fonte dos dados
`codigo`	Yes	Código da série no SGS/BCB
`categoria`	No	Categoria econômica
`observacao`	No	Observação sobre a origem dos metadados
`provenance`	Yes	Um bloco por procedência que contribuiu com esta resposta (contrato v1.0; licenças nunca se fundem)
`attribution`	Yes	URLs canônicas das fontes desta resposta (lista de atribuição)
`ultimoValor`	No	Última observação disponível
`urlConsulta`	No	URL da API do BCB para consulta completa
`urlUltimos10`	No	URL da API do BCB para os últimos 10 valores
`periodicidade`	No	Periodicidade da série
`periodicidadeInferida`	No	Presente e true quando a periodicidade foi inferida do espaçamento das observações

TDQS

A4.7/5.0

Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Beyond the annotations (readOnlyHint, idempotentHint, etc.), the description discloses valuable behavioral details: the SGS API has no public metadata endpoint, the catalog is curated for 139 series, periodicity may be inferred and flagged as periodicidadeInferida, no authentication is needed, retries happen up to 3 times with exponential backoff, and errors return isError with Portuguese messages. It also explains HTTP 404 semantics. These details add real transparency beyond what annotations provide.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is long but every sentence adds information: use-case, non-use-case, returned fields, source limitations, inference behavior, retry logic, error format, and output format. It is well structured with informative labels (Quando usar, Quando NÃO usar, Retorna, Limite, Comportamento), so even the length feels purposeful and easy to scan.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The description covers purpose, usage context, behavioral quirks, retry logic, error handling, output shape, and even caveats about the curated catalog and inferred periodicity. Given the simple schema (one required parameter), the annotations, and the existing output schema, the description is fully complete for tool selection and invocation.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema already has 100% coverage for the single parameter (codigo) with a clear description: 'Código da série no SGS/BCB.' The tool description references the code indirectly by saying 'UMA série' and how to use it to confirm the series, but it does not add material semantic detail beyond the schema. This aligns with the baseline of 3 for high schema coverage.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description opens with a specific verb and resource: 'Obtém a descrição de UMA série do BCB' and immediately restricts the scope by saying 'sem trazer a série histórica.' It also lists exact returned fields (nome, periodicidade, categoria, fonte, último valor), and the 'Quando NÃO usar' line differentiates it from sibling tools like bcb_serie_valores and bcb_serie_ultimos.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides explicit usage guidance: 'Quando usar: para confirmar o que uma série representa e com que frequência é publicada' and 'Quando NÃO usar: para os valores em si use bcb_serie_valores ou bcb_serie_ultimos.' This gives the agent clear when-to-use and when-not-to-use criteria with named alternatives.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

bcb_series_popularesA

Read-onlyIdempotent

Inspect

Lista o catálogo interno curado de 139 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 navegar/descobrir as séries disponíveis por tema. Quando NÃO usar: para busca por palavra-chave use bcb_buscar_serie; esta ferramenta não busca valores. Retorna: totalSeries, categorias (nº de categorias) e series — objeto agrupado por categoria quando sem filtro, ou array plano quando filtrado por categoria; cada item tem codigo, nome, categoria, periodicidade e fonteNome. Catálogo local: não faz chamada de rede. Procedência: fonteNome = 'portal' quando o nome é transcrito do dataset da série no Portal de Dados Abertos do BCB (82 séries, com unidade), e 'medido' quando a série não tem dataset lá — nesse caso o nome é herdado e o que foi verificado contra a origem é a periodicidade e a ordem de grandeza. Expectativas do Focus NÃO estão aqui: use bcb_focus_expectativas.

ParametersJSON Schema

Name	Required	Description	Default
`categoria`	No	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

Output Schema

ParametersJSON Schema

Name	Required	Description
`series`	Yes	Séries encontradas. Objeto agrupado por categoria quando sem filtro; array plano quando filtrado por categoria.
`categorias`	Yes	Quantidade de categorias distintas
`observacao`	No	Dica de uso
`provenance`	Yes	Bloco de proveniência (contrato v1.0): fonte, URL, competência, extração e licença
`attribution`	Yes	URLs canônicas das fontes desta resposta (lista de atribuição)
`totalSeries`	Yes	Quantidade total de séries retornadas

TDQS

A4.9/5.0

Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Besides the annotations, the description discloses meaningful details: it is a local catalog with no network call, the response shape changes by filtering, the number of series, and the provenance semantics of `fonteNome` ('portal' vs 'medido'). This goes well beyond the annotations and significantly helps the agent reason about data reliability.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Each sentence adds substantive information: purpose, use cases, exclusions, return shape, local nature, and provenance. The item is longer than average, but the complexity of the catalog and its edge cases warrant it; there is no filler or redundancy.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a one-optional-parameter catalog tool, the description covers use cases, output structure, data-source caveats, and important exclusions not discoverable from the schema. Combined with the existing output schema, this gives the agent a complete picture for correct invocation.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The single optional `categoria` parameter is already fully described in the schema, so the description doesn't add syntax-level info. However, it does add key semantics: filtering by categoria changes return from a grouped object to a flat array, and it warns that Focus expectations are excluded. That extra context justifies a score above baseline, even with 100% schema coverage.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description opens with a strong verb and resource: 'Lista o catálogo interno curado de 139 séries econômicas do BCB com seus códigos', and further details the grouping by category and optional filter. It also explicitly distinguishes the tool from siblings like bcb_buscar_serie and bcb_focus_expectativas, making its purpose unmistakable.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It provides explicit 'Quando usar' and 'Quando NÃO usar' sections, naming bcb_buscar_serie for keyword searches and bcb_focus_expectativas for Focus expectations. This gives the agent concrete guidance on when to select or avoid this tool compared to its siblings.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

bcb_serie_ultimosA

Read-onlyIdempotent

Inspect

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 um intervalo de datas ou o histórico completo use bcb_serie_valores. Retorna: objeto serie, totalRegistros e dados (array de {data, valor}); sem dados, totalRegistros = 0 com observacao. Acima de 20: o endpoint nativo do BCB rejeita N > 20 em qualquer periodicidade, então o servidor descobre a periodicidade da série e busca por janela de datas, devolvendo os N últimos pontos. Comportamento: consome a API pública SGS do Banco Central do Brasil — sem autenticação, chave de API ou cadastro, e sem limite de requisições divulgado (uso é best-effort). Em falha transitória ou timeout a chamada é repetida automaticamente (até 3 tentativas, backoff exponencial); persistindo o erro, retorna isError: true com mensagem em português (HTTP 404 = série inexistente ou sem dados no período solicitado). O resultado vem como JSON tanto em texto quanto em structuredContent (conforme o outputSchema); datas no formato dd/MM/yyyy e valores numéricos (ponto decimal).

ParametersJSON Schema

Name	Required	Description	Default
`codigo`	Yes	Código da série no SGS/BCB
`quantidade`	No	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.

Output Schema

ParametersJSON Schema

Name	Required	Description
`dados`	Yes	Observações mais recentes
`serie`	Yes	Identificação da série temporal
`chunking`	No	Presente quando a consulta foi fatiada em várias requisições à origem, por causa do limite de 10 anos por janela em séries diárias. As fatias são fundidas e ordenadas antes de responder.
`observacao`	No	Mensagem informativa (ex.: quando não há dados)
`provenance`	Yes	Bloco de proveniência (contrato v1.0): fonte, URL, competência, extração e licença
`attribution`	Yes	URLs canônicas das fontes desta resposta (lista de atribuição)
`totalRegistros`	Yes	Quantidade de observações retornadas

TDQS

A4.8/5.0

Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Even with annotations declaring readOnlyHint/idempotentHint/destructiveHint false, the description adds substantial behavioral context: automatic retries with exponential backoff, the N > 20 native API limitation and workaround, HTTP 404 semantics, Portuguese error messages, JSON/structuredContent behavior, and output date/number formats. No contradiction with annotations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is long but well organized into semantic sections: what returns, when to use, when not to use, limits, behavior, errors, and output format. It contains minor redundancy with the schema's parameter descriptions, but no wasted sentences overall, and the most important purpose is front-loaded first.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's moderate complexity, the description covers all key operational aspects: output shape, no-auth backend API, retry behavior, error semantics, native AGI constraints, and output formatting. With both an output schema and a very complete description, an AI agent has sufficient context to invoke the tool correctal

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema already covers both parameters at 100%, including the 1-1000 range and default for quantidade. The description adds value by explaining that N > 20 triggers the system's date-window search behavior, which directly informs an agent how the quantidade parameter actually behaves in practice.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's function: retrieving the last N observations of a single BCB time series, most recent first. It distinguishes itself from the sibling tool bcb_serie_valores by explicitly positioning this as the choice for recent data without date calculation.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description includes an explicit 'Quando usar' section with a concrete IPCA example and an explicit 'Quando NÃO usar' section that names bcb_serie_valores as the alternative for date ranges or full history. This gives an agent clear decision criteria.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

bcb_serie_valoresA

Read-onlyIdempotent

Inspect

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 mais recentes use bcb_serie_ultimos; para a variação percentual use bcb_variacao; para comparar várias séries use bcb_comparar; se não souber o código, descubra-o antes com bcb_buscar_serie ou bcb_series_populares. Retorna: objeto serie (codigo, nome, categoria, periodicidade), totalRegistros, periodoInicial, periodoFinal e dados (array de {data, valor}); quando não há dados, totalRegistros = 0 e uma observacao explicativa. Períodos longos: a API do BCB limita séries DIÁRIAS a 10 anos por consulta e recusa janela aberta (HTTP 406). Isso é tratado automaticamente — a janela é fatiada em requisições de até 3 anos e o resultado vem fundido e ordenado, com chunking na resposta dizendo quantas janelas foram usadas; se o período pedido estava aberto numa série diária, janelaAplicada diz qual janela foi usada e por quê. Harmonização: frequencia (mensal|trimestral|anual) reamostra a série antes de responder, com a convenção escolhida em agregacao; a resposta traz harmonizacao com derived: true e a nota do cálculo. Comportamento: consome a API pública SGS do Banco Central do Brasil — sem autenticação, chave de API ou cadastro, e sem limite de requisições divulgado (uso é best-effort). Em falha transitória ou timeout a chamada é repetida automaticamente (até 3 tentativas, backoff exponencial); persistindo o erro, retorna isError: true com mensagem em português (HTTP 404 = série inexistente ou sem dados no período solicitado). O resultado vem como JSON tanto em texto quanto em structuredContent (conforme o outputSchema); datas no formato dd/MM/yyyy e valores numéricos (ponto decimal).

ParametersJSON Schema

Name	Required	Description	Default
`codigo`	Yes	Código da série no SGS/BCB (ex: 433 para IPCA mensal, 11 para Selic)
`agregacao`	No	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 (IPCA mensal, por exemplo), compondo geometricamente — somar 12 variações mensais NÃO dá a inflação do ano.	ultimo
`dataFinal`	No	Data final no formato yyyy-MM-dd ou dd/MM/yyyy (opcional)
`frequencia`	No	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 periodicidades diferentes.
`dataInicial`	No	Data inicial no formato yyyy-MM-dd ou dd/MM/yyyy (opcional)

Output Schema

ParametersJSON Schema

Name	Required	Description
`dados`	Yes	Observações históricas
`serie`	Yes	Identificação da série temporal
`chunking`	No	Presente quando a consulta foi fatiada em várias requisições à origem, por causa do limite de 10 anos por janela em séries diárias. As fatias são fundidas e ordenadas antes de responder.
`observacao`	No	Mensagem informativa (ex.: quando não há dados)
`provenance`	Yes	Bloco de proveniência (contrato v1.0): fonte, URL, competência, extração e licença
`attribution`	Yes	URLs canônicas das fontes desta resposta (lista de atribuição)
`harmonizacao`	No	Presente quando `frequencia` foi informada: descreve a reamostragem aplicada. Valor DERIVADO — calculado por este servidor, não publicado pelo Banco Central.
`periodoFinal`	No	Data da última observação
`janelaAplicada`	No	Presente quando o período pedido estava aberto numa série diária e o servidor aplicou uma janela própria (a origem recusa janela aberta em série diária com HTTP 406).
`periodoInicial`	No	Data da primeira observação
`totalRegistros`	Yes	Quantidade de observações retornadas

TDQS

A4.7/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

The annotations already declare readOnlyHint: true, openWorldHint: true, idempotentHint: true, and destructiveHint: false, so the safety profile is well covered. The description adds substantial behavioral context: daily series capped at 10 years with automatic chunking, open-window refusal handling (HTTP 406), harmonic resampling behavior, public API without auth, automatic retry (3 attempts, exponential backoff), error handling (HTTP 404), and both text and structuredContent output. This adds context beyond annotations, though it doesn't describe the exact response schema (which the output schema covers). No contradiction with annotations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is long but tightly organized with clear sections (Quando usar, Quando NÃO usar, Retorna, Períodos longos, Harmonização, Comportamento). Every section provides unique value; the list of alternatives is essential for tool selection. However, it is quite dense and could potentially be trimmed, though the complexity of the tool (chunking, harmonization, error handling) justifies most length. One point off for being slightly verbose in the chunking section.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a tool with 5 parameters, 2 enums, an output schema, and rich annotations, the description covers all critical operational aspects: input validation (date formats, aggregation conventions), edge cases (open windows, long periods, HTTP 406), error handling (retry, 404), harmonization behavior, and output structure. The output schema handles return value specifics, so the description doesn't need to duplicate that. It is complete for the complexity level.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters5/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Even though the input schema has 100% description coverage, the description adds significant semantic value: it explains the chunking logic triggered by long date ranges (which is a behavioral consequence of dataInicial/dataFinal), defines the date format (dd/MM/yyyy and yyyy-MM-dd), and elaborates on the `agregacao` parameter by explaining the difference between `soma` and `acumulada` for inflation series — a critical nuance not in the schema. The description clarifies that `frequencia` only aggregates to larger periods and refuses finer frequencies, which complements the schema. It also explains the return structure (serie, totalRegistros, etc.) which helps parameter understanding.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description opens with a specific verb+resource: 'Consulta o histórico de valores de UMA série temporal do BCB pelo código SGS' — clearly stating the action (query), the resource (historical values of a time series), and the key identifier (SGS code). It explicitly distinguishes from siblings by naming five alternative tools and their specific uses, which fully differentiates this tool from its siblings.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description includes an explicit 'Quando usar' and 'Quando NÃO usar' section that names five specific alternative tools (bcb_serie_ultimos, bcb_variacao, bcb_comparar, bcb_buscar_serie, bcb_series_populares) and the exact scenarios where each is more appropriate, along with a prerequisite (finding the code first). This is explicit, actionable guidance with clear exclusions and alternatives.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

bcb_variacaoA

Read-onlyIdempotent

Inspect

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 índices de preço mensais do catálogo; Selic/CDI acumulados no mês 4390/4391; rentabilidade da poupança 25/195) é o ACUMULADO do período por encadeamento — "quanto o IPCA acumulou em 2024" ou "quanto a Selic rendeu em 2024" é esta tool. O campo analise.metodo diz qual das duas contas foi feita; código fora do catálogo curado é tratado como nível. Série de acumulado móvel (IPCA em 12 meses, 13522) é recusada com orientação — o valor publicado já é a resposta. O período pode ser definido por datas (dataInicial/dataFinal) OU pelos últimos N períodos (parâmetro periodos, que tem precedência e ignora as datas). Quando usar: para medir tendência/variação/acumulado de uma única série. Quando NÃO usar: para comparar várias séries use bcb_comparar; para os valores brutos use bcb_serie_valores. Requer ao menos 2 observações no período (senão retorna isError). Retorna: serie, periodo (dataInicial, dataFinal, totalPeriodos), analise (metodo, valorInicial, valorFinal, diferencaAbsoluta — nula quando encadeado —, variacaoPercentual, variacaoFormatada) e estatisticas (maximo, minimo, media, amplitude). Períodos longos são tratados automaticamente: janela diária acima de 10 anos é fatiada (a API do BCB responde 406) e periodos acima de 20 é atendido por janela de datas; chunking e janelaAplicada aparecem na resposta quando isso acontece. Comportamento: consome a API pública SGS do Banco Central do Brasil — sem autenticação, chave de API ou cadastro, e sem limite de requisições divulgado (uso é best-effort). Em falha transitória ou timeout a chamada é repetida automaticamente (até 3 tentativas, backoff exponencial); persistindo o erro, retorna isError: true com mensagem em português (HTTP 404 = série inexistente ou sem dados no período solicitado). O resultado vem como JSON tanto em texto quanto em structuredContent (conforme o outputSchema); datas no formato dd/MM/yyyy e valores numéricos (ponto decimal).

ParametersJSON Schema

Name	Required	Description
`codigo`	Yes	Código da série no SGS/BCB
`periodos`	No	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.
`dataFinal`	No	Data final (yyyy-MM-dd ou dd/MM/yyyy). Se não informada, usa o último valor disponível.
`dataInicial`	No	Data inicial (yyyy-MM-dd ou dd/MM/yyyy). Se não informada, usa o primeiro valor disponível.

Output Schema

ParametersJSON Schema

Name	Required	Description
`serie`	Yes	Identificação da série
`analise`	Yes	Resultado da variação no período. Em `metodo: "nivel"` é a variação entre o primeiro e o último valor; em `metodo: "encadeamento"` (série que já é variação por período, como IPCA e IGP-M mensais) é o acumulado composto de todas as observações
`periodo`	Yes	Janela temporal analisada
`chunking`	No	Presente quando a consulta foi fatiada em várias requisições à origem, por causa do limite de 10 anos por janela em séries diárias. As fatias são fundidas e ordenadas antes de responder.
`derivacao`	Yes	Origem dos números calculados: o que é derivado, por qual motor e com quais convenções
`provenance`	Yes	Bloco de proveniência (contrato v1.0): fonte, URL, competência, extração e licença
`attribution`	Yes	URLs canônicas das fontes desta resposta (lista de atribuição)
`estatisticas`	Yes	Estatísticas descritivas dos valores no período
`janelaAplicada`	No	Presente quando o período pedido estava aberto numa série diária e o servidor aplicou uma janela própria (a origem recusa janela aberta em série diária com HTTP 406).

TDQS

A4.9/5.0

Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Adds substantial detail beyond annotations: explains no authentication required, best-effort usage, retry logic (3 attempts with exponential backoff), error handling (isError, HTTP 404 semantics), and automatic chunking for long periods. This complements the readOnlyHint and provides practical behavioral context.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is long but exceptionally well-structured: it opens with the core purpose, then details the two calculation methods, usage guidance, edge cases, error handling, and return schema in a logical flow. Every sentence contributes unique value, and the use of semicolons and bullet-like lists improves readability.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's complexity (distinguishing level vs. variation series, handling moving averages, periodos limits, chunking, retries, and a rich output structure), the description covers all relevant aspects. Even though an output schema exists, the description succinctly lists all returned fields and their meaning, making the behavior fully predictable.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema already covers all parameters (100% coverage), so baseline is 3. The description adds meaning by explaining periodos precedence over dates, the interpretation of variation vs level series, and the behavior when dates are omitted. This is extra value over the schema's basic field descriptions.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool calculates percentage variation of a single series with descriptive statistics, and explicitly distinguishes between level series and series that are already variations. It also names sibling tools (bcb_comparar, bcb_serie_valores) as alternatives, making its purpose unambiguous.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Provides explicit when-to-use ('para medir tendência/variação/acumulado de uma única série') and when-not-to-use ('para comparar várias séries use bcb_comparar; para os valores brutos use bcb_serie_valores'). Also gives special handling for moving-average series and the periodos precedence, leaving no doubt about scope.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

15 tool updatesv1.9.2Aug 19, 2026

Changedbcb_buscar_serie4 fields changed

addedOutput schema / properties / attribution

Added value: +{
+  "description": "URLs canônicas das fontes desta resposta (lista de atribuição)",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

addedOutput schema / properties / provenance

Added value: +{
+  "description": "Um bloco por procedência que contribuiu com esta resposta (contrato v1.0; licenças nunca se fundem)",
+  "items": {
+    "additionalProperties": false,
+    "description": "Bloco de proveniência (contrato v1.0): fonte, URL, competência, extração e licença",
+    "properties": {
+      "citation": {
+        "description": "Citação pronta para uso",
+        "type": "string"
+      },
+      "data_vintage": {
+        "description": "Competência do dado segundo a fonte; null quando a fonte não expõe",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "license": {
+        "description": "Regime legal do dado",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "retrieved_at": {
+        "description": "Instante REAL da extração na origem (ISO-8601, horário de Brasília). Resposta servida de cache mantém o instante do fetch ORIGINAL, que é a data de extração relevante.",
+        "type": "string"
+      },
+      "source": {
+        "description": "Fonte oficial do dado",
+        "type": "string"
+      },
+      "source_url": {
+        "description": "URL canônica que reproduz a consulta",
+        "type": "string"
+      }
+    },
+    "required": [
+      "source",
+      "source_url",
+      "data_vintage",
+      "retrieved_at",
+      "citation",
+      "license"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

addedOutput schema / properties / series / items / properties / fonteNome

Added value: +{
+  "description": "Só quando `origem` = curado. 'portal' = nome transcrito do dataset da série no Portal de Dados Abertos do BCB; 'medido' = série sem dataset no portal, nome herdado e apenas periodicidade e ordem de grandeza verificadas contra a origem.",
+  "enum": [
+    "portal",
+    "medido"
+  ],
+  "type": "string"
+}

changedOutput schema / required

Previous value: -[
-  "termo",
-  "totalEncontradas",
-  "series",
-  "catalogo"
-]New value: +[
+  "termo",
+  "totalEncontradas",
+  "series",
+  "catalogo",
+  "provenance",
+  "attribution"
+]

Changedbcb_cambio_cotacao3 fields changed

addedOutput schema / properties / attribution

Added value: +{
+  "description": "URLs canônicas das fontes desta resposta (lista de atribuição)",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

addedOutput schema / properties / provenance

Added value: +{
+  "description": "Um bloco por procedência que contribuiu com esta resposta (contrato v1.0; licenças nunca se fundem)",
+  "items": {
+    "additionalProperties": false,
+    "description": "Bloco de proveniência (contrato v1.0): fonte, URL, competência, extração e licença",
+    "properties": {
+      "citation": {
+        "description": "Citação pronta para uso",
+        "type": "string"
+      },
+      "data_vintage": {
+        "description": "Competência do dado segundo a fonte; null quando a fonte não expõe",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "license": {
+        "description": "Regime legal do dado",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "retrieved_at": {
+        "description": "Instante REAL da extração na origem (ISO-8601, horário de Brasília). Resposta servida de cache mantém o instante do fetch ORIGINAL, que é a data de extração relevante.",
+        "type": "string"
+      },
+      "source": {
+        "description": "Fonte oficial do dado",
+        "type": "string"
+      },
+      "source_url": {
+        "description": "URL canônica que reproduz a consulta",
+        "type": "string"
+      }
+    },
+    "required": [
+      "source",
+      "source_url",
+      "data_vintage",
+      "retrieved_at",
+      "citation",
+      "license"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

changedOutput schema / required

Previous value: -[
-  "moeda",
-  "periodo",
-  "totalRegistros",
-  "cotacoes",
-  "disclaimer",
-  "urlConsulta",
-  "consultadoEm"
-]New value: +[
+  "moeda",
+  "periodo",
+  "totalRegistros",
+  "cotacoes",
+  "disclaimer",
+  "urlConsulta",
+  "consultadoEm",
+  "provenance",
+  "attribution"
+]

Changedbcb_cambio_moedas3 fields changed

addedOutput schema / properties / attribution

Added value: +{
+  "description": "URLs canônicas das fontes desta resposta (lista de atribuição)",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

addedOutput schema / properties / provenance

Added value: +{
+  "additionalProperties": false,
+  "description": "Bloco de proveniência (contrato v1.0): fonte, URL, competência, extração e licença",
+  "properties": {
+    "citation": {
+      "description": "Citação pronta para uso",
+      "type": "string"
+    },
+    "data_vintage": {
+      "description": "Competência do dado segundo a fonte; null quando a fonte não expõe",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "license": {
+      "description": "Regime legal do dado",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "retrieved_at": {
+      "description": "Instante REAL da extração na origem (ISO-8601, horário de Brasília). Resposta servida de cache mantém o instante do fetch ORIGINAL, que é a data de extração relevante.",
+      "type": "string"
+    },
+    "source": {
+      "description": "Fonte oficial do dado",
+      "type": "string"
+    },
+    "source_url": {
+      "description": "URL canônica que reproduz a consulta",
+      "type": "string"
+    }
+  },
+  "required": [
+    "source",
+    "source_url",
+    "data_vintage",
+    "retrieved_at",
+    "citation",
+    "license"
+  ],
+  "type": "object"
+}

changedOutput schema / required

Previous value: -[
-  "totalMoedas",
-  "moedas",
-  "disclaimer",
-  "urlConsulta",
-  "consultadoEm"
-]New value: +[
+  "totalMoedas",
+  "moedas",
+  "disclaimer",
+  "urlConsulta",
+  "consultadoEm",
+  "provenance",
+  "attribution"
+]

Changedbcb_comparar5 fields changed

addedOutput schema / properties / attribution

Added value: +{
+  "description": "URLs canônicas das fontes desta resposta (lista de atribuição)",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

addedOutput schema / properties / provenance

Added value: +{
+  "additionalProperties": false,
+  "description": "Bloco de proveniência (contrato v1.0): fonte, URL, competência, extração e licença",
+  "properties": {
+    "citation": {
+      "description": "Citação pronta para uso",
+      "type": "string"
+    },
+    "data_vintage": {
+      "description": "Competência do dado segundo a fonte; null quando a fonte não expõe",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "license": {
+      "description": "Regime legal do dado",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "retrieved_at": {
+      "description": "Instante REAL da extração na origem (ISO-8601, horário de Brasília). Resposta servida de cache mantém o instante do fetch ORIGINAL, que é a data de extração relevante.",
+      "type": "string"
+    },
+    "source": {
+      "description": "Fonte oficial do dado",
+      "type": "string"
+    },
+    "source_url": {
+      "description": "URL canônica que reproduz a consulta",
+      "type": "string"
+    }
+  },
+  "required": [
+    "source",
+    "source_url",
+    "data_vintage",
+    "retrieved_at",
+    "citation",
+    "license"
+  ],
+  "type": "object"
+}

addedOutput schema / properties / ranking / items / properties / metodo

Added value: +{
+  "description": "Como a variação foi medida: `nivel` = (último − primeiro) / primeiro, para série de nível; `encadeamento` = acumulado composto de todas as observações, para série que já é uma variação percentual por período (IPCA, INPC, IGP-M mensais e os núcleos/grupos do IPCA do catálogo; Selic e CDI acumulados no mês, 4390/4391; rentabilidade da poupança, 25/195 — nesta, uma observação por mês). A detecção cobre as séries de variação do catálogo curado; código fora dele é tratado como nível.",
+  "enum": [
+    "nivel",
+    "encadeamento"
+  ],
+  "type": "string"
+}

addedOutput schema / properties / ranking / items / properties / variacaoPercentual / description

Added value: +"Variação entre as pontas (metodo nivel) ou acumulado encadeado do período (metodo encadeamento), em %"

changedOutput schema / required

Previous value: -[
-  "periodo",
-  "totalSeries",
-  "seriesComDados",
-  "seriesComErro",
-  "ranking",
-  "erros",
-  "derivacao"
-]New value: +[
+  "periodo",
+  "totalSeries",
+  "seriesComDados",
+  "seriesComErro",
+  "ranking",
+  "erros",
+  "derivacao",
+  "provenance",
+  "attribution"
+]

Changedbcb_correlacao3 fields changed

addedOutput schema / properties / attribution

Added value: +{
+  "description": "URLs canônicas das fontes desta resposta (lista de atribuição)",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

addedOutput schema / properties / provenance

Added value: +{
+  "additionalProperties": false,
+  "description": "Bloco de proveniência (contrato v1.0): fonte, URL, competência, extração e licença",
+  "properties": {
+    "citation": {
+      "description": "Citação pronta para uso",
+      "type": "string"
+    },
+    "data_vintage": {
+      "description": "Competência do dado segundo a fonte; null quando a fonte não expõe",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "license": {
+      "description": "Regime legal do dado",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "retrieved_at": {
+      "description": "Instante REAL da extração na origem (ISO-8601, horário de Brasília). Resposta servida de cache mantém o instante do fetch ORIGINAL, que é a data de extração relevante.",
+      "type": "string"
+    },
+    "source": {
+      "description": "Fonte oficial do dado",
+      "type": "string"
+    },
+    "source_url": {
+      "description": "URL canônica que reproduz a consulta",
+      "type": "string"
+    }
+  },
+  "required": [
+    "source",
+    "source_url",
+    "data_vintage",
+    "retrieved_at",
+    "citation",
+    "license"
+  ],
+  "type": "object"
+}

changedOutput schema / required

Previous value: -[
-  "periodo",
-  "metodo",
-  "base",
-  "series",
-  "alinhamento",
-  "pares",
-  "erros",
-  "derivacao"
-]New value: +[
+  "periodo",
+  "metodo",
+  "base",
+  "series",
+  "alinhamento",
+  "pares",
+  "erros",
+  "derivacao",
+  "provenance",
+  "attribution"
+]

Changedbcb_deflacionar3 fields changed

addedOutput schema / properties / attribution

Added value: +{
+  "description": "URLs canônicas das fontes desta resposta (lista de atribuição)",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

addedOutput schema / properties / provenance

Added value: +{
+  "additionalProperties": false,
+  "description": "Bloco de proveniência (contrato v1.0): fonte, URL, competência, extração e licença",
+  "properties": {
+    "citation": {
+      "description": "Citação pronta para uso",
+      "type": "string"
+    },
+    "data_vintage": {
+      "description": "Competência do dado segundo a fonte; null quando a fonte não expõe",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "license": {
+      "description": "Regime legal do dado",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "retrieved_at": {
+      "description": "Instante REAL da extração na origem (ISO-8601, horário de Brasília). Resposta servida de cache mantém o instante do fetch ORIGINAL, que é a data de extração relevante.",
+      "type": "string"
+    },
+    "source": {
+      "description": "Fonte oficial do dado",
+      "type": "string"
+    },
+    "source_url": {
+      "description": "URL canônica que reproduz a consulta",
+      "type": "string"
+    }
+  },
+  "required": [
+    "source",
+    "source_url",
+    "data_vintage",
+    "retrieved_at",
+    "citation",
+    "license"
+  ],
+  "type": "object"
+}

changedOutput schema / required

Previous value: -[
-  "serie",
-  "deflator",
-  "base",
-  "periodo",
-  "dados",
-  "variacao",
-  "derivacao"
-]New value: +[
+  "serie",
+  "deflator",
+  "base",
+  "periodo",
+  "dados",
+  "variacao",
+  "derivacao",
+  "provenance",
+  "attribution"
+]

Changedbcb_focus_expectativas3 fields changed

addedOutput schema / properties / attribution

Added value: +{
+  "description": "URLs canônicas das fontes desta resposta (lista de atribuição)",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

addedOutput schema / properties / provenance

Added value: +{
+  "additionalProperties": false,
+  "description": "Bloco de proveniência (contrato v1.0): fonte, URL, competência, extração e licença",
+  "properties": {
+    "citation": {
+      "description": "Citação pronta para uso",
+      "type": "string"
+    },
+    "data_vintage": {
+      "description": "Competência do dado segundo a fonte; null quando a fonte não expõe",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "license": {
+      "description": "Regime legal do dado",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "retrieved_at": {
+      "description": "Instante REAL da extração na origem (ISO-8601, horário de Brasília). Resposta servida de cache mantém o instante do fetch ORIGINAL, que é a data de extração relevante.",
+      "type": "string"
+    },
+    "source": {
+      "description": "Fonte oficial do dado",
+      "type": "string"
+    },
+    "source_url": {
+      "description": "URL canônica que reproduz a consulta",
+      "type": "string"
+    }
+  },
+  "required": [
+    "source",
+    "source_url",
+    "data_vintage",
+    "retrieved_at",
+    "citation",
+    "license"
+  ],
+  "type": "object"
+}

changedOutput schema / required

Previous value: -[
-  "indicador",
-  "horizonte",
-  "base",
-  "filtro",
-  "totalRegistros",
-  "expectativas",
-  "urlConsulta",
-  "consultadoEm"
-]New value: +[
+  "indicador",
+  "horizonte",
+  "base",
+  "filtro",
+  "totalRegistros",
+  "expectativas",
+  "urlConsulta",
+  "consultadoEm",
+  "provenance",
+  "attribution"
+]

Changedbcb_focus_referencias3 fields changed

addedOutput schema / properties / attribution

Added value: +{
+  "description": "URLs canônicas das fontes desta resposta (lista de atribuição)",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

addedOutput schema / properties / provenance

Added value: +{
+  "additionalProperties": false,
+  "description": "Bloco de proveniência (contrato v1.0): fonte, URL, competência, extração e licença",
+  "properties": {
+    "citation": {
+      "description": "Citação pronta para uso",
+      "type": "string"
+    },
+    "data_vintage": {
+      "description": "Competência do dado segundo a fonte; null quando a fonte não expõe",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "license": {
+      "description": "Regime legal do dado",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "retrieved_at": {
+      "description": "Instante REAL da extração na origem (ISO-8601, horário de Brasília). Resposta servida de cache mantém o instante do fetch ORIGINAL, que é a data de extração relevante.",
+      "type": "string"
+    },
+    "source": {
+      "description": "Fonte oficial do dado",
+      "type": "string"
+    },
+    "source_url": {
+      "description": "URL canônica que reproduz a consulta",
+      "type": "string"
+    }
+  },
+  "required": [
+    "source",
+    "source_url",
+    "data_vintage",
+    "retrieved_at",
+    "citation",
+    "license"
+  ],
+  "type": "object"
+}

changedOutput schema / required

Previous value: -[
-  "indicadores",
-  "referencias",
-  "escopos",
-  "janela",
-  "totalRegistros",
-  "consultadoEm"
-]New value: +[
+  "indicadores",
+  "referencias",
+  "escopos",
+  "janela",
+  "totalRegistros",
+  "consultadoEm",
+  "provenance",
+  "attribution"
+]

Changedbcb_focus_selic3 fields changed

addedOutput schema / properties / attribution

Added value: +{
+  "description": "URLs canônicas das fontes desta resposta (lista de atribuição)",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

addedOutput schema / properties / provenance

Added value: +{
+  "additionalProperties": false,
+  "description": "Bloco de proveniência (contrato v1.0): fonte, URL, competência, extração e licença",
+  "properties": {
+    "citation": {
+      "description": "Citação pronta para uso",
+      "type": "string"
+    },
+    "data_vintage": {
+      "description": "Competência do dado segundo a fonte; null quando a fonte não expõe",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "license": {
+      "description": "Regime legal do dado",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "retrieved_at": {
+      "description": "Instante REAL da extração na origem (ISO-8601, horário de Brasília). Resposta servida de cache mantém o instante do fetch ORIGINAL, que é a data de extração relevante.",
+      "type": "string"
+    },
+    "source": {
+      "description": "Fonte oficial do dado",
+      "type": "string"
+    },
+    "source_url": {
+      "description": "URL canônica que reproduz a consulta",
+      "type": "string"
+    }
+  },
+  "required": [
+    "source",
+    "source_url",
+    "data_vintage",
+    "retrieved_at",
+    "citation",
+    "license"
+  ],
+  "type": "object"
+}

changedOutput schema / required

Previous value: -[
-  "base",
-  "filtro",
-  "totalRegistros",
-  "expectativas",
-  "urlConsulta",
-  "consultadoEm"
-]New value: +[
+  "base",
+  "filtro",
+  "totalRegistros",
+  "expectativas",
+  "urlConsulta",
+  "consultadoEm",
+  "provenance",
+  "attribution"
+]

Changedbcb_indicadores_atuais3 fields changed

addedOutput schema / properties / attribution

Added value: +{
+  "description": "URLs canônicas das fontes desta resposta (lista de atribuição)",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

addedOutput schema / properties / provenance

Added value: +{
+  "additionalProperties": false,
+  "description": "Bloco de proveniência (contrato v1.0): fonte, URL, competência, extração e licença",
+  "properties": {
+    "citation": {
+      "description": "Citação pronta para uso",
+      "type": "string"
+    },
+    "data_vintage": {
+      "description": "Competência do dado segundo a fonte; null quando a fonte não expõe",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "license": {
+      "description": "Regime legal do dado",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "retrieved_at": {
+      "description": "Instante REAL da extração na origem (ISO-8601, horário de Brasília). Resposta servida de cache mantém o instante do fetch ORIGINAL, que é a data de extração relevante.",
+      "type": "string"
+    },
+    "source": {
+      "description": "Fonte oficial do dado",
+      "type": "string"
+    },
+    "source_url": {
+      "description": "URL canônica que reproduz a consulta",
+      "type": "string"
+    }
+  },
+  "required": [
+    "source",
+    "source_url",
+    "data_vintage",
+    "retrieved_at",
+    "citation",
+    "license"
+  ],
+  "type": "object"
+}

changedOutput schema / required

Previous value: -[
-  "consultadoEm",
-  "indicadores"
-]New value: +[
+  "consultadoEm",
+  "indicadores",
+  "provenance",
+  "attribution"
+]

Changedbcb_serie_metadados3 fields changed

addedOutput schema / properties / attribution

Added value: +{
+  "description": "URLs canônicas das fontes desta resposta (lista de atribuição)",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

addedOutput schema / properties / provenance

Added value: +{
+  "description": "Um bloco por procedência que contribuiu com esta resposta (contrato v1.0; licenças nunca se fundem)",
+  "items": {
+    "additionalProperties": false,
+    "description": "Bloco de proveniência (contrato v1.0): fonte, URL, competência, extração e licença",
+    "properties": {
+      "citation": {
+        "description": "Citação pronta para uso",
+        "type": "string"
+      },
+      "data_vintage": {
+        "description": "Competência do dado segundo a fonte; null quando a fonte não expõe",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "license": {
+        "description": "Regime legal do dado",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "retrieved_at": {
+        "description": "Instante REAL da extração na origem (ISO-8601, horário de Brasília). Resposta servida de cache mantém o instante do fetch ORIGINAL, que é a data de extração relevante.",
+        "type": "string"
+      },
+      "source": {
+        "description": "Fonte oficial do dado",
+        "type": "string"
+      },
+      "source_url": {
+        "description": "URL canônica que reproduz a consulta",
+        "type": "string"
+      }
+    },
+    "required": [
+      "source",
+      "source_url",
+      "data_vintage",
+      "retrieved_at",
+      "citation",
+      "license"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

changedOutput schema / required

Previous value: -[
-  "codigo",
-  "nome",
-  "fonte"
-]New value: +[
+  "codigo",
+  "nome",
+  "fonte",
+  "provenance",
+  "attribution"
+]

Changedbcb_serie_ultimos3 fields changed

addedOutput schema / properties / attribution

Added value: +{
+  "description": "URLs canônicas das fontes desta resposta (lista de atribuição)",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

addedOutput schema / properties / provenance

Added value: +{
+  "additionalProperties": false,
+  "description": "Bloco de proveniência (contrato v1.0): fonte, URL, competência, extração e licença",
+  "properties": {
+    "citation": {
+      "description": "Citação pronta para uso",
+      "type": "string"
+    },
+    "data_vintage": {
+      "description": "Competência do dado segundo a fonte; null quando a fonte não expõe",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "license": {
+      "description": "Regime legal do dado",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "retrieved_at": {
+      "description": "Instante REAL da extração na origem (ISO-8601, horário de Brasília). Resposta servida de cache mantém o instante do fetch ORIGINAL, que é a data de extração relevante.",
+      "type": "string"
+    },
+    "source": {
+      "description": "Fonte oficial do dado",
+      "type": "string"
+    },
+    "source_url": {
+      "description": "URL canônica que reproduz a consulta",
+      "type": "string"
+    }
+  },
+  "required": [
+    "source",
+    "source_url",
+    "data_vintage",
+    "retrieved_at",
+    "citation",
+    "license"
+  ],
+  "type": "object"
+}

changedOutput schema / required

Previous value: -[
-  "serie",
-  "totalRegistros",
-  "dados"
-]New value: +[
+  "serie",
+  "totalRegistros",
+  "dados",
+  "provenance",
+  "attribution"
+]

Changedbcb_serie_valores3 fields changed

addedOutput schema / properties / attribution

Added value: +{
+  "description": "URLs canônicas das fontes desta resposta (lista de atribuição)",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

addedOutput schema / properties / provenance

Added value: +{
+  "additionalProperties": false,
+  "description": "Bloco de proveniência (contrato v1.0): fonte, URL, competência, extração e licença",
+  "properties": {
+    "citation": {
+      "description": "Citação pronta para uso",
+      "type": "string"
+    },
+    "data_vintage": {
+      "description": "Competência do dado segundo a fonte; null quando a fonte não expõe",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "license": {
+      "description": "Regime legal do dado",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "retrieved_at": {
+      "description": "Instante REAL da extração na origem (ISO-8601, horário de Brasília). Resposta servida de cache mantém o instante do fetch ORIGINAL, que é a data de extração relevante.",
+      "type": "string"
+    },
+    "source": {
+      "description": "Fonte oficial do dado",
+      "type": "string"
+    },
+    "source_url": {
+      "description": "URL canônica que reproduz a consulta",
+      "type": "string"
+    }
+  },
+  "required": [
+    "source",
+    "source_url",
+    "data_vintage",
+    "retrieved_at",
+    "citation",
+    "license"
+  ],
+  "type": "object"
+}

changedOutput schema / required

Previous value: -[
-  "serie",
-  "totalRegistros",
-  "dados"
-]New value: +[
+  "serie",
+  "totalRegistros",
+  "dados",
+  "provenance",
+  "attribution"
+]

Changedbcb_series_populares4 fields changed

addedOutput schema / properties / attribution

Added value: +{
+  "description": "URLs canônicas das fontes desta resposta (lista de atribuição)",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

addedOutput schema / properties / provenance

Added value: +{
+  "additionalProperties": false,
+  "description": "Bloco de proveniência (contrato v1.0): fonte, URL, competência, extração e licença",
+  "properties": {
+    "citation": {
+      "description": "Citação pronta para uso",
+      "type": "string"
+    },
+    "data_vintage": {
+      "description": "Competência do dado segundo a fonte; null quando a fonte não expõe",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "license": {
+      "description": "Regime legal do dado",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "retrieved_at": {
+      "description": "Instante REAL da extração na origem (ISO-8601, horário de Brasília). Resposta servida de cache mantém o instante do fetch ORIGINAL, que é a data de extração relevante.",
+      "type": "string"
+    },
+    "source": {
+      "description": "Fonte oficial do dado",
+      "type": "string"
+    },
+    "source_url": {
+      "description": "URL canônica que reproduz a consulta",
+      "type": "string"
+    }
+  },
+  "required": [
+    "source",
+    "source_url",
+    "data_vintage",
+    "retrieved_at",
+    "citation",
+    "license"
+  ],
+  "type": "object"
+}

changedOutput schema / properties / series / anyOf

Previous value: -[
-  {
-    "items": {
-      "additionalProperties": false,
-      "description": "Identificação da série temporal",
-      "properties": {
-        "categoria": {
-          "description": "Categoria econômica",
-          "type": "string"
-        },
-        "codigo": {
-          "description": "Código da série no SGS/BCB",
-          "type": "number"
-        },
-        "nome": {
-          "description": "Nome da série",
-          "type": "string"
-        },
-        "periodicidade": {
-          "description": "Periodicidade (Diária, Mensal, etc.)",
-          "type": "string"
-        }
-      },
-      "required": [
-        "codigo",
-        "nome"
-      ],
-      "type": "object"
-    },
-    "type": "array"
-  },
-  {
-    "additionalProperties": {
-      "items": {
-        "additionalProperties": false,
-        "description": "Identificação da série temporal",
-        "properties": {
-          "categoria": {
-            "description": "Categoria econômica",
-            "type": "string"
-          },
-          "codigo": {
-            "description": "Código da série no SGS/BCB",
-            "type": "number"
-          },
-          "nome": {
-            "description": "Nome da série",
-            "type": "string"
-          },
-          "periodicidade": {
-            "description": "Periodicidade (Diária, Mensal, etc.)",
-            "type": "string"
-          }
-        },
-        "required": [
-          "codigo",
-          "nome"
-        ],
-        "type": "object"
-      },
-      "type": "array"
-    },
-    "type": "object"
-  }
-]New value: +[
+  {
+    "items": {
+      "additionalProperties": false,
+      "description": "Identificação da série temporal",
+      "properties": {
+        "categoria": {
+          "description": "Categoria econômica",
+          "type": "string"
+        },
+        "codigo": {
+          "description": "Código da série no SGS/BCB",
+          "type": "number"
+        },
+        "fonteNome": {
+          "description": "Procedência do `nome`: 'portal' = transcrito do dataset da série no Portal de Dados Abertos do BCB; 'medido' = a série não tem dataset no portal, o nome é herdado e só a periodicidade e a ordem de grandeza foram verificadas contra a origem.",
+          "enum": [
+            "portal",
+            "medido"
+          ],
+          "type": "string"
+        },
+        "nome": {
+          "description": "Nome da série",
+          "type": "string"
+        },
+        "periodicidade": {
+          "description": "Periodicidade (Diária, Mensal, etc.)",
+          "type": "string"
+        },
+        "unidade": {
+          "description": "Unidade de medida publicada pelo portal. Ausente nas séries sem dataset (fonteNome 'medido').",
+          "type": "string"
+        }
+      },
+      "required": [
+        "codigo",
+        "nome"
+      ],
+      "type": "object"
+    },
+    "type": "array"
+  },
+  {
+    "additionalProperties": {
+      "items": {
+        "additionalProperties": false,
+        "description": "Identificação da série temporal",
+        "properties": {
+          "categoria": {
+            "description": "Categoria econômica",
+            "type": "string"
+          },
+          "codigo": {
+            "description": "Código da série no SGS/BCB",
+            "type": "number"
+          },
+          "fonteNome": {
+            "description": "Procedência do `nome`: 'portal' = transcrito do dataset da série no Portal de Dados Abertos do BCB; 'medido' = a série não tem dataset no portal, o nome é herdado e só a periodicidade e a ordem de grandeza foram verificadas contra a origem.",
+            "enum": [
+              "portal",
+              "medido"
+            ],
+            "type": "string"
+          },
+          "nome": {
+            "description": "Nome da série",
+            "type": "string"
+          },
+          "periodicidade": {
+            "description": "Periodicidade (Diária, Mensal, etc.)",
+            "type": "string"
+          },
+          "unidade": {
+            "description": "Unidade de medida publicada pelo portal. Ausente nas séries sem dataset (fonteNome 'medido').",
+            "type": "string"
+          }
+        },
+        "required": [
+          "codigo",
+          "nome"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "type": "object"
+  }
+]

changedOutput schema / required

Previous value: -[
-  "totalSeries",
-  "categorias",
-  "series"
-]New value: +[
+  "totalSeries",
+  "categorias",
+  "series",
+  "provenance",
+  "attribution"
+]

Changedbcb_variacao11 fields changed

changedOutput schema / properties / analise / description

Previous value: -"Resultado da variação entre o primeiro e o último valor"New value: +"Resultado da variação no período. Em `metodo: \"nivel\"` é a variação entre o primeiro e o último valor; em `metodo: \"encadeamento\"` (série que já é variação por período, como IPCA e IGP-M mensais) é o acumulado composto de todas as observações"

addedOutput schema / properties / analise / properties / diferencaAbsoluta / description

Added value: +"valorFinal − valorInicial em série de nível; NULO em série encadeada, onde não se aplica"

changedOutput schema / properties / analise / properties / diferencaAbsoluta / type
```
Previous value: -"number"New value: +[
+  "number",
+  "null"
+]
```

addedOutput schema / properties / analise / properties / metodo

Added value: +{
+  "description": "Como a variação foi medida: `nivel` = (último − primeiro) / primeiro, para série de nível; `encadeamento` = acumulado composto de todas as observações, para série que já é uma variação percentual por período (IPCA, INPC, IGP-M mensais e os núcleos/grupos do IPCA do catálogo; Selic e CDI acumulados no mês, 4390/4391; rentabilidade da poupança, 25/195 — nesta, uma observação por mês). A detecção cobre as séries de variação do catálogo curado; código fora dele é tratado como nível.",
+  "enum": [
+    "nivel",
+    "encadeamento"
+  ],
+  "type": "string"
+}

addedOutput schema / properties / analise / properties / valorFinal / description
```
Added value: +"Última observação do período, verbatim da fonte"
```
addedOutput schema / properties / analise / properties / valorInicial / description
```
Added value: +"Primeira observação do período, verbatim da fonte"
```
addedOutput schema / properties / analise / properties / variacaoPercentual / description
```
Added value: +"Variação (nível) ou acumulado (encadeamento), em %"
```

changedOutput schema / properties / analise / required

Previous value: -[
-  "valorInicial",
-  "valorFinal",
-  "diferencaAbsoluta",
-  "variacaoPercentual",
-  "variacaoFormatada"
-]New value: +[
+  "metodo",
+  "valorInicial",
+  "valorFinal",
+  "diferencaAbsoluta",
+  "variacaoPercentual",
+  "variacaoFormatada"
+]

addedOutput schema / properties / attribution

Added value: +{
+  "description": "URLs canônicas das fontes desta resposta (lista de atribuição)",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

addedOutput schema / properties / provenance

Added value: +{
+  "additionalProperties": false,
+  "description": "Bloco de proveniência (contrato v1.0): fonte, URL, competência, extração e licença",
+  "properties": {
+    "citation": {
+      "description": "Citação pronta para uso",
+      "type": "string"
+    },
+    "data_vintage": {
+      "description": "Competência do dado segundo a fonte; null quando a fonte não expõe",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "license": {
+      "description": "Regime legal do dado",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "retrieved_at": {
+      "description": "Instante REAL da extração na origem (ISO-8601, horário de Brasília). Resposta servida de cache mantém o instante do fetch ORIGINAL, que é a data de extração relevante.",
+      "type": "string"
+    },
+    "source": {
+      "description": "Fonte oficial do dado",
+      "type": "string"
+    },
+    "source_url": {
+      "description": "URL canônica que reproduz a consulta",
+      "type": "string"
+    }
+  },
+  "required": [
+    "source",
+    "source_url",
+    "data_vintage",
+    "retrieved_at",
+    "citation",
+    "license"
+  ],
+  "type": "object"
+}

changedOutput schema / required

Previous value: -[
-  "serie",
-  "periodo",
-  "analise",
-  "estatisticas",
-  "derivacao"
-]New value: +[
+  "serie",
+  "periodo",
+  "analise",
+  "estatisticas",
+  "derivacao",
+  "provenance",
+  "attribution"
+]

15 tool updatesv1.6.0Aug 12, 2026

Changedbcb_buscar_serie16 fields changed

removedInput schema / $schema

Removed value: -"http://json-schema.org/draft-07/schema#"

addedInput schema / properties / limite

Added value: +{
+  "default": 20,
+  "description": "Máximo de séries a devolver (1-100, padrão: 20). `totalEncontradas` traz o total antes do corte.",
+  "maximum": 100,
+  "minimum": 1,
+  "type": "number"
+}

changedInput schema / properties / termo / description

Previous value: -"Termo de busca (mínimo 2 caracteres)"New value: +"Termo de busca (mínimo 2 caracteres) ou o código da série. Vários termos são combinados com E."

removedOutput schema / $schema

Removed value: -"http://json-schema.org/draft-07/schema#"

addedOutput schema / properties / avisos

Added value: +{
+  "description": "Avisos de degradação (índice vencido ou indisponível)",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

addedOutput schema / properties / catalogo

Added value: +{
+  "additionalProperties": false,
+  "description": "Proveniência do índice usado na busca",
+  "properties": {
+    "cobertura": {
+      "description": "Limite explícito de cobertura do índice",
+      "type": "string"
+    },
+    "obtidoEm": {
+      "description": "Timestamp ISO 8601 em que o índice do portal foi obtido",
+      "type": "string"
+    },
+    "origem": {
+      "description": "Camadas consultadas",
+      "type": "string"
+    },
+    "seriesIndexadas": {
+      "description": "Quantidade de séries no índice consultado",
+      "type": "number"
+    }
+  },
+  "required": [
+    "origem",
+    "seriesIndexadas",
+    "cobertura"
+  ],
+  "type": "object"
+}

addedOutput schema / properties / observacao

Added value: +{
+  "description": "Aviso de corte quando há mais resultados que `limite`",
+  "type": "string"
+}

changedOutput schema / properties / series / description

Previous value: -"Séries que correspondem ao termo"New value: +"Séries que correspondem ao termo — as do catálogo curado primeiro"

changedOutput schema / properties / series / items / properties / categoria / description

Previous value: -"Categoria econômica"New value: +"Categoria econômica (só no catálogo curado)"

addedOutput schema / properties / series / items / properties / dataset

Added value: +{
+  "description": "Página do dataset no portal de dados abertos (só quando `origem` = indice)",
+  "type": "string"
+}

changedOutput schema / properties / series / items / properties / nome / description

Previous value: -"Nome da série"New value: +"Nome da série (revisado quando `origem` = curado; derivado do slug do portal quando = indice)"

addedOutput schema / properties / series / items / properties / origem

Added value: +{
+  "description": "Camada de onde veio o achado",
+  "enum": [
+    "curado",
+    "indice"
+  ],
+  "type": "string"
+}

changedOutput schema / properties / series / items / properties / periodicidade / description

Previous value: -"Periodicidade da série"New value: +"Periodicidade (só no catálogo curado)"

changedOutput schema / properties / series / items / required

Previous value: -[
-  "codigo",
-  "nome"
-]New value: +[
+  "codigo",
+  "nome",
+  "origem"
+]

changedOutput schema / properties / totalEncontradas / description

Previous value: -"Quantidade de séries encontradas"New value: +"Quantidade de séries encontradas, antes do corte por `limite`"

changedOutput schema / required

Previous value: -[
-  "termo",
-  "totalEncontradas",
-  "series"
-]New value: +[
+  "termo",
+  "totalEncontradas",
+  "series",
+  "catalogo"
+]

Addedbcb_cambio_cotacao
Addedbcb_cambio_moedas

Changedbcb_comparar9 fields changed

removedInput schema / $schema

Removed value: -"http://json-schema.org/draft-07/schema#"

addedInput schema / properties / agregacao

Added value: +{
+  "default": "ultimo",
+  "description": "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 (IPCA mensal, por exemplo), compondo geometricamente — somar 12 variações mensais NÃO dá a inflação do ano.",
+  "enum": [
+    "ultimo",
+    "primeiro",
+    "media",
+    "soma",
+    "acumulada"
+  ],
+  "type": "string"
+}

addedInput schema / properties / frequencia

Added value: +{
+  "description": "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 periodicidades diferentes.",
+  "enum": [
+    "mensal",
+    "trimestral",
+    "anual"
+  ],
+  "type": "string"
+}

removedOutput schema / $schema

Removed value: -"http://json-schema.org/draft-07/schema#"

addedOutput schema / properties / aviso

Added value: +{
+  "description": "Presente quando as séries comparadas têm periodicidades diferentes e nenhuma harmonização foi pedida — os números do ranking, nesse caso, não são diretamente comparáveis entre si.",
+  "type": "string"
+}

addedOutput schema / properties / derivacao

Added value: +{
+  "additionalProperties": false,
+  "description": "Origem dos números calculados: o que é derivado, por qual motor e com quais convenções",
+  "properties": {
+    "derived": {
+      "description": "Sempre true: há número calculado nesta resposta",
+      "type": "boolean"
+    },
+    "motor": {
+      "description": "Componente que computou a estatística",
+      "type": "string"
+    },
+    "nota": {
+      "description": "Convenções de cálculo e arredondamento, em prosa",
+      "type": "string"
+    }
+  },
+  "required": [
+    "derived",
+    "motor",
+    "nota"
+  ],
+  "type": "object"
+}

addedOutput schema / properties / harmonizacao

Added value: +{
+  "additionalProperties": false,
+  "description": "Presente quando `frequencia` foi informada: descreve a reamostragem aplicada. Valor DERIVADO — calculado por este servidor, não publicado pelo Banco Central.",
+  "properties": {
+    "agregacao": {
+      "description": "Convenção usada para agregar os valores de cada período",
+      "enum": [
+        "ultimo",
+        "primeiro",
+        "media",
+        "soma",
+        "acumulada"
+      ],
+      "type": "string"
+    },
+    "derived": {
+      "description": "Sempre true: o valor é derivado, não publicado pela fonte",
+      "type": "boolean"
+    },
+    "frequencia": {
+      "description": "Frequência de destino",
+      "enum": [
+        "mensal",
+        "trimestral",
+        "anual"
+      ],
+      "type": "string"
+    },
+    "nota": {
+      "description": "Descrição em prosa do que foi calculado",
+      "type": "string"
+    },
+    "observacoesOriginais": {
+      "description": "Observações antes da agregação",
+      "type": "number"
+    }
+  },
+  "required": [
+    "frequencia",
+    "agregacao",
+    "derived",
+    "nota"
+  ],
+  "type": "object"
+}

addedOutput schema / properties / ranking / items / properties / posicao / description
```
Added value: +"Posição no ranking"
```

changedOutput schema / required

Previous value: -[
-  "periodo",
-  "totalSeries",
-  "seriesComDados",
-  "seriesComErro",
-  "ranking",
-  "erros"
-]New value: +[
+  "periodo",
+  "totalSeries",
+  "seriesComDados",
+  "seriesComErro",
+  "ranking",
+  "erros",
+  "derivacao"
+]

Addedbcb_correlacao
Addedbcb_deflacionar
Addedbcb_focus_expectativas
Addedbcb_focus_referencias
Addedbcb_focus_selic

Changedbcb_indicadores_atuais5 fields changed

removedInput schema / $schema

Removed value: -"http://json-schema.org/draft-07/schema#"

addedInput schema / additionalProperties
```
Added value: +false
```

removedOutput schema / $schema

Removed value: -"http://json-schema.org/draft-07/schema#"

changedOutput schema / properties / indicadores / description

Previous value: -"Indicadores com seus valores mais recentes"New value: +"Lista de indicadores com seus valores mais recentes"

changedOutput schema / properties / indicadores / items / properties / erro / description

Previous value: -"Mensagem de erro quando indisponível"New value: +"Mensagem de erro quando o indicador não pôde ser obtido"

Changedbcb_serie_metadados6 fields changed

removedInput schema / $schema

Removed value: -"http://json-schema.org/draft-07/schema#"

removedOutput schema / $schema

Removed value: -"http://json-schema.org/draft-07/schema#"

removedOutput schema / properties / especial

Removed value: -{
-  "description": "Indica se é uma série especial",
-  "type": "boolean"
-}

addedOutput schema / properties / periodicidadeInferida

Added value: +{
+  "description": "Presente e true quando a periodicidade foi inferida do espaçamento das observações",
+  "type": "boolean"
+}

changedOutput schema / properties / ultimoValor / description

Previous value: -"Última observação disponível (fallback)"New value: +"Última observação disponível"

removedOutput schema / properties / unidade

Removed value: -{
-  "description": "Unidade de medida",
-  "type": "string"
-}

Changedbcb_serie_ultimos7 fields changed

removedInput schema / $schema

Removed value: -"http://json-schema.org/draft-07/schema#"

changedInput schema / properties / quantidade / description

Previous value: -"Quantidade de valores a retornar (1-1000, padrão: 10)"New value: +"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."

removedOutput schema / $schema

Removed value: -"http://json-schema.org/draft-07/schema#"

addedOutput schema / properties / chunking

Added value: +{
+  "additionalProperties": false,
+  "description": "Presente quando a consulta foi fatiada em várias requisições à origem, por causa do limite de 10 anos por janela em séries diárias. As fatias são fundidas e ordenadas antes de responder.",
+  "properties": {
+    "fatiaAnos": {
+      "description": "Largura máxima de cada janela, em anos",
+      "type": "number"
+    },
+    "janelas": {
+      "description": "Quantidade de janelas consultadas",
+      "type": "number"
+    }
+  },
+  "required": [
+    "janelas",
+    "fatiaAnos"
+  ],
+  "type": "object"
+}

addedOutput schema / properties / serie / description

Added value: +"Identificação da série temporal"

changedOutput schema / properties / serie / properties / periodicidade / description

Previous value: -"Periodicidade da série"New value: +"Periodicidade (Diária, Mensal, etc.)"

addedOutput schema / properties / serie / properties / periodicidadeInferida

Added value: +{
+  "description": "Presente e true quando a periodicidade foi inferida do espaçamento das observações, e não lida do catálogo — a API do SGS não publica metadados de série.",
+  "type": "boolean"
+}

Changedbcb_serie_valores11 fields changed

removedInput schema / $schema

Removed value: -"http://json-schema.org/draft-07/schema#"

addedInput schema / properties / agregacao

Added value: +{
+  "default": "ultimo",
+  "description": "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 (IPCA mensal, por exemplo), compondo geometricamente — somar 12 variações mensais NÃO dá a inflação do ano.",
+  "enum": [
+    "ultimo",
+    "primeiro",
+    "media",
+    "soma",
+    "acumulada"
+  ],
+  "type": "string"
+}

addedInput schema / properties / frequencia

Added value: +{
+  "description": "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 periodicidades diferentes.",
+  "enum": [
+    "mensal",
+    "trimestral",
+    "anual"
+  ],
+  "type": "string"
+}

removedOutput schema / $schema

Removed value: -"http://json-schema.org/draft-07/schema#"

addedOutput schema / properties / chunking

Added value: +{
+  "additionalProperties": false,
+  "description": "Presente quando a consulta foi fatiada em várias requisições à origem, por causa do limite de 10 anos por janela em séries diárias. As fatias são fundidas e ordenadas antes de responder.",
+  "properties": {
+    "fatiaAnos": {
+      "description": "Largura máxima de cada janela, em anos",
+      "type": "number"
+    },
+    "janelas": {
+      "description": "Quantidade de janelas consultadas",
+      "type": "number"
+    }
+  },
+  "required": [
+    "janelas",
+    "fatiaAnos"
+  ],
+  "type": "object"
+}

addedOutput schema / properties / dados / items / properties / observacoes

Added value: +{
+  "description": "Só em resposta harmonizada: observações de origem agregadas neste ponto",
+  "type": "number"
+}

addedOutput schema / properties / harmonizacao

Added value: +{
+  "additionalProperties": false,
+  "description": "Presente quando `frequencia` foi informada: descreve a reamostragem aplicada. Valor DERIVADO — calculado por este servidor, não publicado pelo Banco Central.",
+  "properties": {
+    "agregacao": {
+      "description": "Convenção usada para agregar os valores de cada período",
+      "enum": [
+        "ultimo",
+        "primeiro",
+        "media",
+        "soma",
+        "acumulada"
+      ],
+      "type": "string"
+    },
+    "derived": {
+      "description": "Sempre true: o valor é derivado, não publicado pela fonte",
+      "type": "boolean"
+    },
+    "frequencia": {
+      "description": "Frequência de destino",
+      "enum": [
+        "mensal",
+        "trimestral",
+        "anual"
+      ],
+      "type": "string"
+    },
+    "nota": {
+      "description": "Descrição em prosa do que foi calculado",
+      "type": "string"
+    },
+    "observacoesOriginais": {
+      "description": "Observações antes da agregação",
+      "type": "number"
+    }
+  },
+  "required": [
+    "frequencia",
+    "agregacao",
+    "derived",
+    "nota"
+  ],
+  "type": "object"
+}

addedOutput schema / properties / janelaAplicada

Added value: +{
+  "additionalProperties": false,
+  "description": "Presente quando o período pedido estava aberto numa série diária e o servidor aplicou uma janela própria (a origem recusa janela aberta em série diária com HTTP 406).",
+  "properties": {
+    "dataFinal": {
+      "description": "Fim da janela efetivamente consultada (dd/MM/yyyy)",
+      "type": "string"
+    },
+    "dataInicial": {
+      "description": "Início da janela efetivamente consultada (dd/MM/yyyy)",
+      "type": "string"
+    },
+    "motivo": {
+      "description": "Por que a janela foi aplicada e como pedir outra",
+      "type": "string"
+    }
+  },
+  "required": [
+    "dataInicial",
+    "dataFinal",
+    "motivo"
+  ],
+  "type": "object"
+}

addedOutput schema / properties / serie / description

Added value: +"Identificação da série temporal"

changedOutput schema / properties / serie / properties / periodicidade / description

Previous value: -"Periodicidade da série"New value: +"Periodicidade (Diária, Mensal, etc.)"

addedOutput schema / properties / serie / properties / periodicidadeInferida

Added value: +{
+  "description": "Presente e true quando a periodicidade foi inferida do espaçamento das observações, e não lida do catálogo — a API do SGS não publica metadados de série.",
+  "type": "boolean"
+}

Changedbcb_series_populares4 fields changed

removedInput schema / $schema

Removed value: -"http://json-schema.org/draft-07/schema#"

removedOutput schema / $schema

Removed value: -"http://json-schema.org/draft-07/schema#"

changedOutput schema / properties / series / anyOf

Previous value: -[
-  {
-    "items": {
-      "additionalProperties": false,
-      "properties": {
-        "categoria": {
-          "description": "Categoria econômica",
-          "type": "string"
-        },
-        "codigo": {
-          "description": "Código da série no SGS/BCB",
-          "type": "number"
-        },
-        "nome": {
-          "description": "Nome da série",
-          "type": "string"
-        },
-        "periodicidade": {
-          "description": "Periodicidade da série",
-          "type": "string"
-        }
-      },
-      "required": [
-        "codigo",
-        "nome"
-      ],
-      "type": "object"
-    },
-    "type": "array"
-  },
-  {
-    "additionalProperties": {
-      "items": {
-        "$ref": "#/properties/series/anyOf/0/items"
-      },
-      "type": "array"
-    },
-    "type": "object"
-  }
-]New value: +[
+  {
+    "items": {
+      "additionalProperties": false,
+      "description": "Identificação da série temporal",
+      "properties": {
+        "categoria": {
+          "description": "Categoria econômica",
+          "type": "string"
+        },
+        "codigo": {
+          "description": "Código da série no SGS/BCB",
+          "type": "number"
+        },
+        "nome": {
+          "description": "Nome da série",
+          "type": "string"
+        },
+        "periodicidade": {
+          "description": "Periodicidade (Diária, Mensal, etc.)",
+          "type": "string"
+        }
+      },
+      "required": [
+        "codigo",
+        "nome"
+      ],
+      "type": "object"
+    },
+    "type": "array"
+  },
+  {
+    "additionalProperties": {
+      "items": {
+        "additionalProperties": false,
+        "description": "Identificação da série temporal",
+        "properties": {
+          "categoria": {
+            "description": "Categoria econômica",
+            "type": "string"
+          },
+          "codigo": {
+            "description": "Código da série no SGS/BCB",
+            "type": "number"
+          },
+          "nome": {
+            "description": "Nome da série",
+            "type": "string"
+          },
+          "periodicidade": {
+            "description": "Periodicidade (Diária, Mensal, etc.)",
+            "type": "string"
+          }
+        },
+        "required": [
+          "codigo",
+          "nome"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "type": "object"
+  }
+]

changedOutput schema / properties / series / description

Previous value: -"Séries encontradas (array quando filtrado; objeto agrupado por categoria caso contrário)"New value: +"Séries encontradas. Objeto agrupado por categoria quando sem filtro; array plano quando filtrado por categoria."

Changedbcb_variacao7 fields changed

removedInput schema / $schema

Removed value: -"http://json-schema.org/draft-07/schema#"

changedInput schema / properties / periodos / description

Previous value: -"Alternativa: calcular variação dos últimos N períodos (ignora datas se informado)"New value: +"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."

removedOutput schema / $schema

Removed value: -"http://json-schema.org/draft-07/schema#"

addedOutput schema / properties / chunking

Added value: +{
+  "additionalProperties": false,
+  "description": "Presente quando a consulta foi fatiada em várias requisições à origem, por causa do limite de 10 anos por janela em séries diárias. As fatias são fundidas e ordenadas antes de responder.",
+  "properties": {
+    "fatiaAnos": {
+      "description": "Largura máxima de cada janela, em anos",
+      "type": "number"
+    },
+    "janelas": {
+      "description": "Quantidade de janelas consultadas",
+      "type": "number"
+    }
+  },
+  "required": [
+    "janelas",
+    "fatiaAnos"
+  ],
+  "type": "object"
+}

addedOutput schema / properties / derivacao

Added value: +{
+  "additionalProperties": false,
+  "description": "Origem dos números calculados: o que é derivado, por qual motor e com quais convenções",
+  "properties": {
+    "derived": {
+      "description": "Sempre true: há número calculado nesta resposta",
+      "type": "boolean"
+    },
+    "motor": {
+      "description": "Componente que computou a estatística",
+      "type": "string"
+    },
+    "nota": {
+      "description": "Convenções de cálculo e arredondamento, em prosa",
+      "type": "string"
+    }
+  },
+  "required": [
+    "derived",
+    "motor",
+    "nota"
+  ],
+  "type": "object"
+}

addedOutput schema / properties / janelaAplicada

Added value: +{
+  "additionalProperties": false,
+  "description": "Presente quando o período pedido estava aberto numa série diária e o servidor aplicou uma janela própria (a origem recusa janela aberta em série diária com HTTP 406).",
+  "properties": {
+    "dataFinal": {
+      "description": "Fim da janela efetivamente consultada (dd/MM/yyyy)",
+      "type": "string"
+    },
+    "dataInicial": {
+      "description": "Início da janela efetivamente consultada (dd/MM/yyyy)",
+      "type": "string"
+    },
+    "motivo": {
+      "description": "Por que a janela foi aplicada e como pedir outra",
+      "type": "string"
+    }
+  },
+  "required": [
+    "dataInicial",
+    "dataFinal",
+    "motivo"
+  ],
+  "type": "object"
+}

changedOutput schema / required

Previous value: -[
-  "serie",
-  "periodo",
-  "analise",
-  "estatisticas"
-]New value: +[
+  "serie",
+  "periodo",
+  "analise",
+  "estatisticas",
+  "derivacao"
+]

8 tool updatesv1.3.5Jun 24, 2026

Changedbcb_buscar_serie1 field changed

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "additionalProperties": false,
+  "properties": {
+    "mensagem": {
+      "description": "Mensagem exibida quando nada é encontrado",
+      "type": "string"
+    },
+    "series": {
+      "description": "Séries que correspondem ao termo",
+      "items": {
+        "additionalProperties": false,
+        "properties": {
+          "categoria": {
+            "description": "Categoria econômica",
+            "type": "string"
+          },
+          "codigo": {
+            "description": "Código da série no SGS/BCB",
+            "type": "number"
+          },
+          "nome": {
+            "description": "Nome da série",
+            "type": "string"
+          },
+          "periodicidade": {
+            "description": "Periodicidade da série",
+            "type": "string"
+          }
+        },
+        "required": [
+          "codigo",
+          "nome"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "sugestao": {
+      "description": "Sugestões de termos alternativos",
+      "type": "string"
+    },
+    "termo": {
+      "description": "Termo pesquisado",
+      "type": "string"
+    },
+    "totalEncontradas": {
+      "description": "Quantidade de séries encontradas",
+      "type": "number"
+    }
+  },
+  "required": [
+    "termo",
+    "totalEncontradas",
+    "series"
+  ],
+  "type": "object"
+}

Changedbcb_comparar1 field changed

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "additionalProperties": false,
+  "properties": {
+    "erros": {
+      "description": "Séries que não retornaram dados, com o motivo",
+      "items": {
+        "additionalProperties": false,
+        "properties": {
+          "codigo": {
+            "type": "number"
+          },
+          "erro": {
+            "type": "string"
+          },
+          "nome": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "codigo",
+          "erro"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "periodo": {
+      "additionalProperties": false,
+      "description": "Janela temporal comparada",
+      "properties": {
+        "dataFinal": {
+          "type": "string"
+        },
+        "dataInicial": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "dataInicial",
+        "dataFinal"
+      ],
+      "type": "object"
+    },
+    "ranking": {
+      "description": "Séries ordenadas pela variação percentual (maior para menor)",
+      "items": {
+        "additionalProperties": false,
+        "properties": {
+          "categoria": {
+            "type": "string"
+          },
+          "codigo": {
+            "type": "number"
+          },
+          "maximo": {
+            "type": "number"
+          },
+          "media": {
+            "type": "number"
+          },
+          "minimo": {
+            "type": "number"
+          },
+          "nome": {
+            "type": "string"
+          },
+          "periodicidade": {
+            "type": "string"
+          },
+          "posicao": {
+            "type": "number"
+          },
+          "totalRegistros": {
+            "type": "number"
+          },
+          "valorFinal": {
+            "type": "number"
+          },
+          "valorInicial": {
+            "type": "number"
+          },
+          "variacaoFormatada": {
+            "type": "string"
+          },
+          "variacaoPercentual": {
+            "type": "number"
+          }
+        },
+        "required": [
+          "posicao",
+          "codigo",
+          "nome"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "seriesComDados": {
+      "description": "Quantidade de séries com dados no período",
+      "type": "number"
+    },
+    "seriesComErro": {
+      "description": "Quantidade de séries sem dados ou com erro",
+      "type": "number"
+    },
+    "totalSeries": {
+      "description": "Quantidade de séries solicitadas",
+      "type": "number"
+    }
+  },
+  "required": [
+    "periodo",
+    "totalSeries",
+    "seriesComDados",
+    "seriesComErro",
+    "ranking",
+    "erros"
+  ],
+  "type": "object"
+}

Changedbcb_indicadores_atuais1 field changed

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "additionalProperties": false,
+  "properties": {
+    "consultadoEm": {
+      "description": "Timestamp ISO 8601 da consulta",
+      "type": "string"
+    },
+    "indicadores": {
+      "description": "Indicadores com seus valores mais recentes",
+      "items": {
+        "additionalProperties": false,
+        "properties": {
+          "codigo": {
+            "description": "Código da série no SGS/BCB",
+            "type": "number"
+          },
+          "data": {
+            "description": "Data da observação",
+            "type": "string"
+          },
+          "erro": {
+            "description": "Mensagem de erro quando indisponível",
+            "type": "string"
+          },
+          "indicador": {
+            "description": "Nome do indicador",
+            "type": "string"
+          },
+          "valor": {
+            "description": "Valor mais recente",
+            "type": "number"
+          }
+        },
+        "required": [
+          "indicador",
+          "codigo"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    }
+  },
+  "required": [
+    "consultadoEm",
+    "indicadores"
+  ],
+  "type": "object"
+}

Changedbcb_serie_metadados1 field changed

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "additionalProperties": false,
+  "properties": {
+    "categoria": {
+      "description": "Categoria econômica",
+      "type": "string"
+    },
+    "codigo": {
+      "description": "Código da série no SGS/BCB",
+      "type": "number"
+    },
+    "especial": {
+      "description": "Indica se é uma série especial",
+      "type": "boolean"
+    },
+    "fonte": {
+      "description": "Fonte dos dados",
+      "type": "string"
+    },
+    "nome": {
+      "description": "Nome da série",
+      "type": "string"
+    },
+    "observacao": {
+      "description": "Observação sobre a origem dos metadados",
+      "type": "string"
+    },
+    "periodicidade": {
+      "description": "Periodicidade da série",
+      "type": "string"
+    },
+    "ultimoValor": {
+      "additionalProperties": false,
+      "description": "Última observação disponível (fallback)",
+      "properties": {
+        "data": {
+          "description": "Data da observação (dd/MM/yyyy)",
+          "type": "string"
+        },
+        "valor": {
+          "description": "Valor numérico da observação",
+          "type": "number"
+        }
+      },
+      "required": [
+        "data",
+        "valor"
+      ],
+      "type": "object"
+    },
+    "unidade": {
+      "description": "Unidade de medida",
+      "type": "string"
+    },
+    "urlConsulta": {
+      "description": "URL da API do BCB para consulta completa",
+      "type": "string"
+    },
+    "urlUltimos10": {
+      "description": "URL da API do BCB para os últimos 10 valores",
+      "type": "string"
+    }
+  },
+  "required": [
+    "codigo",
+    "nome",
+    "fonte"
+  ],
+  "type": "object"
+}

Changedbcb_serie_ultimos1 field changed

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "additionalProperties": false,
+  "properties": {
+    "dados": {
+      "description": "Observações mais recentes",
+      "items": {
+        "additionalProperties": false,
+        "properties": {
+          "data": {
+            "description": "Data da observação (dd/MM/yyyy)",
+            "type": "string"
+          },
+          "valor": {
+            "description": "Valor numérico da observação",
+            "type": "number"
+          }
+        },
+        "required": [
+          "data",
+          "valor"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "observacao": {
+      "description": "Mensagem informativa (ex.: quando não há dados)",
+      "type": "string"
+    },
+    "serie": {
+      "additionalProperties": false,
+      "properties": {
+        "categoria": {
+          "description": "Categoria econômica",
+          "type": "string"
+        },
+        "codigo": {
+          "description": "Código da série no SGS/BCB",
+          "type": "number"
+        },
+        "nome": {
+          "description": "Nome da série",
+          "type": "string"
+        },
+        "periodicidade": {
+          "description": "Periodicidade da série",
+          "type": "string"
+        }
+      },
+      "required": [
+        "codigo",
+        "nome"
+      ],
+      "type": "object"
+    },
+    "totalRegistros": {
+      "description": "Quantidade de observações retornadas",
+      "type": "number"
+    }
+  },
+  "required": [
+    "serie",
+    "totalRegistros",
+    "dados"
+  ],
+  "type": "object"
+}

Changedbcb_serie_valores1 field changed

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "additionalProperties": false,
+  "properties": {
+    "dados": {
+      "description": "Observações históricas",
+      "items": {
+        "additionalProperties": false,
+        "properties": {
+          "data": {
+            "description": "Data da observação (dd/MM/yyyy)",
+            "type": "string"
+          },
+          "valor": {
+            "description": "Valor numérico da observação",
+            "type": "number"
+          }
+        },
+        "required": [
+          "data",
+          "valor"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "observacao": {
+      "description": "Mensagem informativa (ex.: quando não há dados)",
+      "type": "string"
+    },
+    "periodoFinal": {
+      "description": "Data da última observação",
+      "type": "string"
+    },
+    "periodoInicial": {
+      "description": "Data da primeira observação",
+      "type": "string"
+    },
+    "serie": {
+      "additionalProperties": false,
+      "properties": {
+        "categoria": {
+          "description": "Categoria econômica",
+          "type": "string"
+        },
+        "codigo": {
+          "description": "Código da série no SGS/BCB",
+          "type": "number"
+        },
+        "nome": {
+          "description": "Nome da série",
+          "type": "string"
+        },
+        "periodicidade": {
+          "description": "Periodicidade da série",
+          "type": "string"
+        }
+      },
+      "required": [
+        "codigo",
+        "nome"
+      ],
+      "type": "object"
+    },
+    "totalRegistros": {
+      "description": "Quantidade de observações retornadas",
+      "type": "number"
+    }
+  },
+  "required": [
+    "serie",
+    "totalRegistros",
+    "dados"
+  ],
+  "type": "object"
+}

Changedbcb_series_populares1 field changed

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "additionalProperties": false,
+  "properties": {
+    "categorias": {
+      "description": "Quantidade de categorias distintas",
+      "type": "number"
+    },
+    "observacao": {
+      "description": "Dica de uso",
+      "type": "string"
+    },
+    "series": {
+      "anyOf": [
+        {
+          "items": {
+            "additionalProperties": false,
+            "properties": {
+              "categoria": {
+                "description": "Categoria econômica",
+                "type": "string"
+              },
+              "codigo": {
+                "description": "Código da série no SGS/BCB",
+                "type": "number"
+              },
+              "nome": {
+                "description": "Nome da série",
+                "type": "string"
+              },
+              "periodicidade": {
+                "description": "Periodicidade da série",
+                "type": "string"
+              }
+            },
+            "required": [
+              "codigo",
+              "nome"
+            ],
+            "type": "object"
+          },
+          "type": "array"
+        },
+        {
+          "additionalProperties": {
+            "items": {
+              "$ref": "#/properties/series/anyOf/0/items"
+            },
+            "type": "array"
+          },
+          "type": "object"
+        }
+      ],
+      "description": "Séries encontradas (array quando filtrado; objeto agrupado por categoria caso contrário)"
+    },
+    "totalSeries": {
+      "description": "Quantidade total de séries retornadas",
+      "type": "number"
+    }
+  },
+  "required": [
+    "totalSeries",
+    "categorias",
+    "series"
+  ],
+  "type": "object"
+}

Changedbcb_variacao1 field changed

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "additionalProperties": false,
+  "properties": {
+    "analise": {
+      "additionalProperties": false,
+      "description": "Resultado da variação entre o primeiro e o último valor",
+      "properties": {
+        "diferencaAbsoluta": {
+          "type": "number"
+        },
+        "valorFinal": {
+          "type": "number"
+        },
+        "valorInicial": {
+          "type": "number"
+        },
+        "variacaoFormatada": {
+          "type": "string"
+        },
+        "variacaoPercentual": {
+          "type": "number"
+        }
+      },
+      "required": [
+        "valorInicial",
+        "valorFinal",
+        "diferencaAbsoluta",
+        "variacaoPercentual",
+        "variacaoFormatada"
+      ],
+      "type": "object"
+    },
+    "estatisticas": {
+      "additionalProperties": false,
+      "description": "Estatísticas descritivas dos valores no período",
+      "properties": {
+        "amplitude": {
+          "type": "number"
+        },
+        "maximo": {
+          "type": "number"
+        },
+        "media": {
+          "type": "number"
+        },
+        "minimo": {
+          "type": "number"
+        }
+      },
+      "required": [
+        "maximo",
+        "minimo",
+        "media",
+        "amplitude"
+      ],
+      "type": "object"
+    },
+    "periodo": {
+      "additionalProperties": false,
+      "description": "Janela temporal analisada",
+      "properties": {
+        "dataFinal": {
+          "type": "string"
+        },
+        "dataInicial": {
+          "type": "string"
+        },
+        "totalPeriodos": {
+          "type": "number"
+        }
+      },
+      "required": [
+        "dataInicial",
+        "dataFinal",
+        "totalPeriodos"
+      ],
+      "type": "object"
+    },
+    "serie": {
+      "additionalProperties": false,
+      "description": "Identificação da série",
+      "properties": {
+        "categoria": {
+          "type": "string"
+        },
+        "codigo": {
+          "type": "number"
+        },
+        "nome": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "codigo",
+        "nome"
+      ],
+      "type": "object"
+    }
+  },
+  "required": [
+    "serie",
+    "periodo",
+    "analise",
+    "estatisticas"
+  ],
+  "type": "object"
+}

8 tool updatesv1.0.0Mar 18, 2026
- First observedbcb_buscar_serie
- First observedbcb_comparar
- First observedbcb_indicadores_atuais
- First observedbcb_serie_metadados
- First observedbcb_serie_ultimos
- First observedbcb_serie_valores
- First observedbcb_series_populares
- First observedbcb_variacao

Install Server

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

TDQS

A4.7/5.0

Disambiguation5/5

Each tool targets a distinct operation or resource: series data (metadados, valores, ultimos), discovery (populares, buscar), analytics (variacao, comparar, correlacao, deflacionar), Focus (expectativas, selic, referencias), and exchange (cotacao, moedas). The descriptions clearly differentiate the tools, even where they overlap in domain, by specifying what each tool is for and when not to use it. There is no ambiguity between tools with similar purposes.

Naming Consistency4/5

All tool names follow a consistent 'bcb_' prefix with lowercase underscores, and they are grouped by subdomain (serie, series, focus, cambio). There is minor variation in style: some use nouns (bcb_variacao, bcb_correlacao) and some use verbs (bcb_comparar, bcb_deflacionar), but the overall pattern is predictable and readable.

Tool Count5/5

With 15 tools covering series metadata, values, discovery, analytics, Focus expectations, and exchange rates, each tool earns its place. The count is well-scoped for the broad purpose of exposing Brazilian Central Bank data, and the grouping by subdomain keeps the surface manageable.

Completeness5/5

The toolset provides comprehensive lifecycle coverage for a read-only economic data API: discovery (search, popular list), retrieval (metadata, values, latest), analysis (variation, compare, correlation, inflation adjustment), and specialized subdomains (Focus expectations, exchange rates). It also includes reference tools (bcb_focus_referencias, bcb_cambio_moedas) to help agents use the other tools correctly, leaving no practical gaps.

Maintenance

ActivityActive

ResponsivenessWithin a week

Resources

Need Help?

Related Servers

Related MCP Connectors

Dados Abertos Senado BR MCP A
io.github.SidneyBissoli
MCP server for Brazilian Federal Senate open data (legislative, administrative, e-Cidadania).
Government Data Open Data
6925
Bcrp Pe A
io.github.pipeworx-io
Banco Central de Reserva del Perú (BCRP) statistics series API MCP. Keyless.
Finance Government Data Open Data
322
Inegi A
io.github.pipeworx-io
INEGI MCP — Mexico's national statistics office (INEGI) Indicators API.
Government Data Open Data
332
Datos Ar A
io.github.pipeworx-io
Argentina 'Series de Tiempo' MCP — national time-series API (apis.datos.gob.ar).
Government Data Open Data
332

Related MCP Servers

FRED MCP Server
Government Data Search Research & Data
kablewy
A
license
B
quality
D
maintenance
A Model Context Protocol server that provides tools to search and retrieve economic data series from the Federal Reserve Economic Data (FRED) API.
Updated 2 years ago (2024-12-11 01:40 UTC)
2
367
11
AGPL 3.0
Financial Modeling Prep MCP
Data Platforms Finance
imbenrabi
A
license
C
quality
A
maintenance
Enables AI assistants to access and analyze financial data including stock information, company fundamentals, and market insights through the Financial Modeling Prep API.
Updated 2 months ago (2026-07-02 17:24 UTC)
100
417
143
TypeScript
Apache 2.0
Financial Modeling Prep MCP
Finance Search Databases
vijitdaroch
A
license
Not graded
quality
D
maintenance
Provides AI assistants with access to comprehensive financial data including real-time stock quotes, company fundamentals, financial statements, market analysis, SEC filings, and economic indicators through 253+ tools across 24 categories.
Updated a year ago (2025-08-20 09:21 UTC)
417
Apache 2.0
IBGE Brasil MCP
Government Data Open Data Research & Data
SidneyBissoli
A
license
A
quality
A
maintenance
This server provides access to IBGE's public APIs, enabling AI assistants to query geographic, demographic, and statistical data from Brazil.
Updated 4 days ago (2026-09-04 01:24 UTC)
23
876
9
MIT

Appeared in Searches

A server for finding macroeconomic data

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/SidneyBissoli/bcb-br-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server