mcpDeterministic

Claim agent chat turn

tools/call

Claim an external Agent Teams chat turn for ten minutes. Returns the addressed role, user input, saved history, selected skill, constraints and claimToken. Use your current coding-agent model, not Pipeline hosted inference. The UI shows this turn as running. Claims are principal/workspace scoped and cannot claim hosted turns.

Parameters

workspaceId

string

No description.

actionrequired

string

No description.

turnIdrequired

string

No description.

Example

MCP tools/calljson

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "claim-agent-chat-turn",
    "arguments": {
      "action": "external_claim",
      "turnId": "00000000-0000-4000-8000-000000000000"
    }
  }
}

Response

Success response schemajson schema

{
  "type": "object",
  "properties": {
    "turnId": {
      "type": "string"
    },
    "conversationId": {
      "type": "string"
    },
    "claimToken": {
      "type": "string"
    },
    "leaseExpiresAt": {
      "type": "string"
    },
    "executionMode": {
      "type": "string",
      "enum": [
        "external_agent"
      ]
    },
    "role": {
      "type": "string"
    },
    "roleDescription": {
      "type": "string"
    },
    "instructions": {
      "type": "string"
    },
    "surfaceContext": {
      "type": [
        "object",
        "null"
      ]
    },
    "input": {
      "type": "object"
    },
    "history": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "selectedSkill": {
      "type": [
        "object",
        "null"
      ]
    },
    "delegatedResults": {
      "type": "array",
      "items": {
        "type": "object"
      }
    }
  },
  "required": [
    "turnId",
    "conversationId",
    "claimToken",
    "leaseExpiresAt",
    "executionMode",
    "role",
    "roleDescription",
    "instructions",
    "surfaceContext",
    "input",
    "history",
    "selectedSkill",
    "delegatedResults"
  ]
}

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.