Adspirer REST API

509 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 (64 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_sp_video ✏️ Guidance on attaching a video to a Sponsored Products product ad
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|adExtensions across ALL a
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), including SB video
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_moderation 📖 Read an Amazon ad's moderation (review) status — APPROVED, IN_PROGRESS, REJECTED, or FAILED — including per-component (image/text/VIDEO) results and policy-viol
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_brands 📖 List the Brand Registry entities for an Amazon profile and return each brand's brandEntityId
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)
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 (50 tools)

add_chatgpt_custom_audience_members ✏️ Add identifiers (email/phone/hashed/gaid) to an audience — inline (up to ~10,000 {identifier_type, identifier} objects) or a file_id
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
archive_chatgpt_custom_audience ✏️ ⛔ PERMANENTLY archive a custom audience — it can no longer be used for targeting
cancel_chatgpt_custom_audience_operation ✏️ Cancel an add/remove operation on an audience (the API reports a cancelled op as status 'failed')
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)
create_chatgpt_conversions_api_key ✏️ Create a Conversions API key for server-side conversion events
create_chatgpt_custom_audience ✏️ Create a custom audience — empty (add members after) or seeded from an uploaded file_id
create_chatgpt_event_setting ✏️ Create a conversion event setting that ties a conversion event (e
create_chatgpt_pixel ✏️ Create a web measurement Pixel for conversion tracking (no need to go into OpenAI Ads Manager)
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_conversion_insights 📖 Conversion reporting for ChatGPT Ads: conversions, click-through conversions, and view-through conversions (1-day, reported separately — not added into the tota
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_custom_audience 📖 Retrieve one custom audience: status (processing→ready/too_small/failed), matched-user range, uploaded/invalid identifier ranges, and membership revision
get_chatgpt_custom_audience_operation 📖 Poll one audience operation by id for its status (processing/succeeded/failed)
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, with status, billing event, and max bid (in the account currency)
list_chatgpt_ads 📖 List the ads (chat_cards) in a ChatGPT Ads ad group, with status, creative title, and review status
list_chatgpt_campaigns 📖 List ChatGPT Ads campaigns with status, bidding type, daily budget, and review status
list_chatgpt_conversion_events 📖 List the supported ChatGPT Ads conversion event types and their data shapes
list_chatgpt_custom_audience_operations 📖 List the add/remove/replace/merge operations on an audience with their status (processing/succeeded/failed)
list_chatgpt_custom_audiences 📖 List custom audiences with their status and matched-user size range
list_chatgpt_event_settings 📖 List the account's conversion event settings — each with its Event Setting ID (used in a conversions-optimized / oCPC campaign's conversion_event_setting_ids),
list_chatgpt_pixels 📖 List the account's ChatGPT Ads measurement pixels — each with its Source ID (cds_…, used when creating a conversion event setting) and short Pixel ID (used in t
merge_chatgpt_custom_audiences ✏️ Merge 2–64 existing audiences into a NEW audience
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)
remove_chatgpt_custom_audience_members ✏️ Remove identifiers from an audience (inline or file_id)
replace_chatgpt_custom_audience_members ✏️ Replace an audience's ENTIRE membership from a file
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
resume_chatgpt_custom_audience_operation ✏️ Resume a paused add/remove operation on an audience
send_chatgpt_conversion_event ✏️ Send a REAL server-side conversion (Conversions API) with advanced matching: an event_type (order_created, lead_created, …), value + currency, an order/event id
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 (9 tools)

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?'
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)
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 (169 tools)

