The most complete Brazilian OSINT toolkit as a Model Context Protocol (MCP) server. Query CNPJ, CEP, court records, government contracts, financial indicators, and more — directly from Claude Desktop, Cursor, Windsurf, Claude Code, or any MCP-compatible AI assistant.
MCP DadosBR é um servidor MCP que conecta assistentes de IA a dados públicos brasileiros. Com ele, Claude, Cursor, Windsurf e outros assistentes podem consultar CNPJs, endereços por CEP, processos judiciais, contratos governamentais, indicadores financeiros do Banco Central e muito mais — sem sair da conversa.
São 23 ferramentas OSINT organizadas em 6 domÃnios: governo, jurÃdico, empresas, financeiro, saúde e inteligência estratégica.
npx @aredes.me/mcp-dadosbrAdicione ao arquivo de configuração do seu cliente MCP:
{
"mcpServers": {
"dadosbr": {
"command": "npx",
"args": ["@aredes.me/mcp-dadosbr"],
"env": {
"TAVILY_API_KEY": "tvly-your-key",
"PERPLEXITY_API_KEY": "pplx-your-key",
"TRANSPARENCIA_API_KEY": "your-key",
"DATAJUD_API_KEY": "your-key"
}
}
}
}Localização do arquivo de configuração por cliente
| Cliente | Localização |
|---|---|
| Claude Desktop | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Cursor | .cursor/mcp.json no projeto |
| Windsurf | ~/.windsurf/config.json |
| Continue.dev | ~/.continue/config.json |
| Gemini CLI | ~/.config/gemini/mcp_config.json |
| Zed | ~/.config/zed/settings.json (campo context_servers) |
| Cline / Roo Cline | VS Code Settings → Extensions → Cline → MCP Servers |
Claude Code CLI:
claude mcp add --transport stdio dadosbr \
--env TAVILY_API_KEY=tvly-xxx \
--env TRANSPARENCIA_API_KEY=xxx \
--env DATAJUD_API_KEY=xxx \
-- npx -y @aredes.me/mcp-dadosbr| Ferramenta | O que faz | API Key |
|---|---|---|
ibge_localidades |
Estados, municÃpios e regiões do IBGE | — |
transparencia_lookup |
Contratos, convênios e licitações federais | TRANSPARENCIA_API_KEY |
ceis_cnep_lookup |
Empresas sancionadas (CEIS/CNEP) | TRANSPARENCIA_API_KEY |
pncp_licitacoes |
Portal Nacional de Contratações Públicas | — |
querido_diario |
Diários oficiais municipais (Open Knowledge) | — |
| Ferramenta | O que faz | API Key |
|---|---|---|
datajud_processos |
Processos judiciais em todos os tribunais brasileiros | DATAJUD_API_KEY |
oab_advogado |
Consulta de advogados no CNA/OAB | — |
bnmp_mandados |
Mandados de prisão (BNMP/CNJ) | — |
procurados_lookup |
Pessoas procuradas (MJSP/Interpol) | — |
lista_suja_lookup |
Lista suja do trabalho escravo (MTE) | — |
| Ferramenta | O que faz | API Key |
|---|---|---|
cnpj_lookup |
Dados cadastrais completos por CNPJ | — |
cep_lookup |
Endereço completo por CEP | — |
cpf_validate |
Validação matemática de CPF | — |
domain_whois |
WHOIS de domÃnios .br (Registro.br) | — |
consumidor_reclamacoes |
Reclamações no Consumidor.gov.br | — |
company_deep_profile |
Perfil completo orquestrado com 6 fontes | Múltiplas |
| Ferramenta | O que faz | API Key |
|---|---|---|
bacen_taxas |
SELIC, IPCA, Dólar, Euro, CDI (Banco Central) | — |
fipe_veiculos |
Tabela FIPE de veÃculos | — |
| Ferramenta | O que faz | API Key |
|---|---|---|
cnes_saude |
Estabelecimentos de saúde (CNES/DataSUS) | — |
| Ferramenta | O que faz | API Key |
|---|---|---|
cnpj_search |
Busca web com Google Dorks via Tavily | TAVILY_API_KEY |
cnpj_intelligence |
Busca inteligente multi-categoria | TAVILY_API_KEY |
strategic_osint_prompt |
Templates de análise (due diligence, fraude, ESG) | — |
sequentialthinking |
RaciocÃnio estruturado passo a passo | — |
Due Diligence completa de empresa:
Faça uma investigação completa do CNPJ 00.000.000/0001-91:
1. Use cnpj_lookup para dados cadastrais
2. Use transparencia_lookup para contratos governamentais
3. Use datajud_processos para processos judiciais
4. Use lista_suja_lookup para verificar trabalho escravo
5. Use company_deep_profile para o perfil consolidado
Detecção de fraude:
Use strategic_osint_prompt com template "fraud_detection" para o CNPJ 11.222.333/0001-81.
Execute cada ferramenta indicada no prompt gerado.
Consulta financeira:
Quais são as taxas atuais do Banco Central?
Use bacen_taxas para SELIC, IPCA e câmbio do Dólar.
Pesquisa jurÃdica:
Use datajud_processos para buscar processos contra "Empresa XYZ" no TJSP.
Depois use oab_advogado para verificar "João Silva" na OAB/SP.
Inteligência territorial:
Use ibge_localidades para listar municÃpios de MG,
depois use cnes_saude para encontrar hospitais em Belo Horizonte.
| Variável | Necessária para | Como obter |
|---|---|---|
TAVILY_API_KEY |
Ferramentas de busca web | tavily.com |
PERPLEXITY_API_KEY |
Busca alternativa (se Tavily não configurado) | perplexity.ai |
TRANSPARENCIA_API_KEY |
Dados de transparência federal | portaldatransparencia.gov.br/api-de-dados |
DATAJUD_API_KEY |
Processos judiciais | datajud-wiki.cnj.jus.br |
MCP_TRANSPORT |
— | stdio (padrão) ou http |
MCP_HTTP_PORT |
— | Porta HTTP (padrão: 3000) |
Todas as ferramentas sem "API Key" na tabela funcionam sem nenhuma chave.
- Node.js 18+
- Chaves de API opcionais conforme tabela acima
git clone https://github.com/cristianoaredes/mcp-dadosbr.git
cd mcp-dadosbr
npm install
npm run build
npm testMIT — veja LICENSE.
Dados fornecidos por: OpenCNPJ, OpenCEP, IBGE, Portal da Transparência, CNJ Datajud, Banco Central, BrasilAPI, CNES/DataSUS
Feito por Cristiano Arêdes · LinkedIn · [email protected]
MCP DadosBR is a Model Context Protocol (MCP) server that gives AI assistants direct access to Brazilian public data. Connect Claude Desktop, Cursor, Windsurf, Claude Code, or any MCP-compatible client to query CNPJ company records, CEP postal addresses, court proceedings, government contracts, Central Bank financial rates, healthcare facilities, and more — all from within the conversation.
23 OSINT tools across 6 domains: government transparency, legal/compliance, companies, financial, health, and strategic intelligence.
npx @aredes.me/mcp-dadosbr{
"mcpServers": {
"dadosbr": {
"command": "npx",
"args": ["@aredes.me/mcp-dadosbr"],
"env": {
"TAVILY_API_KEY": "tvly-your-key",
"PERPLEXITY_API_KEY": "pplx-your-key",
"TRANSPARENCIA_API_KEY": "your-key",
"DATAJUD_API_KEY": "your-key"
}
}
}
}Config file location by client
| Client | Location |
|---|---|
| Claude Desktop | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Cursor | .cursor/mcp.json in the project |
| Windsurf | ~/.windsurf/config.json |
| Continue.dev | ~/.continue/config.json |
| Gemini CLI | ~/.config/gemini/mcp_config.json |
| Zed | ~/.config/zed/settings.json (context_servers field) |
| Cline / Roo Cline | VS Code Settings → Extensions → Cline → MCP Servers |
Claude Code CLI:
claude mcp add --transport stdio dadosbr \
--env TAVILY_API_KEY=tvly-xxx \
--env TRANSPARENCIA_API_KEY=xxx \
--env DATAJUD_API_KEY=xxx \
-- npx -y @aredes.me/mcp-dadosbr| Domain | Tools | Description |
|---|---|---|
| Government | ibge_localidades · transparencia_lookup · ceis_cnep_lookup · pncp_licitacoes · querido_diario |
IBGE geography, federal contracts, sanctioned companies, public procurement, municipal gazettes |
| Legal | datajud_processos · oab_advogado · bnmp_mandados · procurados_lookup · lista_suja_lookup |
Court proceedings across all Brazilian courts, lawyer verification, arrest warrants, wanted persons, slave labor blacklist |
| Company | cnpj_lookup · cep_lookup · cpf_validate · domain_whois · consumidor_reclamacoes · company_deep_profile |
Company registration, address lookup, CPF validation, .br domain WHOIS, consumer complaints, 6-source deep profile |
| Financial | bacen_taxas · fipe_veiculos |
Brazilian Central Bank rates (SELIC, IPCA, USD, EUR, CDI), FIPE vehicle pricing table |
| Health | cnes_saude |
Healthcare facility search via CNES/DataSUS |
| Intelligence | cnpj_search · cnpj_intelligence · strategic_osint_prompt · sequentialthinking |
Web search with Google Dorks, multi-source intelligence, strategic analysis templates (due diligence, fraud, ESG), structured reasoning |
- Node.js 18+
- Optional API keys depending on which tools you need (see table below)
| Variable | Required for | How to get |
|---|---|---|
TAVILY_API_KEY |
Web search tools (cnpj_search, cnpj_intelligence) |
tavily.com |
PERPLEXITY_API_KEY |
Alternative search (used if Tavily not set) | perplexity.ai |
TRANSPARENCIA_API_KEY |
Government transparency data | Portal da Transparência API |
DATAJUD_API_KEY |
Court proceedings | Datajud Wiki |
All tools without an API key in the table above work with zero configuration.
Full company due diligence:
Run a full due diligence on CNPJ 00.000.000/0001-91:
cnpj_lookup → transparencia_lookup → datajud_processos → lista_suja_lookup → company_deep_profile
Fraud detection:
Use strategic_osint_prompt with template "fraud_detection" for CNPJ 11.222.333/0001-81.
Then run each tool indicated in the generated prompt.
Brazilian Central Bank rates:
What are the current Brazilian Central Bank rates?
Use bacen_taxas for SELIC, IPCA, and USD exchange rate.
Legal research:
Search for lawsuits against "Company XYZ" using datajud_processos in TJSP.
Then verify lawyer "João Silva" with oab_advogado in OAB/SP.
- 23 tools · 257 tests (100% passing) · 64 Google Dork templates · 10 OSINT categories
- TypeScript strict mode · Node.js 18+ · Vitest · Express 5
- Circuit breaker, LRU cache, request deduplication built-in
lib/
├── adapters/ # CLI, Cloudflare Workers, Smithery
├── config/ # Configuration and timeouts
├── core/ # Registry, search, intelligence, dork-templates
├── infrastructure/ # Cache, circuit breaker, rate limiting
├── tools/ # Domain-organized tools
│ ├── core.ts # CNPJ, CEP, search, intelligence, thinking
│ ├── government.ts # IBGE, Transparência, CEIS/CNEP, PNCP, Querido Diário
│ ├── legal.ts # Datajud, OAB, BNMP, Procurados, Lista Suja
│ ├── company.ts # CPF, WHOIS, Consumidor, Deep Profile
│ ├── financial.ts # Banco Central, FIPE
│ ├── health.ts # CNES/DataSUS
│ └── osint.ts # Strategic prompts
└── types/ # TypeScript type definitions
git clone https://github.com/cristianoaredes/mcp-dadosbr.git
cd mcp-dadosbr
npm install
npm run build
npm testMIT — see LICENSE.
Data sources: OpenCNPJ, OpenCEP, IBGE, Portal da Transparência, CNJ Datajud, Banco Central do Brasil, BrasilAPI, CNES/DataSUS
Built by Cristiano Arêdes · LinkedIn · [email protected]