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

Commerce

proposeAdBudget

Propose Ad Budget

Propose how much each ad in an ad set may spend, and put that table on the user's approval card.

write

Ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "how much do you want me to put on each of those ads", and it calls proposeAdBudget.

Example call

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

{
  "arguments": {
    "adSetId": "<adSetId>",
    "ads": [
      {}
    ],
    "days": 1,
    "platforms": [
      "<platforms>"
    ]
  },
  "name": "proposeAdBudget"
}

Arguments

• adSetIdstringrequiredThe ad set these ads belong to (its row in the Ad Set table).
• adsobject[]requiredEvery ad in the set with its proposed daily amount.
• agentLabelstringoptionalHow you are named to the user on the card. Defaults to Ora.
• currencystringoptionalISO currency code. Defaults to USD.
• daysintegerrequiredHow many days each ad runs.
• platformsstring[]requiredWhere each ad runs. Every ad runs on every platform named.

Returns

The registry does not declare a return shape.

Declared limits

• ads: minimum items 1
• currency: minimum length 3
• currency: maximum length 3
• days: greater than 0
• days: maximum 90
• platforms: minimum items 1

Ask for it

The Cloud routes these requests to this verb.

• how much do you want me to put on each of those ads
• put $5 a day on each
• budget the Rocket ads
• propose a spend for the ad set

Pair it with

The verbs that finish the job.

• launchAdSet
• readPurchaseApproval

Questions

• What does proposeAdBudget do?

  Propose how much each ad in an ad set may spend, and put that table on the user's approval card. It is one of the tools The Cloud MCP server gives every connected AI.

• How do I use proposeAdBudget 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 "how much do you want me to put on each of those ads", and it calls proposeAdBudget.

• Is proposeAdBudget safe to let an AI call?

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