Which integrations are available for this server?

Enables deployment of the server as a Cloudflare Workers application with REST API endpoints, OAuth 2.0 authentication, rate limiting, and global edge distribution for querying Brazilian company and postal code data.

How do I use MCP DadosBR?

This server has a remotely hosted endpoint. Open its connector listing for connection details, authentication requirements, and setup instructions: * cristianoaredes-mcp-dadosbr

de en es ja ko ru zh

MCP DadosBR

by cristianoaredes

Overview Schema Source Related Servers Discussions Admin

TypeScript

Hybrid

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

Related MCP server: MCP Brazil Public Data

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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive

ResponsivenessNo recent community issues

Resources

Related MCP Connectors

CNPJA
io.github.mcp-dir
Free Brazilian CNPJ lookup (legal name, status, partners) + lawsuit discovery. Public data, no login
Government Data Open Data Legal & Compliance
821
https://api.mcp.ai/p_cnpj
Fichário — CNPJ BrasilB
io.github.thiagopatzdorf
Free lookup of 28.4M active Brazilian companies by CNPJ or name (Receita Federal open data).
Government Data Open Data
1
https://cnpj.genesisinnovation.io/mcp
Receita Federal PJA
io.github.mcp-dir
Looks up a company's registration data at the Federal Revenue from the CNPJ, optionally with the own
Government Data Finance
71
https://api.mcp.ai/p_receita_pj
agent-university-empresasD
io.github.Mila-Pirate
Brazilian company data & sanctions screening for AI agents. Certified. Pay-per-call x402.
Government Data Legal & Compliance
51
https://agent-university-empresas.onrender.com/mcp

Related MCP Servers

cnpj-br
Government Data Open Data
pipeworx-io
A
license
Not graded
quality
B
maintenance
Brazilian company-registry lookup via Receita Federal, allowing AI agents to query CNPJ data.
Updated 11 days ago (2026-10-31 08:22 UTC)
306 npm
MIT
MCP Brazil Public Data
devantage
A
license
A
quality
C
maintenance
Enables lookup of Brazilian public data including companies (CNPJ), postal codes (CEP), banking, economy, geography, and more through 15 tools and 2 guided prompts, powered by BrasilAPI with no API key required.
Updated 4 months ago (2026-07-20 09:18 UTC)
15
MIT
mcp-hunter
Browser Automation Web Scraping Government Data
rrcodeia
F
license
A
quality
C
maintenance
Enables AI assistants to perform OSINT investigations, web searches, deep website scraping, contact extraction, and Brazilian company data enrichment via CNPJ, including 360-degree company and person lookups.
Updated 2 months ago (2026-08-27 17:58 UTC)
6
-
company-investigator-mcp
Open Data Research & Data Search
CalebePrates
A
license
A
quality
B
maintenance
Enables LLM clients to investigate Brazilian companies by CNPJ or name, mapping corporate relationships and gathering structured, source-attributed public evidence from official registries, news, social profiles, judicial proceedings, and PEP checks.
Updated 2 months ago (2026-09-23 23:36 UTC)
6
MIT