Dados Financeiros Abertos · alpha
-MCP público no Cloudflare Workers
-
- Superfície pública: /mcp (Streamable HTTP).
- REST/FastAPI, CLI e code mode não ficam na internet — só na rede Tailscale.
+
Dados Financeiros Abertos · alpha
+Dados oficiais do Brasil, direto no seu assistente de IA
++ Conecte o ChatGPT, o Claude ou o Cursor a este endereço e pergunte em + português sobre Selic, IPCA, Boletim Focus, fundos da CVM e finanças + públicas. A resposta vem da fonte primária: Banco Central, IBGE, IPEA, + Tesouro Nacional, CVM e Open Finance Brasil.
-
- Uso justo: cerca de 60 req/min por IP (pico 20 / 10s). Sem API key.
- Sem execução de código no endpoint público. Excesso em
- /mcp responde 429 + Retry-After.
+
O que dá para perguntar
++ Exemplos reais, respondidos com dado oficial. Você escreve assim mesmo, + em linguagem natural, dentro do seu assistente.
-Tools neste Worker (fontes públicas, sem processar Python):
--
-
bcb_seriesbcb_ptaxbcb_focus
- ibge_indicatoribge_ipca_breakdown
- ipea_seriesipea_search
- tesouro_siconfi
- openfinance_directory
- cvm_fund— cadastro RCVM 175, cotas INF_DIARIO e carteira CDA
-
- B3/ANBIMA/registry, lâmina/perfil e a API REST completa continuam no
- pacote Python (pip install openfindata) e no FastAPI interno.
+
Como conectar em um minuto
++ Este serviço fala MCP (Model Context Protocol), o padrão + aberto que permite a um assistente de IA consultar uma fonte de dados + externa com segurança. Na prática: você cola um endereço na configuração + do seu assistente e ele ganha acesso às ferramentas listadas abaixo.
-Cliente MCP:
-{
+ Claude Code, Cursor e clientes que leem um JSON
+ {
"mcpServers": {
"openfindata": {
+ "type": "http",
"url": "https://openfindata.com.br/mcp"
}
}
-}
+}
+
+ O "type": "http" é obrigatório. Sem ele, o Claude Code trata
+ a entrada como servidor local e ignora a URL.
+
Claude Desktop
+
+ O Desktop não lê esse JSON para servidor remoto. Vá em Configurações,
+ Conectores, Adicionar conector personalizado e cole
+ https://openfindata.com.br/mcp.
+
ChatGPT
+
+ O ChatGPT não lê o JSON acima. Conector personalizado lá depende do
+ Modo desenvolvedor, que está em beta, só funciona na
+ versão web e não existe no plano gratuito. Em conta de
+ trabalho, o administrador precisa liberar. Com o modo ligado, você cria
+ um conector novo e cola
+ https://openfindata.com.br/mcp, sem autenticação.
+
+ O plano exigido e o caminho exato do menu já mudaram mais de uma vez, e + por isso não repetimos aqui: confira o passo atual na + ajuda + oficial da OpenAI. +
+Qualquer outro cliente MCP
++ Em cliente que peça só a URL, use o mesmo endereço e escolha o + transporte Streamable HTTP. Não há etapa de login. +
+ +As 10 ferramentas
+| Ferramenta | O que entrega | Fonte |
|---|---|---|
bcb_series | Séries temporais: Selic, IPCA, CDI, câmbio e o catálogo completo | BCB / SGS |
bcb_ptax | Câmbio oficial PTAX, por dia ou por período | BCB / Olinda |
bcb_focus | Boletim Focus: expectativas de mercado para IPCA, Selic, PIB e câmbio | BCB |
ibge_indicator | Indicadores econômicos do IBGE | IBGE / SIDRA |
ibge_ipca_breakdown | IPCA mensal aberto por grupo | IBGE |
ipea_series | Séries macro com histórico longo | IPEA Data |
ipea_search | Busca textual em cerca de 8 mil séries | IPEA Data |
tesouro_siconfi | Finanças públicas: RREO, RGF e a lista de entes federativos | Tesouro / SICONFI |
cvm_fund | Fundos: cadastro RCVM 175, cotas diárias e carteira (CDA) | CVM |
openfinance_directory | Diretório público de participantes e endpoints | Open Finance Brasil |
O que este serviço não faz
+-
+
- + Não calcula indicador derivado. Sem Sharpe, sem CAGR, sem drawdown. + Ele entrega o número que o órgão publicou, normalizado, e a conta fica + com você ou com o seu assistente. + +
- + Não acessa dado de cliente. O Open Finance aqui é só o diretório + público de participantes, nunca informação de conta de ninguém. + +
- Não revende dado de terceiros nem executa código no endpoint público. +
- Não é recomendação de investimento. +
Limites e transparência
+-
+
- Não pede API key, cadastro nem cartão. É só apontar o cliente para a URL. +
- Uso justo:
60 req/minpor IP, com pico de 20 a cada 10 segundos. O excesso recebe HTTP 429 comRetry-After.
+ - Sem execução de código: o servidor só lê fontes públicas e devolve dados. Ele não roda snippet, não escreve em lugar nenhum e não guarda o que você perguntou. +
- Resposta longa vem limitada, não paginada: não existe argumento de página ou offset. Ela traz
total_matched,returned,truncatedeupstream_complete. Setruncatedfor verdadeiro, você não viu tudo; estreite a busca com os filtros da ferramenta, comouf,esferaouqemtesouro_siconfi.
+ - Se
upstream_completefor falso, a fonte ainda tinha páginas quando a busca parou. Nesse casototal_matchedconta só o que foi buscado e não é um total geral.
+ - Parâmetro desconhecido é recusado com erro explícito, nunca ignorado em silêncio. +
- Lista vazia não é erro: quando cabe, um campo
reasonexplica o motivo, como PTAX ainda não publicado no dia ou fim de semana.
+ - Projeto em alpha. A superfície pode mudar, e o repositório é a fonte da verdade. +
Para quem desenvolve
- Código: - github.com/robertoecf/OpenFinData + O endpoint público é só o MCP. A biblioteca Python, a API REST em FastAPI, + a CLI e as fontes adicionais (B3, ANBIMA, SUSEP, ANEEL, Receita Federal e + o registro de CNPJ e ticker) ficam no repositório e rodam localmente. + Instruções de instalação, contribuição e a matriz completa de fontes + estão no + GitHub. + Resumo legível por máquina em /llms.txt.
+ +