MCP DadosBR 🇧🇷

🕵️ The most complete Brazilian OSINT toolkit as an MCP server — 23 tools covering company data, government transparency, legal proceedings, financial indicators, healthcare, and strategic intelligence.

Works with Claude Desktop, Cursor, Windsurf, Gemini CLI, Claude Code, and any MCP-compatible AI assistant.

[Português](# português) | [English](# english)

# Português

# # ⚡ Instalação

npx @aredes.me/mcp-dadosbr

# # 🔌 Configuração (qualquer 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"
      }
    }
  }
}

| IDE / 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

# # 🛠️ 23 Ferramentas OSINT

# # # 🏛️ Governo & Transparência

| Ferramenta | Descrição | API Key |
|- --|- --|- --|
| ibge_localidades | Estados, municípios, regiões do IBGE | — |
| transparencia_lookup | Contratos, convênios, 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) | — |

# # # ⚖️ Jurídico & Compliance

| Ferramenta | Descrição | API Key |
|- --|- --|- --|
| datajud_processos | Processos judiciais em todos os tribunais | DATAJUD_API_KEY |
| oab_advogado | Consulta de advogados na OAB/CNA | — |
| bnmp_mandados | Mandados de prisão (BNMP/CNJ) | — |
| procurados_lookup | Pessoas procuradas (MJSP/Interpol) | — |
| lista_suja_lookup | Lista suja do trabalho escravo | — |

# # # 🏢 Empresas & Pessoas

| Ferramenta | Descrição | 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 (6 fontes) | Múltiplas |

# # # 💰 Financeiro

| Ferramenta | Descrição | API Key |
|- --|- --|- --|
| bacen_taxas | SELIC, IPCA, Dólar, Euro, CDI (Banco Central) | — |
| fipe_veiculos | Tabela FIPE de veículos | — |

# # # 🏥 Saúde

| Ferramenta | Descrição | API Key |
|- --|- --|- --|
| cnes_saude | Estabelecimentos de saúde (CNES/DataSUS) | — |

# # # 🧠 Intelligence

| Ferramenta | Descrição | 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 estratégica (due diligence, fraude, ESG) | — |
| sequentialthinking | Raciocínio estruturado passo a passo | — |

# # 🎯 Exemplos de Uso (Prompts)

Due Diligence Completa:

Faça uma investigação completa da empresa 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 perfil consolidado

Análise de Fraude:

Use strategic_osint_prompt com template "fraud_detection" para o CNPJ 11.222.333/0001-81.
Depois 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 Dólar.

Pesquisa Jurídica:

Use datajud_processos para buscar processos contra "Empresa XYZ" no TJSP.
Depois use oab_advogado para verificar o advogado "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áveis de Ambiente

| Variável | Obrigatória | Descrição |
|- --|- --|- --|
| TAVILY_API_KEY | Para buscas | tavily.com — habilita cnpj_search + cnpj_intelligence |
| PERPLEXITY_API_KEY | Alternativo | perplexity.ai — provider alternativo de busca (se Tavily não configurado) |
| TRANSPARENCIA_API_KEY | Para transparência | portaldatransparencia.gov.br |
| DATAJUD_API_KEY | Para processos | datajud.cnj.jus.br |
| MCP_TRANSPORT | — | stdio (padrão) ou http |
| MCP_HTTP_PORT | — | Porta HTTP (padrão: 3000) |

# # 🧬 Arquitetura

lib/
├── adapters/          #  CLI, Cloudflare Workers, Smithery
├── config/            #  Configuração e timeouts
├── core/              #  Registry, search, intelligence, dork-templates
│   └── registry.ts    #  Tool registry pattern (auto-registration)
├── 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, Q. 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
│   └── index.ts       #    Barrel (triggers auto-registration)
├── types/             #  TypeScript type definitions
└── workers/           #  Cloudflare Workers adapter

Padrões de Design:

