Summary
This server gives Claude direct access to Brazilian public data through 23 OSINT tools. Query company records via CNPJ, validate addresses with CEP lookup, search court proceedings through DataJud, check government contracts on Portal da Transparência, pull financial indicators from Banco Central (SELIC, IPCA, exchange rates), and verify healthcare facilities in CNES. It includes compliance checks like the lista suja (slave labor registry), CEIS sanctions, arrest warrants, and OAB lawyer verification. The strategic intelligence tools use Tavily for web searches with Google Dorks and offer due diligence templates. Most tools work without API keys, though you'll need credentials for Tavily, DataJud, and Transparência to unlock the full toolkit. Built for Portuguese-speaking compliance, legal research, and investigative workflows.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
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
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 · 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
| 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 · cristiano@aredes.me
Links
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →