by cristianoaredes
Provides Brazilian public data such as company registration (CNPJ), postal codes (CEP), municipal gazettes, Central Bank indicators and procurement notices directly within AI assistants, returning structured results with source URLs and timestamps.
Mcp Dadosbr connects AI assistants to 23 public‑data tools covering companies, addresses, government gazettes, finance, legal processes and more. It delivers the data as JSON while preserving provenance, and offers five interactive MCP Apps (IBGE locations, Querido Diário, Central Bank rates, PNCP procurement, and CNPJ profile) that can be displayed inside the conversation.
npx command – it runs as a local CLI (stdio) or as an HTTP/SSE endpoint.cnpj_lookup, cep_lookup, bacen_taxas). The response includes content[0].text with JSON and, when the client advertises UI support, a structuredContent payload with an HTML panel (ui://dadosbr/*.html).MCP_API_KEY.fetchedAt and, when available, updatedAt..mcprc.json (allow‑list enforced).Do I need API keys to get started? No. All five MCP Apps and most tools (CNPJ, CEP, CPF validation, FIPE, etc.) work without any credentials. Keys are only required for optional services such as Transparency, DataJud or web‑search providers.
What happens if my AI client does not support MCP Apps? The 23 tools still return JSON‑structured text. The UI panels are omitted, but the data remains usable.
Can I change the CNPJ or CEP provider?
Yes. Set CNPJ_API_BASE_URL or CEP_API_BASE_URL (or use a .mcprc.json file). The host must be in the built‑in allow‑list for SSRF protection.
How is authentication handled for the HTTP/SSE mode?
When the server binds to a non‑loopback address, an MCP_API_KEY environment variable is mandatory. Requests must include Authorization: Bearer <key> or X-API-Key: <key>.
Is the server safe to run in production?
The runtime includes rate limiting, request deduplication, exponential back‑off, and a circuit‑breaker. Logs are written to stderr so stdout remains a clean JSON‑RPC stream.
Why is the project licensed under AGPL‑3.0? Because it is a network‑exposed server; the license ensures that anyone who modifies and offers the service over a network shares the source under the same terms.
by OrqoDados públicos brasileiros na conversa com IA. Com fonte, proveniência e limites declarados.
O problema · 5 MCP Apps · 23 ferramentas · Perímetro · Instalação · Por dentro · O que não faz · Governança · AGPL-3.0 · English
O MCP DadosBR é um servidor open source do Model Context Protocol (MCP) desenvolvido pela Orqo que conecta assistentes de IA a 23 consultas de dados públicos brasileiros — com 5 painéis interativos (MCP Apps) para explorar municípios, diários oficiais, indicadores do Banco Central, editais do PNCP e fichas cadastrais de CNPJ diretamente na conversa.
fetchedAt) nos 5 MCP Apps (structuredContent) e nas consultas de CNPJ/CEP (source/fetchedAt), com separação explícita entre fetchedAt e updatedAt na ficha cadastral.stdio e HTTP/SSE) com painéis interativos, ou Cloudflare Worker com retorno JSON, REST e OAuth.Pedir dados públicos brasileiros "de memória" a um modelo de linguagem mistura fato, defasagem e suposição. Para due diligence, jornalismo de dados, compras públicas ou engenharia, texto fluente não substitui a consulta à fonte.
| Pedir ao LLM "de memória" | Consultar via MCP DadosBR by Orqo |
|---|---|
| Situação cadastral e CNAEs possivelmente defasados ou inventados | Consulta direta ao provedor declarado (OpenCNPJ ou allowlist HTTPS), com provider, fetchedAt e updatedAt separados |
| Taxas de Selic, IPCA e câmbio sem série ou janela verificável | Séries oficiais do BCData/SGS com ID da série, unidade e janela explícita (30, 90 ou 365 dias até hoje em São Paulo) |
| Editais e diários oficiais sem link verificável | Publicações consultadas na API do PNCP (links em pncp.gov.br) e no Querido Diário (edição original) |
| Erro silencioso ou preenchimento de lacunas com palpite | Erro explícito (isError: true) ou fallback com URL oficial quando o provedor falha ou exige CAPTCHA |
| Apenas texto corrido para listas, gráficos e cadastros | 5 MCP Apps interativos (ui://dadosbr/*.html) na conversa + retorno JSON preservado para qualquer cliente MCP |
Os cinco painéis implementam a extensão MCP Apps (mimeType: text/html;profile=mcp-app), são empacotados como HTML autônomo em build/lib/apps/*.html e já acompanham o pacote npm a partir da versão 0.5.0.
| MCP App | Ferramenta | Recurso ui:// |
O que você faz no painel | Fonte dos dados |
|---|---|---|---|---|
| Localidades do IBGE | ibge_localidades |
ui://dadosbr/ibge-localidades.html |
Navega por 5 macro-regiões, 27 UFs e ~5.570 municípios, filtra por nome ou código IBGE e abre diretamente o painel de diários oficiais do município selecionado. | API de Localidades do IBGE |
| Querido Diário | querido_diario |
ui://dadosbr/querido-diario.html |
Pesquisa publicações em diários oficiais municipais por termo, territory_id (código IBGE) e período (since/until), ou lista edições recentes, com link para a edição original. |
API pública do Querido Diário |
| Indicadores do Banco Central | bacen_taxas |
ui://dadosbr/banco-central.html |
Visualiza gráfico e tabela para Meta Selic (432), IPCA (433), Dólar venda (1), Euro venda (21619) e CDI (12) em janelas de 30, 90 ou 365 dias até o dia corrente em São Paulo. |
Banco Central — BCData/SGS |
| Editais do PNCP | pncp_licitacoes |
ui://dadosbr/editais-pncp.html |
Filtra publicações da Lei 14.133/2021 por período, modalidade (20 modalidades oficiais, ex.: 6 = Pregão Eletrônico) e CNPJ opcional do órgão, com links permanentes no portal oficial. |
API de Consultas do PNCP |
| Ficha por CNPJ | cnpj_lookup |
ui://dadosbr/ficha-cnpj.html |
Exibe razão social, nome fantasia, situação cadastral e data, CNAE principal e secundários, endereço, hostname do provedor, horário da consulta (fetchedAt) e data de atualização cadastral (updatedAt) quando informada. |
OpenCNPJ por padrão ou provedor compatível |
"Abra o Explorador do IBGE para Alagoas, selecione Batalha, clique em Ver publicações e busque por orçamento."
"Abra a ficha do CNPJ 00.394.460/0001-41 e mostre situação cadastral, CNAEs, endereço e o provedor que respondeu."
"Abra o painel do Banco Central e mostre a Selic dos últimos 90 dias com a série e a fonte."
"Abra o painel do PNCP e liste editais de pregão eletrônico publicados nos últimos 30 dias."
"Monte um perfil completo do CNPJ 00.394.460/0001-41 verificando contrato federal, sanções e WHOIS do domínio."
Todas as 23 ferramentas registradas em lib/tools/index.ts respondem em JSON estruturado no conteúdo textual (content[0].text). As cinco marcadas com MCP App também entregam structuredContent e painel HTML quando o cliente suporta io.modelcontextprotocol/ui.
| Ferramenta | Descrição | Fonte | MCP App | Credencial |
|---|---|---|---|---|
cnpj_lookup |
Dados cadastrais de empresa brasileira por CNPJ (com ou sem máscara). | OpenCNPJ (padrão) ou allowlist | Sim | Sem chave |
cep_lookup |
Endereço completo por CEP brasileiro (com ou sem máscara). | OpenCEP (padrão) ou allowlist | Texto | Sem chave |
cpf_validate |
Valida dígito verificador (mod-11), formata e informa a região fiscal do 9º dígito. | Cálculo local | Texto | Sem chave |
| Ferramenta | Descrição | Fonte | MCP App | Credencial |
|---|---|---|---|---|
ibge_localidades |
Lista regiões (regioes), estados (estados), todos os municípios (municipios) ou por UF (municipios_por_uf). |
API de Localidades do IBGE | Sim | Sem chave |
querido_diario |
Busca publicações em diários oficiais municipais por texto, territory_id, since, until, page, size. |
Open Knowledge Brasil | Sim | Sem chave |
pncp_licitacoes |
Consulta publicações filtradas (modalidade_id, data_inicial, data_final, cnpj_orgao, query: "") ou busca legada por termo. |
PNCP (Lei 14.133/2021) | Sim | Sem chave |
transparencia_lookup |
Consulta contratos, licitacoes, convenios, servidores ou sancoes federais por CNPJ/CPF e período. |
Portal da Transparência (CGU) | Texto | TRANSPARENCIA_API_KEY |
ceis_cnep_lookup |
Verifica sanções em CEIS, CNEP e CEPIM (tipo: ceis|cnep|cepim|all). Sem chave, retorna URLs de consulta manual. |
Portal da Transparência (CGU) | Texto | TRANSPARENCIA_API_KEY (opcional com fallback manual) |
| Ferramenta | Descrição | Fonte | MCP App | Credencial |
|---|---|---|---|---|
bacen_taxas |
Séries selic, ipca, dolar, euro e cdi por ultimos pontos ou periodo_dias (30, 90, 365). |
Banco Central — BCData/SGS | Sim | Sem chave |
fipe_veiculos |
Consulta preços por codigo_fipe ou lista marcas por tipo (carros, motos, caminhoes). |
Tabela FIPE via BrasilAPI | Texto | Sem chave |
| Ferramenta | Descrição | Fonte | MCP App | Credencial |
|---|---|---|---|---|
datajud_processos |
Busca processos judiciais em 17 tribunais mapeados (tst, trf1–trf5, tjsp, tjrj, tjmg, tjrs, tjpr, tjsc, tjba, tjpe, tjce, tjgo, tjdf). |
API Pública DataJud (CNJ) | Texto | DATAJUD_API_KEY |
oab_advogado |
Consulta o Cadastro Nacional dos Advogados por nome, inscricao e uf. Retorna link manual quando bloqueado por CAPTCHA. |
OAB — CNA | Texto | Sem chave (sujeito a CAPTCHA) |
bnmp_mandados |
Consulta mandados de prisão por nome e orgaoJulgador. Retorna link manual quando bloqueado por CAPTCHA. |
CNJ — BNMP | Texto | Sem chave (sujeito a CAPTCHA) |
procurados_lookup |
Busca por correspondência parcial na lista federal de procurados (~195 registros). | MJSP — Projeto Captura | Texto | Sem chave |
lista_suja_lookup |
Verifica o cadastro de empregadores em trabalho análogo à escravidão (com fallback para links oficiais). | Portal da Transparência / MTE | Texto | Sem chave |
| Ferramenta | Descrição | Fonte | MCP App | Credencial |
|---|---|---|---|---|
cnes_saude |
Busca estabelecimentos (estabelecimento) ou profissionais (profissional) por código CNES, nome, UF ou município (códigos IBGE). |
CNES — DataSUS | Texto | Sem chave |
consumidor_reclamacoes |
Consulta indicadores de reclamações por nome da empresa (com fallback para dados abertos). | Consumidor.gov.br — SENACON | Texto | Sem chave |
| Ferramenta | Descrição | Fonte | MCP App | Credencial |
|---|---|---|---|---|
cnpj_search |
Pesquisa web com dorks e filtros direcionados sobre empresas e CNPJs. | Tavily / Perplexity | Texto | TAVILY_API_KEY ou PERPLEXITY_API_KEY |
cnpj_intelligence |
Pesquisa automatizada multi-categoria por CNPJ com limite de concorrência configurável. | Tavily / Perplexity + CNPJ | Texto | TAVILY_API_KEY ou PERPLEXITY_API_KEY |
company_deep_profile |
Orquestra em paralelo cnpj_lookup, transparencia_lookup, datajud_processos, domain_whois, lista_suja_lookup e cnpj_search, listando fontes consultadas e indisponíveis. |
Múltiplas fontes acima | Texto | Usa chaves configuradas |
domain_whois |
Consulta registro de domínio via RDAP (.br no Registro.br com fallback IANA RDAP). |
Registro.br / RDAP.org | Texto | Sem chave |
strategic_osint_prompt |
Gera roteiros estruturados de análise (due_diligence, competitor_analysis, fraud_detection, esg_compliance, investment_screening) referenciando as ferramentas do servidor. |
Templates locais | Texto | Sem chave |
sequentialthinking |
Auxilia decomposição passo a passo e revisão de hipóteses em investigações complexas. | Processamento local | Texto | Sem chave |
O que muda entre os modos é onde o servidor executa e se o cliente recebe os painéis HTML interativos — não a validação de entrada nem a separação entre dado e erro.
| Modo | Transporte | MCP Apps (ui://) |
Retorno JSON textual | Controles inclusos | Quando escolher |
|---|---|---|---|---|---|
| CLI local (padrão) | stdio |
Sim (5 apps) | Sim (23 ferramentas) | stdout reservado para JSON-RPC, cache em memória, deduplicação, retry + circuit breaker, allowlist SSRF |
Uso local no Claude Desktop, Cursor, Windsurf, Claude Code e demais hosts desktop |
| CLI HTTP/SSE local | GET /mcp + POST /messages |
Sim (5 apps) | Sim (23 ferramentas) | Rate limit (30 req/min por IP), limpeza de sessões SSE inativas, CORS restrito, MCP_API_KEY obrigatória fora de loopback |
Rede local, Docker, VPS própria ou clientes MCP remotos com suporte a SSE |
| Cloudflare Worker | POST /mcp, /sse, REST e OAuth |
Não (somente texto) | Sim | Autenticação/OAuth, rate limit na borda, GET /health, OpenAPI |
Conectores remotos serverless e integrações HTTP sem manter servidor dedicado |
Autenticação obrigatória fora de loopback (
MCP_API_KEY): por padrão, o modoHTTP/SSEescuta em127.0.0.1. Ao definirMCP_HTTP_HOSTpara um endereço não-loopback (0.0.0.0,::, IP de rede etc.), o servidor opera em modo fail-closed e recusa iniciar semMCP_API_KEY. ComMCP_API_KEYconfigurada (inclusive em loopback), todas as requisiçõesGET /mcpePOST /messagesexigemAuthorization: Bearer <chave>ouX-API-Key: <chave>.
O que não muda entre os modos:
Pré-requisito: Node.js 22.12 ou posterior na linha 22, 24 ou 26 (engines.node em package.json).
0.5.0 inclui os 5 MCP Apps)Em clientes que utilizam mcpServers (Claude Desktop, Cursor, Windsurf, Claude Code e compatíveis), adicione:
{
"mcpServers": {
"dadosbr": {
"command": "npx",
"args": ["-y", "@aredes.me/mcp-dadosbr"]
}
}
}
O pacote publicado no npm e os releases no GitHub distribuem os cinco HTMLs em
build/lib/apps/a partir da versão0.5.0(com a candidata0.6.0inaugurando a distribuição npm sobAGPL-3.0-onlyapós publicação). Para fixar uma versão específica, use"@aredes.me/mcp-dadosbr@<versão>".
git clone https://github.com/cristianoaredes/mcp-dadosbr.git
cd mcp-dadosbr
npm ci
npm run build
Configure seu cliente apontando para o caminho absoluto do build:
{
"mcpServers": {
"dadosbr": {
"command": "node",
"args": ["/caminho/absoluto/mcp-dadosbr/build/lib/adapters/cli.js"]
}
}
}
# Uso local em loopback (127.0.0.1:3000)
MCP_TRANSPORT=http MCP_HTTP_PORT=3000 npx -y @aredes.me/mcp-dadosbr
# Exposição em rede / Docker / VPS (MCP_API_KEY obrigatória fora de loopback)
MCP_TRANSPORT=http MCP_HTTP_HOST=0.0.0.0 MCP_API_KEY="<sua-chave-secreta>" npx -y @aredes.me/mcp-dadosbr
O servidor abre o stream SSE em GET http://127.0.0.1:3000/mcp e recebe mensagens JSON-RPC em POST http://127.0.0.1:3000/messages?sessionId=<id>, com rate limit de 30 requisições por minuto por IP (lib/adapters/cli-http.ts). Ao configurar MCP_API_KEY, envie Authorization: Bearer <sua-chave-secreta> ou X-API-Key: <sua-chave-secreta> nas requisições.
.mcprc.json ou variável de ambiente)A hierarquia de configuração em lib/config/index.ts é: variáveis de ambiente > .mcprc.json no diretório atual > padrões (OpenCNPJ e OpenCEP).
Exemplo com variável de ambiente (ex.: CNPJ.ws):
{
"mcpServers": {
"dadosbr": {
"command": "npx",
"args": ["-y", "@aredes.me/mcp-dadosbr"],
"env": {
"CNPJ_API_BASE_URL": "https://publica.cnpj.ws/cnpj/",
"TRANSPARENCIA_API_KEY": "sua-chave-opcional"
}
}
}
}
Ou crie um .mcprc.json baseado em .mcprc.example.json:
{
"apiUrls": {
"cnpj": "https://publica.cnpj.ws/cnpj/",
"cep": "https://viacep.com.br/ws/"
},
"auth": {
"headers": {
"X-API-Key": "sua-chave-se-o-provedor-exigir"
}
}
}
Hosts permitidos na allowlist SSRF (lib/config/index.ts — somente HTTPS, exceto localhost/127.0.0.1):
api.opencnpj.org, receitaws.com.br, www.receitaws.com.br, brasilapi.com.br, publica.cnpj.ws, minhareceita.org, localhost, 127.0.0.1opencep.com, viacep.com.br, brasilapi.com.br, cep.awesomeapi.com.br, localhost, 127.0.0.1| Variável | Padrão | Uso |
|---|---|---|
TRANSPARENCIA_API_KEY |
(nenhum) | Habilita transparencia_lookup e consultas diretas em ceis_cnep_lookup (chave gratuita no Portal da Transparência). |
DATAJUD_API_KEY |
(nenhum) | Habilita datajud_processos na API Pública do CNJ. |
TAVILY_API_KEY |
(nenhum) | Provedor prioritário de busca web em cnpj_search, cnpj_intelligence e company_deep_profile. |
PERPLEXITY_API_KEY |
(nenhum) | Provedor alternativo de busca web quando configurado. |
CNPJ_API_BASE_URL |
https://api.opencnpj.org/ |
URL base HTTPS para cnpj_lookup (deve estar na allowlist). |
CEP_API_BASE_URL |
https://opencep.com/v1/ |
URL base HTTPS para cep_lookup (deve estar na allowlist). |
API_KEY_HEADER / API_KEY_VALUE |
(nenhum) | Cabeçalho de autenticação enviado ao provedor customizado de CNPJ/CEP. |
MCP_TRANSPORT |
stdio |
Modo de transporte do CLI: stdio ou http (HTTP/SSE). |
MCP_HTTP_PORT |
3000 |
Porta TCP usada quando MCP_TRANSPORT=http. |
MCP_HTTP_HOST |
127.0.0.1 |
Host de bind do modo HTTP/SSE (endereços não-loopback exigem MCP_API_KEY). |
MCP_API_KEY |
(nenhum) | Chave de autenticação (Authorization: Bearer ou X-API-Key) obrigatória ao expor HTTP/SSE fora de loopback e opcional em loopback. |
MCP_CACHE_SIZE / MCP_CACHE_TTL |
256 / 3600000 ms |
Capacidade e TTL (ms) do cache em memória do CLI. |
MCP_CACHE_BACKGROUND_CLEANUP |
false |
Se true, ativa limpeza periódica em segundo plano do cache. |
MCP_API_TIMEOUT |
8000 ms |
Timeout (ms) das requisições HTTP de saída. |
MCP_INTELLIGENCE_CONCURRENCY |
3 |
Limite de buscas simultâneas em cnpj_intelligence. |
DISABLE_THOUGHT_LOGGING |
false |
Se true, suprime log de pensamentos de sequentialthinking no stderr. |
NODE_ENV |
(não definido) | Em production, desativa logs [DEBUG] no stderr e mascara IPs nas mensagens de rate limit. |
Para deploy serverless no Cloudflare Workers, consulte docs/CONFIGURATION.md e os scripts npm run build:worker, npm run deploy e npm run deploy:staging.
structuredContent + fallback textual (lib/core/mcp-server.ts): toda chamada bem-sucedida devolve o JSON serializado em content[0].text. Quando o cliente negocia extensions["io.modelcontextprotocol/ui"] com text/html;profile=mcp-app, o servidor acrescenta structuredContent: { items, source } no IBGE, { ...result.data, provenance: result.source } em Querido Diário/BACEN/PNCP, e { profile } (via readCnpjProfile) no CNPJ.stdio (lib/core/tools.ts): stdout é reservado exclusivamente a mensagens JSON-RPC; logs de inicialização, depuração e métricas periódicas (a cada 100 requisições) são gravados em stderr. O teste test/integration/transports.mjs valida 101 chamadas consecutivas sem erro de enquadramento.lib/core/http-client.ts): backoff exponencial (1s, 2s, 4s) para erros transitórios (429, 500, 502, 503, 504 e falhas de rede), circuit breaker global, deduplicação de requisições em andamento (janela de 30s em cnpj_lookup/cep_lookup) e tratamento explícito de HTTP 204 como página vazia no modo filtrado do PNCP.scripts/build-apps.mjs): esbuild gera bundles IIFE minificados e embute CSS/JS nos templates HTML verificando marcadores obrigatórios e bloqueando </script ou </style no conteúdo inline.Esta seção existe para evitar expectativas erradas antes da adoção.
fetchedAt registra quando o servidor consultou o provedor; updatedAt só aparece quando o próprio provedor devolve essa informação.cpf_validate roda 100% localmente, validando apenas o dígito verificador (mod-11) e a região fiscal do 9º dígito — não confirma existência nem titularidade.lib/config/index.ts são recusadas na inicialização para mitigar SSRF.ui://dadosbr/*.html rodam no servidor Node.js (stdio e HTTP/SSE); o Worker serve o retorno textual JSON, REST e OAuth.O MCP DadosBR é um projeto da Orqo e um caso público de desenvolvimento governado pelo Codebase OPS by Orqo. Em vez de deixar decisões perdidas em conversas de chat, o repositório guarda o rastro verificável em .archagents/: pedido → design → execução → verificação independente.
Exemplos auditáveis no histórico deste repositório:
.archagents/ e configuração do CI.TCK-0005, DES-0005, run de execução e parecer independente.v0.5.0 e correção TCK-0007: durante a verificação independente da documentação (VER-20261118-030814-tck-0006), uma sequência de 101 chamadas stdio detectou uma linha de métricas vazando em stdout e quebrando o JSON-RPC — o defeito virou o ticket TCK-0007, foi corrigido com teste de regressão e só então a v0.5.0 foi liberada com gate de CI por SHA exato.Conheça mais sobre a camada de governança em orqo.pro.
Preciso de chaves de API para começar?
Não. Os cinco MCP Apps (ibge_localidades, querido_diario, bacen_taxas, pncp_licitacoes, cnpj_lookup), além de cep_lookup, cpf_validate, fipe_veiculos, domain_whois, cnes_saude, consumidor_reclamacoes, procurados_lookup, lista_suja_lookup, strategic_osint_prompt e sequentialthinking, funcionam sem nenhuma credencial. Chaves opcionais ampliam o alcance para Portal da Transparência, DataJud e busca web.
O que acontece se o meu cliente MCP não suportar MCP Apps?
Todas as 23 ferramentas continuam funcionando normalmente com retorno JSON estruturado em texto. O structuredContent e os recursos ui:// só são ativados quando o cliente anuncia suporte a io.modelcontextprotocol/ui.
Posso trocar o provedor de CNPJ ou CEP?
Sim, via CNPJ_API_BASE_URL / CEP_API_BASE_URL ou .mcprc.json, desde que o host esteja na allowlist HTTPS de lib/config/index.ts.
Como o projeto garante que logs não corrompem o transporte stdio?
Todo log de inicialização, depuração e métricas vai para stderr (console.error), e npm run test:transport executa 101 chamadas stdio validando ausência total de erros de protocolo.
Por que a licença mudou de MIT para GNU AGPL-3.0? Porque o MCP DadosBR é um servidor público mantido pela Orqo voltado a infraestrutura de dados abertos. A GNU AGPL-3.0 garante que quem rodar versões modificadas do servidor pela rede (como serviço SaaS, API interna exposta a terceiros ou Worker customizado) também compartilhe as melhorias com a comunidade.
Este projeto é distribuído sob a GNU Affero General Public License v3.0 (AGPL-3.0-only) — consulte o texto oficial completo em LICENSE e as atribuições de terceiros em NOTICE.md.
Em resumo prático (não substitui o texto jurídico da licença):
0.5.0 permaneceram sob a licença MIT; a partir da versão 0.6.0, o pacote é distribuído sob AGPL-3.0-only.Depois de instalar e compilar (npm ci && npm run build), execute a verificação completa:
npm test # Suíte unitária (Vitest)
npm run test:transport # Handshake, 23 ferramentas, 5 MCP Apps e 101 chamadas stdio + HTTP/SSE
npm run build:worker # Validação de build do Cloudflare Worker
docs/README.md) · Documentação PT-BR (docs/pt-br/README.md)docs/CONFIGURATION.md) · Integração com clientes MCP (docs/MCP_CLIENT_INTEGRATION.md)docs/USAGE_EXAMPLES.md) · Governança do projeto (.archagents/README.md)Leia o guia de contribuição ou abra uma issue.
O MCP DadosBR realiza consultas sob demanda a fontes públicas brasileiras e não mantém banco de dados permanente próprio (utilizando apenas cache efêmero opcional em memória ou Cloudflare KV com TTL). Consulte a Política de Privacidade e Transparência LGPD (PRIVACY.md) para detalhes sobre bases legais (LGPD Art. 6º e Art. 7º), direitos do titular (Art. 18), uso de provedores externos (Tavily, Perplexity e Cloudflare Workers) e salvaguardas contra homônimos com revisão humana obrigatória em ferramentas jurídicas e sancionatórias (Art. 20).
MCP_DPO_CONTACT (exposta em GET / no Cloudflare Worker em privacy.dpo_contact). Para contato com os mantenedores do projeto open source, consulte PRIVACY.md.by Orqo — Brazilian public data in AI conversations, with source, provenance, and explicit boundaries.MCP DadosBR is an open-source Model Context Protocol (MCP) server maintained by Orqo that connects AI assistants to 23 Brazilian public-data tools and 5 interactive MCP Apps (ui://dadosbr/*.html).
ibge_localidades), Querido Diário municipal gazettes (querido_diario), Central Bank SGS indicators (bacen_taxas — Selic, IPCA, USD, EUR, CDI over 30/90/365-day windows), PNCP public procurement notices (pncp_licitacoes), and Company Registration Profiles (cnpj_lookup).stdio or HTTP/SSE, with all 5 interactive MCP Apps and strict JSON-RPC stdout isolation) and Cloudflare Worker (serverless edge runtime with text JSON, REST, and OAuth).{
"mcpServers": {
"dadosbr": {
"command": "npx",
"args": ["-y", "@aredes.me/mcp-dadosbr"]
}
}
}
Version 0.5.0 on npm bundles all five MCP Apps. To build from source, run npm ci && npm run build and point args to build/lib/adapters/cli.js.updatedAt timestamps, does not query federal tax databases for cpf_validate (local mod-11 check only), never bypasses CAPTCHAs, rejects non-allowlisted CNPJ/CEP hosts (SSRF protection), and serves interactive HTML apps only on the Node.js runtime (the Cloudflare Worker returns JSON text)..archagents/.0.5.0 were distributed under MIT, and AGPL-3.0-only applies starting with 0.6.0). Third-party acknowledgments live in NOTICE.md.MCP DadosBR é um projeto open source Orqo, iniciado por Cristiano Arêdes.
Please log in to share your review and rating for this MCP.
Explore related MCPs that share similar capabilities and solve comparable challenges
by exa-labs
Provides real-time web search capabilities to AI assistants via a Model Context Protocol server, enabling safe and controlled access to the Exa AI Search API.
by perplexityai
Enables Claude and other MCP‑compatible applications to perform real‑time web searches through the Perplexity (Sonar) API without leaving the MCP ecosystem.
by Aas-ee
Provides multi-engine web search and article/content retrieval through an MCP server, command‑line interface, and a reusable local daemon, all without requiring API keys or authentication.
by MicrosoftDocs
Provides semantic search and fetch capabilities for Microsoft official documentation, returning content in markdown format via a lightweight streamable HTTP transport for AI agents and development tools.
by elastic
Enables natural‑language interaction with Elasticsearch indices via the Model Context Protocol, exposing tools for listing indices, fetching mappings, performing searches, running ES|QL queries, and retrieving shard information.
by graphlit
Enables integration between MCP clients and the Graphlit platform, providing ingestion, extraction, retrieval, and RAG capabilities across a wide range of data sources and connectors.
by ihor-sokoliuk
Provides web search capabilities via the SearXNG API, exposing them through an MCP server for seamless integration with AI agents and tools.
by mamertofabian
Fast cross‑platform file searching leveraging the Everything SDK on Windows, Spotlight on macOS, and locate/plocate on Linux.
by spences10
Provides unified access to multiple search engines, AI response tools, and content processing services through a single Model Context Protocol server.
{
"mcpServers": {
"dadosbr": {
"command": "npx",
"args": [
"-y",
"@aredes.me/mcp-dadosbr"
],
"env": {
"TRANSPARENCIA_API_KEY": "<YOUR_TRANSPARENCIA_API_KEY>",
"DATAJUD_API_KEY": "<YOUR_DATAJUD_API_KEY>",
"TAVILY_API_KEY": "<YOUR_TAVILY_API_KEY>",
"PERPLEXITY_API_KEY": "<YOUR_PERPLEXITY_API_KEY>",
"CNPJ_API_BASE_URL": "<YOUR_CNPJ_API_BASE_URL>",
"CEP_API_BASE_URL": "<YOUR_CEP_API_BASE_URL>",
"MCP_API_KEY": "<YOUR_MCP_API_KEY>"
}
}
}
}claude mcp add dadosbr npx -y @aredes.me/mcp-dadosbr