MCP tool

list_agent_runs

List tenant-scoped runs for one mission newest first, including their bound mandate and durable control-record counts. Filter by state when looking for work waiting on approval or blocked by an exception.

Input

Pass fields from this schema as the tool arguments. Runtime ownership, product scope and readiness checks still apply.

Input JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "missionId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128,
      "description": "owning mission id"
    },
    "status": {
      "type": "string",
      "enum": [
        "running",
        "waiting_approval",
        "blocked",
        "succeeded",
        "failed",
        "cancelled"
      ]
    },
    "limit": {
      "description": "page size; API default 50",
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    },
    "offset": {
      "description": "rows to skip; API default 0",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "missionId"
  ]
}

REST mapping and authority

The tool wraps this REST endpoint. The mapping identifies path/query/body transformations and approval or idempotency headers.

Request contract

{
  "method": "GET",
  "path": "/api/v1/agent/missions/{missionId}/runs",
  "pathFields": [
    "missionId"
  ],
  "pathSchema": {
    "type": "object",
    "properties": {
      "missionId": {
        "type": "string",
        "minLength": 1,
        "maxLength": 128,
        "description": "owning mission id"
      }
    },
    "additionalProperties": false,
    "required": [
      "missionId"
    ]
  },
  "pathEncoding": "encodeURIComponent for each path field",
  "governedAction": null,
  "headers": {},
  "querySchema": {
    "type": "object",
    "properties": {
      "status": {
        "type": "string",
        "enum": [
          "running",
          "waiting_approval",
          "blocked",
          "succeeded",
          "failed",
          "cancelled"
        ]
      },
      "limit": {
        "description": "page size; API default 50",
        "type": "integer",
        "minimum": 1,
        "maximum": 200
      },
      "offset": {
        "description": "rows to skip; API default 0",
        "type": "integer",
        "minimum": 0,
        "maximum": 9007199254740991
      }
    },
    "additionalProperties": false
  },
  "queryEncoding": "URLSearchParams; omit undefined fields, stringify supplied values",
  "responseMapping": "REST JSON is returned as MCP structuredContent and a compatibility text block; privacy-sensitive tools validate their output schema."
}

Output

This is the registered MCP output envelope. Nested fields are only modeled where the schema explicitly defines them.

Output JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "runs": {
      "type": "array",
      "items": {}
    }
  },
  "required": [
    "runs"
  ],
  "additionalProperties": {}
}

Safety annotations

MCP annotations

{
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": false,
  "openWorldHint": false
}

Annotations help a client present the tool. The API independently enforces authorization and exact action approvals. Error and retry guidance →