ck_cost_optimizer
Read-onlyIdempotent
Get cost optimization suggestions from recent spending patterns or compare AI provider/model prices for a task to lower costs.
Instructions
Get cost optimization suggestions or compare AI provider/model prices for a task. Read-only — no budget records are written (use ck_budget to record actual spend). Two modes: suggest returns optimization tips based on recent session spending patterns; compare returns a side-by-side price breakdown for the given task. For suggest mode, pass session_id. For compare mode, pass task_description and estimated_tokens along with top_provider and top_model as the baseline. Use ck_cost_optimizer before choosing a model for expensive multi-agent work; use ck_budget to record and enforce spend limits.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | Yes | Operation mode that determines the tool behavior and return shape. | |
| spending | No | ||
| top_model | No | Primary model for cost comparison. | |
| session_id | No | Unique session identifier for correlating findings, proofs, budget, and audit trail. | |
| top_provider | No | Primary provider for cost comparison. | |
| estimated_tokens | No | ||
| task_description | No | Task description for cost estimation. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | ||
| comparisons | No | ||
| suggestions | No |