hookpulse changelog

• − billing

description

Dead-man switch for cron and webhooks: ingest URL, miss detection, alerts and a status feed. → Know when a job stops or a site goes down after the agent exits. Free monitors; paid extra coverage.

version

1.0.1 → 1.1.0

https://hookpulse.net/llms.txt

− > Monitor backups, automations and scheduled tasks.− > Create a monitor and connect the routine to `/in/:id` for successful check-ins.− > A missing check-in causes an alert on the next five-minute check.− > Unresolved alerts repeat daily by default. Set `alert_repeat_sec` for another interval.− > Read `/api/billing` before paid operations. E-mail alerts are charged per additional− > monitor, even when the address is reused. The account's 7-day trial does not waive that charge.− **Partnership, sponsorship and advertising**− Ad spaces with suggested prices in US dollars for 30 days.− - `GET https://hookpulse.net/api/partners` — ad spaces, suggested price, wallet and the proposal fields.− - [Send a proposal](https://hookpulse.net/partners) — form to send a proposal.− - `GET https://hookpulse.net/okf/parceria.md` — the offer in Markdown.− **Public data archives**− Browse addresses and procurement by location, then open the records you need. Up to 20 items per page, in formats ready for people and agents. Check coverage and the reference date before using a result. Access options are shown by each product.− - [Postal codes and addresses](https://api.pontofato.com/enderecos/index.json): Find addresses by location, with coordinates and a 2022 reference date. Not a current postal-code certification. Each HTML page opens the product app with its public data already rendered. State → municipality → locality → street → addresses. [HTML](https://pontofato.com/enderecos/) · [llms.txt](https://api.pontofato.com/enderecos/llms.txt) · [OKF](https://api.pontofato.com/enderecos/okf/index.md)− - [Public procurement](https://api.editalmd.com/licitacoes/index.json): Find public procurement by location and date. View documents and reading options in EditalMD. Each HTML page opens the product app with its public data already rendered. Procedure → state → year → month → day → municipality → purchases. [HTML](https://editalmd.com/licitacoes/) · [llms.txt](https://api.editalmd.com/licitacoes/llms.txt) · [OKF](https://api.editalmd.com/licitacoes/okf/index.md)− **Quota**− - Free: dead-man endpoints — 10 per owner.− - Free: minimum interval at no cost — 90s.− - Free: ingest (`/in/:id`) — no charge per ping.− - Free: webhook alert (`alert_url`) — no quota — it is a fetch of ours.− - Free: e-mail alert (`alert_to`) — 1 registration.− - Free: status dashboard by URL (JSON and RSS) — no quota.− - Paid: endpoint beyond the allowance — **$0.10** USDC via x402.− - Paid: interval below the free minimum — **$0.05** USDC via x402.− - Paid: e-mail alert registration beyond the 1st — **$0.10** USDC via x402.− - **Not charging right now**: extra_endpoint, fast_interval. Call it directly — no 402. The price above is the list price and comes back without notice.− - Trial: sign up and CONFIRM the e-mail → **7 days** of full access, free. Loop: Sign in at /conta/global for 7 days without usage charges on extra monitors and faster intervals, counted from the account's first use of HookPulse. E-mail alerts on additional monitors remain $0.10 each. Service limits still apply. After the trial, alerts from monitors beyond the free ten need a plan (GET /api/plans); the monitors keep checking. When the trial or a plan ends, the account gets one e-mail with the pl− Read GET /api/billing before a paid operation. Its gratis field lists options with billing off. If a charge applies, the API returns HTTP 402 with accepts[]. Pay through x402 using USDC on Base, then repeat the same call with PAYMENT-SIGNATURE (x402 v2) or X-PAYMENT (v1); a standard x402 client such as @x402/fetch does it for you. E-mail alerts are charged once per additional monitor, even when the address is reused.− Numbers in force: https://hookpulse.net/api/billing− **MCP**− - **Endpoint:** `POST https://hookpulse.net/mcp` — Streamable HTTP, JSON-RPC 2.0. Nothing to install.− - Check it with `GET https://hookpulse.net/mcp` (server card) or `tools/list`.− - Every tool is a call on this same API — the MCP has no backend of its own.− - Credentials (`X-Guest-Token`, `Authorization`, `X-PAYMENT`) go in the header and are forwarded.− - **Sign in (OAuth 2.1):** clients such as claude.ai, ChatGPT, Claude Code and Cursor sign in to your account (`https://hookpulse.net/.well-known/oauth-protected-resource`). The account tools open, and the free limit becomes yours. Connected apps are listed, and can be disconnected, at https://hookpulse.net/conta/global?vista=apps.− **Skill**− - `.agents/skills/hookpulse/SKILL.md` — parity with this surface.− - **Parity:** touched the UI/API → apidocs + skill + this file in the same PR.− ## Discovery− - [API index](https://hookpulse.net/api/)+ > A persistent monitor with schedule, state and configured alerts. Site monitors use active checks; routines send check-ins.+ We keep the schedule, detect missing runs and send configured alerts. Your agent can stop after setting up the monitor.+ Start with POST /api/endpoints within the current free coverage. Send a check-in or test the site's response.+ Expand the monitor count or frequency when needed. Compare the extra-monitor quote with a 30-day plan in /api/pricing.+ A check-in proves the signal arrived, not that a backup can be restored. Alert timing depends on the check cycle. A single paid probe does not create continuous monitoring.+ Use existing access and spending authority. Read the current quote before a paid request.+ ## Choose the task+ - [How do I know when a scheduled job stops or a site goes down?](/llms-full.txt?prefix=%2Fapi%2Fendpoints): POST /api/endpoints+ ## Access and prices+ - [Free allowances and paid services](https://hookpulse.net/api/pricing): current units, packages and prices.+ - [Payment](https://hookpulse.net/api/billing): available methods and conditions.+ - [MCP](https://hookpulse.net/mcp): use tools/list; no local installation required.+ - [Skill](https://hookpulse.net/skill.md): first request and result checks.+ - [Other operations](https://hookpulse.net/api/): full catalog.+ - [OpenAPI](https://hookpulse.net/openapi.json): schemas.+ - [Also available on PayAPI Market](https://payapi.market/api/hookpulse)

