Your Winning Ads Are Now a Library Your AI Agent Can Use

What shipped

A brand creative library: one place where your best-performing ads, your brand assets, and your AI-generated images live together, described in plain language, and addressable by your AI agent with a single reference id.

Three pieces make it up:

1. A winning-ads library. Point your agent at a top ad and it saves that ad as a durable library entry: which ads run the creative, performance for the source window, a full creative analysis, and a 2-4 sentence description of what the ad actually looks like and says.
2. An asset dictionary. Every brand asset and AI-generated image now carries an automatic description, so an agent scanning your library knows "white logo for dark backgrounds" from "lifestyle product shot" without opening a single file.
3. Copy-paste references. Every item has a stable id (winning_ad:{id}, brand_asset:{id}, generated:{id}). Paste one into a conversation and the agent resolves the full record, including a display URL, with one call.

Saving a winner

Your agent imports a winner with media({action:"save_winning_ad"}) and an ad id. The server does the heavy lifting in one pass:

• It resolves the ad's actual creative (image, video, or an Instagram post the ad boosts).
• It scans the account for every other ad running the same creative and unions them into one entry, so "this creative" and "this ad" stop being different bookkeeping problems. Saving a second ad that runs the same image or video merges into the existing entry instead of duplicating it.
• It pulls 30 days of spend, impressions, CTR, and ROAS across those ads, judged on the ad set's actual optimization goal.
• It runs the same creative analysis Xylo uses for diagnostics (hooks, promise, proof, audience, emotional levers) and distills it into a short description.

Partnership and whitelisting ads, the creator-posted kind whose video files Meta often locks, still import: Xylo resolves the public Instagram source where possible, and when it cannot, the entry keeps its ad ids and performance stats with an explicit warning instead of failing.

On paid plans, Meta winner selection is automatic. Your agent can call media({action:"sync_winning_ads"}) during onboarding, and Xylo refreshes the library every week after that. The server ranks ads within their optimization goal, refuses to import ads with zero results on the event Meta optimized for, keeps a useful image-and-video mix with a bias toward easier-to-remake images, and looks back as far as 120 days when a recent window is thin. It also attributes multi-media ads to the asset that actually produced results. A creative that already has analysis keeps it, so the weekly refresh does not pay to analyze the same pixels again.

Free-plan accounts keep the manual flow above: inspect the winners, choose the proven creative, and save it with save_winning_ad.

The library is curated, not a dump: list_winning_ads shows what is saved, update_winning_ad names or annotates an entry, and delete_winning_ad removes it. Deleting a library entry never touches the ad on the platform, and automatic refresh honors the deletion instead of adding the creative back.

Why an agent needs this

Generated creative is only as good as its references. Xylo's image generation already accepts your logo and product shots as reference images; the library closes the loop by giving the agent your proven ads as references too. "Make me three variations on our best static from the Father's Day sale" now resolves to a specific creative with known performance, not a guess from memory.

It also compounds. accounts({action:"read_brief"}), the call agents make at the start of a session to load your account's saved context, now returns the winning-ads library alongside the brand profile, brand assets, and remembered facts. A fresh conversation starts already knowing which creative won and why.

In the dashboard

The Assets tab now has three sections: Brand assets, Ads, and AI generated. Winner cards show the entry's stats and description, every asset opens a dictionary popup with its full record, and each item has a "Copy ID for Claude" button that copies the reference your agent resolves with media({action:"get_asset"}). AI-generated images are grouped by day and can be saved to your Meta ad account permanently with one click; unsaved generations expire after 7 days.

Where this fits

No new tools to install. Xylo still ships 300+ ad operations across Meta, Google, TikTok, and X through 28 tools; the library lives on the media tool your agent already has, plus a richer read_brief. If your connector is set up, ask your agent to sync your winning Meta ads and the library starts working today.