Returns token totals and USD cost estimates for the current session. Read-only.
Returns per-tool cost breakdown for the session, sorted by cost descending. Read-only.
Start a new cost-tracking session. Previous session data is retained in history.
Record token usage for a tool call. Takes `tool_name`, `model` (optional), `input_tokens`, and `output_tokens`. Emits a budget warning notification if 80% of threshold is reached.
Set a budget threshold in USD (`threshold_usd`). Warns at 80% and 100% of the threshold. Use with `--enforce-budget` to block calls beyond the limit.
Heuristic model recommendation by task type. Takes `task_description` and optional `constraints.max_cost_usd`. Returns recommended model with reasoning and estimated cost.
Check whether a model is allowed for a given task type under the routing policy. Takes `task_type` and `model`.
Query historical spend aggregated by `period` (`day`/`week`/`month`). Returns breakdown by model and tool. Read-only.
Pre-run cost estimation for a multi-step workflow. Takes a `steps` array with `tool_name`, `estimated_input_tokens`, `estimated_output_tokens`, and optional `model`. Read-only.
Generate a single-file HTML spend report with session breakdown, historical spend, model cost comparison, and budget status. Read-only.
Export the audit log of budget enforcement decisions. Accepts optional `from_date`, `to_date`, and `format` (`json`/`csv`). Read-only.
Create or update a project with an optional `budget_usd`. Takes `project_name`.
+3 more tools listed on main page