Showing the first 40 of each.

• + backup_monitor
• + website_uptime
• + late_routines
• + cron_setup
• + monitor_history

• + list_plans
• + buy_plan
• + cancel_plan
• + billing
• + pricing
• + get_api_x402_check

https://hookpulse.net/llms.txt

− - Trial: sign up and CONFIRM the e-mail → **7 days** of full access, free. Loop: Sign in at /conta/global for 7 days without usage charges on extra monitors and faster intervals, counted from the account's first use of HookPulse. E-mail alerts on additional monitors remain $0.10 each. Service limits still apply.− Read GET /api/billing before a paid operation. Its gratis field lists options with billing off. If a charge applies, the API returns HTTP 402 with accepts[]. Pay through x402 using USDC on Base, then repeat the same call with X-PAYMENT. E-mail alerts are charged once per additional monitor, even when the address is reused.− - `/skill.md` is the ready-made agent skill (index at `/.well-known/agent-skills/index.json`); `/.well-known/api-catalog` (or `/discovery/resources`) lists every surface; `/mcp` also answers at `/mcp/v1`, and its server card is at `/mcp/server-card`.+ - **Not charging right now**: extra_endpoint, fast_interval. Call it directly — no 402. The price above is the list price and comes back without notice.+ - Trial: sign up and CONFIRM the e-mail → **7 days** of full access, free. Loop: Sign in at /conta/global for 7 days without usage charges on extra monitors and faster intervals, counted from the account's first use of HookPulse. E-mail alerts on additional monitors remain $0.10 each. Service limits still apply. After the trial, alerts from monitors beyond the free ten need a plan (GET /api/plans); the monitors keep checking. When the trial or a plan ends, the account gets one e-mail with the pl+ Read GET /api/billing before a paid operation. Its gratis field lists options with billing off. If a charge applies, the API returns HTTP 402 with accepts[]. Pay through x402 using USDC on Base, then repeat the same call with PAYMENT-SIGNATURE (x402 v2) or X-PAYMENT (v1); a standard x402 client such as @x402/fetch does it for you. E-mail alerts are charged once per additional monitor, even when the address is reused.+ - `/skill.md` is the ready-made agent skill (index at `/.well-known/agent-skills/index.json`); `/.well-known/api-catalog` (or `/discovery/resources`) lists every surface; `/mcp` also answers at `/mcp/v1`, its server card is at `/mcp/server-card`, and `/.well-known/mcp.json` sums up the server (endpoint, auth, logo and tools).

