list_swipe_file
Browse Inspiration — the saved and curated exemplar ad creatives (Adlyse-curated winners plus this org’s own saved references) with durable media URLs, ad copy, curator notes, and the extracted angle summary. It’s a platform-agnostic home for video/image ads (filter by media kind, not network).
Use item_id when the user has selected a specific item; this is an exact,
tenant-scoped lookup and avoids relying on free-text search for opaque ids.
Use the filters to find proven reference ads to draw on — each item’s
angle_summary and curator_notes explain the transferable idea, and
remix_from_swipe_file turns an item into on-brand draft creatives.
Args: item_id: Exact item id for a selected item or remix scope: all (default) | curated | org | favorite media_kind: Optional filter — image | video | text source: Optional filter — competitor_ad | own_creative | upload | url tags: Optional swipe-tag filter (vertical/angle/hook values) featured_only: Only featured curated picks search: Free-text search over title/copy/notes limit: Max items to return (default 24, max 50) offset: Pagination offset
Returns: A dictionary containing:
- items: list of item objects (id, scope, source, media_kind, aspect, title, advertiser_name, media_url, copy, curator_notes, tags, angle_summary, featured, and more)
- total, limit, offset
- source: provenance tag
Parameters#
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
item_id | string | no | Fetch one exact Inspiration item by id. Use this for a selected item or remix; other filters are ignored. | |
scope | string | no | "all" | ’all’ (default: curated + this org’s saves), ‘curated’ (the Adlyse-curated global library), ‘org’ (this org’s private saves), or ‘favorite’ (items this org has favorited — org-shared). |
media_kind | string | no | Filter by media kind: ‘image’ or ‘video’ (or ‘text’ for copy-only). | |
source | string | no | Filter by where items came from: ‘competitor_ad’, ‘own_creative’, ‘upload’, ‘url’. | |
tags | array | no | Filter by swipe tags from the creative taxonomy (vertical/angle/hook, e.g. ‘ecommerce’, ‘social_proof’, ‘question’). An unknown tag is rejected with the valid list. | |
featured_only | boolean | no | false | Only featured curated picks. |
search | string | no | Free-text search over title/copy/notes. | |
limit | integer | no | 24 | Max items (default 24, max 50). |
offset | integer | no | 0 | Pagination offset. |
Generated by generate_mcp_docs from the server tool. Add to this page below this block; the block is rewritten on every run.