add_ad_group_audiences ✏️ Add audience targeting to an ad group
add_app_ad_asset ✏️ Add an image or video asset to an existing App (Universal App / UAC) ad
add_asset_group_listing_filter ✏️ Subdivide a retail Performance Max asset group's products — include or exclude a partition
add_business_name_asset ✏️ Add a BUSINESS_NAME asset to a Search campaign
add_call_asset ✏️ Add a phone call asset to a campaign
add_callout_extensions ✏️ Add callout extensions to a campaign
add_campaign_label ✏️ Attach an existing label to a campaign
add_campaign_proximity ✏️ Add proximity (radius) targeting to a campaign — target everyone within N miles/km of an address
add_demandgen_ad ✏️ Add a new Demand Gen ad (image or video) to an EXISTING Demand Gen ad group
add_demandgen_ad_group ✏️ Add a new ad group with targeting and ads to an EXISTING Demand Gen campaign
add_display_ad ✏️ Add another Responsive Display Ad (RDA) to an EXISTING Display ad group
add_display_ad_group ✏️ Add a new DISPLAY_STANDARD ad group (with its own targeting + a Responsive Display Ad) to an EXISTING Display campaign
add_display_audiences ✏️ Add audience targeting to a Display ad group
add_display_keywords ✏️ Add contextual display keywords to a Display ad group
add_display_placements ✏️ Add managed placements (websites, mobile apps, YouTube channels, YouTube videos) to a Display ad group
add_display_topics ✏️ Add topic targeting to a Display ad group
add_keywords ✏️ Add keywords to an existing ad group
add_negative_keywords ✏️ Add negative keywords to a campaign
add_negative_keywords_to_list ✏️ Add negative keywords to a SHARED negative keyword list
add_placement_exclusions ✏️ Exclude placements — add negative placement criteria so your ads STOP serving on specific websites, YouTube channels/videos, or apps
add_pmax_asset_group ✏️ Add a NEW asset group to an EXISTING Performance Max campaign
add_pmax_asset_group_asset ✏️ Add ONE text or video asset to a Performance Max asset group
add_pmax_asset_group_image ✏️ Upload a new image and link it to a PMax asset group
add_pmax_audience_signal ✏️ Add an audience signal to an existing Performance Max campaign
add_pmax_campaign_logo ✏️ Link a square LOGO as a campaign-level asset to an existing Performance Max campaign
add_pmax_search_themes ✏️ Add search themes to an existing Performance Max campaign
add_product_group ✏️ Subdivide a Shopping ad group's products by a dimension — set a bid for a partition or exclude it
add_search_ad_group ✏️ Add a new ad group to an EXISTING Search campaign
add_search_campaign_image ✏️ Upload + link an image asset at the SEARCH campaign level
add_shopping_ad_group ✏️ Add a new ad group to an existing Standard Shopping campaign
add_shopping_product_ad ✏️ Add product ad(s) to an existing Shopping ad group
add_sitelinks ✏️ Add sitelink extensions to a campaign
add_structured_snippets ✏️ Add structured snippet extensions to a campaign
analyze_pmax_search_categories 📖 See the search CATEGORIES a Performance Max campaign matched (grouped queries), with metrics
analyze_pmax_search_terms 📖 See the actual search terms a Performance Max campaign matched, with per-term metrics
analyze_search_terms 📖 Discover keyword opportunities and optimize match types by analyzing actual search terms
analyze_wasted_spend 📖 Analyze wasted ad spend and identify campaigns losing money or underperforming
attach_negative_keyword_list_to_campaign ✏️ Attach a shared negative keyword list to a campaign
bulk_update_ad_group_status ✏️ Pause or enable MANY ad groups in a SINGLE call
bulk_update_ad_status ✏️ Pause or enable MANY ads in one ad group in a SINGLE call
bulk_update_campaign_status ✏️ Pause or enable MANY campaigns in a SINGLE call
bulk_update_keyword_status ✏️ Pause or enable MANY keywords in one ad group in a SINGLE call
create_ad ✏️ Create a new Responsive Search Ad (RSA) in an existing ad group
create_app_campaign ✏️ Create a Google App campaign (Universal App Campaign / UAC) to drive app installs, in-app engagement, or Play pre-registrations
create_conversion_action ✏️ Create a WEBPAGE conversion action so the account can use TARGET_CPA / MAXIMIZE_CONVERSIONS / TARGET_ROAS bidding
create_demandgen_campaign ✏️ 🔄 LONG-RUNNING TOOL: Creates a Demand Gen campaign across ALL Google channels — YouTube, Discover, Gmail, Display, and Maps
create_display_campaign ✏️ Create a Google **Display** campaign with a Responsive Display Ad on the Google Display Network (GDN)
create_label ✏️ Create an account label — a reusable tag for organizing campaigns (e
create_negative_keyword_list ✏️ Create a new (empty) shared negative keyword list
create_pmax_campaign ✏️ 🔄 LONG-RUNNING TOOL: Creates a Google Performance Max campaign with validated images
create_search_campaign ✏️ 🔄 LONG-RUNNING TOOL: Creates a Google Ads Search campaign with full structure
create_shopping_campaign ✏️ Create a full Standard Shopping campaign advertising the products in a linked Merchant Center feed
create_youtube_campaign ✏️ 🔄 LONG-RUNNING TOOL: Creates a YouTube Video campaign using Google Ads Demand Gen format with YouTube-only placements
discover_existing_assets 📖 🔍 Discover existing assets in the Google Ads account (images, sitelinks, callouts, structured snippets)
explain_performance_anomaly 📖 Explain why a performance metric changed using statistical analysis and historical context
get_ad_creative 📖 Read/export the creative composition of existing ads — videos, images (downloadable URLs), and all text
get_ad_group_audiences 📖 Read audience targeting on an ad group
get_ad_group_demographics 📖 Read demographic targeting on an ad group (Search, Display, etc
get_ad_group_device_bid_modifiers 📖 Read the device (MOBILE/TABLET/DESKTOP) bid modifiers on an ad group
get_ad_group_settings 📖 Read every editable setting on ANY ad group (Search, Display, PMax, Demand Gen, YouTube)
get_ad_performance 📖 Per-AD performance breakdown — one row per ad, with individual metrics
get_ad_policy_violations 📖 Read policy review/approval state for ads
get_asset_group_listing_filters 📖 Read a retail Performance Max asset group's product listing-filter tree
get_benchmark_context 📖 Get industry benchmark context for AI-powered recommendations
get_business_profile 📖 Get the user's business profile for contextual recommendations
get_campaign_dates 📖 Read a campaign's start and end dates
get_campaign_frequency_caps 📖 Read a campaign's frequency caps (how often a user can see the ads)
get_campaign_labels 📖 List the labels currently attached to a campaign
get_campaign_performance 📖 Analyze Google Ads campaign performance with comprehensive insights and recommendations
get_campaign_structure 📖 Get campaign structure with ad groups, keywords, ads, and extensions
get_campaign_targeting 📖 Full targeting view for a Google Ads campaign — locations, languages, demographics, audiences, devices, ad schedule, topics, placements, keywords, AND negative
get_campaign_tracking 📖 Read a campaign's URL tracking settings
get_conversion_action_performance 📖 Per-conversion-action performance breakdown
get_demandgen_audiences 📖 Read the grouped audience targeting on a Demand Gen (or YouTube) ad group
get_demandgen_channel_controls 📖 Read which delivery channels are enabled on a Demand Gen (or YouTube) ad group
get_display_ad_group_settings 📖 Read every editable setting on a Display ad group
get_display_audiences 📖 List audience targeting on a Display campaign's ad groups
get_display_demographics 📖 List demographic targeting (age, gender, parental status, income) on a Display campaign's ad groups
get_display_frequency_caps 📖 Read the frequency caps currently configured on a Display campaign
get_display_keywords 📖 List contextual display keywords on a Display campaign's ad groups
get_display_placements 📖 List all managed placements (websites, mobile apps, YouTube channels, YouTube videos) on a Display campaign's ad groups
get_display_topics 📖 List topic targeting on a Display campaign's ad groups
get_merchant_center_links 📖 List the Merchant Center accounts linked to this Google Ads account
get_negative_keyword_list 📖 Show the keywords inside one shared negative keyword list
get_placement_performance 📖 Per-PLACEMENT performance WITH conversions — where your ads actually ran (websites, YouTube channels/videos, apps) and what each placement cost and produced
get_pmax_asset_groups 📖 List all asset groups on a Performance Max campaign
get_pmax_asset_performance 📖 Read Google's own per-asset performance_label for every image in a PMax campaign, plus asset-group-level rollup metrics
get_pmax_audience_signals 📖 Get current audience signals for a Performance Max campaign
get_pmax_conversion_goals 📖 Read a campaign's campaign-specific conversion goals (read-only)
get_pmax_search_themes 📖 Get current search themes for a Performance Max campaign
get_product_groups 📖 Read a Shopping ad group's product-partition (listing-group) tree
get_reach_frequency 📖 Reach & frequency — how many UNIQUE users your campaigns reached, and the average number of times each person saw your ads
get_shopping_settings 📖 Read a Shopping campaign's Merchant Center settings
get_usage_status 📖 Get your current tool-call usage for the billing period
help_user_upload 📖 Show user instructions for uploading images to postimages
infer_business_profile ✏️ Automatically infer business profile from campaign data using AI analysis
link_merchant_center ✏️ Link a Merchant Center account to this Google Ads account
list_call_assets 📖 List every phone (CALL) asset on a campaign, with status and resource names
list_campaign_extensions 📖 List all campaign-level assets for a campaign: sitelinks, callouts, structured snippets, call assets, business names, and images
list_campaigns 📖 List all Google Ads campaigns for the connected account
list_conversion_actions 📖 List conversion actions for the connected Google Ads account with full per-action metadata
list_google_languages 📖 List Google Ads language constants
list_labels 📖 List the account's labels (for organizing and reporting on campaigns)
list_negative_keyword_lists 📖 List the account's SHARED negative keyword lists
list_pmax_asset_group_assets 📖 List the TEXT and VIDEO assets on a Performance Max campaign's asset groups
list_pmax_asset_group_images 📖 List image assets linked to Performance Max asset groups, grouped by asset_group_id
optimize_budget_allocation 📖 Optimize budget allocation across campaigns using linear programming to maximize conversions
pause_ad ✏️ Pause an ad to stop it from showing
pause_ad_group ✏️ Pause an ad group so none of its ads serve
pause_campaign ✏️ Quickly pause a running campaign
remove_ad ✏️ Remove (soft-delete) an ad — sets status=REMOVED
remove_ad_group ✏️ Remove (soft-delete) an ad group — sets status=REMOVED
remove_app_ad_asset ✏️ Remove an image or video asset from an App (UAC) ad
remove_asset_group_listing_filter ✏️ Remove a listing-filter node (and its whole subtree) from a retail-PMax asset group
remove_call_assets ✏️ Remove (unlink) phone (CALL) assets from a campaign
remove_callouts ✏️ Remove callout extensions from a campaign
remove_campaign ✏️ Permanently remove (delete) a campaign — sets its status to REMOVED
remove_campaign_label ✏️ Detach a label from a campaign (removes the tag; the label itself is not deleted)
remove_display_ad ✏️ Remove (soft-delete) a Responsive Display Ad
remove_display_ad_group ✏️ Remove (soft-delete) a Display ad group
remove_display_criteria ✏️ Remove one or more AdGroupCriteria from a Display ad group by resource name
remove_keywords ✏️ Remove keywords from an ad group
remove_negative_keywords ✏️ Remove negative keywords from a campaign
remove_pmax_asset_group ✏️ Remove (soft-delete) an asset group from a PMax campaign
remove_pmax_asset_group_asset ✏️ Unlink a text or video asset from a Performance Max asset group
remove_pmax_asset_group_image ✏️ Unlink an image from a PMax asset group
remove_pmax_audience_signal ✏️ Remove a specific audience signal from a Performance Max campaign
remove_pmax_search_themes ✏️ Remove specific search themes from a Performance Max campaign
remove_product_group ✏️ Remove a product-group node from a Shopping ad group's tree (and its subtree)
remove_sitelinks ✏️ Remove sitelink extensions from a campaign
remove_structured_snippets ✏️ Remove structured snippet extensions from a campaign
replace_demandgen_audiences ✏️ Replace the grouped audience on a Demand Gen (or YouTube) ad group
research_keywords 📖 Research high-intent keywords using Google Keyword Planner API
resolve_google_locations 📖 Resolve free-text location queries (country, state/province, city, district, postal code) into Google's exact `geoTargetConstants/<id>` resource names
resume_ad ✏️ Resume a paused ad to start showing it again
resume_ad_group ✏️ Resume a paused ad group (any channel)
resume_campaign ✏️ Resume a paused campaign
save_business_profile ✏️ Save or update the user's business profile with provided details
search_audiences 📖 Search for available audience segments (in-market, affinity, custom)
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 ✏️ Set device bid modifiers on an AD GROUP — bid up/down per device, finer than the campaign level
set_call_asset_status ✏️ Pause or re-enable phone (CALL) asset links on a campaign — without deleting them
set_campaign_ad_schedule ✏️ Add ad-schedule (day/hour) targeting to a campaign — control WHEN ads run
set_campaign_device_bid_modifiers ✏️ Set device bid modifiers on a campaign — bid up/down per device
suggest_ad_content 📖 Generate AI-suggested headlines and descriptions based on campaign keywords
unlink_merchant_center ✏️ Remove a Merchant Center link from this Google Ads account
update_ad_content ✏️ Combined update for ad content (RSA, RDA, or DemandGen video-responsive / multi-asset) in a single API call with combined field mask
update_ad_descriptions ✏️ Update descriptions for a Responsive Search Ad (RSA), Responsive Display Ad (RDA), OR a DemandGen ad (video-responsive / multi-asset)
update_ad_group_demographics ✏️ Set demographic TARGETING on an ad group (exclude-the-inverse)
update_ad_group_settings ✏️ Update any combination of settings on ANY ad group (any channel)
update_ad_headlines ✏️ Update headlines for a Responsive Search Ad (RSA), Responsive Display Ad (RDA), OR a DemandGen ad (video-responsive / multi-asset)
update_bid_strategy ✏️ Change campaign bidding strategy
update_campaign ✏️ Update an existing campaign's settings
update_campaign_dates ✏️ Set a campaign's start and/or end date
update_campaign_frequency_caps ✏️ Set a campaign's frequency caps — limit how often a user sees the ads
update_conversion_action ✏️ Update an EXISTING conversion action (change its name, category, status, value, counting, lookback windows, primary flag, whether it counts in Conversions, or a
update_demandgen_channel_controls ✏️ Turn Demand Gen (or YouTube) delivery channels on or off for an ad group
update_display_ad_creative ✏️ Edit any combination of CREATIVE fields on a Responsive Display Ad
update_display_ad_group ✏️ Update one or more editable settings on a Display ad group in a single API call
update_display_campaign_schedule ✏️ Update a Display campaign's start_date and/or end_date
update_display_demographics ✏️ Update demographic targeting on a Display ad group via the exclude-the-inverse pattern
update_display_frequency_caps ✏️ REPLACE all frequency caps on a Display campaign
update_keyword ✏️ Update keyword bid or status
update_location_targeting ✏️ Change a campaign's location-targeting MODE without recreating the campaign
update_pmax_asset_group ✏️ Update settings of an existing PMax asset group
update_pmax_audience_signal ✏️ Update the segment composition of an existing PMax audience IN PLACE (#325)
update_product_group ✏️ Change the max CPC bid on a biddable product-group (UNIT) node
validate_and_prepare_assets ✏️ 🔄 LONG-RUNNING TOOL — **GOOGLE ADS ONLY**
validate_video 📖 Validate video for ad campaigns (unified tool for all platforms)

integrations (7 tools)

apollo_io ✏️ Search and enrich B2B prospect data in the user's Apollo
google_analytics 📖 Read Google Analytics 4 reports and metadata for the user's connected GA4 properties
google_search_console ✏️ Read Google Search Console organic-search data for the user's verified sites, and submit URLs to the Google Indexing API
google_tag_manager ✏️ Read and manage tags and variables in the user's Google Tag Manager containers
hubspot ✏️ Read and write the user's HubSpot CRM — contacts, companies, deals, lists, engagements, and marketing assets
klaviyo ✏️ Read and act on the user's Klaviyo (email + SMS marketing) account
salesforce_rest_api ✏️ Read and write the user's Salesforce org — leads, contacts, accounts, opportunities, campaigns, cases, and custom objects via the REST API

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 ✏️ Creates a LinkedIn single-image sponsored-content campaign
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 (60 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_pages 📖 User wants to know which Facebook Page an ad will run from, or a create/add tool reported the account has 2+ Pages and you need to pick one
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)
list_meta_promotable_apps 📖 User wants to run a Meta app-install / app-promotion campaign, or asks which mobile apps they can advertise
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?"

Microsoft Advertising (36 tools)

associate_microsoft_ad_extensions ✏️ Attach EXISTING ad extensions (by id) to an account, campaign, or ad group so they serve with the ads there
create_microsoft_ad_extensions ✏️ Add ad extensions to make campaigns high-quality — sitelinks, callouts, structured snippets, images, call, review, action, price, promotion, app, location, vide
create_microsoft_ad_group_criterions ✏️ Add DEEP targeting to an existing ad group — age, gender, day/time (dayparting), device, location, radius, location intent, audience, LinkedIn profile (company/
create_microsoft_ad_groups ✏️ Add one or more ad groups to an EXISTING Microsoft campaign — each with CPC/CPM/CPV bids, network, ad-group type, schedule, bidding scheme, ad rotation, and opt
create_microsoft_ads ✏️ Add ads to an EXISTING Microsoft ad group — every ad type Microsoft supports: Responsive Search (3-15 headlines with pinning, 2-4 descriptions, paths), Responsi
create_microsoft_asset_groups ✏️ Create Performance Max asset groups — the PMax creative structure (replaces ad groups/ads)
create_microsoft_audiences ✏️ Create audience-library lists (RemarketingList, CustomerList, CombinedList, ProductAudience, etc
create_microsoft_campaign ✏️ Create a Microsoft Advertising campaign of ANY type Microsoft supports — Search, Shopping (incl
create_microsoft_campaign_criterions ✏️ Add DEEP campaign-level targeting (same criterion types as ad-group targeting) to an existing campaign
create_microsoft_keywords ✏️ Add keywords to an EXISTING Microsoft ad group — text, match type (Broad/Phrase/Exact), a per-keyword bid (plain decimal account currency), dynamic-text params
delete_microsoft_ad_group_criterions ✏️ Remove targeting criterions from an ad group by id (from list_microsoft_ad_group_criterions)
delete_microsoft_campaign_criterions ✏️ Remove campaign-level targeting criterions by id
discover_microsoft_media 📖 List the images already stored in the account's media library (used by image extensions and responsive/audience ads) with their media_id, type, dimensions and a
list_microsoft_accounts 📖 List the connected Microsoft Advertising (Bing Ads) ad accounts with their numeric account_id, manager customer_id, currency and active/inactive status
list_microsoft_ad_extensions 📖 List the ad extensions in the account's shared library (sitelinks, callouts, etc) with their ids and text, so you can reuse and associate them
list_microsoft_ad_group_criterions 📖 Read back an ad group's targeting criterions of one specific type (Age/Gender/DayTime/Device/Location/Radius/LocationIntent/Audience/Profile/Webpage) with their
list_microsoft_ad_groups 📖 List the ad groups in a Microsoft campaign — status, type, CPC bid, bidding scheme, network, schedule dates, targeting settings and every ad-group control
list_microsoft_ads 📖 List the ads in a Microsoft ad group with EVERY creative control — all headlines and descriptions (with pinning), paths, business name, final URLs, images/video
list_microsoft_asset_groups 📖 List the Performance Max asset groups in a campaign — name, status, and the count of headlines and images, plus full detail
list_microsoft_audiences 📖 List the account's audience library (ids, names, types, membership duration) so you can target them
list_microsoft_bid_strategies 📖 List the portfolio (shared) bid strategies in the account — id, name, full bidding scheme with its targets, the campaign type it applies to, how many campaigns
list_microsoft_budgets 📖 List the shared budgets in the account's budget library — id, name, amount (plain decimal account currency), budget type and how many campaigns use each
list_microsoft_campaign_criterions 📖 Read back a campaign's targeting criterions of one specific type with their bids and mode
list_microsoft_campaigns 📖 List Microsoft Advertising campaigns in an ad account — every type (Search, Shopping, Audience, Performance Max, Hotel, App, Dynamic Search) with status, daily
list_microsoft_keywords 📖 List the keywords in a Microsoft ad group — text, match type (Broad/Phrase/Exact), status, bid (plain decimal account currency), URL params and editorial status
update_microsoft_ad_extensions ✏️ Edit EXISTING ad extensions in the account library (sitelink text/urls, callout text, price rows, promotion details, etc)
update_microsoft_ad_group_criterions ✏️ Edit an existing ad-group criterion's BID (multiplier or fixed amount) and STATUS in place — e
update_microsoft_ad_groups ✏️ Edit EXISTING ad groups — name, status (pause/resume), CPC/CPM/CPV/mCPA bids, bidding scheme, network, ad rotation, frequency caps, language, dates, URL trackin
update_microsoft_ads ✏️ Edit EXISTING ads — status (pause/resume), and the creative for responsive ads: headlines, descriptions, long headlines, images, videos (with pinning), paths, a
update_microsoft_asset_groups ✏️ Edit EXISTING Performance Max asset groups — name, status, business name, call to action, headlines, long headlines, descriptions, images, videos, final URLs, p
update_microsoft_bid_strategies ✏️ Edit EXISTING portfolio bid strategies (gated feature) — name and the bidding scheme with its targets
update_microsoft_budgets ✏️ Edit EXISTING shared budgets — amount (plain decimal account currency), name, budget type
update_microsoft_campaign ✏️ Edit an EXISTING Microsoft campaign — name, budget, bidding scheme, languages, time zone, URL tracking, dates, status (pause/resume) and per-type settings
update_microsoft_campaign_criterions ✏️ Edit an existing campaign-level criterion's BID (multiplier or fixed amount) and STATUS in place
update_microsoft_keywords ✏️ Edit EXISTING keywords — match type, status (pause/resume), per-keyword bid (plain decimal account currency; pass bid:null to clear it and inherit the ad group'
validate_and_prepare_microsoft_assets ✏️ Validate and upload images and videos to Microsoft, returning ready-to-use asset ids for the create tools

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 📖 Returns the briefing for one monitor signal: what changed on the flagged campaign(s), the recommended action, and any fixes staged for approval
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 (38 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_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_ad_videos 📖 List the videos already uploaded to this advertiser's TikTok video library, returning the `video_id` for each
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_lead_pages 📖 List this advertiser's TikTok Instant Forms (native lead-generation pages) with the page_id needed to attach one to a LEAD_GENERATION ad, and whether each is PU
list_tiktok_pixels 📖 List the TikTok Pixels on the advertiser and, for each one, the exact conversion events it can optimize toward
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