mcp-dadosbr

cristianoaredes/mcp-dadosbr

3.3

If you are the rightful owner of mcp-dadosbr and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

MCP DadosBR is a production-ready Model Context Protocol server designed for querying Brazilian public data, specifically CNPJ (company) and CEP (postal code) information, using OpenCNPJ and OpenCEP APIs.

Tools
2
Resources
0
Prompts
0

MCP DadosBR 🇧🇷

smithery badge npm version npm downloads TypeScript Cloudflare Workers License: MIT

🤖 Model Context Protocol (MCP) server for Brazilian business data lookup — bring CNPJ (company) and CEP (postal code) information directly into Claude Desktop, Cursor, Windsurf, Continue.dev and other AI assistants.

🚀 Multi-platform deployment: NPM package, Cloudflare Workers, Smithery.

English | Português

Português

🇧🇷 Servidor MCP para consulta de dados empresariais brasileiros (CNPJ) e validação de endereços (CEP). Integre essas consultas em minutos em Claude Desktop, Cursor, Windsurf, Continue.dev e qualquer cliente compatível com MCP.

⚡ Instalação Rápida

npm install -g @aredes.me/mcp-dadosbr

Ou execute diretamente com NPX:

npx @aredes.me/mcp-dadosbr

Via Smithery (1 clique)

npx -y @smithery/cli install @cristianoaredes/mcp-dadosbr --client claude

🔌 Configuração por IDE / Cliente MCP

🤖 Claude Desktop

{
  "mcpServers": {
    "dadosbr": {
      "command": "npx",
      "args": ["@aredes.me/mcp-dadosbr"],
      "env": {
        "TAVILY_API_KEY": "tvly-your-api-key-here"
      }
    }
  }
}

Localização: ~/Library/Application Support/Claude/claude_desktop_config.json

⚠️ Obrigatório: Configure TAVILY_API_KEY para usar cnpj_search e cnpj_intelligence. Obtenha sua chave em tavily.com

🎯 Cursor IDE

{
  "mcpServers": {
    "dadosbr": {
      "command": "npx",
      "args": ["@aredes.me/mcp-dadosbr"],
      "env": {
        "TAVILY_API_KEY": "tvly-your-api-key-here"
      }
    }
  }
}

🏄 Windsurf IDE

{
  "mcpServers": {
    "dadosbr": {
      "command": "npx",
      "args": ["@aredes.me/mcp-dadosbr"],
      "env": {
        "TAVILY_API_KEY": "tvly-your-api-key-here"
      }
    }
  }
}

🔄 Continue.dev

{
  "mcpServers": [
    {
      "name": "dadosbr",
      "command": "npx",
      "args": ["@aredes.me/mcp-dadosbr"],
      "env": {
        "TAVILY_API_KEY": "tvly-your-api-key-here"
      }
    }
  ]
}

🤖 ChatGPT MCP

Para usar com ChatGPT, configure o servidor Cloudflare Workers como endpoint remoto:

  1. Deploy no Cloudflare Workers: npm run deploy
  2. Configure no ChatGPT:
    • URL do servidor: https://mcp-dadosbr.your-subdomain.workers.dev
    • O ChatGPT detectará automaticamente os endpoints OAuth e MCP
  3. Configure API Key (opcional, via environment variables no Workers): 
    TAVILY_API_KEY="tvly-your-api-key-here"

APIs REST disponíveis:

  • GET /cnpj/{cnpj} - Consulta dados de empresa
  • GET /cep/{cep} - Consulta dados de endereço
  • POST /search - Busca web inteligente
  • POST /intelligence - Busca inteligente completa
  • POST /thinking - Raciocínio estruturado

✅ Teste rápido

Pode consultar o CNPJ 11.222.333/0001-81?

🛠️ Ferramentas Disponíveis

  • 🏢 cnpj_lookup — razão social, situação cadastral, endereço, CNAE (fonte: OpenCNPJ)
  • 📮 cep_lookup — logradouro, bairro, cidade, UF, DDD (fonte: OpenCEP)
  • 🔍 cnpj_search — buscas web com dorks (site:, intext:, filetype:) via Tavily
  • 🤔 sequentialthinking — raciocínio estruturado passo a passo
  • 🎯 cnpj_intelligence — orquestra múltiplas consultas e gera relatório consolidado com filtros de assertividade

✨ Novidade v0.3.2: Buscas web agora usam Tavily exclusivamente, com filtros automáticos para garantir 100% de precisão nos resultados (valida CNPJ em todos os snippets retornados). Configure TAVILY_API_KEY obrigatoriamente.

🧪 Testes em Linha de Comando

Servidor HTTP + SSE local

npm run build
TAVILY_API_KEY="tvly-xxx" MCP_TRANSPORT=http MCP_HTTP_PORT=3000 node build/lib/adapters/cli.js

