Commerce
updateProduct
Update Product
Edit ONE catalog product in place: name, description, TYPE (physical, digital or service, where a service says how it is booked), base price (in minor units, e.g.
Ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "change the shilajit price to $60", and it calls updateProduct.
Example call
The MCP tools/call params, with the required arguments only.
{
"arguments": {
"appId": "<appId>",
"productId": "<productId>"
},
"name": "updateProduct"
}Arguments
appIdstringrequiredThe Studio app ID whose catalog to edit.customFieldsobjectoptionalCustom fields to set, merged by key (existing keys you don't pass are kept).descriptionstringoptionalNew product description.dietaryTagsstring[]optionalThe product's dietary facts, from the fixed vocabulary: gluten_free, dairy_free, nut_free, peanut_free, tree_nut_free, sesame_free, coconut_free, corn_free, egg_free, soy_free, refined_sugar_free, vegan, vegetarian. REPLACES the whole…displayQuantitybooleanoptionalWhether storefronts may show the remaining inventory count.fulfillmentModestringoptionalHow this product is fulfilled. 'in_stock' sells counted stock now, 'made_to_order' uses lead time and ignores count, and 'hybrid' sells on-hand units now then orders ahead on lead time.leadTimeobjectoptionalThe product lead time in owner-facing units, such as {kind:'days',value:7}.leadTimeMinutesintegeroptionalPrep lead time before a pickup slot, in minutes (2880 = 2 days).lowStockThresholdintegeroptionalProtected inventory floor. Ready-now selling stops at this count.namestringoptionalNew product name.priceMinorintegeroptionalNew base price in minor units (cents), e.g. 6000 = $60.00.productIdstringrequiredThe commerce product ID to edit.productTypestringoptionalThe product's type: 'physical', 'digital' or 'service'. Only a service can carry an option price table (setProductOptionPrices). Making a product a service needs serviceBooking unless it already has one.readyWindowsobject[]optionalOptional local-time ready windows in minutes after midnight, such as [{startMinute:540,endMinute:840}].rushobject | nulloptionalThe paid window below this product's lead time: how early it may be ordered and what that costs. Pass null to stop selling it. For a whole slice of the catalog, set the shop rule instead (setShopRules rush).sellWhenSoldOutbooleanoptionalDeprecated alias for zeroInventoryBehavior: true = 'lead_time', false = 'sold_out'. Prefer zeroInventoryBehavior.serviceBookingobjectoptionalHow this service is booked: {kind:'scheduled',durationMinutes:90} for a visit, or {kind:'subscription',cadence:'monthly'} for a recurring one. Only for a service.zeroInventoryBehaviorstringoptionalLegacy tracked-product policy. Prefer fulfillmentMode; use 'lead_time' only with a positive leadTime or leadTimeMinutes.addedLeadDaysintegeroptionalExtra days boxing and chilling add on top of the bake. Absent = the class default (1 ambient, 2 chilled).parcelobject | nulloptionalPacked weight and dimensions for live carrier rates. Pass null to remove them.parcelBoxKeystringoptionalWhich box carries this product. Absent = the shop's own default box on its shipping location.shippingClassstringoptionalHow this product travels. Absent = ambient; 'chilled' buys an insulated liner and ice.shipsbooleanoptionalWhether this product may be shipped at all. Every product ships by default, so pass false for the ones that stay local.
Returns
The registry does not declare a return shape.
Declared limits
leadTimeMinutes: minimum 0leadTimeMinutes: maximum 9007199254740991lowStockThreshold: minimum 0lowStockThreshold: maximum 9007199254740991priceMinor: minimum 0priceMinor: maximum 9007199254740991addedLeadDays: minimum 0addedLeadDays: maximum 9007199254740991
Ask for it
The Cloud routes these requests to this verb.
- change the shilajit price to $60
- mark the almond cake gluten-free
- this one is vegan
- make this made to order
- when it runs out, keep selling on lead time
- sell out when inventory hits zero
- tell me when only 3 are left
- we will do this one in 30 hours for 25% more
- this cake does not ship
- ship this one chilled
- fix this product's description
- make the solar assessment a service
- this is a 90 minute visit
Pair it with
The verbs that finish the job.
Questions
What does updateProduct do?
Edit ONE catalog product in place: name, description, TYPE (physical, digital or service, where a service says how it is booked), base price (in minor units, e.g. It is one of the tools The Cloud MCP server gives every connected AI.
How do I use updateProduct 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 "change the shilajit price to $60", and it calls updateProduct.
Is updateProduct safe to let an AI call?
updateProduct 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.