add_ad_to_board
ChatGPTAdd a library ad to an existing board in the specified workspace, or the current workspace when omitted. Use when the user asks to put an ad on a board. board takes an id or exact name from list_boards; ad_id takes a full library ad id or its AdSwipeFile page URL. Also saves the ad in that workspace. Returns the board, ad, on_board: true and workspace. If the board already has a public share link, the added ad becomes visible to anyone with that link; this tool does not enable or disable sharing. Repeating the same addition does not duplicate the save or board item. Requires write permission and access to saving; an inaccessible board or workspace is refused. Does not modify the original ad or publish it on Meta.
create_board
ChatGPTCreate a new board with name in the specified workspace, or the current workspace when omitted. Use when the user asks to create a board. Optional ad_id takes a full library ad id or its AdSwipeFile page URL and also saves that ad in the workspace and adds it to the new board. Returns the board id, name, ad count, app URL, share_url: null and workspace. The board is visible to people with access to that workspace; its public share link starts off. Each successful call creates a separate board, even if its name already exists; use list_boards to find an existing board. Requires write permission and access to create boards; a locked workspace or board limit is refused. Does not change billing or publish an ad on Meta.
delete_board
ChatGPTDelete one of the account's boards, by id or exact name. Its ads stay saved (list_saved_ads); its share link stops working. Cannot be undone: confirm with the reader first. A board that is not there answers found: false.
find_similar_ads
ChatGPTAds like one ad, from other brands: one row per thing they share, the same hook tactic, the same main visual format and the same niche, as under the ad in the app. Each row holds up to 10 ads, longest Meta run first, at most 2 of one brand and one per brand before a brand's second, never the ad itself or an ad a row above already holds; each with axis (hook, format or niche), the tag's name and slug (list_ads takes it as hook, visual_format or niche) and the row's app url. An ad with no tags yet has only its niche row. A long run is a reason to study an ad, not proof of its results. When the account's plan does not include every ad of a list, each row holds its first 3, with a note saying so. The id may be cut short to its first 8 characters or more, as with get_ad.
follow_brand
ChatGPTFollow a library brand for the account, as the Follow button on its brand page does: its new ads then show in list_followed_ads, and on the following page. Takes the brand slug from search_library or list_brands (or its plain name). Following a brand already followed succeeds and changes nothing. Returns how many brands the account follows and how many its plan allows. When the plan follows no brands, or the account is at its plan's cap, nothing is followed and the answer says so: relay it once, do not retry.
get_ad
ChatGPTOne ad in full: copy (on plans without ad copy, a line saying it is not included), audiences, brand, niche, formats, its standard tags (visual formats, hook tactic, hook line, asset type, offer type, season, talent; null when not tagged yet), image URL, page URL, run (Meta start date, last day seen, running, days running, landing page) when the ad is tracked on Meta, and why_it_works: a short note on how the ad is built, the mechanism of its hook, format, offer and talent from its tags, plus its run when its brand kept it going a month or more (null when it has neither), never a claim about its results.
get_ads
ChatGPTUp to 10 ads in full in one call, each in the shape get_ad returns (copy, audiences, brand, niche, formats, standard tags, image URL, page URL, run, why_it_works). Use it instead of repeated get_ad calls when reading the ads a search or list returned: one round trip, though each ad counts as one call against the allowance. Ids the library lacks come back under missing (malformed for an item that is not an ad id at all), and the rest still return. On plans without ad copy, the ads come without it, with a line saying so.
get_brand
ChatGPTA brand in brief, as the head of its page in the app: its niche, when its Meta ads were last checked, ads running now, longest and median run (against its niche's median), its top 3 visual formats and hook tactics with ad counts, and whether the workspace follows it. Takes a slug or plain name. For its ads and how it builds them, call list_ads with brand. Run length is a reason to study an ad, never proof of results. Counts as one call.
get_brand_by_domain
ChatGPTThe library brand whose website is the one given: a domain ("glossier.com") or any URL on it ("https://www.glossier.com/products/x"). Use it when the reader names a site rather than a brand. Returns the brand (name, slug for list_ads, page url, niche, how many ads the library holds), match: same_host, parent_domain (what was given is a subdomain of the brand's site) or subdomain (the brand's site is a subdomain of what was given), and source: website (the brand's stored website) or landing_pages (most of the tracked ads linking to the site are this brand's; a marketplace many brands link to names none). When nothing matches, it answers found: false; a brand can sell from another site, so search its name with search_library before saying the library lacks it.
get_format
ChatGPTOne visual format in full, for writing, briefing or tagging an ad in it: gloss (the one line from list_visual_formats), definition, how_to_tell (must_be: what must all hold; not_this: near misses that are another format; quick_test: one question that settles most cases), confused_with (the formats it is mixed up with, each with the line that tells them apart), how_to_build (when_to_use and best_practices) and examples: a few library ads that carry it, longest Meta run first (else newest), each with main (true when it is the ad's main format, false when it is not or the ad's order is not known), image and page URL; read them with get_ads. A format with no guide written yet has its gloss and examples, and null for the rest. Takes a slug from list_visual_formats or the format's plain name. Call it before writing an ad in a format, or to check which format an ad is.
get_hook
ChatGPTA hook tactic in brief, as the head of its page in the app: its line, ads running now, longest run, its share of the library's running ads (share_last_30_days, now against before), and the top 5 visual formats, niches and brands that use it, with ad counts. url opens the full page. Takes a slug from list_hooks or a plain name. For its ads, call list_ads with hook. Counts as one call.
get_niche
ChatGPTA niche in brief, as the head of its page in the app: its line, ads running now, longest and median run, its share of the library's running ads (share_last_30_days, now against before), and its top 5 visual formats, hook tactics and brands with ad counts. url opens the full page. Takes a slug from list_niches or a plain name. For its ads, call list_ads with niche. Counts as one call.
get_trends
ChatGPTWhich visual formats, hook tactics and asset types are taking a bigger share of a niche's ads: the last 30 days against the 30 before, as on the app's Trends page. A share is the part of the niche's ads tracked on Meta and active in the period that carry the tag, so it says what brands make more of, never what performs. Without niche, the whole library. Returns active_ads (the ads the shares are of) and active_ads_before, period, then formats, hooks and asset_types (or only the axis asked for), each tag with share_now and share_before (whole percents), change (points), ads (how many active ads carry it), a few example ad ids to read with get_ads, and its app url; the commonest tags first. rising holds the tags whose share grew most. Below 40 active ads the shares say too little: the lists are empty with a note; try the whole library or a bigger niche. When the account's plan does not include every ad of a list, each list holds its first 3, with a note saying so. Call it for "what's rising in skincare", "which formats are trending", or before suggesting a format.
get_usage
ChatGPTHow many calls the account has used this period (per: a day or a month, UTC, or life for an account with no plan, whose 20 calls never reset), out of how many, and when the count resets (resets_at, null for life). Shared by this server and the JSON API. Reading it costs nothing. Call it before a long run of reads, or when the reader asks how many calls are left.
list_ads
ChatGPTBrowse real ads, newest first, optionally filtered by brand (a competitor's ads), niche and format slug, or by the standard tags: visual_format (list_visual_formats), hook (the hook tactic, list_hooks), season and offer_type. Ads the library has not tagged yet never match a tag filter. Without a brand filter a page keeps a few ads per brand so one advertiser cannot fill it; filter by brand for all of one brand's ads. Ads tracked on Meta carry run (started, last_seen, running, days_running, landing_page); sort: "longest_running" lists those by the longest run, the usual proxy for an ad worth studying (it is not performance data). Paginate with the returned nextCursor; when the account's plan does not include every ad of a list, it stops at its first 20 ads, with no nextCursor and a note saying so. On a plan with every ad of a list, a page counts one call per 10 ads asked for against the allowance (limit: 50 counts 5), so ask for the page you need.
list_boards
ChatGPTThe account's boards (shared with its team), by name: each with its id, its group (the client it is filed under, null for none), how many ads it holds, and its share_url when its share link is on (null when off). The ads on each board come with list_saved_ads. Use the ids or the exact names with the board tools.
list_brands
ChatGPTEvery brand in the library, optionally only one niche's. Each brand comes with updated: the day (YYYY-MM-DD) its Meta ads were last checked for new ones, or null when they have not been.
list_followed_ads
ChatGPTThe brands and Facebook pages you follow on the site, and their newest Meta ads, newest launch first: competitor ads as they go live. Each followed brand comes with its library slug when it has one (use it with list_ads for its filed ads) and its tracking page URL. Empty when the account follows nothing; the result then says where following is set up.
list_followed_brands
ChatGPTThe library brands the account follows, A to Z, each with its slug (use it with list_ads or unfollow_brand) and page URL, plus how many the account follows and how many its plan allows. Empty when it follows none. For their newest ads, use list_followed_ads.
list_formats
ChatGPTEvery ad format (UGC, before/after, testimonial, …) ads are tagged with: the values of list_ads format. The standard visual formats are in list_visual_formats.
list_hooks
ChatGPTEvery hook tactic (curiosity, social proof, myth busting, …) that ads in the library carry, with a one-line description: the device the first frame or the headline uses to earn attention. Pass a slug to list_ads as hook.
list_niches
ChatGPTEvery niche (industry) ads are filed under.
list_saved_ads
ChatGPTThe ads you saved on the site, newest first, then the competitor ads saved from brands you follow (tracked_ads). Each comes with your team's note on it and the boards it is on, with each board's note: the reader's own reasons for keeping it.
list_visual_formats
ChatGPTEvery standard visual format (testimonial, screen recording, us vs them, …) that ads in the library carry, with a one-line description. An ad has up to three. Pass a slug to list_ads as visual_format.
list_workspaces
ChatGPTThe organization's workspaces, oldest first: each with its id, name, current (true for the one calls act in without a workspace argument) and locked (past the plan's workspaces: it cannot be read or changed). Saves, notes, boards and follows belong to one workspace; pass its id or exact name as workspace to the tools that take one. Reading it costs nothing.
remove_ad_from_board
ChatGPTTake an ad off one of the account's boards; it stays saved. An ad that is not on the board succeeds and changes nothing.
rename_board
ChatGPTRename one of the account's boards (by board id or exact name) with name, file it under a client with group (an empty string takes it out of its client; on a plan that does not file boards by client, the client is left as it was and the answer says so), or both. Its ads, notes and share link stay as they are.
save_ad
ChatGPTSave a reference to an existing library ad in the specified workspace, or the current workspace when omitted. Use when the user asks to save an ad. ad_id takes a full library ad id from list_ads, search_library or get_ad, or its AdSwipeFile page URL. Returns the ad id and URL, saved: true, the saved-ads page URL and workspace. The save is visible to people with access to that workspace and appears in list_saved_ads. Repeating a save does not create a duplicate or replace notes. Requires write permission and access to saving; otherwise returns a refusal without saving. Does not add the ad to a board, turn on a public share link, download a file to the user device or change the original ad on Meta.
search_library
ChatGPTFind real Meta (Facebook and Instagram) ads for ad inspiration, hooks, angles, competitor research or a swipe file. Keyword search across ads, brands, niches and formats. Matches whole words in each ad's copy and in a description of its visual (so "screenshot" or "before after" work); only ads holding every word come back when there are any, else ads holding some (match says "all", "partial" or "none", with a hint). When no ad holds every word as written, a last word of 4+ letters is also read as a word start ("cust" finds customer; the hint says so). When nothing matches at all, misspelt words are corrected to the closest words the library's names and ads use and searched once more; corrected_query then says what was searched. Use 1–3 English product or format words; long phrases match little. Returns each hit's type, slug or id, and page URL. Start here when you have a product, brand or idea rather than an exact slug; when match is "none", follow the hint: it names a matching niche or format, or says the library has nothing on it.
set_ad_note
ChatGPTWrite the workspace's note on a saved ad (why it is worth keeping, what to borrow), or with board the note on that board's copy of it. Replaces the note there, and the old text is not kept; an empty note clears it. When the ad already has a note, show it to the reader and confirm before replacing it. The ad must be saved, or on the board, first (save_ad, add_ad_to_board). Notes come back in list_saved_ads.
share_board
ChatGPTTurn on a board's share link and return it as share_url: anyone with the link sees the board and its ads, without an account. A board already shared returns its current link unchanged.
submit_feedback
ChatGPTReport to the AdSwipeFile team: a brand the library lacks (missing_brand, with brand), a wrong tag on an ad (wrong_tag, with ad_id), a tool that answered wrongly or failed (broken_result, with tool and context: the arguments it was called with and what came back), or something the reader wants (feature_request). Send it when the reader asks to report something, or once, after asking the reader, when a result is plainly wrong. Never put personal data in it. Free on every plan; each call files one report, so do not repeat it. Returns received: true.
switch_workspace
ChatGPTMake a workspace (id or exact name, from list_workspaces) the one this connection works in. Every later call without workspace reads and writes there until the next switch. Only this connection moves, not the reader's workspace on the site. Returns the workspace now active and the previous one. A workspace the caller may not use is refused and nothing moves. Switch only when the reader asks to work on another client or brand, and say which workspace you are in. Free.
unfollow_brand
ChatGPTStop following a library brand: its new ads leave list_followed_ads and the following page. Open on every plan. Unfollowing a brand the account does not follow succeeds and changes nothing.
unsave_ad
ChatGPTUnsave an ad: it leaves list_saved_ads and every board it was on, and its notes go with it. Confirm with the reader first when it is on a board. An ad that is not saved succeeds and changes nothing.
unshare_board
ChatGPTTurn off a board's share link: the old link stops working at once. Sharing it again later makes a new link. A board whose link is already off succeeds and changes nothing.
get_ad
Claudelist_ads
Claudelist_brands
Claudelist_followed_ads
Claudelist_formats
Claudelist_niches
Claudelist_saved_ads
Claudesearch_library
Claude