MCP DadosBR Server (`ai.smithery/cristianoaredes-mcp-dadosbr`)

O MCP DadosBR é um servidor Model Context Protocol focado em dados públicos do Brasil. A descrição indica que oferece duas ferramentas simples voltadas a consultas relacionadas a identificadores e endereços (como CEP e CNPJ), compatíveis com clientes MCP como Claude Desktop, Cursor e outros assistentes.

🛠️ Key Features

Servidor MCP para dados públicos do Brasil
Duas ferramentas simples (conforme a descrição)
Temas/assuntos: CEP e CNPJ
Publicado sob o pacote @aredes.me/mcp-dadosbr (TypeScript)

🚀 Use Cases

Consultar dados públicos do Brasil via MCP
Integração com Claude Desktop, Cursor, Continue, Windsurf e assistentes baseados em MCP
Apoiar fluxos para validação/consulta usando CEP e CNPJ

⚡ Developer Benefits

Compatível com o ecossistema Model Context Protocol (MCP)
Implementação em TypeScript
Adequado para clientes MCP que consumem ferramentas via tool calls

⚠️ Limitations

A documentação disponível aqui confirma apenas duas ferramentas simples; detalhes adicionais não estão incluídos no trecho fornecido.

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

npm version

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

bash

npx @aredes.me/mcp-dadosbr

Configuração (qualquer cliente MCP)

Adicione ao arquivo de configuração do seu cliente MCP:

json

{
  "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:

bash

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:

code

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:

code

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:

code

Quais são as taxas atuais do Banco Central?
Use bacen_taxas para SELIC, IPCA e câmbio do Dólar.

Pesquisa jurídica:

code

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:

code

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

bash

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

bash

npx @aredes.me/mcp-dadosbr

Configuration (any MCP client)

json

{
  "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:

bash

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:

code

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:

code

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:

code

What are the current Brazilian Central Bank rates?
Use bacen_taxas for SELIC, IPCA, and USD exchange rate.

Legal research:

code

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

code

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

bash

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

ai.smithery/cristianoaredes-mcp-dadosbr

MCP DadosBR Server (`ai.smithery/cristianoaredes-mcp-dadosbr`)

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

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

Português

O que é isso?

Instalação rápida

Configuração (qualquer cliente MCP)

23 Ferramentas OSINT

Governo e Transparência

Jurídico e Compliance

Empresas e Pessoas

Financeiro

Saúde

Inteligência Estratégica

Exemplos de uso

Variáveis de ambiente

Requisitos

Desenvolvimento e contribuição

Licença

English

What is this?

Quick install

Configuration (any MCP client)

23 OSINT Tools

Requirements

Environment Variables

Example prompts

Stats

Architecture overview

Contributing

License

Links

Install

Remote endpoint

Related servers

MCP DadosBR Server (ai.smithery/cristianoaredes-mcp-dadosbr)

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

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

Português

O que é isso?

Instalação rápida

Configuração (qualquer cliente MCP)

23 Ferramentas OSINT

Governo e Transparência

Jurídico e Compliance

Empresas e Pessoas

Financeiro

Saúde

Inteligência Estratégica

Exemplos de uso

Variáveis de ambiente

Requisitos

Desenvolvimento e contribuição

Licença

English

What is this?

Quick install

Configuration (any MCP client)

23 OSINT Tools

Requirements

Environment Variables

Example prompts

Stats

Architecture overview

Contributing

License

Links

Install

Remote endpoint

Related servers

MCP DadosBR Server (`ai.smithery/cristianoaredes-mcp-dadosbr`)