MCPFerramentas MCP/Publicações/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.

Parâmetros
postSubmissionIdstringopcional
An already-published post's submission id — boosts it immediately. Use this OR postId, not both.
postIdstringopcional
A not-yet-published post's id — pre-configures a deferred boost. Requires platform or connectionId.
platformstringopcional
Which platform submission to boost, when using postId (e.g. "facebook").
connectionIdstringopcional
The exact connection to boost, when using postId. Preferred over platform when the post has multiple submissions on the same platform.
boostConfigIdstringopcional
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.
adAccountIdstringopcional
The ad account to spend from (from list_ad_accounts). Required unless boostConfigId supplies one.
targetingobjectopcional
Ad targeting. All fields optional — omitted ones use the platform's defaults / broad targeting.
ageMinnumberopcional
Minimum age.
ageMaxnumberopcional
Maximum age.
gendersnumber[]opcional
Platform gender codes to target.
geoLocationsobjectopcional
Geographic targeting.
countriesstring[]opcional
ISO country codes.
regionsstring[]opcional
Region/state names or ids.
citiesstring[]opcional
City names or ids.
zipsstring[]opcional
Postal/ZIP codes.
interestsobject[]opcional
Interest targeting.
idstringopcional
namestringopcional
publisherPlatformsstring[]opcional
Platform surfaces to run on, e.g. ["facebook", "instagram"].
dailyBudgetnumberobrigatório
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).
durationDaysnumberobrigatório
How many days the boost runs for. REQUIRED. Must be between 1 and 90.
delayHoursnumberopcional
Hours to wait after the post goes live before spend starts. Defaults to 0 (or the boostConfig's, if given).
publisherPlatformsstring[]opcional
Platform surfaces to run on, e.g. ["facebook", "instagram"].
scheduledStartstringopcional
An exact ISO datetime to start spend at, instead of delayHours from publish time.
Exemplo de solicitação
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "create_post_boost",
    "arguments": {
      "dailyBudget": 0,
      "durationDays": 0
    }
  }
}
Exemplo de resposta
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "..."
      }
    ]
  }
}

O formato da resposta é ilustrativo — o conteúdo real depende da ferramenta e dos seus dados.