mcpDeterministic

List handoffs

tools/call

Read the live agent handoff queue (Scout to Researcher, Researcher to ICP, etc). Each row carries fromAgent, toAgent, status, attempts, payload, and timestamps. Stuck or failed handoffs are the #1 silent failure mode of the assembly line.

Parameters

workspaceId

string

Optional workspace ID or slug. Required when this credential can access multiple workspaces and no workspace was configured on the client.

limit

number

Max rows (1-100, default 20).

Example

MCP tools/calljson

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list-handoffs",
    "arguments": {}
  }
}

Response

The operation is available, but its typed response schema has not been published yet.

JSON-RPC errors

-32602: Invalid parameters. Field-level details are returned in the JSON-RPC error data.
-32001: Authentication or hosted AI consent is required.
-32003: Workspace access is denied.
-32029: The request was rate limited.