MCPMCP Tools/Posts/create_post_boost

create_post_boost

Writeposts:write

Boost a post with paid ad spend through a connected ad account — this spends real money. dailyBudget (minor currency units, e.g. cents) and durationDays are ALWAYS required, regardless of whether you also pass boostConfigId; if boostConfigId is given, only its adAccountId/targeting/publisherPlatforms/delayHours are used as defaults for whatever you don't specify — its own saved budget is never used silently. Pass postSubmissionId to boost an ALREADY-PUBLISHED post's live submission (spends immediately). Pass postId (+ platform or connectionId) instead to pre-configure a boost on a post that hasn't published yet — it stays queued (no spend) and only starts once that post's submission goes live. adAccountId must belong to a connected account (see list_ad_accounts); use select_ad_account first if none is selected.

Parameters
postSubmissionIdstringoptional
An already-published post's submission id — boosts it immediately. Use this OR postId, not both.
postIdstringoptional
A not-yet-published post's id — pre-configures a deferred boost. Requires platform or connectionId.
platformstringoptional
Which platform submission to boost, when using postId (e.g. "facebook").
connectionIdstringoptional
The exact connection to boost, when using postId. Preferred over platform when the post has multiple submissions on the same platform.
boostConfigIdstringoptional
A saved boost config (from list_boost_configs) to source adAccountId/targeting/publisherPlatforms/delayHours defaults from. Its budget/duration are NOT used — pass dailyBudget/durationDays explicitly regardless.
adAccountIdstringoptional
The ad account to spend from (from list_ad_accounts). Required unless boostConfigId supplies one.
targetingobjectoptional
Ad targeting. All fields optional — omitted ones use the platform's defaults / broad targeting.
ageMinnumberoptional
Minimum age.
ageMaxnumberoptional
Maximum age.
gendersnumber[]optional
Platform gender codes to target.
geoLocationsobjectoptional
Geographic targeting.
countriesstring[]optional
ISO country codes.
regionsstring[]optional
Region/state names or ids.
citiesstring[]optional
City names or ids.
zipsstring[]optional
Postal/ZIP codes.
interestsobject[]optional
Interest targeting.
idstringoptional
namestringoptional
publisherPlatformsstring[]optional
Platform surfaces to run on, e.g. ["facebook", "instagram"].
dailyBudgetnumberrequired
Daily budget in minor currency units (cents), e.g. 2500 for $25.00/day. REQUIRED. Must be positive and no more than 500000 (this MCP tool's own safety cap — not enforced anywhere else in the app, including the dashboard UI).
durationDaysnumberrequired
How many days the boost runs for. REQUIRED. Must be between 1 and 90.
delayHoursnumberoptional
Hours to wait after the post goes live before spend starts. Defaults to 0 (or the boostConfig's, if given).
publisherPlatformsstring[]optional
Platform surfaces to run on, e.g. ["facebook", "instagram"].
scheduledStartstringoptional
An exact ISO datetime to start spend at, instead of delayHours from publish time.
Example request
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "create_post_boost",
    "arguments": {
      "dailyBudget": 0,
      "durationDays": 0
    }
  }
}
Example response
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "..."
      }
    ]
  }
}

Response shape shown for illustration — the actual content depends on the tool and your data.