# MCP DadosBR Servidor MCP focado em dados públicos do Brasil. Oferece duas ferramentas simples e rápidas para **consulta de CNPJ** e **consulta de CEP**, perfeitas para validação de cadastros, preenchimento automático de endereços e enriquecimento de dados em agentes. ## Por que usar * Latência baixa e alta disponibilidade em Cloudflare Workers * Interface MCP padronizada, pronta para agentes e IDEs compatíveis * Design stateless por padrão. Cache opcional com KV se desejar * Sem dependência de serviços proprietários do lado do cliente ## Tools disponíveis * `cnpj_lookup` **Entrada**: `{ "cnpj": "string" }` com ou sem máscara **Retorno**: dados cadastrais quando disponíveis, por exemplo razão social, nome fantasia, CNAE principal, natureza jurídica, situação, endereço * `cep_lookup` **Entrada**: `{ "cep": "string" }` com ou sem máscara **Retorno**: logradouro, bairro, município, UF, código IBGE e campos correlatos quando disponíveis ## Endpoints * HTTP JSON-RPC: `/mcp` * Server-Sent Events: `/sse` * Saúde: `/health` Exemplo de chamada JSON-RPC: ```json { "jsonrpc": "2.0", "id": "1", "method": "tools/call", "params": { "name": "cep_lookup", "arguments": { "cep": "30130-010" } } } ``` ## Integração rápida * **SSE**: aponte seu cliente MCP para `.../sse` * **HTTP**: aponte para `.../mcp` usando JSON-RPC 2.0 Funciona com agentes e IDEs compatíveis com MCP. Exemplos de configuração estão no repositório. ## Casos de uso * Autocomplete de endereço a partir do CEP * Validação de CNPJ em fluxos de onboarding e KYC * Enriquecimento de dados em CRMs, ERPs e chatbots * Auditoria cívica e aplicações gov-tech locais ## Privacidade e limites O servidor não persiste PII por padrão. Se o cache KV for habilitado, use políticas de retenção mínimas. Respeite limites das fontes públicas utilizadas. Planos e cotas do Cloudflare podem impactar throughput. ## Código e docs * Repositório e exemplos: [https://github.com/cristianoaredes/mcp-dadosbr](https://github.com/cristianoaredes/mcp-dadosbr) * Documentação dos endpoints no README ## Suporte Abra uma issue no GitHub para bugs, dúvidas e sugestões. Roadmap inclui busca por empresa, normalização de formatos e retornos enriquecidos. Brasil, CNPJ, CEP, GovTech, Validação, Endereços, Cloudflare Workers, MCP