Agents / MCP

List handoffs

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.

tools/callDeterministic operation

Parameters

workspaceIdOptional · string
Optional workspace ID or slug. Required when this credential can access multiple workspaces and no workspace was configured on the client.
limitOptional · number
Max rows (1-100, default 20).
Request example
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list-handoffs",
    "arguments": {}
  }
}
Full input schema
Input schema
{
  "type": "object",
  "properties": {
    "workspaceId": {
      "type": "string",
      "minLength": 1,
      "description": "Optional workspace ID or slug. Required when this credential can access multiple workspaces and no workspace was configured on the client."
    },
    "limit": {
      "type": "number",
      "description": "Max rows (1-100, default 20)."
    }
  }
}
See this operation inCLI REST API TypeScript SDK
Tool directory | Pipeline v2 preview