MCP tools

Preview ads

Preview a campaign launch's ads as they appear in feed: primary text, headline, call to action and the creative image for every ad in the launch, in structure order.

Tool name: preview-ads.

Preview a campaign launch's ads as they appear in feed: primary text, headline, call to action and the creative image for every ad in the launch, in structure order. Read-only, it renders what is already there and changes nothing.

When to use

The user asks what the ads look like, wants to see the creative, or wants to review copy and images together before launching. For one ad's full settings use getAdDetails; for the structure alone use getCampaignTree.

Access

PropertyValue
Required scoperead
PublishesNo
Read-onlyYes
DestructiveNo
IdempotentYes
Open worldNo

Input

FieldTypeRequiredDescription
campaignLaunchIdstringYesCampaign launch ID (a.k.a. batch ID). Read it from the Current Context block when one is in scope, or resolve it from a mention via listAccountCampaigns / the campaign tree when the user @-mentioned a different launch.

Output

FieldTypeRequiredDescription
campaignNamestring | nullYes
adsobject[]Yes
withoutMedianumberYes

REST equivalent

MCP only. No REST operation does the same thing.

On this page