tokmeter_budget
Check AI coding spend against daily, weekly, or monthly budgets, optionally scoped to a project or providers. Get spent, remaining, percent used, status, progress bar, and end-of-period projections.
Instructions
Check spend against one or more budgets you pass in (daily, weekly = rolling last 7 days, monthly = calendar month), optionally for one project or a set of providers. For each budget: spent, remaining, percent used with a status, and a progress bar; weekly and monthly also project to the end of the period at the average daily rate so far. Use it for a scoped budget question ("is project X on track this month?"); for a whole-account red/yellow/green status with hours left at the current hourly burn, use tokmeter_budget_alert. Nothing is stored: budgets live only in the call.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "tokmeter_budget"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| project | No | Filter by project name/path substring | |
| providers | No | Filter to specific providers (e.g. ['claude-code','cursor']) | |
| daily_budget | No | Daily budget in USD | |
| weekly_budget | No | Weekly budget in USD | |
| monthly_budget | No | Monthly budget in USD |