cristianoaredes-mcp-dadosbr

MCP DadosBR — Brazilian Data MCP Server for Claude, Cursor & AI Assistants

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.

Português | English

Português

O que é isso?

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.

Instalação rápida

npx @aredes.me/mcp-dadosbr

Configuração (qualquer cliente MCP)

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

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 e Transparência

Jurídico e Compliance

Empresas e Pessoas

Financeiro

Saúde

Inteligência Estratégica

Exemplos de uso

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áveis de ambiente

Todas as ferramentas sem "API Key" na tabela funcionam sem nenhuma chave.

Requisitos

• Node.js 18+
• Chaves de API opcionais conforme tabela acima

Desenvolvimento e contribuição

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

Licença

MIT — 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]

English

What is this?

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.

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

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 OSINT Tools

Requirements

• Node.js 18+
• Optional API keys depending on which tools you need (see table below)

Environment Variables

All tools without an API key in the table above work with zero configuration.

Example prompts

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.

Stats

• 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

Architecture overview

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

Contributing

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

License

MIT — 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]

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