Get a payment link for Energy
buy_energyGet a payment link to buy Energy packs, only after the customer agrees to the amount (offer the smallest top-up from energy's refill guidance). Nothing is charged by this call: the customer opens checkoutUrl and pays; Energy lands within a minute of payment and lasts twelve months. Recheck the balance with energy after payment before resuming work. A workspace without a saved card is told how to add one, and a Team member's workspace is told the billing owner buys. This never turns on automatic top-up; set_auto_top_up does that with its own consent. Returns packs, energy, usd, checkoutUrl 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": {
"packs": "<packs>"
},
"name": "buy_energy"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| packs | Yes | Packs to buy; each pack is $10 for 75 Energy, or 100 Energy each when buying 5 or more. The billing page offers 1 ($10), 5 ($50), 10 ($100), 25 ($250), 50 ($500). | |
| 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 |
|---|---|---|---|
| usd | Yes | Price in US dollars. | |
| packs | Yes | Packs in the checkout. | |
| action | Yes | Always buy. | |
| energy | Yes | Energy the customer receives after paying. | |
| message | Yes | What to tell the customer; nothing has been charged yet. | |
| checkoutUrl | Yes | Payment link the customer opens to pay; share it as is. |