Skip to main content
Sets a spending budget that the spend gate enforces before any checkout mints a card. Use it to cap how much an agent can spend per day, week, month, or in total.
Not advertised in tools/list by default — the buy tool covers this conversationally. Expert integrations can still call it by name.

​
Parameters

ParameterTypeRequiredDescription
periodstringYesOne of daily, weekly, monthly, or total
limit_centsnumberYesBudget cap in cents
timezonestringNoIANA timezone for window boundaries (default UTC)

​
Returns

A confirmation with the cap in dollars, the period, and the timezone it applies in, for example “Budget set: $100.00 per weekly (UTC)”. Failures return a short error message.

​
Example

{ "name": "buy_set_budget", "arguments": { "period": "weekly", "limit_cents": 10000 } }