MCPMCP Tools/Posts/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'.
Parameters
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).
Example request
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "list_post_boosts",
"arguments": {}
}
}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.