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

Commerce

placeApprovedOrder

Place Approved Order

Place an order the user has ALREADY approved, by driving their own machine through the merchant's checkout in a session opened for this order alone.

writedestructiveexternal

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

Example call

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

{
  "arguments": {
    "plan": [
      {}
    ],
    "purchaseId": "<purchaseId>"
  },
  "name": "placeApprovedOrder"
}

Arguments

• agentLabelstringoptionalHow you were named to the user on their approval card. It has to match, or the approval will not be spent. Defaults to Ora.
• cancellationUrlstringoptionalThe merchant's own page for cancelling an order, so the user can be sent there if they change their mind after it is placed.
• historyUrlstringoptionalThe merchant's own order list, used to check what actually happened if the checkout is interrupted. Without it an interrupted order can only be reported as unknown.
• machineIdstringoptionalWhich of the user's machines runs the checkout (machineId from listMachines). Omit to let it pick a healthy one; whichever it lands on is then pinned for the whole order.
• planobject[]requiredThe checkout, in order: one open, then the clicks and fills, then exactly one submit. Pinned on the first call, so a later call cannot change it.
• purchaseIdstringrequiredThe same purchase id you reserved the spend against and asked for approval with. One purchase, one approval, one order.

Returns

Each call does ONE step and returns what happened, so call it again until state stops changing.

Ask for it

The Cloud routes these requests to this verb.

• go ahead and order it
• place that order
• finish the checkout
• buy it now that I have approved it

Pair it with

The verbs that finish the job.

• requestPurchaseApproval
• readOrderExecution
• cancelApprovedOrder

Questions

• What does placeApprovedOrder do?

  Place an order the user has ALREADY approved, by driving their own machine through the merchant's checkout in a session opened for this order alone. It is one of the tools The Cloud MCP server gives every connected AI.

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

• Is placeApprovedOrder safe to let an AI call?

  placeApprovedOrder 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.