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

Commerce

replaceProductImage

Replace Product Image

Swap ONE of a product's pictures for a photo already in your Cloud Files.

write

Ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "use this photo for the brownie", and it calls replaceProductImage.

Example call

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

{
  "arguments": {
    "appId": "<appId>",
    "fileId": "<fileId>",
    "image": 1,
    "productId": "<productId>"
  },
  "name": "replaceProductImage"
}

Arguments

• appIdstringrequiredThe Studio app ID whose catalog holds this product.
• fileIdstringrequiredCloud File id of the new photo, from listFiles or searchFiles.
• imageintegerrequiredWhich picture to swap, counting from 1 in the product's own gallery order.
• productIdstringrequiredThe commerce product ID whose picture to swap.

Returns

The registry does not declare a return shape.

Declared limits

• image: greater than 0
• image: maximum 9007199254740991

Ask for it

The Cloud routes these requests to this verb.

• use this photo for the brownie
• replace the first picture with the JPEG
• swap the cookie photo for the one in my files

Pair it with

The verbs that finish the job.

• listProducts
• searchFiles
• tagProductImages

Questions

• What does replaceProductImage do?

  Swap ONE of a product's pictures for a photo already in your Cloud Files. It is one of the tools The Cloud MCP server gives every connected AI.

• How do I use replaceProductImage 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 "use this photo for the brownie", and it calls replaceProductImage.

• Is replaceProductImage safe to let an AI call?

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