# HookPulse

> Dead-man switch: você cria um endpoint, o cron/webhook dá ping em `/in/:id`.
> Se o silêncio passar do intervalo, conta como miss. Cliente principal: agente de IA.

## Descoberta

- [Índice da API](https://hookpulse.net/api/)
- [llms.txt](https://hookpulse.net/llms.txt): este arquivo
- [OpenAPI](https://hookpulse.net/openapi.json)
- [Health](https://hookpulse.net/api/health)
- [Billing](https://hookpulse.net/api/billing)
- UI humana: botão **API** no topo + **Agent resource hub** no rodapé (mesmos links).

## Endpoints principais

- `POST /api/guest` — Cria guest token `hp_…` (dono anônimo de endpoints). (auth: none)
- `GET /api/endpoints` — Lista endpoints do dono (guest ou sessão). (auth: guest)
- `POST /api/endpoints` — Cria endpoint de dead-man. 2º+ ou intervalo < free_min → x402 (402 até pagar). (auth: guest)
- `GET /api/endpoints/:id` — Status de um endpoint (token de dono ou token do endpoint). (auth: hook)
- `PATCH /api/endpoints/:id` — Atualiza nome/intervalo/alert_to (pode cobrar x402 se intervalo ficar pago). (auth: guest)
- `DELETE /api/endpoints/:id` — Desativa/remove o endpoint do dono. (auth: guest)
- `GET /api/endpoints/:id/events` — Últimos pings recebidos no ingest. (auth: hook)
- `GET /in/:id` — URL de ingest — cron/webhook faz GET/POST aqui para provar vida. (auth: none)
- `POST /in/:id` — Mesmo ingest via POST (body opcional). (auth: none)
- `GET /api/billing` — Free tier, preços e parâmetros x402 (incl. contact_agent_usd). (auth: none)
- `POST /api/contact` — Suporte: Turnstile (humano) ou x402 $0.10 (agente). (auth: none)
- `GET /api/me` — Usuário da sessão + endpoints. (auth: session)
- `POST /api/auth/start` — Envia OTP por e-mail. (auth: none)
- `POST /api/auth/verify` — Troca OTP por sessão sess_… (auth: none)
- `POST /api/auth/claim` — Move endpoints do guest para a conta. (auth: session)
- `POST /api/auth/logout` — Invalida sessão. (auth: session)
- `POST /api/visit` — Ping de audiência da UI (agente ignora). (auth: none)
- `GET /api/metrics` — Métricas 7d (operador). (auth: token)

## Free / pago (x402 Base)

- Free: 1 endpoint, intervalo ≥ 900s.
- Extra endpoint $0.10 · intervalo rápido $0.05 · contato agente $0.10.
- Valores vivos: https://hookpulse.net/api/billing

## MCP / skill

- Skill: `.agents/skills/hookpulse/SKILL.md`
- MCP: hub `~/src/make-money/scripts/mcp/server.mjs --product hookpulse`
- **Paridade:** mexeu na UI/API → apidocs + skill + MCP + este arquivo no mesmo PR.