DadosBR
# 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