MCPMCP-Tools/Beiträge/list_post_boosts

list_post_boosts

Readposts:read

List boosts (paid promotions of posts), newest first, so one can be found again without the create_post_boost response: status, whether it is deferred (waiting for its post to publish), the budget, spend so far, the post it promotes, and `control` — the tool that applies now (`stop_post_boost` with adRunId for a live one, `cancel_deferred_boost` with adCampaignId for a deferred one, null when it is over). Filter by postId, status, or activeOnly. Up to 50 per page; follow hasMore. A client (portal) session sees only its own client's boosts, without the agency's ad spend and without controls; a member limited to some clients sees only those clients'.

Parameter
postIdstringoptional
Only boosts of this post. Accepts the database ID or public post- ID. IDs must belong to the authenticated agency and permitted client.
statusstringoptional
Only this ad-run status, e.g. awaiting_publish, active, paused, stopped, cancelled, completed, rejected, error.
activeOnlybooleanoptional
Only boosts that can still be stopped or cancelled.
pagenumberoptional
Page number, starting at 1 (default 1).
limitnumberoptional
Boosts per page (1–50, default 50).
Beispielanfrage
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_post_boosts",
    "arguments": {}
  }
}
Beispielantwort
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "..."
      }
    ]
  }
}

Die Antwortform dient nur zur Veranschaulichung — der tatsächliche Inhalt hängt vom Tool und Ihren Daten ab.