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

Commerce

listCoupons

List Coupons

List a shop's discount codes and what each one is worth: code, flat or percent value, any minimum cart (including one that only bites from a customer's second redemption onward), window, redemption…

read

Ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "what coupons do we have", and it calls listCoupons.

Example call

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

{
  "arguments": {
    "appId": "<appId>"
  },
  "name": "listCoupons"
}

Arguments

• appIdstringrequiredThe Studio app ID whose shop to read.
• statusstringoptionalNarrow to one bucket. Omit for all three, newest first.

Returns

The registry does not declare a return shape.

Ask for it

The Cloud routes these requests to this verb.

• what coupons do we have
• is SAVE5 still live
• which codes expired
• how many times has that code been used

Pair it with

The verbs that finish the job.

• createCoupon
• updateCoupon
• deactivateCoupon

Questions

• What does listCoupons do?

  List a shop's discount codes and what each one is worth: code, flat or percent value, any minimum cart (including one that only bites from a customer's second redemption onward), window, redemption… It is one of the tools The Cloud MCP server gives every connected AI.

• How do I use listCoupons 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 "what coupons do we have", and it calls listCoupons.

• Is listCoupons safe to let an AI call?

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