Explain a schedule
cron_explain_scheduleDecode a cron expression into plain English, list upcoming run times in a time zone, and surface scheduling warnings so you can read or preview a schedule before using it.
Instructions
Decode a cron expression into a plain-English description, its next count run times as ISO timestamps in tz, and advisory warnings from the server's scheduling engine. Use it to read an expression or preview its runs; use cron_validate_schedule for the check before saving, or cron_why_no_run to test an existing job at a timestamp.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"expression": "<expression>"
},
"name": "cron_explain_schedule"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tz | No | IANA time zone to compute the runs in. Pass the job's zone. Defaults to UTC. | |
| seed | No | Name of the job that will use the expression, which resolves Jenkins-style H fields to that job's slot. For a workflow's schedule, use dag:<name>. Required when the expression uses H. | |
| count | No | Upcoming runs to list. | |
| expression | Yes | Cron expression, such as 0 3 * * 1-5. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lint | No | ||
| seed | No | ||
| error | No | ||
| fires | No | ||
| valid | Yes | ||
| reboot | No | ||
| resolved | No | ||
| timezone | Yes | ||
| expression | Yes | ||
| normalized | No | ||
| description | No | ||
| never_fires | No |