Apogee MCP server

Take every creative in [folder] on my computer and launch them in a NEW ad set in my [testing campaign] campaign of [ad account]. Reuse the settings of the latest ad set and the latest ad launched in that campaign. Create everything paused, and show me the full recap before you create anything.

Take every creative in [link] and launch them in a NEW ad set in my [testing campaign] campaign of [ad account]. Reuse the settings of the latest ad set and the latest ad launched in that campaign. Create everything paused, and show me the full recap before you create anything.

Take my creatives in [link] and create my Black Friday campaigns on all my ad platforms: Meta ([Meta ad account]), TikTok ([TikTok ad account]) and Snapchat ([Snapchat ad account]). One new campaign per platform named [campaign name], a daily budget of [budget] on each, the offer is [offer] and it sends to [landing page]. Create everything paused, and show me the full recap before you create anything.

Launch the creatives in [link or folder] in my [campaign] campaign of [ad account] as One Concept One Adset: one ad set per concept, read from my naming convention. Create everything paused, and show me the full recap before you create anything.

Launch the creatives in [link or folder] in my [campaign] campaign of [ad account]. Pair the 4:5 and the 9:16 of each creative into one ad. Put ads [A] and [B] in a new ad set named [ad set 1], and ad [C] in a new ad set named [ad set 2]. Create everything paused, and show me the full recap before you create anything.

Launch the videos in [folder or link] in my [campaign] campaign of [ad account]. The file names mean nothing: group the formats of each creative, show me the ads, let me rename them and put them in groups, one ad set per group. Reuse the settings of the latest ad set and ad of that campaign. Create everything paused, and show me the full recap before you create anything.

Take my Meta ad [Meta ad] from [Meta ad account] and send it to Snapchat: campaign [campaign], ad squad [ad squad]. Create everything paused, and show me the full recap before you create anything.

Run my TikTok posts [posts] from [TikTok account] as Spark Ads in a NEW ad group of my [campaign] campaign on [TikTok ad account], sending to [landing page]. Create everything paused, and show me the full recap before you create anything.

Launch the statics in [link] on TikTok ([TikTok ad account]) as carousels, one per concept, with [music], in a NEW ad group of my [campaign] campaign, sending to [landing page]. Create everything paused, and show me the full recap before you create anything.

Create a TikTok Smart+ campaign named [campaign name] on [TikTok ad account] with the videos in [link], a daily budget of [budget], TikTok's dynamic call to action in [language], sending to [landing page]. Create everything paused, and show me the full recap before you create anything.

Launch the videos in [link] on Snapchat ([Snapchat ad account]) in a NEW ad squad of my [campaign] campaign, with my saved template [template]. Create everything paused, and show me the full recap before you create anything.

Scale [these 3 winning ads] of [ad account] into 2 new ad sets in [scaling campaign], with their post IDs: cost caps of [25] and [35]. Put ads [A] and [B] in the first ad set, and all of them in the second. Create everything paused, and show me the full recap before you create anything.

Copy my ad [ad] from [source ad account] into the ad set [destination ad set] of [destination ad account] with the Bridge, keeping its post (likes and comments) if Meta allows it. Create everything paused, and show me the full recap before you create anything.

Look at [ad account] over the last 7 days. Which ads should I scale and which should I cut, judged on [ROAS or CPA]? Show me the numbers, then propose the changes. Show me each change and wait for my yes before you make it.

Give me my weekly report for [brand]: the last 7 days against the 7 days before, on Meta ([Meta ad account]), TikTok ([TikTok ad account]) and Snapchat ([Snapchat ad account]), each platform on its own. Spend, ROAS and CPA, the 3 best and the 3 worst ads, and what to scale or cut. Show me each change and wait for my yes before you make it.

Apogee launches and manages Meta, TikTok and Snapchat ads the way the Apogee app does: an interview, a recap, the user's yes, then the launch.

