{
  "markdown": "# MCP DadosBR — Brazilian Data MCP Server for Claude, Cursor & AI Assistants\n\n[![smithery badge](https://smithery.ai/badge/@cristianoaredes/mcp-dadosbr)](https://smithery.ai/server/@cristianoaredes/mcp-dadosbr)\n[![npm version](https://badge.fury.io/js/@aredes.me%2Fmcp-dadosbr.svg)](https://www.npmjs.com/package/@aredes.me/mcp-dadosbr)\n[![npm downloads](https://img.shields.io/npm/dm/@aredes.me/mcp-dadosbr.svg)](https://www.npmjs.com/package/@aredes.me/mcp-dadosbr)\n[![TypeScript](https://img.shields.io/badge/TypeScript-007ACC?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n**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.\n\n_[Português](#português) | [English](#english)_\n\n---\n\n## Português\n\n### O que é isso?\n\nMCP 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.\n\nSão **23 ferramentas OSINT** organizadas em 6 domínios: governo, jurídico, empresas, financeiro, saúde e inteligência estratégica.\n\n### Instalação rápida\n\n```bash\nnpx @aredes.me/mcp-dadosbr\n```\n\n### Configuração (qualquer cliente MCP)\n\nAdicione ao arquivo de configuração do seu cliente MCP:\n\n```json\n{\n  \"mcpServers\": {\n    \"dadosbr\": {\n      \"command\": \"npx\",\n      \"args\": [\"@aredes.me/mcp-dadosbr\"],\n      \"env\": {\n        \"TAVILY_API_KEY\": \"tvly-your-key\",\n        \"PERPLEXITY_API_KEY\": \"pplx-your-key\",\n        \"TRANSPARENCIA_API_KEY\": \"your-key\",\n        \"DATAJUD_API_KEY\": \"your-key\"\n      }\n    }\n  }\n}\n```\n\n<details>\n<summary>Localização do arquivo de configuração por cliente</summary>\n\n| Cliente | Localização |\n|---|---|\n| Claude Desktop | `~/Library/Application Support/Claude/claude_desktop_config.json` |\n| Cursor | `.cursor/mcp.json` no projeto |\n| Windsurf | `~/.windsurf/config.json` |\n| Continue.dev | `~/.continue/config.json` |\n| Gemini CLI | `~/.config/gemini/mcp_config.json` |\n| Zed | `~/.config/zed/settings.json` (campo `context_servers`) |\n| Cline / Roo Cline | VS Code Settings → Extensions → Cline → MCP Servers |\n\n**Claude Code CLI:**\n```bash\nclaude mcp add --transport stdio dadosbr \\\n  --env TAVILY_API_KEY=tvly-xxx \\\n  --env TRANSPARENCIA_API_KEY=xxx \\\n  --env DATAJUD_API_KEY=xxx \\\n  -- npx -y @aredes.me/mcp-dadosbr\n```\n</details>\n\n---\n\n### 23 Ferramentas OSINT\n\n#### Governo e Transparência\n\n| Ferramenta | O que faz | API Key |\n|---|---|---|\n| `ibge_localidades` | Estados, municípios e regiões do IBGE | — |\n| `transparencia_lookup` | Contratos, convênios e licitações federais | `TRANSPARENCIA_API_KEY` |\n| `ceis_cnep_lookup` | Empresas sancionadas (CEIS/CNEP) | `TRANSPARENCIA_API_KEY` |\n| `pncp_licitacoes` | Portal Nacional de Contratações Públicas | — |\n| `querido_diario` | Diários oficiais municipais (Open Knowledge) | — |\n\n#### Jurídico e Compliance\n\n| Ferramenta | O que faz | API Key |\n|---|---|---|\n| `datajud_processos` | Processos judiciais em todos os tribunais brasileiros | `DATAJUD_API_KEY` |\n| `oab_advogado` | Consulta de advogados no CNA/OAB | — |\n| `bnmp_mandados` | Mandados de prisão (BNMP/CNJ) | — |\n| `procurados_lookup` | Pessoas procuradas (MJSP/Interpol) | — |\n| `lista_suja_lookup` | Lista suja do trabalho escravo (MTE) | — |\n\n#### Empresas e Pessoas\n\n| Ferramenta | O que faz | API Key |\n|---|---|---|\n| `cnpj_lookup` | Dados cadastrais completos por CNPJ | — |\n| `cep_lookup` | Endereço completo por CEP | — |\n| `cpf_validate` | Validação matemática de CPF | — |\n| `domain_whois` | WHOIS de domínios .br (Registro.br) | — |\n| `consumidor_reclamacoes` | Reclamações no Consumidor.gov.br | — |\n| `company_deep_profile` | Perfil completo orquestrado com 6 fontes | Múltiplas |\n\n#### Financeiro\n\n| Ferramenta | O que faz | API Key |\n|---|---|---|\n| `bacen_taxas` | SELIC, IPCA, Dólar, Euro, CDI (Banco Central) | — |\n| `fipe_veiculos` | Tabela FIPE de veículos | — |\n\n#### Saúde\n\n| Ferramenta | O que faz | API Key |\n|---|---|---|\n| `cnes_saude` | Estabelecimentos de saúde (CNES/DataSUS) | — |\n\n#### Inteligência Estratégica\n\n| Ferramenta | O que faz | API Key |\n|---|---|---|\n| `cnpj_search` | Busca web com Google Dorks via Tavily | `TAVILY_API_KEY` |\n| `cnpj_intelligence` | Busca inteligente multi-categoria | `TAVILY_API_KEY` |\n| `strategic_osint_prompt` | Templates de análise (due diligence, fraude, ESG) | — |\n| `sequentialthinking` | Raciocínio estruturado passo a passo | — |\n\n---\n\n### Exemplos de uso\n\n**Due Diligence completa de empresa:**\n```\nFaça uma investigação completa do CNPJ 00.000.000/0001-91:\n1. Use cnpj_lookup para dados cadastrais\n2. Use transparencia_lookup para contratos governamentais\n3. Use datajud_processos para processos judiciais\n4. Use lista_suja_lookup para verificar trabalho escravo\n5. Use company_deep_profile para o perfil consolidado\n```\n\n**Detecção de fraude:**\n```\nUse strategic_osint_prompt com template \"fraud_detection\" para o CNPJ 11.222.333/0001-81.\nExecute cada ferramenta indicada no prompt gerado.\n```\n\n**Consulta financeira:**\n```\nQuais são as taxas atuais do Banco Central?\nUse bacen_taxas para SELIC, IPCA e câmbio do Dólar.\n```\n\n**Pesquisa jurídica:**\n```\nUse datajud_processos para buscar processos contra \"Empresa XYZ\" no TJSP.\nDepois use oab_advogado para verificar \"João Silva\" na OAB/SP.\n```\n\n**Inteligência territorial:**\n```\nUse ibge_localidades para listar municípios de MG,\ndepois use cnes_saude para encontrar hospitais em Belo Horizonte.\n```\n\n---\n\n### Variáveis de ambiente\n\n| Variável | Necessária para | Como obter |\n|---|---|---|\n| `TAVILY_API_KEY` | Ferramentas de busca web | [tavily.com](https://tavily.com) |\n| `PERPLEXITY_API_KEY` | Busca alternativa (se Tavily não configurado) | [perplexity.ai](https://docs.perplexity.ai/) |\n| `TRANSPARENCIA_API_KEY` | Dados de transparência federal | [portaldatransparencia.gov.br/api-de-dados](http://portaldatransparencia.gov.br/api-de-dados) |\n| `DATAJUD_API_KEY` | Processos judiciais | [datajud-wiki.cnj.jus.br](https://datajud-wiki.cnj.jus.br/) |\n| `MCP_TRANSPORT` | — | `stdio` (padrão) ou `http` |\n| `MCP_HTTP_PORT` | — | Porta HTTP (padrão: `3000`) |\n\nTodas as ferramentas sem \"API Key\" na tabela funcionam sem nenhuma chave.\n\n---\n\n### Requisitos\n\n- **Node.js 18+**\n- Chaves de API opcionais conforme tabela acima\n\n---\n\n### Desenvolvimento e contribuição\n\n```bash\ngit clone https://github.com/cristianoaredes/mcp-dadosbr.git\ncd mcp-dadosbr\nnpm install\nnpm run build\nnpm test\n```\n\n---\n\n### Licença\n\nMIT — veja [LICENSE](LICENSE).\n\nDados fornecidos por: [OpenCNPJ](https://opencnpj.org/), [OpenCEP](https://opencep.com/), [IBGE](https://servicodados.ibge.gov.br/), [Portal da Transparência](https://portaldatransparencia.gov.br/), [CNJ Datajud](https://datajud-wiki.cnj.jus.br/), [Banco Central](https://www.bcb.gov.br/), [BrasilAPI](https://brasilapi.com.br/), [CNES/DataSUS](https://cnes.datasus.gov.br/)\n\nFeito por [Cristiano Arêdes](https://github.com/cristianoaredes) · [LinkedIn](https://www.linkedin.com/in/cristianoaredes/) · cristiano@aredes.me\n\n---\n\n## English\n\n### What is this?\n\nMCP 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.\n\n**23 OSINT tools** across 6 domains: government transparency, legal/compliance, companies, financial, health, and strategic intelligence.\n\n### Quick install\n\n```bash\nnpx @aredes.me/mcp-dadosbr\n```\n\n### Configuration (any MCP client)\n\n```json\n{\n  \"mcpServers\": {\n    \"dadosbr\": {\n      \"command\": \"npx\",\n      \"args\": [\"@aredes.me/mcp-dadosbr\"],\n      \"env\": {\n        \"TAVILY_API_KEY\": \"tvly-your-key\",\n        \"PERPLEXITY_API_KEY\": \"pplx-your-key\",\n        \"TRANSPARENCIA_API_KEY\": \"your-key\",\n        \"DATAJUD_API_KEY\": \"your-key\"\n      }\n    }\n  }\n}\n```\n\n<details>\n<summary>Config file location by client</summary>\n\n| Client | Location |\n|---|---|\n| Claude Desktop | `~/Library/Application Support/Claude/claude_desktop_config.json` |\n| Cursor | `.cursor/mcp.json` in the project |\n| Windsurf | `~/.windsurf/config.json` |\n| Continue.dev | `~/.continue/config.json` |\n| Gemini CLI | `~/.config/gemini/mcp_config.json` |\n| Zed | `~/.config/zed/settings.json` (`context_servers` field) |\n| Cline / Roo Cline | VS Code Settings → Extensions → Cline → MCP Servers |\n\n**Claude Code CLI:**\n```bash\nclaude mcp add --transport stdio dadosbr \\\n  --env TAVILY_API_KEY=tvly-xxx \\\n  --env TRANSPARENCIA_API_KEY=xxx \\\n  --env DATAJUD_API_KEY=xxx \\\n  -- npx -y @aredes.me/mcp-dadosbr\n```\n</details>\n\n---\n\n### 23 OSINT Tools\n\n| Domain | Tools | Description |\n|---|---|---|\n| Government | `ibge_localidades` · `transparencia_lookup` · `ceis_cnep_lookup` · `pncp_licitacoes` · `querido_diario` | IBGE geography, federal contracts, sanctioned companies, public procurement, municipal gazettes |\n| 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 |\n| 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 |\n| Financial | `bacen_taxas` · `fipe_veiculos` | Brazilian Central Bank rates (SELIC, IPCA, USD, EUR, CDI), FIPE vehicle pricing table |\n| Health | `cnes_saude` | Healthcare facility search via CNES/DataSUS |\n| 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 |\n\n---\n\n### Requirements\n\n- **Node.js 18+**\n- Optional API keys depending on which tools you need (see table below)\n\n### Environment Variables\n\n| Variable | Required for | How to get |\n|---|---|---|\n| `TAVILY_API_KEY` | Web search tools (`cnpj_search`, `cnpj_intelligence`) | [tavily.com](https://tavily.com) |\n| `PERPLEXITY_API_KEY` | Alternative search (used if Tavily not set) | [perplexity.ai](https://docs.perplexity.ai/) |\n| `TRANSPARENCIA_API_KEY` | Government transparency data | [Portal da Transparência API](http://portaldatransparencia.gov.br/api-de-dados) |\n| `DATAJUD_API_KEY` | Court proceedings | [Datajud Wiki](https://datajud-wiki.cnj.jus.br/) |\n\nAll tools without an API key in the table above work with zero configuration.\n\n---\n\n### Example prompts\n\n**Full company due diligence:**\n```\nRun a full due diligence on CNPJ 00.000.000/0001-91:\ncnpj_lookup → transparencia_lookup → datajud_processos → lista_suja_lookup → company_deep_profile\n```\n\n**Fraud detection:**\n```\nUse strategic_osint_prompt with template \"fraud_detection\" for CNPJ 11.222.333/0001-81.\nThen run each tool indicated in the generated prompt.\n```\n\n**Brazilian Central Bank rates:**\n```\nWhat are the current Brazilian Central Bank rates?\nUse bacen_taxas for SELIC, IPCA, and USD exchange rate.\n```\n\n**Legal research:**\n```\nSearch for lawsuits against \"Company XYZ\" using datajud_processos in TJSP.\nThen verify lawyer \"João Silva\" with oab_advogado in OAB/SP.\n```\n\n---\n\n### Stats\n\n- **23 tools** · **257 tests** (100% passing) · **64 Google Dork templates** · **10 OSINT categories**\n- TypeScript strict mode · Node.js 18+ · Vitest · Express 5\n- Circuit breaker, LRU cache, request deduplication built-in\n\n### Architecture overview\n\n```\nlib/\n├── adapters/          # CLI, Cloudflare Workers, Smithery\n├── config/            # Configuration and timeouts\n├── core/              # Registry, search, intelligence, dork-templates\n├── infrastructure/    # Cache, circuit breaker, rate limiting\n├── tools/             # Domain-organized tools\n│   ├── core.ts        #   CNPJ, CEP, search, intelligence, thinking\n│   ├── government.ts  #   IBGE, Transparência, CEIS/CNEP, PNCP, Querido Diário\n│   ├── legal.ts       #   Datajud, OAB, BNMP, Procurados, Lista Suja\n│   ├── company.ts     #   CPF, WHOIS, Consumidor, Deep Profile\n│   ├── financial.ts   #   Banco Central, FIPE\n│   ├── health.ts      #   CNES/DataSUS\n│   └── osint.ts       #   Strategic prompts\n└── types/             # TypeScript type definitions\n```\n\n---\n\n### Contributing\n\n```bash\ngit clone https://github.com/cristianoaredes/mcp-dadosbr.git\ncd mcp-dadosbr\nnpm install\nnpm run build\nnpm test\n```\n\n### License\n\nMIT — see [LICENSE](LICENSE).\n\nData sources: [OpenCNPJ](https://opencnpj.org/), [OpenCEP](https://opencep.com/), [IBGE](https://servicodados.ibge.gov.br/), [Portal da Transparência](https://portaldatransparencia.gov.br/), [CNJ Datajud](https://datajud-wiki.cnj.jus.br/), [Banco Central do Brasil](https://www.bcb.gov.br/), [BrasilAPI](https://brasilapi.com.br/), [CNES/DataSUS](https://cnes.datasus.gov.br/)\n\nBuilt by [Cristiano Arêdes](https://github.com/cristianoaredes) · [LinkedIn](https://www.linkedin.com/in/cristianoaredes/) · cristiano@aredes.me\n\n---\n\n### Links\n\n- **npm**: https://www.npmjs.com/package/@aredes.me/mcp-dadosbr\n- **Smithery**: https://smithery.ai/server/@cristianoaredes/mcp-dadosbr\n- **GitHub**: https://github.com/cristianoaredes/mcp-dadosbr\n",
  "bytes": 13784,
  "sha": "c7e4f93fa8ee33f531ca3b33905bd7b6ef67af13ea390934f07023101c2cf179",
  "repo_slug": "cristianoaredes/mcp-dadosbr",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_ai_smithery_cristianoaredes_mcp_dadosbr_acf9b13e/readme"
}