# PontoFato

> Ponto CNEFE (coordenada IBGE) + empresas no CEP. Não é ViaCEP. Cliente: agente.

## Descoberta

- [Índice da API](https://pontofato.com/api/)
- [llms.txt](https://pontofato.com/llms.txt)
- [llms-full.txt](https://pontofato.com/llms-full.txt)
- [OpenAPI](https://pontofato.com/openapi.json)
- [MCP](https://pontofato.com/mcp)

## Endpoints principais

- `POST /mcp` — MCP Streamable HTTP — as tools deste catálogo, despachadas neste mesmo Worker. (auth: none)
- `GET /api/cep/:cep` — Pontos CNEFE de um CEP, com lat/lon IBGE — não é chute de mapa. (auth: none)
- `GET /api/cep/:cep/unidades` — Unidades CNEFE de um CEP, com complemento, espécie e id — paginado. (auth: none)
- `GET /api/proximo` — Ponto CNEFE mais perto de um par lat/lon. Sem default para (0,0). (auth: none)
- `GET /api/buscar` — Busca textual de logradouro (FTS5), com UF e cidade opcionais. (auth: none)
- `GET /api/empresas` — Estabelecimentos da Receita neste CEP (join no c3, teto 50). (auth: none)
- `GET /api/local` — Cidade/UF de quem chama, pela borda Cloudflare. Sem cache. (auth: none)

## Contato agente

- `POST /api/contact` sem captcha → **HTTP 402** x402 **$0.10** USDC.

## Cota

- Grátis: lookup de CEP, próximo, busca e empresas — sem cota no v1.
- Pago: contato de agente — **$0.10** USDC via x402.

Contato agente → **402** com `accepts[]`. Pague e repita com `X-PAYMENT`.

Números em vigor: https://pontofato.com/api/