Adspirer REST API

430 tools across Google Ads, Meta, LinkedIn, TikTok, Monitoring, and Audit — callable from any HTTP client. Designed for n8n, Zapier, Make, Python, Node.js, curl, and any language with an HTTP library.

Interactive (Swagger UI) OpenAPI 3.1 spec llms.txt llms-full.txt Get an API key

Quickstart

curl -X POST https://api.adspirer.ai/api/v1/tools/list_connected_accounts/execute \
  -H "Authorization: Bearer sk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"arguments":{}}'

Every request takes the same shape: POST /api/v1/tools/<tool_name>/execute with {"arguments": {...}} as the body. Every response is JSON — no streaming.

Core concepts

Authentication: Bearer API key (sk_live_...). Generate at adspirer.ai/keys.
Idempotency: Pass Idempotency-Key: <uuid> on writes to make retries safe.
Quota: Each plan has a monthly tool-call allowance; current usage is attached to every response.
Multi-account: Customers with multiple connected ad accounts must pass ad_account_id / customer_id / advertiser_id / account_id explicitly.

Amazon Ads (61 tools)

add_amazon_keywords ✏️ Add keywords to a MANUAL SP ad group
add_amazon_negative_keywords ✏️ Block wasteful search terms
add_amazon_product_ads ✏️ Add products (ASINs for vendors, SKUs for sellers) to an existing SP ad group
add_amazon_sb_keywords ✏️ Add keywords to an SB ad group
add_amazon_sb_negative_keywords ✏️ Block search terms on SB campaigns
add_amazon_sb_targets ✏️ SB product targeting — 'expressions' PLURAL with camelCase types (asinSameAs, asinCategorySameAs, asinBrandSameAs) — differs from SP
add_amazon_sb_themes ✏️ Theme-based SB targeting (KEYWORDS_RELATED_TO_YOUR_BRAND /
add_amazon_targets ✏️ Target specific ASINs or categories
amazon_unified_api ✏️ POWER TOOL — direct access to Amazon's modern unified Ads API (/adsApi/v1 create|query|update|delete on campaigns|adGroups|ads|targets across ALL ad products)
analyze_amazon_placements 📖 Placement breakdown (top-of-search vs product pages vs rest-of-search) with ACOS per placement and a placement-bid-adjustment recommendation
analyze_amazon_targeting 📖 Per-keyword/target efficiency with current bids and a bid up/down/negative suggestion per target — the keyword-level optimization loop
analyze_amazon_wasted_spend 📖 Find search terms burning spend with ZERO sales, totaled and ranked — with a ready negative-keyword action plan
create_amazon_ad_groups ✏️ Create Sponsored Products ad groups in existing campaigns
create_amazon_sb_ad ✏️ Create Sponsored Brands ads of ANY type: productCollection (logo+headline+3 ASINs), video, brandVideo, storeSpotlight (store subpages), autoCollection, manualCo
create_amazon_sb_campaign ✏️ Create a Sponsored Brands campaign (brand banner with logo + headline + ≥3 products)
create_amazon_sd_campaign ✏️ Create a Sponsored Display campaign (display/remarketing ads on and off Amazon) with optional ad group
create_amazon_sp_campaign ✏️ Create a complete Sponsored Products campaign: campaign → ad group → product ads (your ASINs/SKUs) → keywords (MANUAL only)
delete_amazon_ad_groups ✏️ Delete (archive) SP ad groups
delete_amazon_campaigns ✏️ Delete (archive) Amazon Ads campaigns
delete_amazon_keywords ✏️ Delete (archive) SP keywords
delete_amazon_negative_keywords ✏️ Remove negative keywords (un-block terms)
delete_amazon_product_ads ✏️ Delete (archive) SP product ads
delete_amazon_sb_keywords ✏️ Archive SB keywords
delete_amazon_targets ✏️ Delete (archive) SP targeting clauses
get_amazon_bid_recommendations 📖 Theme-based suggested bids for targeting expressions in an ad group (AUTO themes or specific keywords)
get_amazon_budget_recommendations 📖 Amazon-recommended daily budgets + estimated missed impressions/clicks/sales for under-budgeted campaigns
get_amazon_budget_usage 📖 Percent of daily budget already consumed per campaign — find campaigns capping out
get_amazon_campaign_performance 📖 Amazon Ads performance report (Reporting v3): impressions, clicks, CTR, spend, purchases, sales, ACOS, ROAS — totals plus per-campaign breakdown
get_amazon_keyword_recommendations 📖 Amazon-suggested keywords with theme metrics
get_amazon_product_performance 📖 Per-ASIN/SKU ad performance — which advertised products convert and which burn spend
get_amazon_purchased_products 📖 Cross-sell intelligence: what shoppers ACTUALLY bought after clicking your ads (incl
get_amazon_report 📖 Fetch Amazon metric rows for a report type + date range, served instantly from Adspirer's nightly-collected warehouse (no polling — Amazon reporting is async)
get_amazon_sb_bid_recommendations 📖 Suggested bids for SB targeting expressions
get_amazon_sb_keyword_recommendations 📖 SB keyword suggestions by creative ASINs or store/landing-page URL
get_amazon_search_terms 📖 Search-term report: the actual shopper queries that triggered SP ads, with spend/sales per term
list_amazon_ad_groups 📖 List Sponsored Products ad groups, optionally filtered to campaigns
list_amazon_campaigns 📖 List Amazon Ads campaigns — Sponsored Products and/or Sponsored Brands — with state, budget and targeting type
list_amazon_keywords 📖 List SP keywords with bids and match types, optionally by campaign
list_amazon_negative_keywords 📖 List SP negative keywords
list_amazon_product_ads 📖 List SP product ads (the advertised ASINs/SKUs), optionally by campaign
list_amazon_profiles 📖 List the user's Amazon Ads advertiser profiles (accounts)
list_amazon_sb_ad_groups 📖 List Sponsored Brands ad groups
list_amazon_sb_ads 📖 List Sponsored Brands ads (creatives)
list_amazon_sb_creatives 📖 List creative versions for SB ads (incl
list_amazon_sb_keywords 📖 List Sponsored Brands keywords
list_amazon_sb_targets 📖 List SB product/category targeting clauses
list_amazon_targets 📖 List SP product/category targeting clauses
optimize_amazon_budget 📖 Budget reallocation plan: per-campaign ACOS crossed with real-time budget usage — identifies efficient campaigns capping out (scale UP) and inefficient spenders
pause_amazon_campaigns ✏️ Pause one or more Amazon Ads campaigns (SP or SB)
resume_amazon_campaigns ✏️ Resume (enable) paused Amazon Ads campaigns (SP or SB)
search_amazon_assets 📖 Browse existing creative assets (brand logos, images, videos) to reuse their asset IDs
update_amazon_ad_groups ✏️ Update SP ad groups (name, state, defaultBid)
update_amazon_campaigns ✏️ Update campaign fields: budget, name, end date, bidding
update_amazon_keywords ✏️ Update SP keyword bids and/or state
update_amazon_product_ads ✏️ Update SP product ads (pause/enable individual products)
update_amazon_sb_ads ✏️ Pause/enable Sponsored Brands ads
update_amazon_sb_creative ✏️ Submit a NEW creative version for an existing SB ad (creative refresh — goes through Amazon moderation)
update_amazon_sb_keywords ✏️ Update SB keyword bids/state (lowercase states: enabled|paused)
update_amazon_sb_targets ✏️ Update SB target bids/state
update_amazon_targets ✏️ Update SP targeting clause bids/state
upload_amazon_asset ✏️ Download an image/video from a URL, validate it against Amazon's creative specs (BRAND_LOGO ≥400×400px ≤1MB; OTHER_IMAGE ≥1200×628px ≤5MB; BACKGROUND_VIDEO MP4/

Audit (1 tools)

audit_conversion_tracking 📖 Review your conversion tracking setup across ad platforms

ChatGPT Ads (31 tools)

archive_chatgpt_ad ✏️ Archive (delete) a single ChatGPT ad
archive_chatgpt_ad_group ✏️ Archive (delete) a ChatGPT Ads ad group
archive_chatgpt_campaign ✏️ Archive (delete) a ChatGPT Ads campaign
chatgpt_geo_lookup 📖 Resolve a location name (e
create_chatgpt_ad ✏️ Create a chat_card ad under an existing ad group
create_chatgpt_ad_group ✏️ Create an ad group under an existing campaign
create_chatgpt_campaign ✏️ Create a campaign by itself (no ad group/ad)
get_chatgpt_ad 📖 Get full detail for one ChatGPT ad, including review status and reason
get_chatgpt_ad_group 📖 Get full detail for one ChatGPT Ads ad group
get_chatgpt_campaign 📖 Get full detail for one ChatGPT Ads campaign
get_chatgpt_conversions_config 📖 Show the brand's ChatGPT Ads conversion-tracking config (Pixel ID, whether a Conversions API key is set, enabled flag, and the ready-to-paste pixel snippet)
get_chatgpt_insights 📖 Full performance reporting at any scope: ad_account, campaign, ad_group, or ad (pass scope + scope_id)
get_chatgpt_performance 📖 Performance for ChatGPT Ads: impressions, clicks, spend, CTR, CPC — by campaign over a lookback window, optionally broken out daily or monthly
launch_chatgpt_ad ✏️ Create a complete ChatGPT ad in one step: campaign → ad group → image upload → chat_card ad
list_chatgpt_accounts 📖 Show the connected ChatGPT Ads (OpenAI Ads) account
list_chatgpt_ad_groups 📖 List ad groups under a ChatGPT Ads campaign
list_chatgpt_ads 📖 List the ads (chat_cards) in a ChatGPT Ads ad group, with review status
list_chatgpt_campaigns 📖 List ChatGPT Ads campaigns with status, daily budget, and review status
list_chatgpt_conversion_events 📖 List the supported ChatGPT Ads conversion event types and their data shapes
pause_chatgpt_ad ✏️ Pause a single ChatGPT ad
pause_chatgpt_ad_group ✏️ Pause a ChatGPT Ads ad group
pause_chatgpt_campaign ✏️ Pause a ChatGPT Ads campaign (stops delivery; resume any time)
resume_chatgpt_ad ✏️ Activate a single ChatGPT ad
resume_chatgpt_ad_group ✏️ Activate a ChatGPT Ads ad group
resume_chatgpt_campaign ✏️ Activate (resume) a ChatGPT Ads campaign — this is the spend gate; delivery starts
set_chatgpt_conversions_config ✏️ Save the brand's Pixel ID and/or Conversions API key (stored encrypted), and enable/disable conversion tracking
test_chatgpt_conversion ✏️ Send a validate-only test conversion event through the Conversions API to verify setup (requires a Pixel ID + Conversions API key already configured)
update_chatgpt_ad ✏️ Update an ad's creative (title, body, target_url), name, and/or status
update_chatgpt_ad_group ✏️ Update an ad group's name, max_bid, status, and/or context_hints
update_chatgpt_campaign ✏️ Update a campaign's daily budget, name, and/or status
upload_chatgpt_creative ✏️ Upload a PUBLIC image URL (square PNG/JPG ≥256px) and get a file_id to use in create_chatgpt_ad

Diagnostic & Helper (13 tools)

diagnose_my_setup 📖 Full account + connection health check: MCP auth (AI-client→Adspirer), ad-platform OAuth tokens, and per-platform health
explain_platform_error 📖 Translate an opaque ad-platform error message into a plain-language cause and the exact next step to fix it
get_campaign_spec 📖 Get the exact required fields, character limits, asset requirements, and enums for a campaign type on a platform
list_what_i_can_do 📖 Personalized capability menu — directly answers 'can it even do X?'
preflight_campaign 📖 Check an ad account is launch-ready BEFORE creating a campaign: billing active, notification email, platform connected, account access, and (Meta) Facebook Page
start_here 📖 Personalized starting point for THIS user
suggest_next_action 📖 Rank the highest-value next things this user can do RIGHT NOW given their connected data — analyze/report on existing campaigns, find wasted spend, set a monito
usage_value_summary 📖 Frame the user's plan as value delivered: tool calls used vs included this period and what those calls accomplished
validate_campaign_draft 📖 Dry-run validate a fully-assembled campaign draft against the platform spec (no platform write)
verify_campaign_is_live 📖 After creating a campaign, confirm it actually exists and is serving (not paused / $0 budget)
weekly_opportunities 📖 Surface 1-3 concrete, high-value optimization opportunities from the user's recent performance (wasted spend, paused-but-spent campaigns, active-but-not-deliver
whats_changed_since_last_visit 📖 Show the user how long they've been away and what moved in their ad accounts since (spend/clicks/conversions trend + biggest-mover campaigns)
why_did_this_fail 📖 Summarize the user's recent failed tool calls and the errors, so you can correct and retry

General (Account Management) (3 tools)

get_connections_status ✏️ View connected ad accounts and OAuth connections
list_connected_accounts ✏️ List all connected ad accounts across platforms
switch_primary_account ✏️ Activate ad accounts for a platform

Google Ads (152 tools)

add_ad_group_audiences ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
add_app_ad_asset ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
add_asset_group_listing_filter ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
add_business_name_asset ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
add_call_asset ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
add_callout_extensions ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
add_campaign_label ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
add_campaign_proximity ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
add_demandgen_ad ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
add_demandgen_ad_group ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
add_display_ad ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
add_display_ad_group ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
add_display_audiences ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
add_display_keywords ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
add_display_placements ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
add_display_topics ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
add_keywords ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
add_negative_keywords ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
add_placement_exclusions ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
add_pmax_asset_group ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
add_pmax_asset_group_asset ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
add_pmax_asset_group_image ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
add_pmax_audience_signal ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
add_pmax_search_themes ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
add_product_group ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
add_search_ad_group ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
add_search_campaign_image ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
add_shopping_ad_group ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
add_shopping_product_ad ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
add_sitelinks ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
add_structured_snippets ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
analyze_search_terms 📖 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
analyze_wasted_spend 📖 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
create_ad ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
create_app_campaign ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
create_conversion_action ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
create_demandgen_campaign ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
create_display_campaign ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
create_label ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
create_pmax_campaign ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
create_search_campaign ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
create_shopping_campaign ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
create_youtube_campaign ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
discover_existing_assets 📖 🔍 Discover existing assets in the Google Ads account (images, sitelinks, callouts, structured snippets)
explain_performance_anomaly 📖 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
get_ad_creative 📖 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
get_ad_group_audiences 📖 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
get_ad_group_demographics 📖 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
get_ad_group_device_bid_modifiers 📖 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
get_ad_group_settings 📖 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
get_ad_performance 📖 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
get_ad_policy_violations 📖 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
get_asset_group_listing_filters 📖 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
get_benchmark_context 📖 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
get_business_profile 📖 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
get_campaign_dates 📖 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
get_campaign_frequency_caps 📖 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
get_campaign_labels 📖 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
get_campaign_performance 📖 Analyze Google Ads campaign performance with comprehensive insights and recommendations
get_campaign_structure 📖 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
get_campaign_targeting 📖 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
get_campaign_tracking 📖 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
get_conversion_action_performance 📖 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
get_demandgen_audiences 📖 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
get_demandgen_channel_controls 📖 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
get_display_ad_group_settings 📖 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
get_display_audiences 📖 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
get_display_demographics 📖 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
get_display_frequency_caps 📖 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
get_display_keywords 📖 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
get_display_placements 📖 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
get_display_topics 📖 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
get_merchant_center_links 📖 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
get_placement_performance 📖 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
get_pmax_asset_groups 📖 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
get_pmax_asset_performance 📖 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
get_pmax_audience_signals 📖 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
get_pmax_search_themes 📖 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
get_product_groups 📖 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
get_reach_frequency 📖 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
get_shopping_settings 📖 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
get_usage_status 📖 Get your current usage status with interactive quota widget
help_user_upload 📖 Show user instructions for uploading images to postimages
infer_business_profile ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
link_merchant_center ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
list_campaign_extensions 📖 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
list_campaigns 📖 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
list_conversion_actions 📖 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
list_google_languages 📖 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
list_labels 📖 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
list_pmax_asset_group_assets 📖 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
list_pmax_asset_group_images 📖 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
optimize_budget_allocation 📖 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
pause_ad ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
pause_ad_group ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
pause_campaign ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
remove_ad ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
remove_ad_group ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
remove_app_ad_asset ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
remove_asset_group_listing_filter ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
remove_callouts ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
remove_campaign ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
remove_campaign_label ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
remove_display_ad ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
remove_display_ad_group ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
remove_display_criteria ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
remove_keywords ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
remove_negative_keywords ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
remove_pmax_asset_group ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
remove_pmax_asset_group_asset ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
remove_pmax_asset_group_image ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
remove_pmax_audience_signal ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
remove_pmax_search_themes ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
remove_product_group ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
remove_sitelinks ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
remove_structured_snippets ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
replace_demandgen_audiences ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
research_keywords 📖 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
resolve_google_locations 📖 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
resume_ad ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
resume_ad_group ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
resume_campaign ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
save_business_profile ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
search_audiences 📖 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
select_google_campaign_type 📖 **USE THIS TOOL FIRST WHEN:** User wants to create a Google Ads campaign but hasn't specified the campaign type
set_ad_group_device_bid_modifiers ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
set_campaign_ad_schedule ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
set_campaign_device_bid_modifiers ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
suggest_ad_content 📖 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
unlink_merchant_center ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
update_ad_content ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
update_ad_descriptions ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
update_ad_group_demographics ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
update_ad_group_settings ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
update_ad_headlines ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
update_bid_strategy ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
update_campaign ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
update_campaign_dates ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
update_campaign_frequency_caps ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
update_demandgen_channel_controls ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
update_display_ad_creative ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
update_display_ad_group ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
update_display_campaign_schedule ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
update_display_demographics ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
update_display_frequency_caps ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
update_keyword ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
update_location_targeting ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
update_pmax_asset_group ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
update_pmax_audience_signal ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
update_product_group ✏️ 🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the u
validate_and_prepare_assets ✏️ 🔄 LONG-RUNNING TOOL — **GOOGLE ADS ONLY**
validate_video 📖 Validate video for ad campaigns (unified tool for all platforms)

integrations (2 tools)

google_analytics ✏️ Read Google Analytics 4 reports and metadata for the user's connected GA4 properties
klaviyo ✏️ Read and act on the user's Klaviyo (email + SMS marketing) account

LinkedIn Ads (56 tools)

add_linkedin_campaign_to_group ✏️ **USE THIS TOOL WHEN:** User wants to add a new campaign with DIFFERENT targeting/audience to an EXISTING campaign group
add_linkedin_carousel_creative ✏️ User wants to add another carousel ad variation to an existing carousel campaign
add_linkedin_creative ✏️ **USE THIS TOOL WHEN:** User wants to add another IMAGE ad/creative to an EXISTING LinkedIn image campaign
add_linkedin_text_creative ✏️ **USE THIS TOOL WHEN:** User wants to add another text ad to an EXISTING TEXT_AD campaign
add_linkedin_video_creative ✏️ **USE THIS TOOL WHEN:** User wants to add another video ad to an EXISTING LinkedIn video campaign
analyze_linkedin_creative_performance 📖 User asks about ad/creative performance, wants to identify winning/losing ad variations, or asks about creative fatigue
analyze_linkedin_wasted_spend 📖 User asks about wasted ad spend, unprofitable campaigns, where their LinkedIn budget is being wasted, or wants to identify underperformers
archive_linkedin_campaign ✏️ User wants to ARCHIVE a LinkedIn campaign (hide it, distinct from pausing)
associate_linkedin_conversion ✏️ User wants to add conversion tracking to a campaign
batch_create_linkedin_campaign_groups ✏️ User wants to create MULTIPLE LinkedIn campaign groups at once
batch_delete_linkedin_campaigns ✏️ User wants to DELETE multiple LinkedIn campaigns at once
batch_update_linkedin_campaigns ✏️ User wants to update multiple LinkedIn campaigns at once (bulk operations)
batch_update_linkedin_creatives ✏️ User wants to change the status of MULTIPLE LinkedIn creatives/ads at once
clone_linkedin_campaign ✏️ User wants to duplicate, copy, or clone a LinkedIn campaign
create_linkedin_campaign_group ✏️ User wants to create a NEW LinkedIn campaign group (folder) to organize campaigns
create_linkedin_carousel_campaign ✏️ **USE THIS TOOL WHEN:** User wants to create a LinkedIn CAROUSEL ad campaign (2-10 swipeable image cards)
create_linkedin_image_campaign ✏️ ⚠️ STOP - DO NOT CALL THIS TOOL DIRECTLY! This tool creates REAL LinkedIn campaigns that cost REAL money
create_linkedin_text_campaign ✏️ **USE THIS TOOL WHEN:** User wants to create a LinkedIn TEXT ad campaign (desktop right rail/top banner)
create_linkedin_video_campaign ✏️ **USE THIS TOOL WHEN:** User wants to create a LinkedIn VIDEO ad campaign
delete_linkedin_campaign ✏️ User wants to DELETE a LinkedIn campaign
delete_linkedin_campaign_group ✏️ User wants to DELETE a LinkedIn campaign group
delete_linkedin_creative ✏️ User wants to delete, archive, or remove a LinkedIn ad/creative
discover_linkedin_assets 📖 User wants to find existing images/videos in their LinkedIn account to reuse
estimate_linkedin_audience_size 📖 User wants to know how many people a LinkedIn campaign's targeting reaches
explain_linkedin_anomaly 📖 User asks why their LinkedIn metrics changed, wants to understand a performance drop/spike, or says something like "My LinkedIn leads dropped 40%, why?" Explai
explain_linkedin_objectives 📖 User asks about LinkedIn campaign objectives or which one to choose
forecast_linkedin_campaign_supply 📖 User wants a forecast of impressions, clicks, and spend for a LinkedIn campaign
generate_linkedin_ad_creatives 📖 User needs ad copy for LinkedIn campaigns
get_linkedin_audience_insights 📖 User asks about B2B audience demographics, which professional segments perform best, targeting optimization, or wants to understand their LinkedIn audience brea
get_linkedin_campaign_performance 📖 User asks about LinkedIn Ads performance, campaign metrics, B2B engagement, ROAS, or wants to understand how their LinkedIn campaigns are performing
get_linkedin_campaign_structure 📖 User wants full details about a specific LinkedIn campaign
get_linkedin_campaign_targeting 📖 User wants to copy targeting from one campaign to another
get_linkedin_engagement_metrics 📖 User asks specifically about LinkedIn engagement, social actions, lead generation metrics, or video performance
get_linkedin_organizations 📖 Fetch the LinkedIn Organizations (Company Pages) AND Ad Accounts the user can manage
list_linkedin_campaign_groups 📖 User wants to see their LinkedIn campaign groups (also called campaign folders or groups)
list_linkedin_campaigns 📖 User wants to see all their LinkedIn campaigns with performance metrics
list_linkedin_conversions 📖 User wants to see available conversion tracking options
list_linkedin_creatives 📖 User wants to see all ads in a LinkedIn campaign
manage_linkedin_conversions ✏️ User wants to manage LinkedIn conversion tracking - list, create, associate conversions, or set up full conversion tracking
optimize_linkedin_budget 📖 User asks how to allocate their LinkedIn budget, wants budget optimization recommendations, or asks "How should I split my LinkedIn spend?" Uses linear program
pause_linkedin_campaign ✏️ User wants to pause an active LinkedIn campaign
pause_linkedin_creative ✏️ User wants to pause a specific ad within a campaign
reactivate_linkedin_campaign ✏️ User wants to REACTIVATE an archived or completed LinkedIn campaign
research_business_for_linkedin_targeting 📖 User wants targeting recommendations based on their business
resume_linkedin_campaign ✏️ User wants to resume a paused LinkedIn campaign
resume_linkedin_creative ✏️ User wants to resume a paused ad
search_linkedin_campaign_groups 📖 User wants to find specific LinkedIn campaign groups by name, status, or ID
search_linkedin_targeting 📖 User needs to find targeting URNs for LinkedIn campaigns
select_linkedin_campaign_type 📖 User wants to create a LinkedIn ad campaign but hasn't specified the campaign type (image, video, carousel, or text)
update_linkedin_campaign ✏️ User wants to modify LinkedIn campaign settings
update_linkedin_campaign_budget ✏️ User wants to change a LinkedIn campaign's budget (daily or total)
update_linkedin_campaign_group ✏️ User wants to modify a LinkedIn campaign group (rename, change status, update budget)
update_linkedin_campaign_schedule ✏️ User wants to change a LinkedIn campaign's end date or schedule
update_linkedin_campaign_targeting ✏️ User wants to add or remove targeting criteria from a LinkedIn campaign
update_linkedin_creative ✏️ User wants to edit a LinkedIn ad/creative
validate_and_prepare_linkedin_assets ✏️ **LINKEDIN ADS ONLY

Meta Ads (58 tools)

add_meta_ad ✏️ User wants to add another ad/creative variation to an EXISTING ad set
add_meta_ad_set ✏️ User wants to add a new ad set to an EXISTING campaign
add_meta_catalog_ad ✏️ User wants to add ANOTHER catalog ad to an existing catalog ad set — e
add_meta_catalog_ad_set ✏️ User wants to add ANOTHER ad set to an existing Advantage+ Catalog campaign — e
analyze_meta_ad_performance 📖 User wants detailed analysis of specific Meta ads, creative performance, or wants to identify winning/losing ad variations
analyze_meta_audiences 📖 User asks about Meta/Facebook/Instagram audience performance by demographics, age group or gender targeting optimization, audience saturation, or which demograp
analyze_meta_catalog_performance 📖 User wants to analyze how their Advantage+ Catalog / Dynamic Product Ads are performing AT THE PRODUCT or PRODUCT-SET level
analyze_meta_wasted_spend 📖 User asks about Meta/Facebook/Instagram ad spend efficiency, wasted money, underperforming campaigns, placement optimization, or creative fatigue
browse_meta_targeting 📖 User wants to browse all targeting options in a specific category without a search query
compare_meta_catalog_product_sets 📖 User wants to compare their catalog PRODUCT SETS against each other and decide where to put budget
create_meta_carousel_campaign ✏️ User wants to create a Meta (Facebook/Instagram) carousel ad campaign with multiple images
create_meta_catalog_campaign ✏️ User wants to create an Advantage+ Catalog ad / Dynamic Product Ad (DPA) — ads that automatically show products from their Meta product catalog
create_meta_dco_ad ✏️ User wants Meta to automatically TEST MULTIPLE IMAGES and find the best combination
create_meta_image_campaign ✏️ User wants to create a Meta (Facebook/Instagram) single-image ad campaign
create_meta_product_set ✏️ User wants to advertise a SUBSET of their catalog — "boost just these items / these SKUs", "promote my sale items", "make a set of my new arrivals"
create_meta_video_campaign ✏️ User wants to create a Meta (Facebook/Instagram) video ad campaign
detect_meta_catalog_waste 📖 User wants to find and recover WASTED catalog spend at the PRODUCT level
detect_meta_creative_fatigue 📖 User asks about creative fatigue, ad refresh timing, frequency management, declining CTR, when to replace ads, or audience exhaustion on Meta/Facebook/Instagram
diagnose_meta_catalog_funnel 📖 User wants to know WHERE in the catalog shopping funnel they're losing shoppers
discover_meta_assets 📖 User wants to browse existing images and videos in their Meta Ad Library for reuse in new campaigns
duplicate_meta_campaign ✏️ User wants to duplicate/copy an existing Meta campaign with all its ad sets, ads, and settings
explain_meta_anomaly 📖 User asks why Meta/Facebook/Instagram performance dropped or changed, what happened to their ROAS/CTR/CPM, or wants to understand why a metric changed during a
get_meta_ad_creatives 📖 User wants to see their Meta ad creatives, ad copy, media URLs, or creative performance
get_meta_adset_performance 📖 User wants ad-set-level Meta performance — the middle layer between campaigns and individual ads
get_meta_app_adsets 📖 User wants PER-AD-SET install cost for app-promotion (AEO) campaigns — drill into a campaign's ad sets to see which audiences/placements deliver the cheapest in
get_meta_app_campaigns 📖 User wants PER-CAMPAIGN install cost for their app-promotion (AEO) campaigns
get_meta_app_creatives 📖 User wants PER-CREATIVE (per-ad) install cost for app-promotion (AEO) campaigns — which creatives/videos drive the cheapest installs
get_meta_app_summary 📖 User wants their mobile-APP-promotion (AEO / App Installs / OUTCOME_APP_PROMOTION) performance — INSTALLS and COST PER INSTALL (CPI)
get_meta_audience_insights 📖 User asks about audience demographics, which placements perform best, device breakdown, or targeting optimization for Meta ads
get_meta_campaign_details 📖 User wants to see detailed information about a specific Meta campaign, including its full structure (ad sets, ads, targeting, budgets)
get_meta_campaign_performance 📖 User asks about Meta/Facebook/Instagram ad performance, campaign metrics, ROAS, spend analysis, or wants to understand how their Meta ads are performing
get_meta_lead_form_submissions 📖 User wants to see lead submissions, lead data, or leads collected from a Meta lead form
get_meta_pixel_stats 📖 User wants to set up RETARGETING catalog ads, or check whether a pixel is firing product events
get_meta_product_performance 📖 User wants to drill into ONE specific catalog product's performance over time — its daily spend/ROAS trend and full funnel (views → carts → checkouts → purchase
list_meta_ad_sets 📖 User wants to see the ad sets within a specific Meta campaign, including their targeting, budgets, and optimization settings
list_meta_ads 📖 User wants to see the individual ads within a specific Meta ad set, including their status and creative information
list_meta_campaigns 📖 User wants to see their existing Meta/Facebook/Instagram campaigns, browse campaign structure, or find a campaign ID
list_meta_catalogs 📖 User wants to browse product catalogs for catalog / dynamic product ads (DPA / Advantage+ Catalog), or before creating a catalog campaign
list_meta_custom_audiences 📖 User wants to browse, list, or select Custom Audiences for targeting — DB lists, lookalike audiences, remarketing segments, website visitors, engagement audienc
list_meta_instagram_accounts 📖 User wants to run ads on Instagram, asks about Instagram accounts, or you need to find the instagram_account_id before campaign creation
list_meta_lead_forms 📖 User wants to see their Meta lead generation forms, list lead forms, or find a lead form ID
list_meta_pixels 📖 User wants conversion tracking, asks about Meta Pixels, or before creating OUTCOME_SALES campaigns
list_meta_product_sets 📖 User wants to see the product sets (groupings) inside a catalog, to choose which products a catalog ad should advertise
list_meta_products 📖 User wants to inspect the individual products in a catalog or product set (to confirm what will be advertised)
optimize_meta_budget 📖 User asks about Meta/Facebook/Instagram budget optimization, reallocating ad spend, maximizing conversions with their budget, or wants data-driven budget recomm
optimize_meta_placements 📖 User asks about Meta/Facebook/Instagram placement performance, which placements work best, Feed vs Stories vs Reels, should they use Audience Network, or wants
pause_meta_campaign ✏️ User wants to pause a running Meta campaign
resume_meta_campaign ✏️ User wants to resume a paused Meta campaign
search_meta_targeting 📖 User wants to find targeting options for their Meta (Facebook/Instagram) ad campaigns
select_meta_campaign_type 📖 User wants to create a Meta (Facebook/Instagram) ad campaign but hasn't specified the campaign type (image, video, carousel, or app)
update_meta_ad ✏️ User wants to update an individual Meta ad — pause/resume it, rename it, or swap its creative
update_meta_ad_set ✏️ User wants to edit an existing Meta ad set's targeting, budget, bid, placements, schedule, or optimization settings
update_meta_campaign ✏️ User wants to update an existing Meta campaign's status, budget, name, or schedule
update_meta_catalog_ad ✏️ User wants to edit/change an existing catalog AD — rename, pause/activate, swap to another creative, or change the copy/headline/description/CTA/landing/product
update_meta_catalog_ad_set ✏️ User wants to edit/change an existing catalog AD SET — deep control: budget, bid amount/strategy, optimization goal, full targeting (geo/age/gender/interests/be
update_meta_catalog_campaign ✏️ User wants to edit/change an existing Advantage+ Catalog CAMPAIGN — rename, pause/activate/archive, change budget (CBO), spend cap, bid strategy, schedule, spec
validate_and_prepare_meta_assets ✏️ **META ADS ONLY
validate_catalog_readiness 📖 User wants to create Advantage+ Catalog / Dynamic Product Ads, or asks "is my catalog ready for ads?"

Monitoring & Reporting (16 tools)

apply_signal_actions ✏️ Apply the pre-staged fixes for a signal (executes on the ad platform)
create_monitor ✏️ Create a monitoring alert for the user's ad campaigns
delete_monitor ✏️ Delete a monitoring alert by its task ID
generate_report_now ✏️ Generate an immediate performance report and deliver it now
get_monitor_history 📖 Show trigger history for a monitoring alert
get_research_status 📖 Check the status of a research job
get_signal_briefing 📖 Open a watch-signal briefing (use this when an Adspirer alert email asks you to)
list_monitors 📖 List all your monitoring alerts
list_pending_actions 📖 List auto-actions waiting for your approval
list_scheduled_tasks 📖 List all your scheduled automation tasks
manage_action ✏️ Approve or reject a pending auto-action
manage_scheduled_task ✏️ Manage a scheduled task — pause, resume, or delete
run_watch_now ✏️ Run the Watch Agent now — an on-demand proactive scan of your ad accounts
schedule_brief ✏️ Schedule recurring performance briefs delivered to your inbox
start_research ✏️ Start an AI-powered research job (runs in background)
test_monitor 📖 Dry-run a monitor against current data WITHOUT triggering alerts or sending notifications

TikTok Ads (37 tools)

add_tiktok_ad ✏️ Add a new ad to an existing TikTok ad group
add_tiktok_ad_group ✏️ Add a new ad group to an existing TikTok campaign
analyze_tiktok_geo_performance 📖 Analyze TikTok geographic/country-level performance
analyze_tiktok_wasted_spend 📖 Analyze TikTok campaigns for wasted ad spend
create_tiktok_campaign ✏️ User wants to create a TikTok ad campaign with IMAGES, Spark Ads, or Carousel ads (not video)
create_tiktok_carousel_card ✏️ Create a carousel card from multiple images for TikTok carousel ads
create_tiktok_video_campaign ✏️ User wants to create a TikTok ad campaign with a VIDEO (not images)
delete_tiktok_ad ✏️ Delete a TikTok ad
delete_tiktok_ad_group ✏️ Delete a TikTok ad group (cascades to child ads)
delete_tiktok_campaign ✏️ Delete a TikTok campaign (DELETE status — cascades to all child ad groups and ads)
detect_tiktok_creative_fatigue 📖 Detect TikTok creative fatigue using video-specific metrics (hook rate decline, completion rate decline, engagement decline, frequency)
discover_tiktok_assets 📖 User wants to reuse existing TikTok images instead of uploading new ones
explain_tiktok_anomaly 📖 Explain why a TikTok metric changed during a specific period
explain_tiktok_objective 📖 Explain what a TikTok campaign objective requires BEFORE attempting to create one
get_tiktok_ad_group_details 📖 Get full details for a single TikTok ad group: targeting, placements, pixel/optimization event, schedule, and timestamps
get_tiktok_ad_performance 📖 Get TikTok ad-level performance with creative details, video metrics, and engagement
get_tiktok_audience_insights 📖 Analyze TikTok audience segment performance by age, gender, and combined demographics
get_tiktok_campaign_details 📖 Get detailed information about a specific TikTok campaign including status, budget, objective, and timestamps
get_tiktok_campaign_performance 📖 Get TikTok campaign performance metrics including TikTok-specific video and engagement data
list_tiktok_ad_groups 📖 List TikTok ad groups
list_tiktok_ads 📖 List TikTok ads
list_tiktok_campaigns 📖 List all TikTok campaigns with their status, objective, and budget
list_tiktok_custom_audiences 📖 List DMP custom audiences on the advertiser (customer-list, pixel-event, lookalike audiences)
list_tiktok_identities 📖 List every TikTok identity available on the advertiser (BC_AUTH_TT, TT_USER, etc
list_tiktok_saved_audiences 📖 List saved (re-usable demographic + interest) audiences
optimize_tiktok_budget 📖 Optimize TikTok budget allocation using linear programming to maximize conversions
pause_tiktok_ad ✏️ Pause a TikTok ad
pause_tiktok_ad_group ✏️ Pause a TikTok ad group
pause_tiktok_campaign ✏️ Pause a TikTok campaign
resume_tiktok_ad ✏️ Resume a paused TikTok ad
resume_tiktok_ad_group ✏️ Resume a paused TikTok ad group
resume_tiktok_campaign ✏️ Resume a paused TikTok campaign
search_tiktok_targeting 📖 Search TikTok targeting options for campaign creation and ad group management
update_tiktok_ad_group ✏️ Update TikTok ad group settings: name, budget, targeting (age, gender, locations), schedule
update_tiktok_campaign ✏️ Update TikTok campaign settings like name, budget, or budget mode
upload_tiktok_images ✏️ Upload images to TikTok Asset Library from public URLs
validate_and_prepare_tiktok_assets ✏️ **TIKTOK ADS ONLY

Adspirer REST API — adspirer.ai