Show remaining budget as an LED bar
set_quotaDisplay remaining budget on an LED strip, filling the bar proportionally and coloring it green, amber, or red based on quota left. Use for tokens, API balance, or steps.
Instructions
Show how much of a budget is left using the LED count: the bar is filled proportionally to remaining/total and coloured green above 50%, amber between 20% and 50%, red at 20% or less.
Use it for token budgets, API balance, remaining steps and similar.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"remaining": "<remaining>",
"total": "<total>"
},
"name": "set_quota"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| total | Yes | ||
| detail | No | ||
| remaining | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fps | Yes | ||
| port | Yes | ||
| quota | No | (remaining, total) | |
| ratio | No | ||
| state | Yes | ||
| total | No | ||
| zones | No | ||
| agents | No | all agents currently sharing the lamp | |
| detail | Yes | ||
| device | Yes | ||
| animate | Yes | ||
| control | No | 'global' = the whole strip is controlled as one unit, 'per_led' = every LED is written individually | global |
| percent | No | ||
| agent_id | No | id of this agent in the shared registry | |
| progress | No | 0..1 | |
| restored | No | ||
| led_count | Yes | ||
| remaining | No | ||
| brightness | Yes | ||
| last_error | Yes | ||
| active_mode | Yes | ||
| filled_leds | No | ||
| render_mode | No | 'hardware' = the controller animates on its own, 'per_led' = colours are written LED by LED | per_led |
| state_age_s | Yes | ||
| custom_color | Yes | ||
| display_state | No | state currently shown on the lamp (highest priority of all agents) | idle |
| protocol_version | Yes | ||
| animation_running | Yes |