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

Buscar série no catálogo

bcb_buscar_serie

Read-onlyIdempotent

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

Input Schema

TableJSON 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, sem distinção de acento; a palavra de todo dia é traduzida para a do BCB (déficit→resultado primário, calote→inadimplência, desemprego→desocupação) e a resposta diz quando isso aconteceu (notasVocabulario).
`limite`	No	Máximo de séries a devolver (1-100, padrão: 20). `totalEncontradas` traz o total antes do corte.

Output Schema

TableJSON 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)
`notasVocabulario`	No	Quando um termo foi ampliado para a palavra que o BCB usa (déficit→resultado primário), diz qual
`totalEncontradas`	Yes	Quantidade de séries encontradas, antes do corte por `limite`

Schema Changelog

Changes observed during successful MCP inspections.

Changed2 schema fields changedSep 16, 2026

changedInput schema / properties / termo / description

Previous value: -"Termo de busca (mínimo 2 caracteres) ou o código da série. Vários termos são combinados com E."New value: +"Termo de busca (mínimo 2 caracteres) ou o código da série. Vários termos são combinados com E, sem distinção de acento; a palavra de todo dia é traduzida para a do BCB (déficit→resultado primário, calote→inadimplência, desemprego→desocupação) e a resposta diz quando isso aconteceu (notasVocabulario)."

addedOutput schema / properties / notasVocabulario

Added value: +{
+  "description": "Quando um termo foi ampliado para a palavra que o BCB usa (déficit→resultado primário), diz qual",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

First observedSep 6, 2026

TDQS

A4.9/5.0

Behavior5/5

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

Beyond the readOnly/idempotent/openWorld annotations, the description discloses cache validity of 24 hours, first-search-after-expiry renewal hitting the network, graceful degradation to the curated catalog when the portal is down, and signaling through 'avisos'. This matches and enriches the annotations rather than 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?

The description is long but densely structured with labeled sections (Quando usar, Quando NÃO usar, Retorna, Cobertura, Comportamento de rede). Each section covers a distinct decision or runtime behavior an agent needs, and the most important purpose and usage guidance are 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?

For a search tool with output schema, network behavior, open-world coverage, and sibling alternatives, the description covers discovery, negatives, degradation, response shape, and caveats. Nothing an agent needs to select and call it correctly is missing.

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 coverage is 100%, so the baseline is 3, and the schema already documents termo and limite well. The description adds value by tying `limite` to `totalEncontradas` (total before truncation) and by restating accent-insensitive AND-combination semantics with a concrete example, though much of the termo behavior was already present in the schema.

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 object—'Busca séries do BCB por palavra-chave (ou pelo código)'—and explains the two-layer mechanism. It also explicitly contrasts with siblings: bcb_series_populares for browsing by category and bcb_serie_valores for values, so an agent can distinguish this search-and-discover tool.

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?

There is an explicit 'Quando usar' (to discover a series code before querying values) and 'Quando NÃO usar' with named alternatives. The coverage caveat—the index is not the entire SGS—adds crucial guidance against over-trusting negative results.

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

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

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.