• Tool Registry — Auto-registration, zero boilerplate para novas tools
• Circuit Breaker — Proteção contra falhas de API
• Result Pattern — Tratamento funcional de erros
• Google Dorks Engine — 64 templates em 10 categorias OSINT

# # 📊 Métricas

• 23 ferramentas OSINT registradas
• 257 testes unitários (100% passing)
• 64 dork templates em 10 categorias
• TypeScript estrito em todo o codebase
• Node.js 18+ · Vitest · Express 5

# # 🤝 Contribuição

git clone https://github.com/cristianoaredes/mcp-dadosbr.git
cd mcp-dadosbr
npm install
npm run build
npm test

# # 📄 Licença & Créditos

MIT License — LICENSE

Dados fornecidos por: OpenCNPJ, OpenCEP, IBGE API, Portal da Transparência, CNJ Datajud, Banco Central, BrasilAPI, CNES/DataSUS

# # 👨💻 Mantenedor

| Cristiano Aredes |
|- --|
| LinkedIn · cristiano@aredes.me |

# # 🌐 Links

• NPM: https://www.npmjs.com/package/@aredes.me/mcp-dadosbr
• Smithery: https://smithery.ai/server/@cristianoaredes/mcp-dadosbr
• GitHub: https://github.com/cristianoaredes/mcp-dadosbr

# English

🕵️ The most complete Brazilian OSINT toolkit as an MCP server — 23 tools covering company data, government transparency, legal proceedings, financial indicators, healthcare, and strategic intelligence.

# # ⚡ Quick Install

npx @aredes.me/mcp-dadosbr

# # 🔌 Configuration (any MCP client)

{
  "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"
      }
    }
  }
}

# # 🛠️ 23 OSINT Tools

| Domain | Tools | Description |
|- --|- --|- --|
| 🏛️ Government | ibge_localidades · transparencia_lookup · ceis_cnep_lookup · pncp_licitacoes · querido_diario | IBGE geography, federal contracts, sanctions, public procurement, municipal gazettes |
| ⚖️ Legal | datajud_processos · oab_advogado · bnmp_mandados · procurados_lookup · lista_suja_lookup | Court proceedings, 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, domain WHOIS, consumer complaints, deep profile |
| 💰 Financial | bacen_taxas · fipe_veiculos | Central Bank rates (SELIC, IPCA, USD, EUR, CDI), FIPE vehicle pricing |
| 🏥 Health | cnes_saude | Healthcare facility search (CNES/DataSUS) |
| 🧠 Intelligence | cnpj_search · cnpj_intelligence · strategic_osint_prompt · sequentialthinking | Web search with dorks, multi-source intelligence, strategic analysis templates, structured reasoning |

# # 🔑 Environment Variables

| Variable | Required for | How to get |
|- --|- --|- --|
| TAVILY_API_KEY | Web search tools | tavily.com |
| PERPLEXITY_API_KEY | Alternative search | perplexity.ai (used if Tavily not set) |
| TRANSPARENCIA_API_KEY | Government transparency | Portal da Transparência API |
| DATAJUD_API_KEY | Court proceedings | Datajud Wiki |

# # 🎯 Example Prompts

Run a full due diligence on CNPJ 00.000.000/0001-91:
cnpj_lookup → transparencia_lookup → datajud_processos → lista_suja_lookup → company_deep_profile

What are the current Brazilian Central Bank rates? Use bacen_taxas for SELIC, IPCA, and USD exchange.

Search for lawsuits against "Company XYZ" using datajud_processos in tribunal TJSP.
Then verify lawyer "João Silva" with oab_advogado in OAB/SP.

# # 📊 Stats

• 23 tools · 257 tests · 64 dork templates · 10 OSINT categories
• TypeScript strict mode · Node.js 18+ · Vitest · Express 5

# # 📄 License

MIT — LICENSE

Data sources: OpenCNPJ, OpenCEP, IBGE, Portal da Transparência, CNJ Datajud, Banco Central, BrasilAPI, CNES/DataSUS

# # 👨💻 Maintainer

Cristiano Aredes · LinkedIn · cristiano@aredes.me