Get total tool-call cost and call count for the current day (UTC). Returns a human-readable summary plus structured data.

Returns calls used this month, plan limit, percentage used, and a projection for the rest of the month based on the current daily average. Use this to spot when an org is about to hit the cap.

Top tools by total cost over the past N days. Optionally limit how many entries to return. Useful for finding "what is the most expensive thing my agents do".

Recent agent sessions (each MCP-client process start = one session) with model, total cost, tool call count, and duration.

Drill into a single session by ID: returns the session summary plus every tool call (up to 500) with timing, cost, and success.

Estimate the USD cost of an MCP tool call BEFORE invoking it. Returns expected cost based on the historical average for this (server, tool, model) combo in this org over the last 30 days. Use this to make spend-aware decisions — e.g. confirm with the user before calling tools that would cost more than $0.10. Returns 0 + isUnknown=true when no history exists yet.