Agents / MCP

Get agent spend

LLM spend for the agent assembly line. Default returns per-role spend aggregated over a period. Pass role to get a per-run audit trail for that one agent. Period defaults to 24h.

tools/callDeterministic operation

Parameters

workspaceIdOptional · string
Optional workspace ID or slug. Required when this credential can access multiple workspaces and no workspace was configured on the client.
periodOptional · string
Default 24h.24h · 7d · 30d
roleOptional · string
Pass to drill into one agent. Omit for per-role aggregate.scout · researcher · icp · writer · closer · coach
Request example
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get-agent-spend",
    "arguments": {}
  }
}
Full input schema
Input schema
{
  "type": "object",
  "properties": {
    "workspaceId": {
      "type": "string",
      "minLength": 1,
      "description": "Optional workspace ID or slug. Required when this credential can access multiple workspaces and no workspace was configured on the client."
    },
    "period": {
      "type": "string",
      "enum": [
        "24h",
        "7d",
        "30d"
      ],
      "description": "Default 24h."
    },
    "role": {
      "type": "string",
      "enum": [
        "scout",
        "researcher",
        "icp",
        "writer",
        "closer",
        "coach"
      ],
      "description": "Pass to drill into one agent. Omit for per-role aggregate."
    }
  }
}
See this operation inCLI REST API TypeScript SDK
MCP reference | Pipeline v2 preview