Top up credits on the saved card
top_up_creditsBuys a credit pack on the workspace's saved card, the card it already paid Hercules with. There is no checkout page. Packs: 200 credits for $24.99; 550 credits for $59.99; 1500 credits for $149.99. Before you call it, confirm the pack and the price with the user, unless the user already told you to top up or to keep credits topped up. It charges only when an owner or admin allowed AI top-ups, and only up to the workspace's monthly cap. When AI top-ups are not allowed yet, it charges nothing and returns a one-click approval link for the user. When no card is saved, it charges nothing and returns a link where the user can buy the pack once.
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": {
"credits": "<credits>"
},
"name": "top_up_credits"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| credits | Yes | How many credits to buy. Must be one of the credit pack sizes. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| status | Yes | ||
| balance | Yes | ||
| credits | Yes | ||
| currency | Yes | ||
| expiresAt | Yes | ||
| amountCents | Yes | ||
| approvalUrl | Yes | ||
| monthlyCapCents | Yes | ||
| spentThisMonthCents | Yes |