Skip to content
AdlyseMCP Docs
Product guideMCP reference
⌘K
Open Adlyse
⌘K
Overview
QuickstartAuthentication
adlyse-insights
adlyse-reports
adlyse-ads
list_campaignsget_performancelist_adsget_ad_performancelist_change_eventsupdate_campaign_statusupdate_campaign_budget
adlyse-workflows
adlyse-adminadlyse-all
  1. Overview
  2. adlyse-ads

save_competitor_ad_to_swipe_file

Save a competitor ad from Brand Watch into the org’s Swipe File — a durable reference copy (media + copy + advertiser snapshot) that survives the competitor rotating or deactivating the ad.

The ad must belong to an advertiser this org actively watches (see insights’ list_watched_competitors / list_competitor_ads). Idempotent: re-saving the same ad/variant returns the existing item.

Args: ad_id: The observed ad id (from list_competitor_ads) variant_position: Optional variant position; defaults to the best visual note: Optional note on why this ad matters

Returns: A dictionary containing:

  • item: the saved swipe-file item (id, media_url, copy, …)
  • source: provenance tag

Parameters#

NameTypeRequiredDefault
ad_idstringyes
variant_positionintegerno
notestringno

Generated from the server tool’s docstring by generate_mcp_docs. Extend this page freely — the generator never overwrites an existing file.