mcpDeterministic

Get agent run

tools/call

Drill into a specific agent run: full input/output summary plus every tool call (agent_run_steps) with its arguments, output, duration, and tokens. Use for debugging or auditing what an agent actually did. Read-only.

Parameters

workspaceId

string

Optional workspace ID or slug. Required when this credential can access multiple workspaces and no workspace was configured on the client.

runIdrequired

string

No description.

Example

MCP tools/calljson

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get-agent-run",
    "arguments": {
      "runId": "00000000-0000-4000-8000-000000000000"
    }
  }
}

Response

Success response schemajson schema

{
  "type": "object",
  "properties": {
    "run": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "workspaceId": {
          "type": "string"
        },
        "agentRole": {
          "type": "string"
        },
        "status": {
          "type": "string"
        },
        "trigger": {
          "type": "string"
        },
        "startedAt": {
          "type": "string"
        },
        "endedAt": {
          "type": "string"
        },
        "tokensUsed": {
          "type": "number"
        },
        "toolCalls": {
          "type": "number"
        },
        "costCents": {
          "type": "number"
        },
        "summary": {
          "type": "string"
        },
        "error": {
          "type": "string"
        },
        "skillProvenance": {
          "type": [
            "object",
            "null"
          ]
        },
        "createdAt": {
          "type": "string"
        }
      },
      "required": [
        "id",
        "workspaceId",
        "agentRole",
        "status",
        "trigger"
      ]
    },
    "steps": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "agentRunId": {
            "type": "string"
          },
          "stepIndex": {
            "type": "number"
          },
          "toolName": {
            "type": "string"
          },
          "tokensIn": {
            "type": "number"
          },
          "tokensOut": {
            "type": "number"
          },
          "costCents": {
            "type": "number"
          },
          "durationMs": {
            "type": "number"
          },
          "status": {
            "type": "string"
          },
          "error": {
            "type": "string"
          },
          "createdAt": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "agentRunId",
          "stepIndex",
          "toolName",
          "status"
        ]
      }
    }
  },
  "required": [
    "run",
    "steps"
  ]
}

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.