Skip to main content
Glama

MCP DadosBR — Brasilianischer Daten-MCP-Server für Claude, Cursor & KI-Assistenten

npm version npm downloads TypeScript License: MIT

Das vollständigste brasilianische OSINT-Toolkit als Model Context Protocol (MCP) Server. Fragen Sie CNPJ, CEP, Gerichtsakten, Regierungsverträge, Finanzindikatoren und mehr ab — direkt aus Claude Desktop, Cursor, Windsurf, Claude Code oder jedem MCP-kompatiblen KI-Assistenten.

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: cnpj-br

English

Was ist das?

MCP DadosBR ist ein Model Context Protocol (MCP) Server, der KI-Assistenten direkten Zugriff auf brasilianische öffentliche Daten gibt. Verbinden Sie Claude Desktop, Cursor, Windsurf, Claude Code oder jeden MCP-kompatiblen Client, um CNPJ-Unternehmensdatensätze, CEP-Postanschriften, Gerichtsverfahren, Regierungsverträge, Finanzkurse der Zentralbank, Gesundheitseinrichtungen und mehr abzufragen — alles direkt aus dem Gespräch heraus.

23 OSINT-Tools in 6 Bereichen: Regierungstransparenz, Recht/Compliance, Unternehmen, Finanzen, Gesundheit und strategische Intelligenz.

Schnellinstallation

npx @aredes.me/mcp-dadosbr

Konfiguration (jeder 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

Speicherort

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

Cursor

.cursor/mcp.json im Projekt

Windsurf

~/.windsurf/config.json

Continue.dev

~/.continue/config.json

Gemini CLI

~/.config/gemini/mcp_config.json

Zed

~/.config/zed/settings.json (context_servers Feld)

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

Bereich

Tools

Beschreibung

Regierung

ibge_localidades · transparencia_lookup · ceis_cnep_lookup · pncp_licitacoes · querido_diario

IBGE-Geografie, Bundesverträge, sanktionierte Unternehmen, öffentliches Auftragswesen, kommunale Amtsblätter

Recht

datajud_processos · oab_advogado · bnmp_mandados · procurados_lookup · lista_suja_lookup

Gerichtsverfahren an allen brasilianischen Gerichten, Anwaltsüberprüfung, Haftbefehle, gesuchte Personen, Schwarze Liste für Sklavenarbeit

Unternehmen

cnpj_lookup · cep_lookup · cpf_validate · domain_whois · consumidor_reclamacoes · company_deep_profile

Unternehmensregistrierung, Adresssuche, CPF-Validierung, .br-Domain-WHOIS, Verbraucherbeschwerden, 6-Quellen-Tiefenprofil

Finanzen

bacen_taxas · fipe_veiculos

Kurse der brasilianischen Zentralbank (SELIC, IPCA, USD, EUR, CDI), FIPE-Fahrzeugpreistabelle

Gesundheit

cnes_saude

Suche nach Gesundheitseinrichtungen via CNES/DataSUS

Intelligenz

cnpj_search · cnpj_intelligence · strategic_osint_prompt · sequentialthinking

Websuche mit Google Dorks, Multi-Quellen-Intelligenz, Vorlagen für strategische Analysen (Due Diligence, Betrug, ESG), strukturiertes Denken


Anforderungen

  • Node.js 18+

  • Optionale API-Schlüssel, je nachdem, welche Tools Sie benötigen (siehe Tabelle unten)

Umgebungsvariablen

Variable

Erforderlich für

Wie man sie erhält

TAVILY_API_KEY

Websuch-Tools (cnpj_search, cnpj_intelligence)

tavily.com

PERPLEXITY_API_KEY

Alternative Suche (wird verwendet, wenn Tavily nicht gesetzt ist)

perplexity.ai

TRANSPARENCIA_API_KEY

Daten zur Regierungstransparenz

Portal da Transparência API

DATAJUD_API_KEY

Gerichtsverfahren

Datajud Wiki

Alle Tools ohne API-Schlüssel in der obigen Tabelle funktionieren ohne Konfiguration.


Beispiel-Prompts

Vollständige Due Diligence eines Unternehmens:

Run a full due diligence on CNPJ 00.000.000/0001-91:
cnpj_lookup → transparencia_lookup → datajud_processos → lista_suja_lookup → company_deep_profile

Betrugserkennung:

Use strategic_osint_prompt with template "fraud_detection" for CNPJ 11.222.333/0001-81.
Then run each tool indicated in the generated prompt.

Kurse der brasilianischen Zentralbank:

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

Rechtliche Recherche:

Search for lawsuits against "Company XYZ" using datajud_processos in TJSP.
Then verify lawyer "João Silva" with oab_advogado in OAB/SP.

Statistiken

  • 23 Tools · 257 Tests (100% bestanden) · 64 Google Dork-Vorlagen · 10 OSINT-Kategorien

  • TypeScript Strict Mode · Node.js 18+ · Vitest · Express 5

  • Integrierter Circuit Breaker, LRU-Cache, Anfragededuplizierung

Architektur-Übersicht

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

Mitwirken

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

Lizenz

MIT — siehe LICENSE.

Datenquellen: OpenCNPJ, OpenCEP, IBGE, Portal da Transparência, CNJ Datajud, Banco Central do Brasil, BrasilAPI, CNES/DataSUS

Erstellt von Cristiano Arêdes · LinkedIn · cristiano@aredes.me


Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    B
    maintenance
    Brazilian company-registry lookup via Receita Federal, allowing AI agents to query CNPJ data.
    21 npm
    MIT
  • 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.
    15
    MIT
  • A
    license
    A
    quality
    C
    maintenance
    Enables LLM clients to query public Brazilian data through tools for CEP addresses, CNPJ registrations, banks, FIPE vehicle prices, national holidays, and DDD area codes, with no API key required.
    8
    MIT