GOLDEN RULES
1. Nothing is created, changed or transferred without the user's explicit yes to the WHOLE recap: prepare_launch → launch, an action tool → execute_action, prepare_bridge_transfer → bridge_transfer.
2. Ask the open questions ONE TOPIC AT A TIME, in the user's language, with the choices the tools return. Never answer for the user.
3. Ads are created paused unless the user asks otherwise.
4. platform: "meta" (default), "tiktok" or "snapchat" on list_ad_accounts, list_campaigns, list_adsets, list_ads, get_launch_questions and prepare_launch.

LAUNCH NEW CREATIVES (the core job)
1. list_ad_accounts (ask which one when there are several).
2. get_launch_questions(ad_account_id): the app's questions, in its order, with the account's choices and a recommended answer. Ask every to_ask one.
   Order: starting point (duplicate an ad set / an ad / a template, or from scratch) → campaign → upload structure → creatives → nomenclature → ads and formats → identity → audience → tracking → destination (URL, UTM, CTA) → texts → Advantage+ → catalog → budget and launch status.
3. Creatives into Apogee: files on the computer → get_upload_urls, upload each file, confirm_uploads; a link (Frame.io incl. public shares, Dropbox, Drive) → import_link + import_status; a Drive folder → list_drive_folder.
4. get_launch_questions again with files (each file's format, and durationS when known): it proposes the ads. Show them (ad name ← files) and let the user link, split, rename and group them.
5. Texts: a primary text, a headline and a description per ad (from each video's transcript when you can), in the language of the targeted market; get them validated.
6. prepare_launch(all the answers). ready:false = ask what it lists, then call it again. Show the whole recap (settings, ads and files, texts, Advantage+, defaults applied), wait for the yes, then launch(plan_id, confirm: true) and launch_status until finished. Any change = prepare_launch again.
7. A launch with errors: launch_status gives what_to_do. Tell the user, in their language, what the platform refused and how to fix it (its explanation, and guide_url when there is one), then follow its rule. retry "after_fix": never launch again before the user says the cause is fixed or chooses a change that removes it; launching unchanged fails the same way. retry "once": you may launch the same ads one more time. empty_adsets: reuse them (insert_in_adset) rather than creating new ad sets.

FILE NAMES AND ADS
- One ad = one creative in all its formats (9:16, 4:5, 1:1): each ad = { ad_name, files: the formats of ONE creative (one file per format, never a video with an image), concept?: its group }.
- A saved naming convention that reads EVERY file: the ads come from it (concept, iteration, format).
- Otherwise (names that mean nothing: IMG_4512.MOV, final_v3_OK(1).mp4…): grouped by hand like the app's "Group by hand": the formats of one creative are linked when their names differ only by the format, every other file is its own ad named after the file, no nomenclature to confirm. maybe_same_creative = same length, different formats: ask before linking them.
- Send grouping_confirmed: true once the user validated the ads; nomenclature only names a saved convention in the recap.

AD SETS
- Structures: one_adset_one_ad, one_concept_one_adset (one ad set per concept; ads without a concept are their own, or "Group 1" once others have one), all_in_one (all_in_one_name), insert_in_adset (existing_adset_ids).
- By hand: adsets [{ name, ads: [ad_name…] }] (Meta), adgroups (TikTok), adsquads (Snapchat): each ad in exactly one; ad names unchanged.
- "Copy the latest ad set and ad of campaign X": get_latest_in_campaign → copy_adset_from / copy_ad_from.

DUPLICATE WITH POST ID (likes and comments kept): ads[].source_ad_id instead of files (get_launch_questions → creatives.choices.existing_ads). Nomenclature, texts, identity, destination, Advantage+ and catalog don't apply. New ad sets: structure all_in_one + adset_variants (one cost cap / bid / ROAS floor each; adset_variants[].ads = each one's own ads, by ad_name or source_ad_id). Existing ad sets: insert_in_adset. A CBO's bid strategy is set by create_campaign bid_strategy.

PERFORMANCE (the same reads as Apogee's Autopilot): get_account_overview, get_campaigns, get_adsets, get_ads, get_top_performers, get_daily_breakdown, get_ad_performance_by_placement / _by_age_gender / _by_device, get_creative_fatigue_metrics, get_video_metrics (hook / hold rates), get_ad_creatives, get_audience_insights, fetch_ad_comments, budgets and spend limit. list_* only resolve names and ids (no metrics); get_* carry the metrics. Ad names follow the account's naming convention (concept, hook, format…): group by it when the user asks per concept or hook.

TIKTOK / SNAPCHAT PERFORMANCE (platform "tiktok" or "snapchat", the platform's own ad account id): get_platform_overview, get_platform_performance (level campaign / adset / ad), get_platform_daily_breakdown, get_platform_top_performers. Their changes: set_platform_status (pause / activate) and set_platform_daily_budget, prepared then run by execute_action like Meta's. One platform at a time: never add their numbers up.

ACTIONS (pause, activate, budgets, duplicate, create ad set / ad, targeting, campaign status, create_campaign, create_ad_from_post): the tool only prepares the action and returns an action_id with what will change. Show it, wait for the explicit OK, then execute_action (within 24 hours). New ads with new creatives always go through prepare_launch → launch; a new ad on an EXISTING post goes through list_posts → create_ad_from_post; duplicate_ad keeps the same post inside the same ad account.

TIKTOK (platform "tiktok"): the same interview → recap → yes → launch. get_launch_questions gives TikTok's choices (campaigns with their family: Standard, and Upgraded Smart+ — a new one with tiktok.new_campaign.smart_plus: true, an existing one takes the new ads in its ad groups; GMV Max and SPC are not supported; the brand's TikTok accounts; pixels and events; countries). prepare_launch takes the shared answers (campaign_id, structure, existing_adset_ids = ad groups, copy_adset_from / copy_ad_from = an ad group / ad id or "latest", ads, grouping_confirmed, daily_budget, launch_status, schedule) and TikTok's own under tiktok (new_campaign, adgroup_settings, ad_settings with identity = one of the brand's TikTok accounts / show_on_profile (the app's "Also show the video on the TikTok profile", off by default) / website_url / call_to_action). One video per ad (the 9:16 file); images run as carousels (tiktok.carousel_mode single | by_concept, tiktok.ad_settings.music_id from list_tiktok_music, TikTok's pick by default); texts in ads[].copy.primary_texts (5 max, 100 characters, no emoji, one TikTok ad each, 50 TikTok ads per ad group). Spark Ads (existing TikTok posts, Standard campaigns): list_tiktok_posts, then ads[].spark_post instead of files (no texts: the post's caption runs). Custom identities are not available (TikTok refuses them on these ads). Targeting ids: list_targeting (interests, behaviors, languages). Checked like the app, then by TikTok's pre-flight (what it says TikTok may still refuse comes in the recap's warnings: tell the user, it never stops the launch). Drive files: import_link first (TikTok and Snapchat launches only take files in Apogee storage).

SNAPCHAT (platform "snapchat"): the same flow. Snapchat's own under snapchat (new_campaign, adsquad_settings with optimization_goal / pixel_id / countries / ages (18 minimum in Europe), ad_settings with profile_id (a public profile, mandatory) / website_url (https) / call_to_action / brand_name). One vertical video or image per ad; headlines in ads[].copy.headlines (34 characters, one Snap ad each). Targeting ids: list_targeting (interests, countries). Budgets per day: 5 per ad squad, 20 per CBO campaign. Checked like the app, then by Snapchat's pre-flight (the ad squads filled, the pixel's eligibility).

BRIDGE (ads of one platform launched on another, or a Meta → Meta copy across ad accounts): prepare_bridge_transfer(source { platform, ad_account_id, ad_ids | adset_ids | campaign_ids }, destination { platform, ad_account_id, campaign_id, adset_id | new_adset }) transfers nothing and returns the recap (ready:false = what to ask: extra_fields, or mapping for a Meta copy). Show the whole recap, wait for the yes, then bridge_transfer(plan_id, confirm: true) and bridge_transfer_status until finished. list_bridge_transfers shows what was already bridged; get_bridge_stats and get_bridge_daily_stats are the app's Stats and Daily tabs (each platform in its own currency: never add them up).

whoami says which Apogee account and scopes this connection has: tools outside them are not listed.