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