MCP 2025-06-18

session_complete

Complete or cancel the current agent session. When completing after receiving human instructions, include every processed instruction ID; explicit acknowledgements prevent completion while any instruction is still waiting. Older clients may omit this field, and any remaining instructions will close visibly as unacknowledged.

Input schema

This schema is shared with tools/list. The server also verifies current scopes and resource-level access before returning data or changing a record.

Synthetic example · JSON

{
  "type": "object",
  "properties": {
    "sessionId": {
      "type": "string",
      "description": "Session ID"
    },
    "status": {
      "enum": [
        "completed",
        "canceled"
      ]
    },
    "summary": {
      "type": "string",
      "description": "Completion summary"
    },
    "acknowledgedInstructionIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Every pending human instruction ID received and processed by this agent."
    },
    "requestReview": {
      "type": "boolean",
      "description": "Ask a person to review this work when completing. Leave it off when nothing needs a person's check; sessions are never put in review otherwise."
    },
    "idempotencyKey": {
      "type": "string",
      "description": "Unique retry key"
    }
  },
  "required": [
    "sessionId",
    "idempotencyKey"
  ],
  "additionalProperties": false
}

Call this tool

Use the tool name below in params.name. Supply the exact arguments described above; this envelope deliberately leaves required resource values for your authorized context.

Synthetic example · JSON

{
  "jsonrpc": "2.0",
  "id": "example_request",
  "method": "tools/call",
  "params": {
    "name": "session_complete",
    "arguments": {}
  }
}

Read the result before continuing

Inspect protocol errors and the tool result’s isError flag. A request being accepted is not proof of an external action completing. Preserve correlation IDs and unchanged mutation idempotency keys across safe retries.