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

Commerce

updateLocation

Update Location

Edit ONE fulfillment location in place: rename it, set pickup hours (weekly availability: per-weekday slots in minutes-from-midnight LOCAL time, e.g.

write

Ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "set the bakery's pickup hours", and it calls updateLocation.

Example call

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

{
  "arguments": {
    "appId": "<appId>",
    "locationId": "<locationId>"
  },
  "name": "updateLocation"
}

Arguments

• appIdstringrequiredThe Studio app ID whose location to edit.
• locationIdstringrequiredThe commerce location ID to edit.
• namestringoptionalNew location name.
• timezonestringoptionalIANA timezone (e.g. "America/New_York") the hours are local to.
• addressLine1stringoptionalStreet address line 1.
• addressLine2stringoptionalStreet address line 2.
• citystringoptionalCity.
• regionstringoptionalState / region.
• postalCodestringoptionalPostal code.
• countrystringoptional2-letter ISO country code (e.g. US).
• placementobjectoptionalWhere this location surfaces on the brand's storefront.
• supportedFulfillmentobjectoptionalWhich fulfillment methods this location offers.
• weeklyAvailabilityobject[]optionalThe full weekly hours grid: REPLACES the stored grid, so pass every open weekday (each weekday at most once).
• exceptionDatesobject[]optionalHoliday closures / one-off special hours: REPLACES the stored list.
• orderingClosedUntilnumberoptionalEpoch ms until which ordering is paused (kitchen slammed / after hours).
• clearOrderingClosedUntilbooleanoptionaltrue lifts a temporary ordering pause.
• bookingHorizonDaysintegeroptionalHow far ahead this location's pickup calendar opens, in days: the shop's order-ahead window. Absent = the platform default (30). Up to 730 (two years) for shops that take far-ahead orders (weddings, events).
• pickupStartsAtMinuteintegeroptionalThe first pickup time customers may choose, in minutes from midnight LOCAL to the location's timezone (510 = 8:30am), independent of opening hours. Windows that end at or before it are removed; a window straddling it opens at it. Absent =…
• clearPickupStartsAtMinutebooleanoptionaltrue removes the first-pickup-time floor, so windows open at the location's own hours again.
• taxRegionobjectoptionalSales tax for this location, owner-set. Applies to orders fulfilled here; a product carrying its own rate overrides it.

Returns

The registry does not declare a return shape.

Declared limits

• bookingHorizonDays: minimum 1
• bookingHorizonDays: maximum 730
• pickupStartsAtMinute: minimum 0
• pickupStartsAtMinute: maximum 1439

Ask for it

The Cloud routes these requests to this verb.

• set the bakery's pickup hours
• rename The Hub
• first pickup at 8:30 even though we open at 7
• let customers order months ahead
• close ordering until Monday
• add a holiday closure

Pair it with

The verbs that finish the job.

• createLocation
• listLocations

Questions

• What does updateLocation do?

  Edit ONE fulfillment location in place: rename it, set pickup hours (weekly availability: per-weekday slots in minutes-from-midnight LOCAL time, e.g. It is one of the tools The Cloud MCP server gives every connected AI.

• How do I use updateLocation 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 "set the bakery's pickup hours", and it calls updateLocation.

• Is updateLocation safe to let an AI call?

  updateLocation changes your workspace. What an AI creates is Private until you share it.

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.