wait_for_task

Wait for an ongoing MCP Task to complete, fail, or be canceled by specifying a task ID or batch ID. Set timeout and return options to manage monitoring of complex AI workflows effectively.

Instructions

Wait for a task or any task in a batch to complete, fail, or be cancelled. Only waits for tasks that complete AFTER this call is made - ignores tasks that were already completed.

Input Schema

Name	Required	Description
`batch_id`	No	Wait for any task in this batch to complete (required if task_id not provided)
`return_all`	No	For batch_id: return all completed tasks instead of just the first one (default: false)
`task_id`	No	Wait for this specific task to complete (required if batch_id not provided)
`timeout_seconds`	No	Maximum seconds to wait before timing out (default: 300, max: 600)

Input Schema (JSON Schema)

{
  "properties": {
    "batch_id": {
      "description": "Wait for any task in this batch to complete (required if task_id not provided)",
      "type": "string"
    },
    "return_all": {
      "default": false,
      "description": "For batch_id: return all completed tasks instead of just the first one (default: false)",
      "type": "boolean"
    },
    "task_id": {
      "description": "Wait for this specific task to complete (required if batch_id not provided)",
      "type": "string"
    },
    "timeout_seconds": {
      "default": 300,
      "description": "Maximum seconds to wait before timing out (default: 300, max: 600)",
      "maximum": 600,
      "type": "number"
    }
  },
  "required": [],
  "type": "object"
}

MCP Task

wait_for_task

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from MCP Task

Related Tools

MCP directory API