MCP tool

start_agent_run

Start the single active run allowed for a mission, bound immutably to one active mandate version. Omit mandateId to bind the newest active mandate. The run begins in observe phase. Starting it does not execute tools, contact providers or grant authority beyond the bound mandate.

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": "active mission id"
    },
    "mandateId": {
      "description": "specific active mandate; defaults to the newest active version",
      "type": "string",
      "minLength": 1,
      "maxLength": 128
    }
  },
  "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": "POST",
  "path": "/api/v1/agent/missions/{missionId}/runs",
  "pathFields": [
    "missionId"
  ],
  "pathSchema": {
    "type": "object",
    "properties": {
      "missionId": {
        "type": "string",
        "minLength": 1,
        "maxLength": 128,
        "description": "active mission id"
      }
    },
    "additionalProperties": false,
    "required": [
      "missionId"
    ]
  },
  "pathEncoding": "encodeURIComponent for each path field",
  "governedAction": null,
  "headers": {},
  "bodySchema": {
    "type": "object",
    "properties": {
      "mandateId": {
        "description": "specific active mandate; defaults to the newest active version",
        "type": "string",
        "minLength": 1,
        "maxLength": 128
      }
    },
    "additionalProperties": false
  },
  "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": {
    "run": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    }
  },
  "required": [
    "run"
  ],
  "additionalProperties": {}
}

Safety annotations

MCP annotations

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

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