# Fonteza

> API REST somente leitura e servidor MCP com dados públicos oficiais brasileiros: cadastro de empresas da Receita Federal (CNPJ, sócios), oportunidades de contratação do PNCP e despesas federais do Portal da Transparência. Cada resposta identifica a fonte, a publicação e a cobertura.

- URL base: https://api.fonteza.com.br
- Autenticação: header `X-Api-Key: fk_...`. Chave gratuita em https://fonteza.com.br/app/login, 1.000 chamadas por dia. /v1/meta e /healthz são públicas.
- MCP remoto: https://fonteza.com.br/mcp (streamable HTTP, header `Authorization: Bearer fk_...`)
- Contrato OpenAPI 3.1: https://fonteza.com.br/openapi.yaml
- Toda a documentação em um arquivo: https://fonteza.com.br/llms-full.txt
- Toda página de /docs tem versão Markdown: acrescente `.md` ao endereço ou envie `Accept: text/markdown`.

## Guias

- [API Fonteza](https://fonteza.com.br/docs/index.md): Empresas da Receita Federal, oportunidades do PNCP e despesas federais em JSON, por REST ou MCP.
- [Montar uma busca](https://fonteza.com.br/docs/construtor.md): Escolha os filtros de /v1/buscar e copie a requisição pronta em curl, Python ou JavaScript.
- [Agentes de IA](https://fonteza.com.br/docs/agentes.md): MCP remoto, llms.txt e páginas em Markdown para agentes que consultam ou integram a Fonteza.
- [Autenticação e cota](https://fonteza.com.br/docs/autenticacao.md): Header X-Api-Key, criação de chaves e como a cota diária é contada.
- [Paginação](https://fonteza.com.br/docs/paginacao.md): Offset na busca de empresas; cursor preso à publicação em oportunidades e despesas.
- [Erros](https://fonteza.com.br/docs/erros.md): Status HTTP, formatos do corpo e códigos estáveis de erro.
- [Cobertura e procedência](https://fonteza.com.br/docs/cobertura.md): Como ler fonte, publicação e cobertura antes de concluir que algo não existe.

## Referência

- [GET /v1/buscar](https://fonteza.com.br/docs/referencia/buscar.md): Buscar empresas
- [GET /v1/empresas/{cnpj}](https://fonteza.com.br/docs/referencia/empresas-cnpj.md): Obter o cadastro de uma empresa
- [GET /v1/oportunidades](https://fonteza.com.br/docs/referencia/oportunidades.md): Buscar oportunidades no PNCP
- [GET /v1/empresas/{cnpj}/despesas-federais](https://fonteza.com.br/docs/referencia/empresas-cnpj-despesas-federais.md): Listar despesas federais de uma empresa
- [GET /v1/meta](https://fonteza.com.br/docs/referencia/meta.md): Consultar publicações e cobertura
- [GET /healthz](https://fonteza.com.br/docs/referencia/healthz.md): Verificar o processo
- [GET /v1/cnaes](https://fonteza.com.br/docs/referencia/cnaes.md): Encontrar códigos CNAE por atividade