Package Exports

@aredes.me/mcp-dadosbr
@aredes.me/mcp-dadosbr/build/lib/adapters/cli.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@aredes.me/mcp-dadosbr) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

MCP DadosBR 🇧🇷

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

Deploy no Cloudflare Workers: npm run deploy
Configure no ChatGPT:
- URL do servidor: https://mcp-dadosbr.your-subdomain.workers.dev
- O ChatGPT detectará automaticamente os endpoints OAuth e MCP
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: Compatível com ChatGPT MCP

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

📚 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

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

📄 Licença & Créditos

MIT License — LICENSE
Dados fornecidos por OpenCNPJ e OpenCEP

👨‍💻 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

Cloudflare Worker endpoint: https://mcp-dadosbr.aredes.me
REST: /cnpj/{cnpj}, /cep/{cep}
OpenAPI spec: /openapi.json
Health: /health

Documentation & Support

License

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

Made with ❤️ for the Brazilian developer community 🇧🇷