1. Docs
2. /
3. Tool reference
4. /
5. Ads
6. /
7. uploadAdCreative

Ads

uploadAdCreative

Upload Ad Creative

uploadAdCreative: turn one of the caller's Cloud Files (an image, or a video plus an image thumbnail) into a Meta ad creative on a Facebook Page, with ad copy, a link and a call to action.

writeconsentexternal

Ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "upload the sunset video as an ad", and it calls uploadAdCreative.

Example call

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

{
  "arguments": {
    "clientRequestId": "<clientRequestId>",
    "dryRun": true,
    "adAccountId": "<adAccountId>",
    "callToAction": "<callToAction>",
    "fileId": "<fileId>",
    "linkUrl": "<linkUrl>",
    "message": "<message>",
    "name": "<name>",
    "pageId": "<pageId>"
  },
  "name": "uploadAdCreative"
}

Arguments

• clientRequestIdstringrequiredA stable id you mint for THIS request (e.g. a UUID) and reuse on a retry. A repeat of a succeeded id returns its receipt instead of calling Meta twice.
• dryRunbooleanrequiredtrue runs the account gate and writes a dry_run receipt without sending anything to Meta. Use it first to preview.
• adAccountIdstringrequiredThe ad account id, act_<digits>.
• callToActionstringrequiredThe ad's button.
• fileIdstringrequiredThe Cloud File id of the image or video (from listFiles).
• linkUrlstringrequiredWhere the ad sends people.
• messagestringrequiredThe ad's primary text.
• namestringrequiredCreative name.
• pageIdstringrequiredThe Facebook Page id the ad runs as.
• thumbnailFileIdstringoptionalRequired for a video: an image Cloud File shown before play.

Returns

The registry does not declare a return shape.

Declared limits

• clientRequestId: minimum length 8
• clientRequestId: maximum length 128
• message: minimum length 1
• name: minimum length 1

Ask for it

The Cloud routes these requests to this verb.

• upload the sunset video as an ad
• make a creative from this clip

Pair it with

The verbs that finish the job.

• createAd

Questions

• What does uploadAdCreative do?

  uploadAdCreative: turn one of the caller's Cloud Files (an image, or a video plus an image thumbnail) into a Meta ad creative on a Facebook Page, with ad copy, a link and a call to action. It is one of the tools The Cloud MCP server gives every connected AI.

• How do I use uploadAdCreative 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 "upload the sunset video as an ad", and it calls uploadAdCreative.

• Is uploadAdCreative safe to let an AI call?

  uploadAdCreative widens who can see or receive something, so the owner approves every call explicitly. An AI cannot approve it for itself. It reaches a system outside The Cloud on your behalf.

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.