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

Commerce

listLocations

List Locations

List a shop's fulfillment locations: every location under the app's owner with its full stored shape: name, address, timezone, weekly availability (pickup slots in minutes-from-midnight local time),…

read

Ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "what are my pickup locations", and it calls listLocations.

Example call

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

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

Arguments

• appIdstringrequiredThe Studio app ID whose locations to list.
• includeArchivedbooleanoptionaltrue includes archived (retired) locations.

Returns

The registry does not declare a return shape.

Ask for it

The Cloud routes these requests to this verb.

• what are my pickup locations
• show the shop's hours
• list locations

Pair it with

The verbs that finish the job.

• createLocation
• updateLocation
• getStorefrontState

Questions

• What does listLocations do?

  List a shop's fulfillment locations: every location under the app's owner with its full stored shape: name, address, timezone, weekly availability (pickup slots in minutes-from-midnight local time),… It is one of the tools The Cloud MCP server gives every connected AI.

• How do I use listLocations 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 are my pickup locations", and it calls listLocations.

• Is listLocations safe to let an AI call?

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