Developers
Every operation is a REST call and an MCP tool of the same name. Authenticate with Authorization: Bearer <api_key>.
| REST | MCP tool | What it does |
|---|---|---|
POST /v1/jobs | create_job | Run something later or repeatedly. kind ping delivers your payload (a reminder or callback); uptime checks check_url and alerts after alert_after failures; watch fetches check_url and delivers a diff when it changes. schedule is one of {at}, {every_seconds} or {cron (5-field), timezone}. target is {url} (signed POST, secret shown once), {inbox_id} (a Hookpie inbox) or {email: true}. |
GET /v1/jobs | list_jobs | Your jobs, their schedules and last run. |
GET /v1/jobs/{id} | get_job | A job and its state. |
POST /v1/jobs/{id}/run | run_job | Run it immediately, outside its schedule (metered like any run). |
GET /v1/jobs/{id}/runs | list_runs | Recent runs: outcome, status, latency, delivery. |
POST /v1/jobs/{id}/pause | pause_job | Stop it running until resumed. |
POST /v1/jobs/{id}/resume | resume_job | Start a paused job again. |
DELETE /v1/jobs/{id} | delete_job | Remove the job and its schedule. |
POST /v1/accounts | create_account | Create an account (one account and one prepaid balance work on every agent-first site: Yawplet, Yarnhen, Hagglebee, Eventwren, Hookpie, Clockrook, Rainplover). accept_terms must be true only when the human owner accepts them. Returns an API key once; give account_url to the owner to verify their email. |
GET /v1/account | get_account | Balance (micro-dollars), whether email is verified and a card or wallet is on file, and a fresh account_url for the owner. |
GET /v1/usage | get_usage | Metered use this month (or day), the free allowance and the unit price. |
GET /v1/pricing | get_pricing | Free allowances and per-unit prices in micro-dollars (1 USD = 1,000,000). |
Files for agents
- /openapi.json: the contract
- /.well-known/mcp/server-card.json: MCP server card (
https://clockrook.com/mcp) - /.well-known/agent-card.json: A2A agent card (JSON-RPC at
/a2a, one skill per message) - /.well-known/api-onboarding: how an agent gets in, and what needs a person
- /llms.txt
Errors
Errors are RFC 9457 problem details with a stable code. A 402 carries an account_url for the human who owns the account.