Commerce
chargeWallet
Charge Wallet
Pay for something with a card in the user's own Cloud Wallet, inside the spending dial they set.
Ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "pay for it with my card", and it calls chargeWallet.
Example call
The MCP tools/call params, with the required arguments only.
{
"arguments": {
"amount": 1,
"category": "<category>",
"currency": "<currency>",
"idempotencyKey": "<idempotencyKey>",
"merchant": "<merchant>",
"purpose": "<purpose>",
"walletCardId": "<walletCardId>"
},
"name": "chargeWallet"
}Arguments
agentLabelstringoptionalHow you are named to the user on the receipt. Defaults to Ora.amountnumberrequiredThe FULL amount to charge, counting tax and fees, in whole currency units.approvalIdstringoptionalThe approval id from requestPurchaseApproval when the charge is above the dial, always-ask is on, or the wallet is live.categorystringrequiredThe kind of purchase. Anything you cannot classify is other.currencystringrequiredISO currency code (e.g. USD).idempotencyKeystringrequiredYour own key for THIS charge. Reuse it on a retry; a new charge gets a new key.merchantstringrequiredWho is being paid, as the user would name them.merchantProcessorstringoptionalOnly when the merchant is its own processor and takes the card token directly (e.g. a travel API). Omit to charge through Stripe.purposestringrequiredWhat it buys, in one plain line the receipt will show.taskIdstringoptionalThe Cloud task this spend serves, so the receipt links to it.walletCardIdstringrequiredThe card's id from listWalletCards. Never a card number.
Returns
Within the dial (at or under the ask line, inside the per-purchase and daily limits, in an allowed category, and with ask-before-every-purchase switched off) the charge runs and returns a receipt.
Declared limits
amount: greater than 0currency: minimum length 3currency: maximum length 3idempotencyKey: minimum length 1
Ask for it
The Cloud routes these requests to this verb.
- pay for it with my card
- book it on my card
- charge my wallet
- buy the domain
Pair it with
The verbs that finish the job.
Questions
What does chargeWallet do?
Pay for something with a card in the user's own Cloud Wallet, inside the spending dial they set. It is one of the tools The Cloud MCP server gives every connected AI.
How do I use chargeWallet from Claude or ChatGPT?
Connect your AI to The Cloud at https://mcp.thecloud.so/mcp and sign in once. Then ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "pay for it with my card", and it calls chargeWallet.
Is chargeWallet safe to let an AI call?
chargeWallet deletes or sends, and calling it again does not undo it, so a careful client confirms with you before it runs. It reaches a system outside The Cloud on your behalf.
Connect
One endpoint gives your AI this tool and every other one: connect Claude, ChatGPT, Cursor or Gemini, read what The Cloud is, or see pricing.