402cron

Measured conclusion: Alive, not deep-tested. L2 outcome: not_attempted.

Paid cron for AI agents: we call your https URL on schedule, signed. No account, paid with x402.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "402cron": {
      "url": "https://402cron.com/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (16)

• get_pricing read-only

  What a delivery costs, which packs exist, and the exact x402 payment requirements for each. Balance is counted in DELIVERIES, not money, and packs never expire. Call this before buying.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_docs read-only

  One section of the machine documentation: quickstart, headers, signature, notice, errors, billing or limits. Omit `section` to get the whole document.

  Parameters:

  • section — string — Which section to return. Omit for all of it.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_service_status read-only

  Whether the service is currently selling, on which network, and if not — why not. This is configuration, not liveness: the full health endpoint is at /health.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• list_tasks read-only

  Your tasks and their state. Needs your management token as an Authorization header on this connection.

  Parameters:

  • after — string — Cursor from a previous page.
  • limit — integer — How many to return.
  • state — string — Filter by state: live (default), all, or one exact state such as active or paused_by_client.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_task read-only

  A single task: schedule, destination, state, next run, and how many failures in a row it carries.

  Parameters:

  • id (required) — string — Task id (UUID), as returned by create_task or list_tasks.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• create_task destructive

  Register a schedule against a destination you have already verified. Idempotent on "name": the same name updates the existing task instead of creating a second one. Creating costs nothing; each delivery ATTEMPT costs one credit.

  Parameters:

  • name (required) — string — Your name for the task. Unique among your live tasks; creating with an existing name updates it.
  • cron (required) — string — 5 fields, UTC only, one minute at the finest. Operators: * a-b a,b */n a-b/n. Names: SUN-SAT (day), JAN-DEC (month). Macros: @yearly @annually @monthly @weekly @daily @midnight @hourly. Day-of-week is 0-6 with 0 = Sunday; 7 also means Sunday. Write days as names (MON-FRI). Numbers differ between schedulers: Quartz, AWS EventBridge and Cloudflare number Sunday as 1, we and croniter as 0. Translated for you: "?". "?" as a whole day-of-month or day-of-week field becomes "*". A NUMERIC day-of-week next to "?" is refused, because "?" means the expression was written where Sunday is 1. Refused: Quartz L, Quartz W, Quartz #, six fields (seconds), seven fields (year), @reboot, @every, CRON_TZ= prefixes, time zones of any kind — each with a code saying what to send instead.
  • url (required) — string — The https:// destination. It must already be registered and verified — see register_destination.
  • body — The body we send. Stored in the clear, so it must not carry credentials. A non-string is serialized as JSON.
  • method — string — HTTP method of the delivery. Default POST. GET and HEAD carry no body.
  • headers — object — Headers we send with the delivery. Stored ENCRYPTED at rest — put credentials here, never in the body.
  • timeoutMs — integer — How long we wait for your server, 250-2000 ms. Answer 202 and do the work behind it.

  Hints: read-only no · destructive yes · idempotent yes · open-world yes

• update_task destructive

  Change the schedule, destination, method, timeout, headers or body of an existing task. Omit a field to leave it unchanged — sending null is refused, because "unchanged" and "cleared" must not look the same. State is NOT editable here: use pause_task and resume_task.

  Parameters:

  • id (required) — string — Task id (UUID), as returned by create_task or list_tasks.
  • url — string — The https:// destination. It must already be registered and verified — see register_destination.
  • body — The body we send. Stored in the clear, so it must not carry credentials. A non-string is serialized as JSON.
  • cron — string — 5 fields, UTC only, one minute at the finest. Operators: * a-b a,b */n a-b/n. Names: SUN-SAT (day), JAN-DEC (month). Macros: @yearly @annually @monthly @weekly @daily @midnight @hourly. Day-of-week is 0-6 with 0 = Sunday; 7 also means Sunday. Write days as names (MON-FRI). Numbers differ between schedulers: Quartz, AWS EventBridge and Cloudflare number Sunday as 1, we and croniter as 0. Translated for you: "?". "?" as a whole day-of-month or day-of-week field becomes "*". A NUMERIC day-of-week next to "?" is refused, because "?" means the expression was written where Sunday is 1. Refused: Quartz L, Quartz W, Quartz #, six fields (seconds), seven fields (year), @reboot, @every, CRON_TZ= prefixes, time zones of any kind — each with a code saying what to send instead.
  • name — string — Your name for the task. Unique among your live tasks; creating with an existing name updates it.
  • method — string — HTTP method of the delivery. Default POST. GET and HEAD carry no body.
  • headers — object — Headers we send with the delivery. Stored ENCRYPTED at rest — put credentials here, never in the body.
  • timeoutMs — integer — How long we wait for your server, 250-2000 ms. Answer 202 and do the work behind it.

  Hints: read-only no · destructive yes · idempotent yes · open-world yes

• pause_task destructive

  Stop firing until you resume. Nothing is charged while a task is paused.

  Parameters:

  • id (required) — string — Task id (UUID), as returned by create_task or list_tasks.

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• resume_task destructive

  Start firing again on the schedule. Refused if your balance is empty — buy deliveries first.

  Parameters:

  • id (required) — string — Task id (UUID), as returned by create_task or list_tasks.

  Hints: read-only no · destructive yes · idempotent yes · open-world yes

• run_task_now destructive

  Deliver immediately, outside the schedule. THIS COSTS ONE CREDIT per attempt, exactly like a scheduled firing, and a timeout or unreachable host is retried up to three times — so one call can cost up to three credits. Use it to test a destination.

  Parameters:

  • id (required) — string — Task id (UUID), as returned by create_task or list_tasks.

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• delete_task destructive

  Move the task to the recycle bin. It stops firing immediately and can be restored for 30 days with restore_task; after that it is unrecoverable. Credits already spent are not refunded.

  Parameters:

  • id (required) — string — Task id (UUID), as returned by create_task or list_tasks.

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• restore_task

  Bring a task back from the recycle bin within 30 days. It comes back PAUSED — resume it explicitly.

  Parameters:

  • id (required) — string — Task id (UUID), as returned by create_task or list_tasks.

  Hints: read-only no · destructive no · idempotent yes · open-world no

• register_destination destructive

  Claim an https:// URL you control. We answer with a challenge and a SIGNING SECRET that is shown ONCE and never again — store it before you do anything else; it is what lets you verify that a delivery really came from us. The permission covers that path and everything beneath it, nothing above. Verification is one request from us to the exact URL you registered: POST, headers X-402cron-Challenge: <value> and X-402cron-Event: verify, JSON body {"challenge":"<value>"}. Reply within 5 seconds, without a redirect, with a body that is the bare value or {"challenge":"<value>"}; we read the first 512 bytes and do not check the HTTP status (2xx is fine). Then call POST /api/destinations/{id}/verify within 15 minutes of registering. A fixed-response webhook cannot pass: you need an endpoint you can program. Registering a URL that is still pending issues a new challenge and a new signing secret every time — the old secret immediately stops verifying deliveries; a verified URL is left untouched unless you add ?rotate=1. The daily verification allowance (10 per destination, 40 per client, UTC day) does not reset on re-registration.

  Parameters:

  • url (required) — string — The https:// URL you control.

  Hints: read-only no · destructive yes · idempotent no · open-world no

• verify_destination

  Verification is one request from us to the exact URL you registered: POST, headers X-402cron-Challenge: <value> and X-402cron-Event: verify, JSON body {"challenge":"<value>"}. Reply within 5 seconds, without a redirect, with a body that is the bare value or {"challenge":"<value>"}; we read the first 512 bytes and do not check the HTTP status (2xx is fine). Then call POST /api/destinations/{id}/verify within 15 minutes of registering. A fixed-response webhook cannot pass: you need an endpoint you can program. Registering a URL that is still pending issues a new challenge and a new signing secret every time — the old secret immediately stops verifying deliveries; a verified URL is left untouched unless you add ?rotate=1. The daily verification allowance (10 per destination, 40 per client, UTC day) does not reset on re-registration. Until this passes, no task may point at the destination.

  Parameters:

  • id (required) — integer — Destination id, as returned by register_destination.

  Hints: read-only no · destructive no · idempotent no · open-world yes

• list_destinations read-only

  The URLs you have claimed and whether each is verified. The signing secrets are never shown again.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• delete_destination destructive

  Remove a claimed URL. Refused while a task still points at it — delete the task first.

  Parameters:

  • id (required) — integer — Destination id, as returned by register_destination.

  Hints: read-only no · destructive yes · idempotent yes · open-world no

Publisher website Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.