Turn automatic Energy top-up on or off
set_auto_top_upTurn automatic top-up on or off. Turning it on authorizes future recurring charges to the subscription's saved card ($10 for 75 Energy whenever the balance falls below 50), so call it with enabled=true only after explaining the amount, threshold and recurring charges and getting the customer's explicit yes to those terms; a request to continue work or to buy one pack is not consent. Bring it up only when the customer asks how to avoid running out. enabled=false turns it off at once. A Team member's workspace is told the billing owner manages it, and one without a subscription card is told to add one. Charges nothing now. Returns whether top-up is on, the terms that apply and a message to relay.
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": {
"enabled": "<enabled>"
},
"name": "set_auto_top_up"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| enabled | Yes | true turns automatic top-up on with the customer's explicit consent to recurring charges; false turns it off. | |
| workspaceId | No | A teammate's workspace you may manage: an active workspace ID from list_team_workspaces. Omit for your own workspace. Supply on every call for a teammate. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | Yes | Always auto_top_up. | |
| consent | Yes | The recurring-charge terms the customer agreed to, or null when top-up is off. | |
| enabled | Yes | Whether automatic top-up is on after this call. | |
| message | Yes | What to tell the customer. |