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

Commerce

listProducts

List Products

List the products a Studio app's STOREFRONT SERVES, with each item's publish state (draft / active / archived / published / hidden), effective storefront price, currency, and SHIPS (whether each…

read

Ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "list my products", and it calls listProducts.

Example call

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

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

Arguments

• appIdstringrequiredThe Studio app ID whose storefront catalog to list.
• cursorstringoptionalPage cursor from a previous call. Omit for the first page.
• limitintegeroptionalMax products per page (default 50, cap 200).
• scopestringoptional"storefront" (default) = what this app actually serves: its bound owner + brand, active products only. "catalog" = every product under the owner, all brands and statuses.

Returns

The registry does not declare a return shape.

Declared limits

• limit: greater than 0
• limit: maximum 9007199254740991

Ask for it

The Cloud routes these requests to this verb.

• list my products
• what does this shop sell
• which items are published
• show the catalog
• what's still in draft

Pair it with

The verbs that finish the job.

• getStorefrontState
• publishProduct
• setProductsShipping

Questions

• What does listProducts do?

  List the products a Studio app's STOREFRONT SERVES, with each item's publish state (draft / active / archived / published / hidden), effective storefront price, currency, and SHIPS (whether each… It is one of the tools The Cloud MCP server gives every connected AI.

• How do I use listProducts 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 "list my products", and it calls listProducts.

• Is listProducts safe to let an AI call?

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