Get ad preview (`adsap_get_ad_preview`)

Platform: Meta · Read or write: Read · Plan: All plans · Consumes a task: No · Preview supported: No

What it does

Renders a preview of an existing Meta ad using Meta’s own renderer. In assistants that support interactive cards, the preview shows Facebook Feed and Instagram Reels tabs and a button that opens every placement in Ads Manager. Video ads also get an animated clip. You can name another placement when you need one.

When to use it

Use it to see how an ad that already exists on Meta looks in a placement. It needs the ad_id and the ad_account_id.
The default placement is MOBILE_FEED_STANDARD, the Facebook mobile feed. The card presents that one and INSTAGRAM_REELS.
Name another placement only when you need it. ad_format accepts eight values, among them INSTAGRAM_STORY, DESKTOP_FEED_STANDARD and THREADS_STREAM.
The answer is a PNG screenshot of Meta’s own preview, plus a link that opens the live preview in a browser.
For a video ad, an animated clip is recorded in the background. It is fetched later with adsap_get_preview_clip.

Worked example

You ask

“Show me how ad 120210000000000 in act_1234567890 looks in Instagram Reels.”

The assistant calls `adsap_get_ad_preview`


{
  "ad_account_id": "act_1234567890",
  "ad_id": "120210000000000",
  "ad_format": "INSTAGRAM_REELS"
}

Adsap returns

The field names are the ones Adsap returns. The values are examples.


[
  {
    "type": "image",
    "data": "iVBORw0KGgoAAAANSUhEUgAAAWgAAAII",
    "mimeType": "image/png"
  },
  {
    "type": "text",
    "text": "Live Meta ad preview rendered for Instagram Reels.\nOpen the full interactive preview in a browser: https://www.example.com/meta-ad-preview\nAnimated placement preview (plays in the interactive card, expires in ~1h): https://www.example.com/ad-previews/120210000000000_INSTAGRAM_REELS.webm"
  }
]

How to read it

This tool returns two content parts, not a data object. The first part is the screenshot: data holds the full image as base64 text, shortened here, and mimeType is image/png. The second part is plain text. Its first line names the placement. Its second line is Meta’s preview link, which you can open in a browser.

The third line appears when an animated clip of this ad and placement is already stored. On a first render the text says the clip is rendering in the background. The assistant can then fetch it with adsap_get_preview_clip. In assistants that show interactive cards, the card displays all of this for you.

Parameters

Descriptions are shortened from the tool schema. Your assistant sees the full text.

Name	Type	Required	Description
`ad_account_id`	string	Yes	Ad account ID (act_xxx). Required: scopes the request to the workspace that owns this ad account.
`ad_id`	string	Yes	The ID of the existing ad to render a preview for.
`ad_format`	one of `DESKTOP_FEED_STANDARD`, `MOBILE_FEED_STANDARD`, `INSTAGRAM_STANDARD`, `INSTAGRAM_STORY`, `INSTAGRAM_REELS`, `RIGHT_COLUMN_STANDARD`, `MESSENGER_MOBILE_INBOX_MEDIA`, `THREADS_STREAM`	No	Placement to render. Use MOBILE_FEED_STANDARD (default) or INSTAGRAM_REELS: the two the interactive card presents. Other values exist only for when the user explicitly names that placement; otherwise direct them to the card’s ‘All placements on Meta’ button.
`include_video_source`	boolean	No	Also resolve the ad’s raw video file URL (2 extra Meta reads, page-token lane). Default false: the bare file is NOT the preview experience (no ad chrome, placement-customized assets differ); kept for data/debug use. The upcoming animated placement preview replaces it (scope doc §8b).

Example prompts

“Show me a preview of ad 120210000000000.”
“What does the new Reels ad look like?”
“Preview this ad in Instagram Stories.”

adsap_create_ad_from_ig_post: Turn an existing Instagram post, video, or reel into an ad inside an EXISTING ad set: Meta Ads Manager’s “Use existing post”.
adsap_get_ad_library_snapshot: SHOW what Ad Library ads ACTUALLY LOOK LIKE (creative, copy, page name), in a SELF-CONTAINED card.
adsap_get_creative_performance: Ranked creative performance analysis with fatigue detection.
adsap_get_import_status: Check progress of a Meta historical-asset import started with adsap_import_account_creatives: status, phase (images then videos)…
adsap_get_preview_clip: Fetch the animated placement-preview clip (recorded video of the real Meta preview) for an ad+placement previously rendered with…
adsap_get_upload_status: Check status of an async video upload.
adsap_import_account_creatives: Import ALL historical creative assets (images + videos) that already exist in a Meta ad account into the Adsap Creative Library.
adsap_list_creative_assets: List uploaded Meta creative images and videos in the ad account asset library.
adsap_list_drive_files: Browse Google Drive for creative image/video files to upload to Meta.
adsap_list_dropbox_files: Browse Dropbox for creative image/video files to upload to Meta.
adsap_list_ig_media: List an Instagram account’s recent media/posts (live from Meta): the posts, reels, and stories that can be promoted.
adsap_replace_ad_creative: DESTRUCTIVE.
adsap_search_ad_library: Search Meta’s public Ad Library for ads (competitor research / ad transparency).
adsap_upload_creative: Upload image/video from Google Drive or Dropbox to a Meta ad account.

Guide

Read Creatives for the workflow around this tool, and the Tool reference for every tool.

The Meta Ads MCP server page shows how to connect Meta Ads to Claude, ChatGPT or Perplexity.

Get ad preview (adsap_get_ad_preview)