wait_seconds
Pause execution for a specified number of seconds to pace polling against long-running tasks, preventing excessive API calls while waiting for job or pipeline completion.
Instructions
Sleep for a fixed number of seconds, then return. Use this to pace polling against long-running platform work (most often get_pipeline_status after run_tap, or get_job_status after upload_data) so you do not burn tool calls hammering an endpoint that is still in progress. ALWAYS poll once BEFORE the first wait — many runs finish in 1–5 seconds. Then use exponential backoff between polls: 5s, 10s, 20s, 30s, 60s, 60s, ... (cap at 60s normally, 120s only if the run is genuinely glacial). Reset to a short wait (5–15s) on the next cycle whenever a poll shows new jobs flipped to a terminal state — that means you're close to done. If 80%+ of jobs are terminal, wait ~15s; if only 1–2 jobs remain, wait ~10s. Hard upper bound is 120 seconds per call — for longer waits, call this tool in a loop interleaved with a status check.
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": {
"seconds": "<seconds>"
},
"name": "wait_seconds"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| seconds | Yes | How long to sleep, in seconds. Range: 1–120. Values outside this range are clamped. |