AdAgnt

User wants to add another ad/creative variation to an EXISTING ad set. DO NOT USE to create a new campaign. For new campaigns: - Video campaign - `create_meta_video_campaign` - Image campaign - `create_meta_image_campaign` - Carousel campaign - `create_meta_carousel_campaign` Common scenarios: - A/B test ad copy: Different headlines, primary text, or CTAs for the same audience - A/B test creatives: Different images or videos for the same audience - Format testing within one audience: Image vs ⚠️ WRITE — confirm the exact values with the user before calling; call once; never retry automatically on error (the change may already have applied); verify with a separate read.

add_meta_ad

User wants to add a new ad set to an EXISTING campaign. Common scenarios: - Audience testing: Same ad format, different targeting/interests per ad set (e.g., "4 ad sets with different interests") - Multi-format: Different ad types (image + video + carousel) under one campaign - Budget split: Same creative, different budgets per audience segment - Scaling: Adding new audiences/markets to an existing campaign - Geographic split: Same ad, different locations per ad set - Dynamic Creative (DCO): Se ⚠️ WRITE — confirm the exact values with the user before calling; call once; never retry automatically on error (the change may already have applied); verify with a separate read.

add_meta_ad_set

Add negative keywords to a campaign. Negative keywords prevent your ads from showing for certain searches. They help save budget by avoiding irrelevant clicks. **Parameters:** - campaign_id: The campaign ID (REQUIRED - get from list_campaigns) - keywords: List of negative keywords to add - customer_id: Optional **Each keyword needs:** - text: The keyword phrase (e.g., "free", "cheap", "diy") - match_type: EXACT, PHRASE, or BROAD (default: BROAD) **Campaign-level vs Ad Group-level:** This add ⚠️ WRITE — confirm the exact values with the user before calling; call once; never retry automatically on error (the change may already have applied); verify with a separate read.

add_negative_keywords

Add an audience signal to an existing Performance Max campaign. Audience signals hint Google AI about who your ideal customers are. Uses in-market segments (actively researching), affinity segments (long-term interests), and custom audiences (remarketing lists, customer match). Use search_audiences tool first to discover relevant audience segment IDs. **Parameters:** - campaign_id: The PMax campaign ID - audience_config: Dict with segment IDs **Execution time:** 2-5 seconds ⚠️ WRITE — confirm the exact values with the user before calling; call once; never retry automatically on error (the change may already have applied); verify with a separate read.

add_pmax_audience_signal

Add search themes to an existing Performance Max campaign. Search themes hint Google AI about what customers search for. Max 50 per asset group. NOT keywords — no match types, no bids, no quality scores. **Best practices:** - Derive from keyword research results, business profile, or user input - Keep themes specific but not too narrow (2-5 words ideal) - Avoid generic themes like "buy stuff" or overly specific ones like "buy red nike air max 97 size 12" **Parameters:** - campaign_id: The PMa ⚠️ WRITE — confirm the exact values with the user before calling; call once; never retry automatically on error (the change may already have applied); verify with a separate read.

add_pmax_search_themes

Add sitelink extensions to a campaign. Sitelinks are clickable links to specific pages on your website. Recommended 4-6 sitelinks per campaign. **CONSTRAINTS:** - link_text max 25 characters - description1 max 35 characters (optional) - description2 max 35 characters (required if description1 is set) **EXAMPLE SITELINKS:** `{` "link_text": "How It Works", "final_url": "https://example.com/how-it-works", "description1": "See the platform in action", "description2": "Step-by-ste ⚠️ WRITE — confirm the exact values with the user before calling; call once; never retry automatically on error (the change may already have applied); verify with a separate read.

add_sitelinks

