mcpDeterministic

List agent work orders

tools/call

List Agent Teams work orders that an external coding agent can claim. Each item identifies the current stage, internal role, typed task, status, and revision. Launch and sending stages are excluded because Pipeline Campaign Workflows retain ownership. Read-only.

Parameters

workspaceId

string

Optional with an API key, inferred from the key.

limit

number

Maximum claimable work orders to return, 1 to 50. Defaults to 20.

Example

MCP tools/calljson

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

Response

Success response schemajson schema

{
  "type": "object",
  "properties": {
    "workOrders": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "objective": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "currentStage": {
            "type": [
              "string",
              "null"
            ]
          },
          "role": {
            "type": "string"
          },
          "taskType": {
            "type": "string"
          },
          "revision": {
            "type": "number"
          },
          "updatedAt": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "objective",
          "status",
          "role",
          "taskType",
          "revision",
          "updatedAt"
        ]
      }
    }
  },
  "required": [
    "workOrders"
  ]
}

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.