Skip to main content
Glama
deenesjakoruzh
cristianoaredes

MCP DadosBR

by cristianoaredes
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Hybrid

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

Links

This server cannot be installed

A
license - permissive license
-
quality - not tested
B
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
1dRelease cycle
9Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

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