MCPOutils MCP/Publications/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.

Paramètres
postSubmissionIdstringfacultatif
An already-published post's submission id — boosts it immediately. Use this OR postId, not both.
postIdstringfacultatif
A not-yet-published post's id — pre-configures a deferred boost. Requires platform or connectionId.
platformstringfacultatif
Which platform submission to boost, when using postId (e.g. "facebook").
connectionIdstringfacultatif
The exact connection to boost, when using postId. Preferred over platform when the post has multiple submissions on the same platform.
boostConfigIdstringfacultatif
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.
adAccountIdstringfacultatif
The ad account to spend from (from list_ad_accounts). Required unless boostConfigId supplies one.
targetingobjectfacultatif
Ad targeting. All fields optional — omitted ones use the platform's defaults / broad targeting.
ageMinnumberfacultatif
Minimum age.
ageMaxnumberfacultatif
Maximum age.
gendersnumber[]facultatif
Platform gender codes to target.
geoLocationsobjectfacultatif
Geographic targeting.
countriesstring[]facultatif
ISO country codes.
regionsstring[]facultatif
Region/state names or ids.
citiesstring[]facultatif
City names or ids.
zipsstring[]facultatif
Postal/ZIP codes.
interestsobject[]facultatif
Interest targeting.
idstringfacultatif
namestringfacultatif
publisherPlatformsstring[]facultatif
Platform surfaces to run on, e.g. ["facebook", "instagram"].
dailyBudgetnumberobligatoire
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).
durationDaysnumberobligatoire
How many days the boost runs for. REQUIRED. Must be between 1 and 90.
delayHoursnumberfacultatif
Hours to wait after the post goes live before spend starts. Defaults to 0 (or the boostConfig's, if given).
publisherPlatformsstring[]facultatif
Platform surfaces to run on, e.g. ["facebook", "instagram"].
scheduledStartstringfacultatif
An exact ISO datetime to start spend at, instead of delayHours from publish time.
Exemple de requête
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "create_post_boost",
    "arguments": {
      "dailyBudget": 0,
      "durationDays": 0
    }
  }
}
Exemple de réponse
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "..."
      }
    ]
  }
}

La forme de la réponse est indicative — le contenu réel dépend de l'outil et de vos données.