Skip to main content
Glama
cristianoaredes

MCP DadosBR

by cristianoaredes
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Hybrid

MCP DadosBR 🇧🇷

npm version npm downloads TypeScript License: MIT

🕵️ The most complete Brazilian OSINT toolkit as an MCP server — 23 tools covering company data, government transparency, legal proceedings, financial indicators, healthcare, and strategic intelligence.

Works with Claude Desktop, Cursor, Windsurf, Gemini CLI, Claude Code, and any MCP-compatible AI assistant.

Português

Português

⚡ Instalação

npx @aredes.me/mcp-dadosbr

🔌 Configuração (qualquer 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" } } } }

IDE / 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 & Transparência

Ferramenta

Descrição

API Key

ibge_localidades

Estados, municípios, regiões do IBGE

—

transparencia_lookup

Contratos, convênios, 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 & Compliance

Ferramenta

Descrição

API Key

datajud_processos

Processos judiciais em todos os tribunais

DATAJUD_API_KEY

oab_advogado

Consulta de advogados na OAB/CNA

—

bnmp_mandados

Mandados de prisão (BNMP/CNJ)

—

procurados_lookup

Pessoas procuradas (MJSP/Interpol)

—

lista_suja_lookup

Lista suja do trabalho escravo

—

🏢 Empresas & Pessoas

Ferramenta

Descrição

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 (6 fontes)

Múltiplas

💰 Financeiro

Ferramenta

Descrição

API Key

bacen_taxas

SELIC, IPCA, Dólar, Euro, CDI (Banco Central)

—

fipe_veiculos

Tabela FIPE de veículos

—

🏥 Saúde

Ferramenta

Descrição

API Key

cnes_saude

Estabelecimentos de saúde (CNES/DataSUS)

—

🧠 Intelligence

Ferramenta

Descrição

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 estratégica (due diligence, fraude, ESG)

—

sequentialthinking

Raciocínio estruturado passo a passo

—

🎯 Exemplos de Uso (Prompts)

Due Diligence Completa:

Faça uma investigação completa da empresa 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 perfil consolidado

Análise de Fraude:

Use strategic_osint_prompt com template "fraud_detection" para o CNPJ 11.222.333/0001-81. Depois 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 Dólar.

Pesquisa Jurídica:

Use datajud_processos para buscar processos contra "Empresa XYZ" no TJSP. Depois use oab_advogado para verificar o advogado "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

Obrigatória

Descrição

TAVILY_API_KEY

Para buscas

tavily.com — habilita cnpj_search + cnpj_intelligence

PERPLEXITY_API_KEY

Alternativo

perplexity.ai — provider alternativo de busca (se Tavily não configurado)

TRANSPARENCIA_API_KEY

Para transparência

portaldatransparencia.gov.br

DATAJUD_API_KEY

Para processos

datajud.cnj.jus.br

MCP_TRANSPORT

—

stdio (padrão) ou http

MCP_HTTP_PORT

—

Porta HTTP (padrão: 3000)

🧬 Arquitetura

lib/ ├── adapters/ # CLI, Cloudflare Workers, Smithery ├── config/ # Configuração e timeouts ├── core/ # Registry, search, intelligence, dork-templates │ └── registry.ts # Tool registry pattern (auto-registration) ├── 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, Q. 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 │ └── index.ts # Barrel (triggers auto-registration) ├── types/ # TypeScript type definitions └── workers/ # Cloudflare Workers adapter

Padrões de Design:

  • Tool Registry — Auto-registration, zero boilerplate para novas tools

  • Circuit Breaker — Proteção contra falhas de API

  • Result Pattern — Tratamento funcional de erros

  • Google Dorks Engine — 64 templates em 10 categorias OSINT

📊 Métricas

  • 23 ferramentas OSINT registradas

  • 257 testes unitários (100% passing)

  • 64 dork templates em 10 categorias

  • TypeScript estrito em todo o codebase

  • Node.js 18+ · Vitest · Express 5

🤝 Contribuição

git clone https://github.com/cristianoaredes/mcp-dadosbr.git cd mcp-dadosbr npm install npm run build npm test

📄 Licença & Créditos

MIT License — LICENSE

Dados fornecidos por: OpenCNPJ, OpenCEP, IBGE API, Portal da Transparência, CNJ Datajud, Banco Central, BrasilAPI, CNES/DataSUS

👨‍💻 Mantenedor

Cristiano Aredes

LinkedIn · cristiano@aredes.me

🌐 Links

English

🕵️ The most complete Brazilian OSINT toolkit as an MCP server — 23 tools covering company data, government transparency, legal proceedings, financial indicators, healthcare, 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" } } } }

🛠️ 23 OSINT Tools

Domain

Tools

Description

🏛️ Government

ibge_localidades · transparencia_lookup · ceis_cnep_lookup · pncp_licitacoes · querido_diario

IBGE geography, federal contracts, sanctions, public procurement, municipal gazettes

⚖️ Legal

datajud_processos · oab_advogado · bnmp_mandados · procurados_lookup · lista_suja_lookup

Court proceedings, 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, domain WHOIS, consumer complaints, deep profile

💰 Financial

bacen_taxas · fipe_veiculos

Central Bank rates (SELIC, IPCA, USD, EUR, CDI), FIPE vehicle pricing

🏥 Health

cnes_saude

Healthcare facility search (CNES/DataSUS)

🧠 Intelligence

cnpj_search · cnpj_intelligence · strategic_osint_prompt · sequentialthinking

Web search with dorks, multi-source intelligence, strategic analysis templates, structured reasoning

🔑 Environment Variables

Variable

Required for

How to get

TAVILY_API_KEY

Web search tools

tavily.com

PERPLEXITY_API_KEY

Alternative search

perplexity.ai (used if Tavily not set)

TRANSPARENCIA_API_KEY

Government transparency

Portal da Transparência API

DATAJUD_API_KEY

Court proceedings

Datajud Wiki

🎯 Example Prompts

Run a full due diligence on CNPJ 00.000.000/0001-91: cnpj_lookup → transparencia_lookup → datajud_processos → lista_suja_lookup → company_deep_profile
What are the current Brazilian Central Bank rates? Use bacen_taxas for SELIC, IPCA, and USD exchange.
Search for lawsuits against "Company XYZ" using datajud_processos in tribunal TJSP. Then verify lawyer "João Silva" with oab_advogado in OAB/SP.

📊 Stats

  • 23 tools · 257 tests · 64 dork templates · 10 OSINT categories

  • TypeScript strict mode · Node.js 18+ · Vitest · Express 5

📄 License

MIT — LICENSE

Data sources: OpenCNPJ, OpenCEP, IBGE, Portal da Transparência, CNJ Datajud, Banco Central, BrasilAPI, CNES/DataSUS

👨‍💻 Maintainer

Cristiano Aredes · LinkedIn · cristiano@aredes.me

This server cannot be installed

-
security - not tested
F
license - not found
-
quality - not tested

How are these scores calculated?

Resources

Appeared in Searches

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/cristianoaredes/mcp-dadosbr'

If you have feedback or need assistance with the MCP directory API, please join our Discord server