AdAgnt

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", Changes the ad account. Recorded in the AdAgnt ledger with `intent` (one sentence on why, in the person's words), shown to the account owner.

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" Changes the ad account. Recorded in the AdAgnt ledger with `intent` (one sentence on why, in the person's words), shown to the account owner.

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) Changes the ad account. Recorded in the AdAgnt ledger with `intent` (one sentence on why, in the person's words), shown to the account owner.

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. Changes the ad account. Recorded in the AdAgnt ledger with `intent` (one sentence on why, in the person's words), shown to the account owner.

add_tiktok_ad_group

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

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)

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)

analyze_meta_wasted_spend

Discover keyword opportunities and optimize match types by analyzing actual search terms. 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

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 reports this breakdown at country level. 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?"

analyze_tiktok_wasted_spend

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). Live campaigns additionally require target_cpi, tracking_method, target_countries, and itunes_id for iOS. AppLovin ignores status on create — a new campaign cannot be born live, so launching is always a separate, explicitly approved applovin_set_campaign_status call. Changes the ad account. Recorded in the AdAgnt ledger with `intent` (one sentence on why, in the person's words), shown to the account owner.

applovin_create_campaign

Get one AppLovin campaign in full — objective, platform, budget, ROAS target, targeting, and the number of creative sets attached.

applovin_get_campaign

List AppLovin campaigns for the account with 45-day performance snapshots (spend, installs, revenue, ROAS). Optionally filter by status or by app platform.

applovin_list_campaigns

Set device-level targeting for a campaign: device types (phone/tablet) and connection types (wifi/cellular). Changes the ad account. Recorded in the AdAgnt ledger with `intent` (one sentence on why, in the person's words), shown to the account owner.

applovin_set_device_targeting

Set country-level geo targeting for a campaign: included and/or excluded ISO country codes. Changes the ad account. Recorded in the AdAgnt ledger with `intent` (one sentence on why, in the person's words), shown to the account owner.

applovin_set_geo_targeting

Update an AppLovin campaign's name and/or daily budget. Provide at least one field to change. Changes the ad account. Recorded in the AdAgnt ledger with `intent` (one sentence on why, in the person's words), shown to the account owner.

applovin_update_campaign

Apply a previously listed recommendation by id. Mutates the underlying entity (budget/bid/keyword) accordingly and returns the before/after. Changes the ad account. Recorded in the AdAgnt ledger with `intent` (one sentence on why, in the person's words), shown to the account owner.

amazon_apply_recommendation

Attach (activate) a creative set so it serves within its campaign. Changes the ad account. Recorded in the AdAgnt ledger with `intent` (one sentence on why, in the person's words), shown to the account owner.

applovin_attach_creative_set

Review your conversion tracking setup across ad platforms. Checks Meta Pixel (event volume, CAPI status, dedup, diagnostics) 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.

audit_conversion_tracking

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_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. Changes the ad account. Recorded in the AdAgnt ledger with `intent` (one sentence on why, in the person's words), shown to the account owner.

applovin_clone_creative_set

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. Changes the ad account. Recorded in the AdAgnt ledger with `intent` (one sentence on why, in the person's words), shown to the account owner.

create_ab_test

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. Changes the ad account. Recorded in the AdAgnt ledger with `intent` (one sentence on why, in the person's words), shown to the account owner.

reddit_create_ad_group

Create an ad squad in a Snapchat campaign: type, optimization goal, bid strategy, budget, placement and targeting. Created PAUSED. Snapchat requires at least one country in targeting and either a daily or a lifetime budget. Bids and budgets are in account currency (AdAgnt converts to Snapchat's micros). Changes the ad account. Recorded in the AdAgnt ledger with `intent` (one sentence on why, in the person's words), shown to the account owner.

snapchat_create_ad_squad

Create an audience segment: a FIRST_PARTY customer-list segment (empty until users are added in Ads Manager) or a LOOKALIKE of an existing segment in one country. Changes the ad account. Recorded in the AdAgnt ledger with `intent` (one sentence on why, in the person's words), shown to the account owner.

snapchat_create_audience

Create a Snapchat creative from uploaded media (snapchat_upload_media / snapchat_list_media). Headline max 34 characters, brand name max 25. A WEB_VIEW creative needs an https web_view_url; APP_INSTALL and DEEP_LINK need app details set up in Ads Manager. Changes the ad account. Recorded in the AdAgnt ledger with `intent` (one sentence on why, in the person's words), shown to the account owner.

snapchat_create_creative

Create a new (empty) creative set under a campaign. Upload assets into it with applovin_upload_assets. Changes the ad account. Recorded in the AdAgnt ledger with `intent` (one sentence on why, in the person's words), shown to the account owner.

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). - Creates REAL campaigns that cost REAL money Changes the ad account. Recorded in the AdAgnt ledger with `intent` (one sentence on why, in the person's words), shown to the account owner.

create_demandgen_campaign

Create a line item inside an X campaign. On X, the line item is the ad group: it holds the bid, the budget, the placements, and all targeting criteria. It is created PAUSED — attach targeting and at least one promoted post, then resume it. Changes the ad account. Recorded in the AdAgnt ledger with `intent` (one sentence on why, in the person's words), shown to the account owner.

x_ads_create_line_item

User wants to create a Meta (Facebook/Instagram) carousel ad campaign with multiple images. REQUIRED: You MUST call `select_meta_campaign_type` first and complete ALL phases it describes (audience targeting research via `search_meta_targeting`/`browse_meta_targeting`, asset discovery via `discover_meta_assets`, and user approval) BEFORE calling this tool. IMPORTANT: This tool creates REAL campaigns that will spend money once activated. Campaign is created in PAUSED status for review. DO NOT U ⚠️ 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_meta_carousel_campaign

User wants Meta to automatically TEST MULTIPLE IMAGES and find the best combination. This is Dynamic Creative Optimization (DCO). Meta tests all combinations of images × headlines × primary texts and optimizes delivery automatically. USE THIS TOOL when the user says ANY of these: - "test these images" / "test multiple images" - "let Meta find the winner" / "let Meta optimize" - "Dynamic Creative" / "DCO" - "which image performs best" Changes the ad account. Recorded in the AdAgnt ledger with `intent` (one sentence on why, in the person's words), shown to the account owner.

create_meta_dco_ad

User wants to create a Meta (Facebook/Instagram) single-image ad campaign. REQUIRED: You MUST call `select_meta_campaign_type` first and complete ALL phases it describes (audience targeting research via `search_meta_targeting`/`browse_meta_targeting`, asset discovery via `discover_meta_assets`, and user approval) BEFORE calling this tool. IMPORTANT: This tool creates REAL campaigns that will spend money once activated. Campaign is created in PAUSED status for review. DO NOT USE for video 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.

create_meta_image_campaign

User wants to create a Meta (Facebook/Instagram) video ad campaign. REQUIRED: You MUST call `select_meta_campaign_type` first and complete ALL phases it describes (audience targeting research via `search_meta_targeting`/`browse_meta_targeting`, asset discovery via `discover_meta_assets`, and user approval) BEFORE calling this tool. IMPORTANT: This tool creates REAL campaigns that will spend money once activated. Campaign is created in PAUSED status for review. DO NOT USE for image ads - use ` ⚠️ 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_meta_video_campaign

Create a monitoring alert for your campaigns. Checked daily. **Supported metrics:** roas, ctr, cpc, cpa, cpm, cpv, spend, conversions, impressions, clicks, cost_per_lead, conversion_rate, budget_utilization, video_views, engagement_rate **Operators:** less_than, greater_than, less_than_or_equal, greater_than_or_equal, changes_by **Advanced features:** - **Multiple conditions with AND/OR:** Use `conditions` array with `conditions_logic: "AND"` or `"OR"` Changes AdAgnt's own settings, not the ad account. Recorded in the AdAgnt ledger with `intent` (one sentence on why, in the person's words), shown to the account owner.

create_monitor

🔄 LONG-RUNNING TOOL: Creates a Google Performance Max campaign with validated images. Emits MCP progress updates during authentication, asset upload, and campaign creation (typically 15-30 seconds). Progress stages: validate → commit. Prerequisites: 1. MUST have valid asset_bundle_id from validate_and_prepare_assets tool OR existing_image_ids from discover_existing_assets 3. Creates REAL campaigns that cost REAL money Changes the ad account. Recorded in the AdAgnt ledger with `intent` (one sentence on why, in the person's words), shown to the account owner.

create_pmax_campaign

🔄 LONG-RUNNING TOOL: Creates a Google Ads Search campaign with full structure. Emits MCP progress updates during authentication and campaign creation (typically 5-10 seconds). Progress stages: validate → commit. - Creates REAL campaigns that cost REAL money Changes the ad account. Recorded in the AdAgnt ledger with `intent` (one sentence on why, in the person's words), shown to the account owner.

create_search_campaign

Add targeting keywords to a Sponsored Brands ad group with match types and bids. Changes the ad account. Recorded in the AdAgnt ledger with `intent` (one sentence on why, in the person's words), shown to the account owner.

amazon_create_sb_keywords

Add product/category targeting expressions to a Sponsored Brands ad group. Changes the ad account. Recorded in the AdAgnt ledger with `intent` (one sentence on why, in the person's words), shown to the account owner.

amazon_create_sb_targets