# Referência KnotAPI

## Consulta REST

`GET https://knotapi.online/api?modulo=cpf&consulta=CPF`

Header: `x-api-key: $KNOT_API_KEY`

`KNOT_API_KEY` é o nome da variável de ambiente, não uma chave automática. A chave deve ser criada no portal KnotAPI e armazenada no ambiente server-side ou secret manager. Nunca invente, registre ou solicite o segredo por chat. Se a variável estiver ausente, a integração deve falhar de forma segura.

Sucesso: `sucesso`, `dados.CPF`, `dados.NOME`, `dados.NASCIMENTO`, `dados.MAE` e `meta`.

`NASCIMENTO` usa `DD-MM-AAAA`. `quota_reset` é legível no horário de São Paulo; `quota_reset_iso` deve ser usado em cálculos.

## Erros

- 400: entrada inválida ou chave enviada na URL
- 401: chave ausente/inválida
- 403: conta, plano, IP ou origem bloqueados
- 404: CPF válido sem registro
- 429: velocidade ou franquia atingida
- 500/503: indisponibilidade; use retry limitado com backoff

## MCP

Endpoint: `POST https://knotapi.online/mcp`

Headers: `Authorization: Bearer $KNOT_API_KEY`, `Content-Type: application/json`, `Accept: application/json, text/event-stream`.

Inicialize, envie `notifications/initialized`, liste `tools/list` e chame `tools/call` com `name=consultar_cpf` e `arguments.cpf`.