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

Ads

createAdSet

Create Ad Set

createAdSet: create a PAUSED Meta ad set under a campaign with a daily budget in cents, a billing event, an optimization goal and targeting.

writeconsentexternal

Ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "add an ad set with five dollars a day", and it calls createAdSet.

Example call

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

{
  "arguments": {
    "clientRequestId": "<clientRequestId>",
    "dryRun": true,
    "adAccountId": "<adAccountId>",
    "billingEvent": "<billingEvent>",
    "campaignId": "<campaignId>",
    "dailyBudgetCents": 1,
    "name": "<name>",
    "optimizationGoal": "<optimizationGoal>",
    "targetingJson": "<targetingJson>"
  },
  "name": "createAdSet"
}

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>.
• billingEventstringrequiredWhat Meta bills on.
• campaignIdstringrequiredThe campaign id from createAdCampaign.
• dailyBudgetCentsintegerrequiredDaily budget in cents of the account currency (500 = $5).
• namestringrequiredAd set name.
• optimizationGoalstringrequiredWhat Meta optimizes delivery for.
• targetingJsonstringrequiredMeta targeting spec as JSON, e.g. {"geo_locations":{"countries":["US"]},"age_min":25}.

Returns

The registry does not declare a return shape.

Declared limits

• clientRequestId: minimum length 8
• clientRequestId: maximum length 128
• dailyBudgetCents: minimum 100
• dailyBudgetCents: maximum 9007199254740991
• name: minimum length 1

Ask for it

The Cloud routes these requests to this verb.

• add an ad set with five dollars a day
• target Sonoma drivers

Pair it with

The verbs that finish the job.

• createAdCampaign
• createAd
• setAdBudget

Questions

• What does createAdSet do?

  createAdSet: create a PAUSED Meta ad set under a campaign with a daily budget in cents, a billing event, an optimization goal and targeting. It is one of the tools The Cloud MCP server gives every connected AI.

• How do I use createAdSet 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 "add an ad set with five dollars a day", and it calls createAdSet.

• Is createAdSet safe to let an AI call?

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