Add structured snippet extensions to a campaign. Structured snippets highlight specific aspects of your products/services. **VALID HEADERS:** - AMENITIES, BRANDS, COURSES, DEGREE_PROGRAMS, DESTINATIONS - FEATURED_HOTELS, INSURANCE_COVERAGE, MODELS, NEIGHBORHOODS - SERVICE_CATALOG, SHOWS, STYLES, TYPES **RULES:** - Header must be from predefined list - 3-10 values required per snippet - Each value max 25 characters **EXAMPLES:** For SaaS/Platform: Header: "Types" Values: ["Google Ads" ⚠️ WRITE — confirm the exact values with the user before calling; call once; never retry automatically on error (the change may already have applied); verify with a separate read.

add_structured_snippets

Add a new ad to an existing TikTok ad group. Use this when you need to add additional ads (creatives) to an ad group that was already created. Supports all ad formats: - SINGLE_IMAGE: Provide image_urls (public HTTPS URLs — auto-uploaded) OR image_ids (pre-uploaded TikTok IDs) - SINGLE_VIDEO: Provide video_id (TikTok video ID from creative library) - Spark Ads: Boost organic TikTok posts (requires tiktok_item_id + identity_type=TT_USER) - Carousel: Multi-card ads (first call create_tiktok_caro ⚠️ WRITE — confirm the exact values with the user before calling; call once; never retry automatically on error (the change may already have applied); verify with a separate read.

add_tiktok_ad

Add a new ad group to an existing TikTok campaign. Use this when you need to add additional ad groups to a campaign that was already created. Each ad group can have different targeting, budget, and placement settings. This is useful for: - A/B testing different audiences under the same campaign - Splitting budget across different targeting strategies - Adding new targeting segments to an existing campaign Required: campaign_id, adgroup_name, budget. The objective parameter determines automati ⚠️ WRITE — confirm the exact values with the user before calling; call once; never retry automatically on error (the change may already have applied); verify with a separate read.

add_tiktok_ad_group

User asks about ad/creative performance, wants to identify winning/losing ad variations, or asks about creative fatigue. Analyzes LinkedIn creative/ad performance: Returns: - Top performing creatives by engagement rate - Underperforming creatives needing attention - Creative fatigue indicators (running too long) - Video performance (views, completion rates) - Engagement breakdown per creative - Recommendations for creative refresh Creative Metrics: - Impressions, clicks, CTR - Engagement rate

analyze_linkedin_creative_performance

User asks about wasted ad spend, unprofitable campaigns, where their LinkedIn budget is being wasted, or wants to identify underperformers. Identifies LinkedIn campaigns and B2B segments wasting money: Campaign Analysis: - Campaigns losing money (ROAS `<` 1.0 = actual loss) - Campaigns underperforming (ROAS below target = opportunity cost) - Severity classification (CRITICAL, HIGH, MEDIUM) - Wasted spend calculation per campaign B2B Demographic Waste: - Seniority levels with poor ROAS - Indus

analyze_linkedin_wasted_spend

User wants detailed analysis of specific Meta ads, creative performance, or wants to identify winning/losing ad variations. This tool provides ad-level and creative-level insights for Meta campaigns. Returns: - Top performing ads by CTR and conversion rate - Underperforming ads that need attention - Creative fatigue indicators (high frequency, declining CTR) - Video completion metrics (25%, 50%, 75%, 100% watched) - Creative optimization recommendations When to use this tool: - "Which of my M

analyze_meta_ad_performance

User asks about Meta/Facebook/Instagram audience performance by demographics, age group or gender targeting optimization, audience saturation, or which demographic segments to target or exclude. This tool provides deep analysis of audience segment performance and detects audience saturation to optimize demographic targeting for Meta Ads. Returns: - Age group performance breakdown (18-24, 25-34, 35-44, 45-54, 55-64, 65+) - Gender performance breakdown (male, female, unknown) - Age + Gender comb

analyze_meta_audiences

User asks about Meta/Facebook/Instagram ad spend efficiency, wasted money, underperforming campaigns, placement optimization, or creative fatigue. This tool identifies Meta Ads campaigns and placements that are wasting money by performing below target ROAS or below breakeven (ROAS `<` 1.0). It extends the base wasted spend detector with Meta-specific features: Returns: - Campaign-level wasted spend analysis (ROAS `<` 1.0 = actual losses) - Underperforming spend analysis (1.0 `<`= ROAS `<` targ

analyze_meta_wasted_spend

Discover keyword opportunities and optimize match types by analyzing actual search terms. ⚠️ IMPORTANT: This tool retrieves READ-ONLY data. Safe to call multiple times. Google Ads only - NOT available for TikTok. 🎯 **What This Tool Does (Performance Agent - Phase 1 Feature 3):** - Identifies OPPORTUNITY keywords: Converting search terms NOT in your keyword list - Identifies NEGATIVE keywords: Expensive terms with zero conversions - Analyzes MATCH TYPE performance: Exact vs Phrase vs Broad effi

analyze_search_terms

Analyze TikTok geographic/country-level performance. Returns: per-country spend, conversions, CPA, CTR, hook rate, engagement. Best/worst countries with recommendations. Note: TikTok uses country-level breakdowns (not placement-level like Meta's Feed/Stories/Reels). When to use: "TikTok performance by country", "Which countries perform best on TikTok?", "TikTok geo breakdown" Parameters: - lookback_days: default 30

analyze_tiktok_geo_performance

Analyze TikTok campaigns for wasted ad spend. Identifies campaigns losing money (ROAS `<` 1.0) and underperforming campaigns (ROAS `<` target). Returns: wasted spend by campaign, severity levels (CRITICAL/HIGH/MEDIUM), creative fatigue analysis, status-aware recommendations (distinguishes active vs disabled campaigns). When to use: "Where am I wasting money on TikTok?", "TikTok wasted spend", "Which TikTok campaigns are losing money?" ⚠️ NEVER say "pause" for campaigns with conversions. Say "

analyze_tiktok_wasted_spend

Analyze wasted ad spend and identify campaigns losing money or underperforming. ⚠️ IMPORTANT: This tool retrieves READ-ONLY data. Safe to call multiple times. 🎯 **What This Tool Does (Performance Agent - Phase 1):** - Identifies campaigns LOSING money (ROAS `<` 1.0x) - Identifies campaigns UNDERPERFORMING (1.0x ≤ ROAS `<` target) - Separates true waste from opportunity cost - Provides severity-based classification (CRITICAL/HIGH/MEDIUM) - Generates actionable recommendations with expected impa

analyze_wasted_spend

Find where a Reddit account is leaking money: ad groups and communities with spend but no conversions, ads with clicks that never convert, and budgets pinned to underperforming targeting. Read-only — it recommends changes and never makes them.

reddit_analyze_wasted_spend

Find where an X account is leaking money: line items and keywords with spend but no conversions, promoted posts with clicks that never convert, and budgets pinned to underperforming targeting. Read-only — it recommends changes and never makes them.

x_ads_analyze_wasted_spend

Apply a previously listed recommendation by id. Mutates the underlying entity (budget/bid/keyword) accordingly and returns the before/after. ⚠️ WRITE — confirm the exact values with the user before calling; call once; never retry automatically on error (the change may already have applied); verify with a separate read.

amazon_apply_recommendation

User wants to add conversion tracking to a campaign. Associate an existing conversion with a campaign. Parameters: - campaign_id: Campaign to associate conversion with - conversion_id: Conversion ID to associate Execution time: 2-3 seconds ⚠️ WRITE — confirm the exact values with the user before calling; call once; never retry automatically on error (the change may already have applied); verify with a separate read.

associate_linkedin_conversion

Attach (activate) a creative set so it serves within its campaign. ⚠️ WRITE — confirm the exact values with the user before calling; call once; never retry automatically on error (the change may already have applied); verify with a separate read.

applovin_attach_creative_set

Review your conversion tracking setup across ad platforms. Checks Meta Pixel (event volume, CAPI status, dedup, diagnostics), LinkedIn (conversion rules, CAPI, Insight Tag), and Google Ads (conversion actions, enhanced conversions, attribution). Returns a health score (0-100), grade (A-F), detailed findings, and suggestions with self-validation steps for each platform. Note: Some checks rely on API data availability and may not capture all configurations. Where findings are inconclusive, the to

audit_conversion_tracking

User wants to update multiple LinkedIn campaigns at once (bulk operations). Batch update status, budget, or other settings across multiple campaigns simultaneously. Parameters: - campaign_ids: List of campaign IDs to update (1-50, required) - status: New status for all campaigns (ACTIVE, PAUSED, or ARCHIVED) - daily_budget: New daily budget for all campaigns (minimum $10) - total_budget: New total budget for all campaigns - account_id: Optional LinkedIn Ad Account ID Example Prompts: - "Pause ⚠️ WRITE — confirm the exact values with the user before calling; call once; never retry automatically on error (the change may already have applied); verify with a separate read.

batch_update_linkedin_campaigns

Pull brand funnel metrics — awareness, consideration, and purchase shopper counts plus new-to-brand share — for the account over a window.

amazon_get_brand_metrics_report

User wants to browse all targeting options in a specific category without a search query. This tool retrieves all options in a Meta targeting category for exploration and discovery. Returns: - List of all targeting options in the category - IDs, names, and audience sizes - Useful for discovering targeting options when user doesn't have a specific query When to use this tool: - "Show me all available behaviors for Meta targeting" - "What interest categories are available?" - "Browse demographi

browse_meta_targeting

Browse the product category taxonomy available for product targeting, with category ids you can pass to create_sp_targets / create_sd_targets.

amazon_get_targeting_categories

Clone a creative set (and its assets) into a new creative set, optionally into a different campaign. Useful for A/B testing creative variations. ⚠️ WRITE — confirm the exact values with the user before calling; call once; never retry automatically on error (the change may already have applied); verify with a separate read.

applovin_clone_creative_set

User wants to duplicate, copy, or clone a LinkedIn campaign. Clone an existing campaign with optional overrides for name, budget, locations, and creatives. Parameters: - source_campaign_id: Campaign ID to clone (required) - new_name: Name for the cloned campaign (default: '`{original}` - Copy') - daily_budget: Override daily budget for the clone - locations: Override location targeting for the clone - status: Status for new campaign (default: PAUSED for safety) - copy_creatives: Copy creatives ⚠️ WRITE — confirm the exact values with the user before calling; call once; never retry automatically on error (the change may already have applied); verify with a separate read.

clone_linkedin_campaign

Registers a revenue source (GA4, Shopify, Stripe, or Klaviyo) and builds a 90-day revenue baseline for attribution. IMPORTANT — say this to the user: AdAgnt does not yet pull orders from these providers. The revenue stream is MODELLED from your campaign conversions and the average order value you supply, so true ROAS is a calibrated estimate, not measured revenue. Live order ingestion is not implemented. Never describe the result as real or verified revenue. ⚠️ WRITE — confirm the exact values with the user before calling; call once; never retry automatically on error (the change may already have applied); verify with a separate read.

connect_revenue_source

Creates a controlled creative A/B test inside a campaign: variant A vs variant B (headlines/descriptions), tracked on a chosen metric until statistical significance. ⚠️ Write tool — creates real ad variants; call once. ⚠️ WRITE — confirm the exact values with the user before calling; call once; never retry automatically on error (the change may already have applied); verify with a separate read.

create_ab_test

Create a new Responsive Search Ad (RSA) in an existing ad group. Useful for A/B testing different ad copy or adding variation to an ad group. **Parameters:** - ad_group_id: The ad group to add the ad to (REQUIRED) - headlines: 3-15 headlines (REQUIRED, max 30 chars each) - descriptions: 2-4 descriptions (REQUIRED, max 90 chars each) - final_urls: Landing page URLs (REQUIRED, at least one) - path1: Optional display path 1 (max 15 chars) - path2: Optional display path 2 (max 15 chars) - customer ⚠️ WRITE — confirm the exact values with the user before calling; call once; never retry automatically on error (the change may already have applied); verify with a separate read.

create_ad

Create a Reddit ad (promoted post) inside an ad group. Reddit ads read as posts, so the headline should sound like a person, not a banner. The ad is created PAUSED for review. Confirm the exact change with the user before calling this, and never call it twice for one request — it is not idempotent and affects live ad delivery. ⚠️ WRITE — confirm the exact values with the user before calling; call once; never retry automatically on error (the change may already have applied); verify with a separate read.

reddit_create_ad

Create an ad group inside a Reddit campaign. The ad group holds the bid, the budget, and all targeting. It is created PAUSED — add targeting and at least one ad, then resume it. Confirm the exact change with the user before calling this, and never call it twice for one request — it is not idempotent and affects live ad delivery. ⚠️ WRITE — confirm the exact values with the user before calling; call once; never retry automatically on error (the change may already have applied); verify with a separate read.

reddit_create_ad_group

Create an AppLovin (AXON) app-install/engagement campaign. AXON auto-bids toward the chosen optimization goal — there are no keywords or manual bids. The campaign is created PAUSED by default so you can attach creative sets and review targeting before it serves. Objectives: CPI (installs), CPE (in-app engagement), CPP (in-app purchases), AD_ROAS (return on ad spend). ⚠️ WRITE — confirm the exact values with the user before calling; call once; never retry automatically on error (the change may already have applied); verify with a separate read.

applovin_create_campaign

Create a Reddit campaign. The campaign is created PAUSED so you can add ad groups, targeting, and creative before it serves — resume it with reddit_resume_campaign when the structure is reviewed. Reddit objectives: CLICKS (traffic), IMPRESSIONS (reach/awareness), CONVERSIONS, APP_INSTALLS, VIDEO_VIEWABLE_IMPRESSIONS, CATALOG_SALES, LEAD_GENERATION. Confirm the exact change with the user before calling this, and never call it twice for one request — it is not idempotent and affects live ad delivery. ⚠️ WRITE — confirm the exact values with the user before calling; call once; never retry automatically on error (the change may already have applied); verify with a separate read.

reddit_create_campaign

Create an X (Twitter) campaign. It is created PAUSED so you can add line items, targeting, and promoted posts before it serves — resume it once the structure is reviewed. X objectives: REACH, VIDEO_VIEWS, PRE_ROLL_VIEWS, APP_INSTALLS, WEBSITE_CLICKS, ENGAGEMENTS, FOLLOWERS, WEBSITE_CONVERSIONS. Confirm the exact change with the user before calling this, and never call it twice for one request — it is not idempotent and affects live ad delivery. ⚠️ WRITE — confirm the exact values with the user before calling; call once; never retry automatically on error (the change may already have applied); verify with a separate read.

x_ads_create_campaign

Create a new (empty) creative set under a campaign. Upload assets into it with applovin_upload_assets. ⚠️ WRITE — confirm the exact values with the user before calling; call once; never retry automatically on error (the change may already have applied); verify with a separate read.

applovin_create_creative_set

🔄 LONG-RUNNING TOOL: Creates a Demand Gen campaign across ALL Google channels — YouTube, Discover, Gmail, Display, and Maps. Emits MCP progress updates during creation (typically 10-20 seconds). ⚠️ CRITICAL WARNING ⚠️ - Call this tool ONLY ONCE per campaign - Creates REAL campaigns that cost REAL money - Do NOT retry automatically if errors occur - Report errors to user instead of retrying 🌐 **Demand Gen Campaign Channels (ALL enabled by default):** ✅ YouTube In-Feed (search results & related ⚠️ WRITE — confirm the exact values with the user before calling; call once; never retry automatically on error (the change may already have applied); verify with a separate read.

create_demandgen_campaign