Skip to content

cristianoaredes/mcp-dadosbr

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

97 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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

smithery badge npm version npm downloads TypeScript License: MIT

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

23 Ferramentas OSINT

Governo e Transparência

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) —

Jurídico e Compliance

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) —

Empresas e Pessoas

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

Financeiro

Ferramenta O que faz API Key
bacen_taxas SELIC, IPCA, Dólar, Euro, CDI (Banco Central) —
fipe_veiculos Tabela FIPE de veículos —

Saúde

Ferramenta O que faz API Key
cnes_saude Estabelecimentos de saúde (CNES/DataSUS) —

Inteligência Estratégica

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 —

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

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.


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

23 OSINT Tools

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

Requirements

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

Environment Variables

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.


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

About

🤖 Model Context Protocol (MCP) server for Brazilian public data lookup - Company (CNPJ) and postal code (CEP) information directly in Claude Desktop, Cursor, Windsurf, Continue.dev, and other AI assistants

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors