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"
}
}
}
}
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
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 · cristiano@aredes.me
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