Em outro terminal:

TAVILY_API_KEY="tvly-xxx" node scripts/mcp-client.js list-tools
TAVILY_API_KEY="tvly-xxx" node scripts/mcp-client.js cnpj 28526270000150
TAVILY_API_KEY="tvly-xxx" MAX_QUERIES=3 MAX_RESULTS=3 node scripts/mcp-client.js intelligence 28526270000150

Health check rápido

curl -i https://mcp-dadosbr.aredes.me/health

🌐 Deploy Web (Opcional)

Cloudflare Workers: https://mcp-dadosbr.aredes.me

  • 🔗 REST API: /cnpj/{cnpj} · /cep/{cep} · /search · /intelligence · /thinking
  • 🤖 OpenAPI: /openapi.json
  • 📊 Health: /health
  • 🔐 OAuth 2.0 + API Key Authentication: Protegido contra abuso
  • ⚡ Rate Limiting: 30 req/min por IP (configurável)

Smithery: smithery.yaml para deploy single-click.

🚀 Para ChatGPT MCP

# 1. Deploy no Cloudflare
npm run build
npm run deploy

# 2. Configure no ChatGPT:
# - Server URL: https://your-subdomain.workers.dev
# - O ChatGPT detectará automaticamente OAuth + MCP endpoints

🔒 Segurança (Cloudflare Workers)

API Key Authentication:

  • Protegidos: Endpoints REST (/cnpj/*, /cep/*, /search, /intelligence, /thinking)
  • Não protegidos: Protocolo MCP (/mcp, /sse) - para compatibilidade com AI assistants
# Configure API key
wrangler secret put MCP_API_KEY

# Use via headers (apenas para endpoints REST):
curl -H "X-API-Key: your-key" https://mcp-dadosbr.aredes.me/cnpj/11222333000181
# ou
curl -H "Authorization: Bearer your-key" https://mcp-dadosbr.aredes.me/cnpj/11222333000181

# Endpoints MCP não precisam de autenticação:
curl -X POST https://mcp-dadosbr.aredes.me/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}'

Rate Limiting:

  • Padrão: 30 requisições por minuto por IP
  • KV-based para escalabilidade
  • Desativável com MCP_DISABLE_RATE_LIMIT=true

📚 Documentação

💼 Casos de Uso

  • Due diligence e compliance
  • E-commerce e logística (validação de endereço)
  • Pesquisa jurídica (tribunais, portais gov.br via dorks)
  • Atendimento ao cliente e CRM (verificação de cadastro)

🤝 Contribuição & Lançamentos

  • Tokens necessários para CI/CD: veja docs/GITHUB_SECRETS_SETUP.md

📄 Licença & Créditos

👨‍💻 Mantenedor

Cristiano Aredes
LinkedIn · cristiano@aredes.me

English

🤖 Model Context Protocol server for Brazilian company (CNPJ) and postal code (CEP) data. Integrate verified business data into Claude Desktop, Cursor, Windsurf, Continue.dev and any MCP-compatible assistant.

⚡ Quick Install

npm install -g @aredes.me/mcp-dadosbr

Or via NPX:

npx @aredes.me/mcp-dadosbr

IDE Configuration

  • Claude Desktop / Cursor / Windsurf: 
    {
  "mcpServers": {
    "dadosbr": {
      "command": "npx",
      "args": ["@aredes.me/mcp-dadosbr"],
      "env": {
        "TAVILY_API_KEY": "tvly-your-api-key-here"
      }
    }
  }
}
  • Continue.dev: 
    {
  "mcpServers": [
    {
      "name": "dadosbr",
      "command": "npx",
      "args": ["@aredes.me/mcp-dadosbr"],
      "env": {
        "TAVILY_API_KEY": "tvly-your-api-key-here"
      }
    }
  ]
}

⚠️ Required: Set TAVILY_API_KEY to use cnpj_search and cnpj_intelligence. Get your key at tavily.com

Test prompt: Can you look up CNPJ 11.222.333/0001-81?

Key Tools

  • cnpj_lookup — Company registry data (OpenCNPJ)
  • cep_lookup — Postal address data (OpenCEP)
  • cnpj_search — Google-dork style search queries via Tavily
  • sequentialthinking — Structured multi-step reasoning
  • cnpj_intelligence — Automated company intelligence workflow with accuracy filters

✨ New in v0.3.2: Web searches now use Tavily exclusively, with automatic filters ensuring 100% accuracy (validates CNPJ in all returned snippets). TAVILY_API_KEY is required.

Web Deployment

Documentation & Support

License

MIT License — see . Data courtesy of OpenCNPJ & OpenCEP.

Made with ❤️ for the Brazilian developer community 🇧🇷