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

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

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

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

MCP DadosBR