MCP BACEN

Servidor MCP remoto para dados publicos do Banco Central do Brasil, nos mesmos moldes do projeto mcp-sidra, preparado para virar um app do ChatGPT com Apps SDK.

Stack

• Node.js + TypeScript + ESM

• @modelcontextprotocol/sdk com transporte Streamable HTTP em /mcp

• @modelcontextprotocol/ext-apps para recurso UI opcional do Apps SDK

• Zod para schemas de entrada e saida

• Vitest para testes dos builders de URL e normalizacao

Related MCP server: BCB Meios de Pagamento MCP

Ferramentas MCP

• search e fetch: compativeis com o padrao data-only/company knowledge do ChatGPT.

• list_sgs_series: busca no catalogo local de codigos SGS comuns.

• get_sgs_series: consulta series temporais do SGS por codigo, com last ou startDate/endDate.

• list_ptax_currencies: lista moedas disponiveis no endpoint PTAX Moedas.

• get_ptax_dollar_quotes: consulta cotacoes PTAX do dolar por dia ou periodo.

• get_ptax_currency_quotes: consulta cotacoes PTAX de outras moedas por dia ou periodo.

Todas as ferramentas sao read-only.

Desenvolvimento

npm install
npm run dev

O MCP fica disponivel em:

http://localhost:8787/mcp

Teste com o MCP Inspector:

npm run inspect

Para validar o MCP no ChatGPT usando um tunel HTTPS local, siga docs/local-https-tunnel.md.

Exemplos de prompts

Liste as series SGS relacionadas a Selic.

Busque os ultimos 5 valores da serie SGS 11.

Qual foi a PTAX de fechamento do dolar em 2026-06-16?

Liste as moedas disponiveis na PTAX e depois consulte EUR em junho de 2026.

ChatGPT App

Para conectar no ChatGPT durante desenvolvimento:

1. Rode npm run dev.

2. Exponha a porta com um tunel HTTPS, por exemplo ngrok http 8787.

3. Em ChatGPT, ative developer mode e crie um app apontando para https://<subdomain>.ngrok.app/mcp.

Para submissao, defina APP_DOMAIN com o dominio HTTPS final do app. O widget e opcional, mas este projeto ja inclui um recurso Apps SDK simples para renderizar resultados tabulares.

Fontes de dados

• SGS: https://api.bcb.gov.br/dados/serie/bcdata.sgs.{codigo}/dados?formato=json

• PTAX: https://olinda.bcb.gov.br/olinda/servico/PTAX/versao/v1/odata

• Dados abertos BCB: https://dadosabertos.bcb.gov.br

Observacoes:

• O endpoint SGS ultimos/{N} aceita no maximo 20 valores.

• Consultas SGS com dataInicial e dataFinal devem ser divididas em janelas de ate 10 anos.

• PTAX usa sintaxe OData, por exemplo CotacaoDolarDia(dataCotacao=@dataCotacao)?@dataCotacao='06-16-2026'&$format=json.