https://hookpulse.net/llms.txt

− > monitor, even when the address is reused. The account's 90-day period does not waive that charge.− - [Postal codes and addresses](https://api.pontofato.com/enderecos/index.json): Find addresses by location, with coordinates and a 2022 reference date. Not a current postal-code certification. State → municipality → locality → street → addresses. [HTML](https://pontofato.com/enderecos/) · [llms.txt](https://api.pontofato.com/enderecos/llms.txt) · [OKF](https://api.pontofato.com/enderecos/okf/index.md)− - [Public procurement](https://api.editalmd.com/licitacoes/index.json): Find public procurement by location and date. View documents and reading options in EditalMD. Procedure → state → year → month → day → municipality → purchases. [HTML](https://editalmd.com/licitacoes/) · [llms.txt](https://api.editalmd.com/licitacoes/llms.txt) · [OKF](https://api.editalmd.com/licitacoes/okf/index.md)− - Trial: sign up and CONFIRM the e-mail → **90 days** of full access, free. Loop: Sign in at /conta/global for 90 days without usage charges on extra monitors and faster intervals, counted from the account's first use of HookPulse. E-mail alerts on additional monitors remain $0.10 each. Service limits still apply.− - [`POST /api/endpoints`](/llms-full.txt?prefix=%2Fapi%2Fendpoints): Creates a dead-man switch: silence beyond the interval becomes an alert. (auth: guest)− - [`GET /api/coletas`](/llms-full.txt?prefix=%2Fapi%2Fcoletas): Lists your measurements with commands adapted to each saved device environment. (auth: none)− - [`POST /api/coletas`](/llms-full.txt?prefix=%2Fapi%2Fcoletas): Adds compatible measurements to a previously detected device. (auth: none)− - [`GET /api/coletas/serie`](/llms-full.txt?prefix=%2Fapi%2Fcoletas%2Fserie): The latest readings of EVERY device you own, in one call. (auth: guest)− - [`GET /api/coletas/:id/serie`](/llms-full.txt?prefix=%2Fapi%2Fcoletas%2F%3Aid%2Fserie): The latest readings of one device, for the screen that draws it. (auth: guest)− - [`PATCH /api/coletas/:id`](/llms-full.txt?prefix=%2Fapi%2Fcoletas%2F%3Aid): Renames one measurement, or stops and resumes reading it. (auth: guest)− - [`DELETE /api/coletas/:id`](/llms-full.txt?prefix=%2Fapi%2Fcoletas%2F%3Aid): Removes one measurement and frees that slot on the device. (auth: guest)− - [`GET /api/ambientes`](/llms-full.txt?prefix=%2Fapi%2Fambientes): Saved environments owned by the current account or guest; empty without a session. (auth: none)− - [`POST /api/ambientes`](/llms-full.txt?prefix=%2Fapi%2Fambientes): Register a device UUID before discovery and collector selection. (auth: none)− - [`GET /api/ambientes/:id`](/llms-full.txt?prefix=%2Fapi%2Fambientes%2F%3Aid): Read the detected environment and compatible measurements. (auth: guest)− - [`POST /api/ambientes/:id/relatorio`](/llms-full.txt?prefix=%2Fapi%2Fambientes%2F%3Aid%2Frelatorio): Preview or save the allowlisted discovery report for one device. (auth: none)− - [`GET /api/ambientes/:id/sonda.sh`](/llms-full.txt?prefix=%2Fapi%2Fambientes%2F%3Aid%2Fsonda.sh): The same identification script, served for people who prefer one short line. (auth: none)− - [`POST /api/ambientes/:id/inputs`](/llms-full.txt?prefix=%2Fapi%2Fambientes%2F%3Aid%2Finputs): Create or rotate an authenticated collector channel for this device. (auth: guest)− - [`GET /api/ambientes/:id/inputs`](/llms-full.txt?prefix=%2Fapi%2Fambientes%2F%3Aid%2Finputs): List this device's collector channels, their state and their live numbers. (auth: guest)− - [`GET /api/ambientes/:id/inputs/:collector/setup`](/llms-full.txt?prefix=%2Fapi%2Fambientes%2F%3Aid%2Finputs%2F%3Acollector%2Fsetup): The saved setup of one collector channel: the configuration in use, its files and steps. (auth: guest)− - [`GET /api/ambientes/:id/inputs/:collector/history`](/llms-full.txt?prefix=%2Fapi%2Fambientes%2F%3Aid%2Finputs%2F%3Acollector%2Fhistory): The batches this collector sent, newest first — filtered and paginated on the server. (auth: guest)− - [`GET /api/ambientes/:id/inputs/:collector/history/:batch`](/llms-full.txt?prefix=%2Fapi%2Fambientes%2F%3Aid%2Finputs%2F%3Acollector%2Fhistory%2F%3Abatch): One received batch, decoded: its series with labels and values, or its NCPA checks. (auth: guest)− - [`DELETE /api/ambientes/:id/inputs/:collector`](/llms-full.txt?prefix=%2Fapi%2Fambientes%2F%3Aid%2Finputs%2F%3Acollector): Revokes and removes one collector channel from a device. (auth: guest)− - [`PATCH /api/ambientes/:id/inputs/:collector`](/llms-full.txt?prefix=%2Fapi%2Fambientes%2F%3Aid%2Finputs%2F%3Acollector): Pauses or resumes one collector channel. (auth: guest)− - [`GET /api/inputs/serie`](/llms-full.txt?prefix=%2Fapi%2Finputs%2Fserie): Every collector channel of the caller, with state and live numbers, in one response. (auth: guest)− - [`PATCH /api/ambientes/:id`](/llms-full.txt?prefix=%2Fapi%2Fambientes%2F%3Aid): Renames a device, and its measurements along with it. (auth: guest)− - [`DELETE /api/ambientes/:id`](/llms-full.txt?prefix=%2Fapi%2Fambientes%2F%3Aid): Removes a device and every measurement on it, in one call. (auth: guest)+ > monitor, even when the address is reused. The account's 7-day trial does not waive that charge.+ - [Postal codes and addresses](https://api.pontofato.com/enderecos/index.json): Find addresses by location, with coordinates and a 2022 reference date. Not a current postal-code certification. Each HTML page opens the product app with its public data already rendered. State → municipality → locality → street → addresses. [HTML](https://pontofato.com/enderecos/) · [llms.txt](https://api.pontofato.com/enderecos/llms.txt) · [OKF](https://api.pontofato.com/enderecos/okf/index.md)+ - [Public procurement](https://api.editalmd.com/licitacoes/index.json): Find public procurement by location and date. View documents and reading options in EditalMD. Each HTML page opens the product app with its public data already rendered. Procedure → state → year → month → day → municipality → purchases. [HTML](https://editalmd.com/licitacoes/) · [llms.txt](https://api.editalmd.com/licitacoes/llms.txt) · [OKF](https://api.editalmd.com/licitacoes/okf/index.md)+ - Trial: sign up and CONFIRM the e-mail → **7 days** of full access, free. Loop: Sign in at /conta/global for 7 days without usage charges on extra monitors and faster intervals, counted from the account's first use of HookPulse. E-mail alerts on additional monitors remain $0.10 each. Service limits still apply.+ - **Sign in (OAuth 2.1):** clients such as claude.ai, ChatGPT, Claude Code and Cursor sign in to your account (`https://hookpulse.net/.well-known/oauth-protected-resource`). The account tools open, and the free limit becomes yours. Connected apps are listed, and can be disconnected, at https://hookpulse.net/conta/global?vista=apps.+ - [`POST /api/endpoints`](/llms-full.txt?prefix=%2Fapi%2Fendpoints): Creates a monitor: a routine that pings us (silence beyond the interval becomes an alert), or with `check` a site we call. (auth: guest)+ - [`POST /api/endpoints/:id/check`](/llms-full.txt?prefix=%2Fapi%2Fendpoints%2F%3Aid%2Fcheck): Checks a site now and returns what it answered. (auth: guest)+ - [`GET /api/sites/estado`](/llms-full.txt?prefix=%2Fapi%2Fsites%2Festado): The state of every site you monitor, with the last check. (auth: guest)+ - [`GET /in/:ingestKey/:slug/:signal`](/llms-full.txt?prefix=%2Fin%2F%3AingestKey%2F%3Aslug%2F%3Asignal): A signal by name: `start`, `fail` or the exit code, for the monitor of that slug. (auth: none)+ - [`POST /api/github/runs`](/llms-full.txt?prefix=%2Fapi%2Fgithub%2Fruns): The GitHub Action's check-in: a scheduled workflow job reports how it ended, with no secret. (auth: github)+ - [`POST /api/github/app/webhook`](/llms-full.txt?prefix=%2Fapi%2Fgithub%2Fapp%2Fwebhook): The HookPulse GitHub App's webhook: scheduled workflow runs of the repositories where it is installed. (auth: github_app)+ - [`GET /api/account/apps`](/llms-full.txt?prefix=%2Fapi%2Faccount%2Fapps): List the apps connected to your account in this product. (auth: session)+ - [`POST /api/account/apps/revoke`](/llms-full.txt?prefix=%2Fapi%2Faccount%2Fapps%2Frevoke): Disconnect an app from your account. (auth: session)+ - [`GET /api/plans`](/llms-full.txt?prefix=%2Fapi%2Fplans): The plans for sale and the authenticated account or wallet's active plan. (auth: none)+ - [`POST /api/plans/:plan`](/llms-full.txt?prefix=%2Fapi%2Fplans%2F%3Aplan): Buys a plan for the account or paying wallet. (auth: none)+ - [`POST /api/plans/cancel`](/llms-full.txt?prefix=%2Fapi%2Fplans%2Fcancel): Cancels the active plan now: the monthly card subscription stops, and a purchase under 7 days is refunded. (auth: session)+ - [`POST /api/plans/:plan/grace`](/llms-full.txt?prefix=%2Fapi%2Fplans%2F%3Aplan%2Fgrace): Takes the free-days offer from the cancellation: the offered plan, free for 7 days, once per account. (auth: session)+ - [`POST /api/credito/asaas/:id/cancelar`](/llms-full.txt?prefix=%2Fapi%2Fcredito%2Fasaas%2F%3Aid%2Fcancelar): Cancels a pending charge when the payment dialog closes. (auth: none)+ - [`POST /api/credito/asaas/:id/cartao`](/llms-full.txt?prefix=%2Fapi%2Fcredito%2Fasaas%2F%3Aid%2Fcartao): Pays a card charge whose card was declined with another card: the same charge, never charged twice. (auth: none)

• + create_site
• + check_site
• + list_sites
• + signal_slug
• − list_environments
• − create_environment
• − get_environment
• − create_device_input
• − list_device_inputs
• − get_device_input_setup
• − list_device_input_history
• − get_device_input_batch
• − delete_device_input
• − set_device_input_active
• − list_input_fleet
• − report_environment
• − list_collections
• − create_collection
• − get_collection_series
• − update_collection
• − delete_collection
• − update_environment
• − delete_environment
• − billing
• − pricing

repository_url

— → https://github.com/wrpbr/hookpulse

version

1.0.0 → 1.0.1

https://hookpulse.net/llms.txt

− > Dead-man switch: you create an endpoint, the cron/webhook pings `/in/:id`.− > If the silence outlasts the interval, it counts as a miss: e-mail and/or an HTTPS POST to `alert_url` (at most 1× / 24h). Main client: AI agents.− > Without paying: a person signs in with an account at `/conta/global` — 90 days without− > the usage paywall, counted from the account's first use of HookPulse (the session is an− > HttpOnly cookie, not a bearer).− Product placements on request, with a suggested price in USD per 30 days, the public numbers next to them and a proposal that reaches the person who answers.− - `GET https://hookpulse.net/api/partners` — placements, suggested price, wallet and the proposal fields.− - [Send a proposal](https://hookpulse.net/partners) — the same offer for people, with the form.− - `GET https://hookpulse.net/okf/parceria.md` — the offer in markdown, to read without parsing JSON.− - [Postal codes and addresses](https://api.pontofato.com/enderecos/index.json): Find addresses by location, with coordinates and a 2022 reference date. Not a current postal-code certification. State → municipality → locality → street → addresses. [HTML](https://api.pontofato.com/enderecos/) · [llms.txt](https://api.pontofato.com/enderecos/llms.txt) · [OKF](https://api.pontofato.com/enderecos/okf/index.md)− - [Public procurement](https://api.editalmd.com/licitacoes/index.json): Find public procurement by location and date. View documents and reading options in EditalMD. Procedure → state → year → month → day → municipality → purchases. [HTML](https://api.editalmd.com/licitacoes/) · [llms.txt](https://api.editalmd.com/licitacoes/llms.txt) · [OKF](https://api.editalmd.com/licitacoes/okf/index.md)− - Trial: sign up and CONFIRM the e-mail → **90 days** of full access, free. Loop: Sign in with your account at /conta/global (browser: e-mail code or link, password or Google) → 90 days without the usage paywall, counted from the account's first use of HookPulse (extra endpoints and fast intervals; e-mail alerts beyond the 1st stay $0.10)− Past the allowance → **402** with `accepts[]` (x402, USDC on Base). Pay and repeat the same call with `X-PAYMENT`.+ > Monitor backups, automations and scheduled tasks.+ > Create a monitor and connect the routine to `/in/:id` for successful check-ins.+ > A missing check-in causes an alert on the next five-minute check.+ > Unresolved alerts repeat daily by default. Set `alert_repeat_sec` for another interval.+ > Read `/api/billing` before paid operations. E-mail alerts are charged per additional+ > monitor, even when the address is reused. The account's 90-day period does not waive that charge.+ Ad spaces with suggested prices in US dollars for 30 days.+ - `GET https://hookpulse.net/api/partners` — ad spaces, suggested price, wallet and the proposal fields.+ - [Send a proposal](https://hookpulse.net/partners) — form to send a proposal.+ - `GET https://hookpulse.net/okf/parceria.md` — the offer in Markdown.+ - [Postal codes and addresses](https://api.pontofato.com/enderecos/index.json): Find addresses by location, with coordinates and a 2022 reference date. Not a current postal-code certification. State → municipality → locality → street → addresses. [HTML](https://pontofato.com/enderecos/) · [llms.txt](https://api.pontofato.com/enderecos/llms.txt) · [OKF](https://api.pontofato.com/enderecos/okf/index.md)+ - [Public procurement](https://api.editalmd.com/licitacoes/index.json): Find public procurement by location and date. View documents and reading options in EditalMD. Procedure → state → year → month → day → municipality → purchases. [HTML](https://editalmd.com/licitacoes/) · [llms.txt](https://api.editalmd.com/licitacoes/llms.txt) · [OKF](https://api.editalmd.com/licitacoes/okf/index.md)+ - Trial: sign up and CONFIRM the e-mail → **90 days** of full access, free. Loop: Sign in at /conta/global for 90 days without usage charges on extra monitors and faster intervals, counted from the account's first use of HookPulse. E-mail alerts on additional monitors remain $0.10 each. Service limits still apply.+ Read GET /api/billing before a paid operation. Its gratis field lists options with billing off. If a charge applies, the API returns HTTP 402 with accepts[]. Pay through x402 using USDC on Base, then repeat the same call with X-PAYMENT. E-mail alerts are charged once per additional monitor, even when the address is reused.+ - [`POST /api/auth/wallet/agent/start`](/llms-full.txt?prefix=%2Fapi%2Fauth%2Fwallet%2Fagent%2Fstart): Start the wallet credential of an agent without an account. (auth: none)+ - [`POST /api/auth/wallet/agent/token`](/llms-full.txt?prefix=%2Fapi%2Fauth%2Fwallet%2Fagent%2Ftoken): Get the wallet credential (mmw_…) of this product. (auth: none)+ - [`POST /api/auth/claim/wallets`](/llms-full.txt?prefix=%2Fapi%2Fauth%2Fclaim%2Fwallets): Move to the account what its wallets did without an account. (auth: session)+ - [`GET /api/credito/asaas/saude`](/llms-full.txt?prefix=%2Fapi%2Fcredito%2Fasaas%2Fsaude): Health of this app's Pix and enabled subscriptions: failures and reasons for the dashboard. (auth: none)