@aredes.me/mcp-dadosbr

v0.4.1

Published

2 months ago

Model Context Protocol server for Brazilian public data lookup (CNPJ companies and CEP postal codes) with intelligent web search and sequential thinking

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 | 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 · [email protected] |

🌐 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 · [email protected]