1. Docs
2. /
3. Tool reference
4. /
5. Commerce
6. /
7. requestPurchaseApproval

Commerce

requestPurchaseApproval

Request Purchase Approval

Show the user one exact order and ask them to approve it.

write

Ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "order it", and it calls requestPurchaseApproval.

Example call

The MCP tools/call params, with the required arguments only.

{
  "arguments": {
    "purchaseId": "<purchaseId>"
  },
  "name": "requestPurchaseApproval"
}

Arguments

• agentLabelstringoptionalHow you are named to the user on the card, in their words (e.g. "Ora", "shopping assistant"). Defaults to Ora.
• currencystringoptionalISO currency code the total is priced in (e.g. USD). Required for an order.
• deliveryEstimatestringoptionalWhen the merchant says it arrives, in the merchant's own words (e.g. "arrives Tue, Sep 9").
• itemstringoptionalWhat is being bought, named as the user would.
• maskedDestinationstringoptionalWhere it ships, ALREADY MASKED (e.g. "home address ending 4821"). Never a full street address.
• merchantstringoptionalWho is selling it.
• merchantOriginstringoptionalThe verified HTTPS origin of the merchant page, with no path.
• paymentMethodstringoptionalThe card or account as the user would recognize it (e.g. "Visa ending 4242"). Never a number or a token.
• purchaseIdstringrequiredYour own id for this purchase, the same one you reserved the spend against. One purchase, one approval.
• quantityintegeroptionalHow many.
• recurringCommitmentstringoptionalSay plainly what repeats and how often if saying yes signs the user up for a repeating charge (e.g. "$29.99 every month until cancelled"). Leave out for a one-time purchase.
• returnTermsstringoptionalWhat happens if the user sends it back, in plain words (e.g. "free returns within 30 days").
• totalnumberoptionalThe FULL total the user would pay, counting tax, shipping and fees, in whole currency units.
• variantstringoptionalThe specific version being bought (e.g. "Medium, navy"). Leave out only when the item has no variants.
• walletChargeobjectoptionalTHE WALLET SHAPE: ask the user to approve one charge to a card in their Cloud Wallet before chargeWallet runs it. When given, leave the order fields out.

Returns

Give every field honestly and completely, because the approval is bound to this exact version of the order: change the seller, the item, the quantity, the price, the delivery estimate, the address,…

Declared limits

• currency: minimum length 3
• currency: maximum length 3
• quantity: greater than 0
• quantity: maximum 9007199254740991
• total: greater than 0

Ask for it

The Cloud routes these requests to this verb.

• order it
• buy that one
• get me the blue one in medium
• yes find me that and order it

Pair it with

The verbs that finish the job.

• readPurchaseApproval
• readSpendPolicy
• chargeWallet

Questions

• What does requestPurchaseApproval do?

  Show the user one exact order and ask them to approve it. It is one of the tools The Cloud MCP server gives every connected AI.

• How do I use requestPurchaseApproval 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 "order it", and it calls requestPurchaseApproval.

• Is requestPurchaseApproval safe to let an AI call?

  requestPurchaseApproval changes your workspace. What an AI creates is Private until you share it.

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.