Cron Next Runs
List the next N executions of a cron expression with exact timestamps — from now or from any reference datetime. Complements cron-describe (which explains what an expression means) with the concrete schedule agents need when scheduling their own work.
Worked examples
Every 15 min, business hours
GET /api/v1/dev/cron-next-runs?cron=*%2F15%209-17%20*%20*%20MON-FRI&count=5
Result: Next run: 2026-10-19T09:00:00.000Z
Daily noon from a fixed date
GET /api/v1/dev/cron-next-runs?cron=0%2012%20*%20*%20*&count=3&fromIso=2026-01-01T00%3A00%3A00Z
Result: Next run: 2026-01-01T12:00:00.000Z
Monthly on the 1st
GET /api/v1/dev/cron-next-runs?cron=0%206%201%20*%20*&count=4
Result: Next run: 2026-11-01T06:00:00.000Z
Machine API (x402)
$0.002 / callThis tool is also a JSON API for AI agents. Requests without payment receive 402 Payment Required plus instructions; agents pay USDC on Base via the x402 protocol — no accounts, no API keys.
GET /api/v1/dev/cron-next-runs?cron=*%2F15%209-17%20*%20*%20MON-FRI&count=5 HTTP/1.1
Host: agentstoolshub.com
→ 402 (payment required, instructions in headers)
→ 200 (after X-PAYMENT header; JSON body below)
{
"tool": "dev/cron-next-runs",
"input": {"cron":"*/15 9-17 * * MON-FRI","count":5},
"result": { "value": 5, "answer": "Next run: 2026-10-19T09:00:00.000Z" }
}Agent docs: /llms.txt · OpenAPI spec · integration guide
About this tool
Concrete upcoming fire times for any 5-field cron expression, optionally counted from a reference datetime instead of now (which makes results fully deterministic and testable). The exact answer to 'when does this job actually run next?' — including DST-safe handling via cron-parser.
Frequently asked questions
What cron syntax is supported?
Standard 5-field expressions (minute hour day month day-of-week) including lists, ranges, steps and day names like MON-FRI. Seconds-field crons are not part of the 5-field standard.
Why offer a 'from' datetime?
Relative-to-now answers change every second; counting from a fixed reference makes schedules reproducible — essential when an agent plans around a job or writes a test.