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 Server for Brazilian Public Data

English | Português

Access Brazilian government data directly in AI assistants like Claude Desktop, Cursor, and Windsurf. Query CNPJ company records, CEP postal codes, perform intelligent web searches, and analyze complex data using the Model Context Protocol (MCP).

🚀 Features

🏢 CNPJ Lookup - Brazilian company data (legal name, status, address, CNAE activity codes)
📮 CEP Lookup - Postal code information (street, neighborhood, city, state)
🔍 Intelligent Search - Web search with Google Dork operators for targeted research
🤔 Structured Reasoning - Sequential thinking tool for complex analysis
🎯 Research Intelligence - Orchestrated multi-query company investigations

⚡ Quick Start

Install globally via NPM:

Installing via Smithery

To install mcp-dadosbr automatically via Smithery:

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

Manual Installation

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

Or use directly with NPX:

npx @aredes.me/mcp-dadosbr

Configure in Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "dadosbr": {
      "command": "npx",
      "args": ["-y", "@aredes.me/mcp-dadosbr"]
    }
  }
}

Config location: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)

Test with: "Can you look up CNPJ 00.000.000/0001-91?"

💼 Use Cases

Company Due Diligence: Verify legal entity status, registration details, and business activity codes for procurement and partnerships.

E-commerce & Logistics: Validate shipping addresses using CEP lookup to reduce delivery errors and optimize routing.

Legal Research: Search government databases for lawsuits, contracts, and procurement documents using intelligent web search with site operators.

KYC & Compliance: Automate company verification for financial services, combining CNPJ data with web research for comprehensive due diligence.

🔌 Supported Platforms

AI Assistants: Claude Desktop, Continue.dev, Cursor, Windsurf
Deployment: Node.js (stdio), Cloudflare Workers (HTTP), Smithery Platform
Transport: stdio for desktop applications, HTTP/SSE for web and API integrations

Live Demo: https://mcp-dadosbr.aredes.me

📚 Documentation

🚀 Getting Started

Configuration Guide - Environment variables, custom API endpoints, authentication
Usage Examples - Real-world integration patterns and code samples
MCP Client Integration - Detailed setup for Claude, Cursor, Windsurf, Continue.dev

🔧 Advanced Features

Web Search Operators - Google Dork syntax for targeted research queries
Sequential Thinking - Structured reasoning for complex data analysis
Intelligence Tool - Multi-query orchestration for comprehensive research

🌐 Deployment

Cloudflare Workers - Serverless deployment with global edge distribution
Smithery Platform - One-click deployment configuration
Search Providers - DuckDuckGo, Tavily, SerpAPI setup and comparison

📚 Reference

Project Structure - Codebase organization and architecture overview
Navigation Guide - Quick reference for finding documentation

🇧🇷 Português

Documentação Completa PT-BR - Complete technical documentation in Brazilian Portuguese
Arquitetura - Detailed architectural diagrams and design decisions
Exemplos Práticos - Brazilian use cases and step-by-step tutorials

🛠️ Key Tools

`cnpj_lookup`

Query Brazilian company data by CNPJ (Cadastro Nacional da Pessoa Jurídica).

Input: CNPJ number (formatted or raw)
Output: Company name, legal status, address, CNAE codes, registration date
Data Source: OpenCNPJ (free public API)

`cep_lookup`

Query Brazilian postal codes for address information.

Input: CEP number (formatted or raw)
Output: Street name, neighborhood, city, state, area code
Data Source: OpenCEP (free public API)

`cnpj_search`

Perform intelligent web searches with advanced operators for company research.

Operators: site:, intext:, intitle:, filetype:, -exclude
Use Cases: Find lawsuits, government contracts, news articles, financial reports

`sequentialthinking`

Structured reasoning tool for breaking down complex analysis into logical steps.

Features: Iterative thinking, plan revision, branch exploration
Use Cases: Multi-step investigations, data validation, decision-making processes

`intelligence`

Orchestrate multiple research queries into comprehensive company intelligence reports.

Capabilities: Automated query generation, parallel search execution, result synthesis
Use Cases: Due diligence, market research, competitive analysis

🤝 Contributing

We welcome contributions from the community! See the Contributing Guide for development setup, coding standards, and how to submit pull requests.

Code of Conduct: This project follows the Contributor Covenant code of conduct.

📦 Releases

This project uses automated releases with semantic versioning and changelog generation. See the Release Guide for detailed instructions on:

Creating new releases
Version tagging process
Automated workflows
Rollback procedures

Quick Release: Update package.json version, commit, create a git tag (v*.*.*), and push to trigger automated release workflow.

📄 License

MIT License - see LICENSE file for details.

🙏 Credits

Data Sources:

OpenCNPJ - Free Brazilian company registry data
OpenCEP - Free Brazilian postal code database

👨‍💻 Author

_{Cristiano Aredes}
💼 💻 📧

Installing via Smithery

Para instalar automaticamente via Smithery:

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

Instalação Manual

Maintainer: Cristiano Aredes | LinkedIn | cristiano@aredes.me

Português

🇧🇷 Servidor MCP para consulta de dados públicos brasileiros.

Integre informações de CNPJ (empresas) e CEP (códigos postais) diretamente no Claude Desktop, Cursor, Windsurf, Continue.dev e outros assistentes de IA compatíveis com o Model Context Protocol.

⚡ Instalação

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

🔌 Configuração

Configure no Claude Desktop editando claude_desktop_config.json:

{
  "mcpServers": {
    "dadosbr": {
      "command": "npx",
      "args": ["-y", "@aredes.me/mcp-dadosbr"]
    }
  }
}

Teste: "Pode consultar o CNPJ 00.000.000/0001-91?"

📖 Documentação Completa

Acesse a documentação completa em português para:

Guias de instalação detalhados para cada IDE
Exemplos de uso com casos brasileiros
Arquitetura e design do sistema
Configuração avançada e personalização
Tutoriais passo a passo

📦 Lançamentos

O projeto utiliza lançamentos automatizados com versionamento semântico e geração automática de changelog. Consulte o Guia de Lançamento para instruções detalhadas sobre:

Criação de novos lançamentos
Processo de versionamento
Fluxos de trabalho automatizados
Procedimentos de rollback

Lançamento Rápido: Atualize a versão no package.json, faça commit, crie uma tag git (v*.*.*) e envie para disparar o fluxo automatizado.

Made with ❤️ for the Brazilian developer community 🇧🇷