How do I use listOrders 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 "orders report", and it calls listOrders.

Is listOrders safe to let an AI call?

listOrders is read-only: it changes nothing.

Commerce

`listOrders`

List Orders

List a shop's orders as a report, newest first, with a cursor for the next page: order number, placed and due dates in the shop's zone, customer, status, stage, payment status, items, total,…

read

Ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "orders report", and it calls listOrders.

Example call

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

{
  "arguments": {},
  "name": "listOrders"
}

Arguments

channelstringoptionalWhich counter rang the sale: POS (the register), Online (storefront, CakeBuilder and other apps, payment links) or Manual (logged by hand).
customerEmailstringoptionalOnly this customer's orders, by the email on the order.
dateFieldstringoptionalWhich date the period applies to: "placed" (when the order was taken, the default) or "due" (the pickup, delivery or event day).
fromstringoptionalFirst day of a custom period, YYYY-MM-DD, included. Only with period "custom".
locationIdstringoptionalOnly orders at one of the shop's locations (see listLocations).
menustringoptionalA menu (product set) by name or id, e.g. "Thanksgiving 2026": only orders that sold something on it (see listProductSets). A near name is matched; a miss lists the menus that exist.
periodstringoptionalThe period in plain words: today, yesterday, last_7_days, last_30_days, this_month, last_month, this_year, all (the default), or custom with from and to. Days are the shop's own.
productIdstringoptionalOnly orders that sold one product (see listProducts).
spacestringoptionalSpace id or slug of a Space-owned shop (see listPageSpaces). Omit for your personal shop.
spaceIdstringoptionalSame as `space`: the Space id (see listPageSpaces) of a Space-owned shop. Pass either one. Omit both for your personal shop.
stagestring[]optionalOnly these stages of the work: unfulfilled, in_progress, ready, fulfilled, cancelled. Omit for every stage.
statusstring[]optionalOnly these order statuses: pending (new), confirmed, completed, cancelled. Omit for every status.
textstringoptionalFree text: an order number, a customer's name, email or phone, whatever is in hand.
tostringoptionalLast day of a custom period, YYYY-MM-DD, included. Only with period "custom".
cursorstringoptionalThe nextCursor from the previous page, for the next page.
limitintegeroptionalRows per page, 1 to 200. Defaults to 50.

Returns

The registry does not declare a return shape.

Declared limits

limit: minimum 1
limit: maximum 200

Ask for it

The Cloud routes these requests to this verb.

orders report
last month's orders
orders for Thanksgiving
how many orders last week
where are my CakeBuilder orders
list this week's pickups
show me Marta's orders

Pair it with

The verbs that finish the job.

Questions

What does listOrders do?
List a shop's orders as a report, newest first, with a cursor for the next page: order number, placed and due dates in the shop's zone, customer, status, stage, payment status, items, total,… It is one of the tools The Cloud MCP server gives every connected AI.
How do I use listOrders 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 "orders report", and it calls listOrders.
Is listOrders safe to let an AI call?
listOrders is read-only: it changes nothing.

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.