List creative assets (`adsap_list_creative_assets`)

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

What it does

Lists the images and videos uploaded to a Meta ad account’s creative library. You can filter by images, videos or both, and page through long lists. Use it to find the asset you want before building an ad.

When to use it

Use it to find an uploaded image or video, and its filename, before building an ad.
It reads the creative library saved in Adsap, newest upload first. It makes no live call to Meta.
type_filter takes IMAGE, VIDEO or ALL. The tool has no search by name, so the assistant reads the names in the list.
To upload a new image or video, use adsap_upload_creative.
It returns no performance data. To rank ads by creative performance, use adsap_get_creative_performance.

Worked example

You ask

“Show me the videos in the creative library for act_1234567890.”

The assistant calls `adsap_list_creative_assets`


{
  "ad_account_id": "act_1234567890",
  "type_filter": "VIDEO",
  "limit": 20
}

Adsap returns

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


{
  "ok": true,
  "data": [
    {
      "id": "120210000000050",
      "ad_account_id": "act_1234567890",
      "name": "spring-sale-vertical.mp4",
      "type": "VIDEO",
      "format": "1080x1920",
      "aspect_ratio": "vertical",
      "thumbnail": "https://www.example.com/signed/spring-sale-vertical.jpg",
      "status": "ready",
      "file_size_mb": 18.4,
      "duration_seconds": null,
      "meta_video_id": "120210000000050",
      "meta_image_hash": null,
      "tags": null,
      "group_id": null,
      "created_at": "2026-03-01T09:30:00+00:00"
    }
  ],
  "meta": {
    "next_cursor": null,
    "total_count": 1,
    "ad_account_id": "act_1234567890"
  }
}

How to read it

name is the filename. adsap_create_ad takes that filename in feed_creative_name, vertical_creative_name or horizontal_creative_name. id is the Meta video ID for a video and the image hash for an image. format holds the pixel size.

thumbnail is a signed link that works for one hour. It is null when Adsap holds no thumbnail for the file. duration_seconds is not filled in. When next_cursor is not null, the assistant passes it as cursor to get the next page.

Parameters

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

Name	Type	Required	Description
`ad_account_id`	string	No
`type_filter`	one of `IMAGE`, `VIDEO`, `ALL`	No
`name_contains`	string	No	Case-insensitive substring match on the filename.
`image_hash`	string	No	Exact Meta image hash to look up (from adsap_get_ad or Meta exports).
`video_id`	string	No	Exact Meta video id to look up.
`group_id`	string	No	Filter to one creative group (paired feed/story assets share a group_id).
`created_after`	string	No	ISO 8601 date/time: only assets added after this moment.
`skip_thumbnails`	boolean	No	true = no signed thumbnail URLs (lightweight mode for scanning large libraries).
`limit`	number	No
`cursor`	string	No

Example prompts

“Show me the videos in the creative library for the US account.”
“List every image asset uploaded to my ad account.”
“Which creatives do I have that are named summer?”

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_ad_preview: Render a pixel-accurate visual preview of an existing Meta ad (real Meta render; video ads also get an animated clip in the interactive…
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_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 Creative library 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.

List creative assets (adsap_list_creative_assets)