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 * 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