tasks_wait

Melso Agents is available only internally or by private invitation. Agents-specific features require existing access. For the autónomo fiscal service, see Get started.

Wait for a selected Task execution. With Accept: text/event-stream, one call streams until completion or a 600-second limit by default; JSON-only requests wait at most 20 seconds. Zero takes an immediate snapshot. Supply run_id to pin an attempt; automatic retries are followed. Read detailed output with tasks_get. This read-only call does not register a persistent Task watch. Availability: Autónomo / Empresa / Agents invitation. Catalog: Core (tools/list). The live catalog is authoritative: company type, membership, plan, connected apps and execution context can narrow this contract. Understand access.

Input

Agents / Autónomo / Company schema

{
  "additionalProperties": false,
  "properties": {
    "id": {
      "description": "Task UUID or identifier.",
      "type": "string"
    },
    "run_id": {
      "description": "Optional run UUID from create, start, send, or a previous wait's target_run_id.",
      "type": "string"
    },
    "timeout_seconds": {
      "description": "Defaults to 600 seconds with SSE or 20 seconds with JSON-only. Zero is immediate.",
      "maximum": 600,
      "minimum": 0,
      "type": "integer"
    }
  },
  "required": [
    "id"
  ],
  "type": "object"
}

Output

A wake-up result with reason, task_id, target_run_id, task_status, and run_status; observed_run_id and pending_interaction_ids may be present. Timeout is not completion. Streaming waits allow up to 600 seconds; JSON-only clients allow at most 20 seconds. The result uses MCP content blocks; JSON payloads are encoded in text and may also appear in structuredContent. Check isError before reading a success payload. The server does not currently declare an outputSchema, so treat additional fields as extensible. Result handling.

Example

Use an OAuth access token issued for this MCP resource (a Run token for Run-only tools). Replace example identifiers with values from your own account. Write actions change data.

curl --fail-with-body https://melso.ai/api/mcp \
  -H "Authorization: Bearer $MELSO_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  --data-binary @- <<'JSON'
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "tasks_wait",
    "arguments": {
      "id": "11111111-1111-4111-8111-111111111111",
      "timeout_seconds": 0
    }
  }
}
JSON

Connect

Contracts and access

Core tools

Agents and managed-Run tools

Advanced tools

Input

Agents / Autónomo / Company schema

Output

Example

​Input

​Agents / Autónomo / Company schema

​Output

​Example

Input

Agents / Autónomo / Company schema

Output

Example