Schedule Callback
timer_scheduleSchedule a durable callback: at fire time this service POSTs your JSON payload to your URL. Use it to wake up future runs of yourself or your orchestrator - agents cannot wake themselves. Prerequisite: the target origin must already pass timer_verify_origin, which requires an HTTPS endpoint you control that echoes a token - without your own endpoint this tool cannot be used. Delay 10s-30d, payload max 8192 bytes, 3 delivery attempts with backoff. Returns an id that doubles as the capability to inspect and cancel the timer; hold it privately.
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": {
"url": "<url>"
},
"name": "timer_schedule"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | https URL to POST to. The origin must already be verified. | |
| fire_at | No | Absolute ISO 8601 fire time. Provide this OR delay_seconds. | |
| payload | No | JSON string delivered as the request body. Default "{}". | |
| delay_seconds | No | Fire after this many seconds. Provide this OR fire_at. |