Skip to main content
Glama

Server Details

Adsap is a Meta and Google Ads automation platform, with a web app and an AI copilot for Claude, ChatGPT and Perplexity.

Ownership verified
Status
Healthy
Uptime
100.0% over the last 24 hours
Last Tested
Transport
Streamable HTTP · MCP 2025-11-25
URL
ChatGPT
–
Claude
–

TDQS

A3.5/5.0

Scored across 100 tools

Disambiguation3/5

Most tools are distinguishable by platform prefix and resource name, but there are several confusing clusters: adsap_get_ad, adsap_get_ad_status, adsap_get_ad_review_status and adsap_list_ads all sound adjacent; adsap_get_ad_preview, adsap_get_ad_library_snapshot and adsap_get_preview_clip overlap around previewing ads; and adsap_search_interests, adsap_search_behaviors and adsap_search_detailed_targeting overlap on targeting lookup. Descriptions do give explicit disambiguation hints (e.g. 'NOT an ad listing'), which keeps the set workable, but the sheer number of near-duplicates raises misselection risk.

Naming Consistency4/5

The set follows a fairly predictable adsap_[google_]verb_noun convention, with clear platform segmentation for Google tools. Minor deviations exist: adsap_create_ad_sets is plural while adsap_create_campaign is singular, and adsap_ping / adsap_manage_onboarding_plan break the resource-oriented pattern slightly. Overall still readable and predictable.

Tool Count1/5

100 tools is far beyond a reasonable surface for a single server, spanning two ad platforms, creatives, catalogs, audiences, targeting, automation, experiments and onboarding. Even with genuine scope, this volume makes tool selection expensive and error-prone; many tools could be consolidated (status reads, previews, targeting searches, Google create-campaign variants).

Completeness4/5

Coverage is extensive: campaign/ad set/ad lifecycle, creatives, catalogs, audiences, instant forms, pixel and conversion reads, insights and breakdowns, automation rules, Google Search/PMax/Demand Gen/Display/App/Shopping creation, keywords, extensions and assets. Gaps remain around deletion (mostly pause-only), customer-list audience upload, Google asset-group editing, and experiments being read-only, but these are documented dead ends rather than silent holes.

Publisher details

Operator
Adsap (To Better Digital SASU) · Publisher source
Vendor relationship
First-party · Publisher source
Privacy policy
Not provided
Trust center
Not available
Restrictions
Needs an Adsap account (a Free plan exists, no card required) and your own Meta or Google Ads account connected in Adsap. Sign-in is by OAuth. · Publisher source

Available Tools

100 tools
adsap_analyze_websiteAnalyze WebsiteAInspect

Fetch and analyze a website URL to extract business context, tracking scripts (Meta Pixel, GTM, GA4, TikTok), product/pricing signals, value proposition, social proof, and landing page quality. Results are stored for cross-session persistence. Use as the first step in onboarding to understand a user's business.

Inputs: url (required).

adsap_create_adCreate AdAInspect

Create a Meta ad (image/video) in an ad set. Defaults to PAUSED. Creative: pass exactly ONE of creative_spec library filenames (feed_creative_name, or vertical_creative_name alone for a vertical-only ad, or a feed + vertical pair), image_hash / video_id (reuse an existing Meta image/video with new copy), creative_id (reuse a WHOLE existing creative as-is) or object_story_id (run an existing Page post as the ad) — the last two keep the original post and its likes/comments, and need no copy fields. ALWAYS call with dry_run: true first: it validates and renders a launch review card where the user confirms, creates (paused) and activates in-card — after it renders, reply with ONE short sentence and stop; do not call the real create from chat unless the user explicitly asks in a new message and the card's activity log shows nothing was created there. For App promotion (OUTCOME_APP_PROMOTION) ad sets: set link_url to the app's store URL (same as the ad set's promoted_object.object_store_url) and call_to_action to INSTALL_MOBILE_APP (or USE_MOBILE_APP/DOWNLOAD); the promoted app binding comes from the ad set. Shop (Meta sending people to the business's Facebook or Instagram shop instead of the website) is off unless the ad template or account_enhancements switches it on.

Inputs: name (required), ad_format (required), ad_set_id (required), ad_account_id (required), +4 more.

adsap_create_ad_from_ig_postCreate Ad from Instagram Post (use existing post)AInspect

Turn an existing Instagram post, video, or reel into an ad inside an EXISTING ad set — Meta Ads Manager's "Use existing post". The ad inherits the ad set's budget, targeting, and schedule (no new budget is created). It is ALWAYS created PAUSED and never spends until you activate it (adsap_set_entity_status with action: "activate"). This does NOT create a campaign or ad set — pick an existing ad set with adsap_list_ad_sets first, get the post id from adsap_list_ig_media, and the Instagram account id from adsap_list_meta_assets. dry_run defaults to TRUE: call once to preview the plan, then again with dry_run: false to create. Images, videos, and reels all work.

Inputs: ad_set_id (required), ig_media_id (required), ad_account_id (required), ig_account_id (required), +4 more.

adsap_create_ad_setsCreate Ad Sets (batch)AInspect

Create one or more Meta ad sets under an existing campaign. Supports batch creation (max 20). Ad sets are created PAUSED by default. Detailed targeting: use targeting.flexible_spec groups (OR inside a group, AND between groups, like Ads Manager's Narrow audience) with ids and types from adsap_search_detailed_targeting. Leads campaigns take three destinations: ON_AD (Instant Forms), WEBSITE, and WEBSITE_AND_LEAD_FORM (Website and Instant Forms: OFFSITE_CONVERSIONS + pixel, ads then carry a link and a lead form). Not supported yet (say so and point the user to Meta Ads Manager, never substitute another destination): Messenger and Instagram Direct ad sets, calls, event responses, reminders, shop destinations. WhatsApp ad sets ARE supported: destination_type WHATSAPP with optimization_goal CONVERSATIONS on traffic, engagement, leads or sales campaigns (LINK_CLICKS also works except on leads), plus the page_id of a Facebook Page whose primary WhatsApp number is a WhatsApp Business account; ads in them need no link. ALWAYS call with dry_run: true first: it validates and renders a launch review card where the user confirms, creates (paused) and activates in-card — after it renders, reply with ONE short sentence and stop; do not call the real create from chat unless the user explicitly asks in a new message and the card's activity log shows nothing was created there. Prerequisites: call list_meta_assets for pages/pixels/Instagram accounts, list_pixel_events for conversion events. For App promotion (OUTCOME_APP_PROMOTION) campaigns: each ad set requires promoted_object.application_id + object_store_url, optimization_goal APP_INSTALLS (or OFFSITE_CONVERSIONS with custom_event_type for app-event optimization), and the promoted app must be in Live mode and advertisable by the ad account; OS targeting (user_os) is derived automatically from the store URL. Saved audiences that target specific devices: on a Sales ad set Adsap keeps delivery to those devices; pass reach_more_devices: true only when the user asks for Meta's "Reach more people across other mobile devices".

Inputs: ad_sets (required), campaign_id (required), dry_run, ad_account_id, +2 more.

adsap_create_campaignCreate CampaignAInspect

Create Meta campaign. Defaults to PAUSED — only set ACTIVE when explicitly requested. For Catalog or Collection ads, set advantage_catalog_ads: true + catalog_id (OUTCOME_SALES only): Meta binds the catalog at the CAMPAIGN level, so a plain sales campaign cannot host those formats and the ad create will fail later. The ad set needs no catalog fields, and the product set is chosen per ad. ALWAYS call with dry_run: true first: it validates and renders a launch review card where the user confirms, creates (paused) and activates in-card — after it renders, reply with ONE short sentence and stop. Do not call the real create from chat unless the user explicitly asks in a new message and the card's activity log shows nothing was created there.

Inputs: name (required), objective (required), ad_account_id (required), status, +16 more.

adsap_duplicate_ad_setDuplicate Ad SetAInspect

Duplicate an existing Meta ad set into 1-10 copies, keeping ALL its ads (including ads with no delivery yet). Every copy and every recreated ad is PAUSED. Each recreated ad reuses the source ad's creative, so the original post and its likes/comments are preserved. Per copy you can override the name, the geo targeting (geo-split flow: one copy per region/country) and daily spend limits — as absolute amounts or as a % of the campaign daily budget (Advantage campaign budget campaigns only; the % auto-computes the absolute like Ads Manager). ALWAYS call with dry_run: true first: it returns the plan (source ad set, the exact ads that will be recreated, per-copy overrides, warnings) — show it to the user and only execute after they confirm. Partial failures are reported per copy and per ad in data.copies[].errors with Meta's own error text.

Inputs: copies (required), ad_account_id (required), source_adset_id (required), dry_run, +2 more.

adsap_get_account_activitiesGet Account ActivitiesAInspect

Retrieve the change log of a Meta ad account: who changed what, when, and with which app. Covers budget, status, creative, targeting, creation, deletion, billing and policy events. Use it to tie a performance change to an edit (e.g. CPA rose after a budget increase) or to answer "was this changed in Ads Manager or through Adsap?". APP: each event's app_name is the app Meta recorded for the change. "ADSAP" = made through Adsap (the web app or this assistant; Meta does not tell the two apart). "Power Editor" = Ads Manager on a computer (Meta's old name for it). "Ads Manager App for iOS" = the Ads Manager iPhone app. "ads MCP server" = Meta's own Ads connector. Any other name = another app connected to the account or a Meta internal tool. null = no app: a change Meta made itself (actor_name "Meta"). summary.by_app counts events per app. FILTERS: ad_set_id (the ad set and all its ads) or ad_id (one ad), and event_type_filter (creative_change = an ad's text, image or video was replaced). Filters scan the WHOLE days_back window, then the newest limit matching events come back; summary.window_truncated=true means the account had more activity than could be scanned, so the OLDEST part of the window may be incomplete. Creative changes carry extra_data.old_creative_id and extra_data.new_creative_id (the ad's creative before and after), never image links. VOCABULARY: object_type is translated (campaign / ad_set / ad), but extra_data keeps Meta's legacy words: inside extra_data 'campaign' means AD SET and 'adgroup' means AD (e.g. extra_data.campaign_id on an ad event is the ad's parent AD SET id, not a campaign id).

Inputs: ad_account_id (required), ad_id, limit, ad_set_id, +2 more.

adsap_get_account_healthGet Account HealthAInspect

Comprehensive health check on a Meta ad account. Returns scorecard covering: account status, payment health, Business Manager verification, Pixel health, connected assets, ad volume limits, attribution consistency. Foundation for audits and readiness checks.

Inputs: ad_account_id (required).

adsap_get_account_summaryGet Account SummaryAInspect

Structural snapshot of a Meta ad account: campaign counts by status/objective, ad set counts, active ad count, budget allocation, top spending campaigns (last 30d), disapproved ads. Provides the big picture before detailed audit.

Inputs: ad_account_id (required).

adsap_get_adGet Ad DetailsAInspect

Read ONE ad in full, live from Meta: its creative content (primary texts, headlines, descriptions, CTA, destination link, URL parameters, image hashes / video ids, Facebook Page and Instagram identity) plus status, timestamps, object_story_id / effective_object_story_id (the underlying post, which carries the ad's likes and comments) and the raw creative specs. Get the ad_id from adsap_list_ads or adsap_get_insights. Use it to inspect an ad's copy and media, to replicate an ad, or to answer 'what does this ad say / link to?' and 'what is switched on?'. SETTINGS: creative_summary.enhancements_on lists the enhancements switched on in the creative, the same list Meta shows in its own tools: key, and name (Meta's name, often the key itself). Use those names as returned, never invent others. Switched on means set to on in the creative; whether one actually runs also depends on the ad's eligibility. creative_summary.standard_enhancements_on is Meta's old bundle switch, which Meta leaves out of its own list: mention it only if the user asks. creative_summary.shop: on means Meta can send people to the business's Facebook or Instagram shop instead of the website (product_set_id = the shop's product set); off means people always go to the website. PARTNERSHIP ADS: creative_summary.partnership gives the partner, the account shown second (partner_page_id, partner_instagram_user_id), and Meta's header choice (both_accounts, first_account_only or meta_picks; null means nothing was set, which Meta shows as both accounts). The account shown first is the ad's own page_id / instagram_user_id. creative_status is Meta's status of the creative: WITH_ISSUES means Meta will not deliver it as it is, IN_PROCESS means Meta is still checking it, so read the ad again in a minute. EARLIER VERSIONS: every edit of an ad's text or media gives it a new creative and keeps the old one. creative_history lists the edits made through Adsap, newest first (when, web app or Claude, previous and new creative id); edits made in Ads Manager are in Meta's change log (adsap_get_account_activities, creative change events carry the old and new creative id). To read an earlier version, pass its id as creative_id: it comes back in older_creative, in the same shape as the current one. Only creatives of the same ad account are read. Read-only: to CHANGE a live ad's creative use adsap_replace_ad_creative.

Inputs: ad_id (required), ad_account_id (required), creative_id.

adsap_get_ad_library_snapshotShow Ad Library AdAInspect

SHOW what Ad Library ads ACTUALLY LOOK LIKE (creative, copy, page name), in a SELF-CONTAINED card. Pass up to 8 ad ids in ad_ids and ONE call renders them all as a gallery the user can click through; pass one id for a single full-size ad. Video ads PLAY in the card and carousel ads show their slides. Use this right after adsap_search_ad_library whenever the user asks to SEE or SHOW ads: a table of links shows nothing, so render the top results (up to 8) in the SAME turn instead of offering to. One call takes about 8 seconds whatever the number of ads, so always batch: never call once per ad. This is public ad-transparency data, not your own ads (for those use adsap_get_ad_preview). It renders ads exactly as the Ad Library shows them, so it works only for ads that search returned in the first place.

Inputs: ad_account_id (required), ad_id, ad_ids.

adsap_get_ad_previewGet Ad PreviewAInspect

Render a pixel-accurate visual preview of an existing Meta ad (real Meta render; video ads also get an animated clip in the interactive card). The card is SELF-CONTAINED: Facebook Feed + Instagram Reels tabs and an 'All placements on Meta' button are built in. AFTER THE CARD RENDERS, reply with ONE short confirmation sentence and stop. NEVER mention, list, or offer any other placement (no 'Desktop Feed', 'Stories', 'right column', etc.) and never describe the card's tabs or buttons — the user can see them. Only if the user themselves asks about another placement: answer that the card's 'All placements on Meta' button opens every placement in Ads Manager, and only pass a non-default ad_format when the user explicitly names one.

Inputs: ad_id (required), ad_account_id (required), ad_format, include_video_source.

adsap_get_ad_review_statusGet Ad Review StatusAInspect

Check review and policy status of all active (optionally paused) ads in an account. Returns aggregate counts by review status and details for problematic ads only (disapproved, with issues, pending). Useful in audits to surface policy violations and delivery blockers. NOT an ad listing: healthy ads appear only in the counts — to enumerate the ads in an ad set or campaign use adsap_list_ads.

Inputs: ad_account_id (required), include_paused.

adsap_get_ad_setGet Ad Set DetailsAInspect

Read ONE ad set in full, live from Meta: complete targeting spec (geo incl. regions/cities, age, genders, custom audiences included/excluded, locales, placements/positions, Advantage+ audience flag), attribution_spec, bid strategy and bid amount, budgets and budget_remaining, daily/lifetime spend limits incl. the percentage-based ones, schedule (start/end), destination_type, promoted_object and effective_status. Use it when adsap_list_ad_sets' cached row is not enough — to replicate an ad set (feed the targeting into adsap_create_ad_sets or adsap_duplicate_ad_set), audit targeting, or answer 'who exactly does this ad set target?'.

Inputs: ad_set_id (required), ad_account_id (required).

adsap_get_ad_sheet_schemaGet Ad Sheet SchemaAInspect

Retrieve column schema, constraints, and dependencies for an ad sheet — use it to read or explain a sheet's structure. Sheets are read-only over MCP; rows are created and edited in the ADSAP web app.

Inputs: sheet_id (required).

adsap_get_ad_statusGet Ad StatusAInspect

Check the current delivery, review, and effective status of a single Meta ad. Returns live data directly from Meta (no cache). Includes parent ad set and campaign statuses, review feedback if disapproved, any active issues, and a human-readable delivery summary. Use this to monitor ads after creation or diagnose delivery problems.

Inputs: ad_id (required), ad_account_id (required).

adsap_get_campaignGet Campaign DetailsAInspect

Read ONE campaign in full, live from Meta: effective_status, objective, buying_type, bid strategy, budgets (campaign budget present = Advantage campaign budget / CBO; absent = ad set budgets), budget_remaining, spend_cap, schedule, Special Ad Categories — plus the ad account currency, so budget amounts (minor units) can be shown correctly. Use it when adsap_list_campaigns' cached row is not enough — to replicate a campaign, check whether it uses a campaign-level budget, or read live delivery status.

Inputs: campaign_id (required), ad_account_id (required).

adsap_get_catalog_data_sourcesGet Catalog Data SourcesAInspect

List all data sources connected to a Meta product catalog — product feeds, Batch API, partner integrations (Shopify/WooCommerce), smart pixel, website crawling — live from Meta. Matches the 'Data Sources' tab in Commerce Manager. Use to see how a catalog's products get ingested.

Inputs: catalog_id (required), ad_account_id (required), after, limit.

adsap_get_catalog_detailsGet Catalog DetailsAInspect

Get a Meta product catalog's metadata — name, vertical, total product count, and owning business — live from Meta. Use as a first step before drilling into a catalog's products, diagnostics, or data sources.

Inputs: catalog_id (required), ad_account_id (required).

adsap_get_catalog_diagnosticsGet Catalog DiagnosticsAInspect

Get data-quality diagnostics for a Meta product catalog — errors and warnings that can block products from ads (broken images, missing required fields, policy violations) — live from Meta. An empty list means no issues detected. Use when products aren't showing in ads or the user asks about catalog health.

Inputs: catalog_id (required), ad_account_id (required), limit.

adsap_get_creative_performanceGet Creative PerformanceAInspect

Ranked creative performance analysis with fatigue detection. Returns Hook Rate (3s plays/impressions), Hold Rate (15s/3s), ad relevance diagnostics, and fatigue classification (healthy/watch/fatigued) per ad. Fatigue based on frequency, CPA decay, Hook Rate decline.

Inputs: ad_account_id (required), limit, sort_by, include_paused, +2 more.

adsap_get_custom_audience_adsGet Custom Audience AdsAInspect

List the ads that use/target a given custom audience (live from Meta) — each with its ad set and campaign id. Use BEFORE deleting an audience (deleting auto-pauses the ad sets that use it — an empty list means it's safe), or to answer 'where is this audience used?'. Group results by adset_id for the ad-set view. Get the custom_audience_id from adsap_list_custom_audiences.

Inputs: ad_account_id (required), custom_audience_id (required), after, limit.

adsap_get_delivery_estimateGet Delivery EstimateAInspect

Get Meta's delivery estimate for a proposed audience and optimization configuration. Returns the estimated monthly audience range and an audience size assessment (too_narrow/narrow/moderate/broad/very_broad); Meta no longer returns daily reach or outcome curves. Sizes detailed targeting groups and demographics (targeting_spec.flexible_spec, the same shape adsap_create_ad_sets takes), so size an audience here before creating it; targeting_summary states the logic in words, e.g. (Cooking or Frequent Travelers) and Parents (All). Use during onboarding to validate strategies or in audits to check targeting breadth.

Inputs: ad_account_id (required), targeting_spec (required), optimization_goal (required), daily_budget, +1 more.

adsap_get_import_statusGet Creative Import StatusAInspect

Check progress of a Meta historical-asset import started with adsap_import_account_creatives: status, phase (images then videos), imported/skipped/failed counts.

Inputs: job_id (required).

adsap_get_insightsGet InsightsAInspect

Retrieve aggregated spend and performance metrics for accounts, campaigns, ad sets, or ads over a date range. Served from ADSAP's insights cache and automatically refreshed live from Meta when the cache is missing or stale (>6h) — no dashboard visit required. Results / cost_per_result are objective-aware at every level (result_type per row names what a result is; 'multiple' when children mix; reach and ad recall fetched live). Parent filters campaign_ids (on adset/ad rows) and adset_ids (on ad rows) narrow the set server-side — sort, limit and summary then describe the filtered set; rows expose adset_id / campaign_id.

Inputs: entity_type (required), ad_account_id (required), limit, cursor, +13 more.

adsap_get_insights_breakdownGet Insights BreakdownAInspect

Live Meta API call: get spend and performance metrics sliced by demographic or placement dimensions (age, gender, platform, country). Not cached.

Inputs: entity_type (required), ad_account_id (required), breakdown_dimensions (required), limit, +8 more.

adsap_get_instant_formGet Instant FormAInspect

Read ONE Meta Instant Form in full: questions, intro, privacy policy and custom disclaimer, thank-you screen, tracking parameters, status and lead count. The form comes back in the same shape adsap_manage_instant_form takes, so use it to explain a form to the user or to prepare a duplicate. To LIST a Page's forms use adsap_list_meta_assets (asset_type instant_forms). The warnings field names anything the form uses that Adsap cannot recreate (for example conditional logic).

Inputs: form_id (required), page_id (required), ad_account_id (required).

adsap_get_pixel_detailsGet Pixel DetailsAInspect

Get a Meta pixel's configuration details (live from Meta) — whether automatic advanced matching is enabled and which customer-info fields it matches on (em/ph/fn/...), the approximate event match rate (match_rate_approx; -1 = not enough data yet), first-party cookie status, data-use setting, last fired time, and owning business. Use to audit pixel setup / event match quality before optimizing campaigns, or to check a pixel is alive (last_fired_time). Get the pixel_id from adsap_list_meta_assets (asset_type:"pixels"). Complements adsap_get_pixel_stats (event volume) and adsap_get_pixel_health (catalog-ads readiness).

Inputs: pixel_id (required), ad_account_id (required).

adsap_get_pixel_healthGet Pixel HealthAInspect

Get Dynamic/Advantage+ catalog-ads readiness health checks for a Meta pixel (live from Meta) — whether the pixel is set up correctly to power dynamic/catalog ads: event-source match rate against catalogs, missing DPA parameters, iOS 14.5+ (AEM) setup, and more. Each check returns pass/fail. Use to diagnose why catalog/Advantage+ ads under-deliver or why events aren't matching products, before launching. Get the pixel_id from adsap_list_meta_assets (asset_type:"pixels"). Complements adsap_get_pixel_stats (event volume).

Inputs: pixel_id (required), ad_account_id (required).

adsap_get_pixel_statsGet Pixel StatsAInspect

Get event volume for a Meta pixel / dataset (live from Meta) — how many of each event type (PageView, Purchase, Lead, CompleteRegistration, …) the pixel has received. Use to confirm a pixel is firing and see which conversion signals it's receiving before building a conversion-optimized ad set. Get the pixel_id from adsap_list_meta_assets (asset_type:"pixels").

Inputs: pixel_id (required), ad_account_id (required), end_time, start_time.

adsap_get_preview_clipGet Animated Preview ClipAInspect

Fetch the animated placement-preview clip (recorded video of the real Meta preview) for an ad+placement previously rendered with adsap_get_ad_preview. Returns a signed URL when ready, or status 'pending' while the background recording is still in progress. Storage-only — costs no Meta API budget.

Inputs: ad_id (required), ad_format (required), ad_account_id (required).

adsap_get_product_detailsGet Product DetailsAInspect

Fetch the full details of one catalog product by its numeric Meta product ID (FBID) — live from Meta. Returns name, description, price, availability, condition, image, URL, brand, and category. For a merchant SKU (alphanumeric retailer_id like 'ABC-001'), use adsap_search_catalog_products with retailer_id instead.

Inputs: product_id (required), ad_account_id (required).

adsap_get_product_set_productsGet Product Set ProductsAInspect

List the products inside a Meta catalog product set (live from Meta). Use after adsap_list_catalogs to inspect exactly which products a product set contains before building a catalog, DPA, or collection ad. Returns product id, retailer_id, name, availability, price, image, and a pagination cursor.

Inputs: ad_account_id (required), product_set_id (required), after, limit.

adsap_get_recommendationsGet RecommendationsAInspect

Verified recommendations AND alerts computed by ADSAP's daily/weekly checks from the client's own data. Returns them as TWO separate arrays that must never be merged or described as one list. alerts = something broke or changed and needs attention now: the account stopped spending (zero_spend_yesterday), a campaign is spending with no conversions (zero_results_with_spend), conversion tracking went silent (tracking_collapse), a switched-on ad or campaign stopped delivering (zero_delivery_active_entity), an unusual week-over-week swing (wow_anomaly). findings = recommendations, clear actions worth taking: under-delivering ads (starved_ad), money-losing ads (losing_ad), weak launches (weak_launch), wearing-out ads (creative_fatigue), wasted Google search terms/themes, keyword promotion candidates. When both are present lead with the alerts, they are the urgent half. Includes evidence numbers, money at risk, and the latest weekly account summary. Omit account_id for a whole-workspace view across all reachable accounts. Explain each item in plain language from its evidence; suggest the action, never promise results. Weekly summaries with summary_source "ai" are AI-written: when relaying one, label it "AI Generated".

Inputs: limit, status, platform, account_id, +1 more.

adsap_get_upload_statusGet Upload StatusBInspect

Check status of an async video upload. Returns processing state and creative_asset_id.

Inputs: job_id (required).

adsap_google_create_ad_groupAdd Ad Group to Google CampaignAInspect

Add an ad group to an EXISTING Google Ads campaign (Search, Display or Demand Gen) in ONE atomic request: the ad group, optional keywords (Search only) and optionally one ad. This is the only tool that adds structure to an already-created campaign — the create-campaign tools always build a fresh campaign. Declare channel to match the campaign's type (SEARCH -> 'search', DISPLAY -> 'display', DEMAND_GEN -> 'demand_gen' — from adsap_google_list_campaigns); the workflow verifies the campaign exists and rejects mismatches (PMax uses asset groups and is NOT supported; App/Shopping ad groups are also unsupported). SAFETY: if the parent campaign is ACTIVE the new ad group is created PAUSED by default so it never starts spending unreviewed — pass ad_group.status 'ENABLED' to override; if the campaign is PAUSED the ad group is created ENABLED (the campaign gates serving). Per channel: SEARCH — ad_group.keywords [{text, match_type EXACT|PHRASE|BROAD}] (optional but the group gets no traffic without them) and an optional responsive search ad (3-15 headlines max 30 chars w/ optional pinned_field, 2-4 descriptions max 90, final_url, path1/path2). DISPLAY — optional optimized_targeting flag and an optional responsive display ad (same shape as adsap_google_create_display_campaign's ad: >=1 landscape AND >=1 square image asset id, 1-5 headlines, exactly 1 long_headline, 1-5 descriptions, business_name, final_url). DEMAND_GEN — geo is REQUIRED at the AD GROUP level (ad_group.geo.location_ids; unlike Search/Display where geo is campaign-level and cannot be set here), plus optional language_ids, channel controls (ad_group.channels.strategy or .selected) and an optional 'multi_asset' image ad or 'video_responsive' YouTube ad (same shapes as adsap_google_create_demand_gen_campaign). An ad group created WITHOUT an ad will not serve until an ad is added. EXISTING-GROUP MODE: pass ad_group_id INSTEAD of ad_group to add ONE responsive search ad to an ad group that already exists (Search only; ad becomes required; ad.status defaults to PAUSED — pass ENABLED to create it serving; the workflow verifies the group exists, is not removed, and belongs to campaign_id). Use dry_run: true first — Google validates the whole chain without creating anything. ad_account_id is the bare 10-digit customer ID.

Inputs: channel (required), campaign_id (required), ad_account_id (required), ad, +3 more.

adsap_google_create_app_campaignCreate Google App CampaignAInspect

Create a complete Google App campaign in ONE atomic request: budget, campaign (ALWAYS created PAUSED — activate later with adsap_google_set_entity_status), location + language targeting, an ad group, and the app ad. App campaigns promote a mobile app across Google Search, Google Play, YouTube, Discover and the Display Network — Google mixes the ad from your text (and optional media) automatically. The ad links to the app's store listing AUTOMATICALLY: there is no URL input, ever. Any PUBLIC store app id works (no app ownership or Play/Firebase link is required to create): Android app_id is the package name (e.g. com.example.app), iOS app_id is the numeric App Store id (e.g. 570060128) with app_store 'apple_app_store'. v1 optimizes INSTALLS at your target_cpi (target cost per install, plain number in the account currency); Google recommends a daily_budget of roughly 50x target_cpi — lower is allowed but slows learning (a warning says so). Text: 2-5 headlines (max 30 chars) + 1-5 descriptions (max 90). Optional media: image_asset_ids / video_asset_ids from adsap_google_upload_asset (images 1.91:1, 4:5 or 1:1 up to 5MB; videos are YouTube assets 10-60s) — text-only is fully valid. In-app-action, value, engagement and pre-registration goals are NOT supported in v1. If the account has no conversion tracking a warning is returned — relay it (Android installs normally auto-track once a Google Play link exists). Use dry_run: true first — Google validates the whole chain without creating anything; show the plan, get confirmation, then execute. ad_account_id is the bare 10-digit customer ID. For website campaigns use adsap_google_create_search_campaign / adsap_google_create_pmax_campaign; for Meta app ads use adsap_create_campaign with an app objective.

Inputs: ad (required), geo (required), campaign (required), ad_account_id (required), +3 more.

adsap_google_create_demand_gen_campaignCreate Google Ads Demand Gen CampaignAInspect

Create a complete Google Ads Demand Gen campaign (YouTube, Discover, Gmail, Maps and the Google Display Network) in ONE atomic request: budget, campaign (ALWAYS created PAUSED — activate later with adsap_google_set_entity_status), a typeless ad group with channel controls, ad-group-level location/language targeting, and ONE ad. Use dry_run: true first — Google validates the whole chain without creating anything; show the plan, get confirmation, then execute. Two ad types (ad.ad_type): 'multi_asset' = image ad (1-5 headlines <=30 chars, 1-5 descriptions <=90, business name <=25, 1-5 logos, at least one landscape 1.91:1 or square 1:1 image from adsap_google_upload_asset, optional portrait 4:5 and tall-portrait 9:16, combined images <=20); 'video_responsive' = YouTube video ad (1-5 YouTube video ids, 1-5 headlines <=40, 1-5 long headlines <=90 REQUIRED, 1-5 descriptions <=90, 1-5 logos). Daily budget minimum is 5 (Google enforces a 5 USD local-currency-equivalent floor for Demand Gen). Channels: default ALL_CHANNELS; or channels.selected booleans (youtube_in_stream/youtube_in_feed/youtube_shorts/discover/gmail/display/maps — display: true is how you reach the Google Display Network). bidding_strategy 'auto' picks maximize_conversions when the account has conversion tracking, else maximize clicks; target_roas needs conversion history (Google rejects otherwise). ad_account_id is the bare 10-digit customer ID. For Search use adsap_google_create_search_campaign, for Performance Max adsap_google_create_pmax_campaign; for Meta use adsap_create_campaign.

Inputs: ad (required), geo (required), campaign (required), ad_account_id (required), +3 more.

adsap_google_create_display_campaignCreate Google Display CampaignAInspect

Create a classic standalone Google Display campaign in ONE atomic request: budget, campaign (ALWAYS created PAUSED — activate later with adsap_google_set_entity_status), location + language targeting, a Display ad group, and a responsive display ad. IMPORTANT CONTEXT to relay when relevant: Google is migrating standalone Display INTO Demand Gen (every response carries a heads-up; this campaign type will eventually be auto-migrated) — for new builds consider adsap_google_create_demand_gen_campaign with channels.selected.display: true instead; this tool exists for classic account-structure parity and full Display bid control. The ad REQUIRES BOTH image classes: at least one landscape image (1.91:1, min 600x314) AND at least one square image (1:1, min 300x300) — combined max 15 — plus 1-5 headlines (max 30 chars), EXACTLY ONE long_headline (max 90), 1-5 descriptions (max 90), business_name (max 25) and final_url. Optional: square logos (1:1, min 128x128) and landscape logos (4:1, min 512x128) combined max 5, up to 5 YouTube video assets, call_to_action_text (max 30). All image/video inputs are ASSET ids from adsap_google_upload_asset. Bidding: 'auto' picks Maximize Clicks (works without conversion tracking); 'manual_cpc' requires cpc_bid; 'maximize_conversions' (no target attached — Display rejects that combination); 'target_cpa' (standalone, needs target_cpa, no conversion-history requirement); 'target_roas' HAS a conversion-history eligibility gate (Google rejects it on accounts without enough conversions — relay that plainly if it fails). Use dry_run: true first — Google validates the whole chain without creating anything; show the plan, get confirmation, then execute. ad_account_id is the bare 10-digit customer ID.

Inputs: ad (required), geo (required), campaign (required), ad_account_id (required), +3 more.

adsap_google_create_pmax_campaignCreate Google Ads Performance Max CampaignAInspect

Create a complete Google Ads Performance Max campaign in ONE atomic request: budget, campaign (ALWAYS created PAUSED — activate later with adsap_google_set_entity_status), location/language targeting, and one asset group with text assets plus images previously created via adsap_google_upload_asset. Use dry_run: true first — Google validates the whole chain without creating anything; show the plan, get confirmation, then execute. Asset-group minimums (enforced): 3-15 headlines (<=30 chars), 1-5 long headlines (<=90), 2-5 descriptions (<=90, at least one <=60), business name (<=25), 1-5 logo images (1:1, min 128x128), 1-20 landscape images (1.91:1, min 600x314), 1-20 square images (1:1, min 300x300). Video is optional — without one, Google may auto-generate video from your assets. bidding_strategy 'auto' resolves to maximize_conversions with a conversion-tracking preflight warning when the account has no conversion actions. retail: true attaches the account's ACTIVE Merchant Center link (fails cleanly if none). ad_account_id is the bare 10-digit customer ID. For Search campaigns use adsap_google_create_search_campaign; for Meta use adsap_create_campaign.

Inputs: geo (required), campaign (required), asset_group (required), ad_account_id (required), +4 more.

adsap_google_create_search_campaignCreate Google Ads Search CampaignAInspect

Create a complete Google Ads Search campaign in ONE atomic request: budget, campaign (ALWAYS created PAUSED — activate later with adsap_google_set_entity_status), location/language targeting, ad group, keywords, and a responsive search ad. Use dry_run: true first — Google validates the whole operation chain without creating anything; show the plan, get confirmation, then execute. Location ids come from adsap_google_search_geo_targets. bidding_strategy 'auto' (default) resolves via a conversion-tracking preflight — maximize_conversions when the account has conversion actions, otherwise target_spend (Maximize Clicks) with an explanatory warning — and can always be overridden explicitly. ad_account_id is the bare 10-digit customer ID. For Meta campaigns use adsap_create_campaign instead.

Inputs: geo (required), rsa (required), ad_group (required), campaign (required), +3 more.

adsap_google_create_shopping_campaignCreate Google Shopping CampaignAInspect

Create a complete standard Google Shopping campaign in ONE atomic request: budget, campaign (ALWAYS created PAUSED — activate later with adsap_google_set_entity_status), location targeting, a Shopping ad group, the product ad, and an 'All products' listing group. Product data, images and landing pages come from the linked Merchant Center — there are NO creative inputs. REQUIRES an ACTIVE Merchant Center link on the account (clean NO_MERCHANT_LINK error if none; merchant_id is auto-resolved when exactly one link exists). Use dry_run: true first — Google validates the whole chain without creating anything; show the plan, get confirmation, then execute. campaign_priority (0-2) only arbitrates between the account's OWN standard Shopping campaigns — a retail Performance Max campaign ALWAYS outranks standard Shopping for the same products; say so when the account also runs retail PMax. feed_label (from adsap_google_list_feed_labels) restricts the campaign to one Merchant Center feed label; omit to advertise all feeds. Language targeting does not exist for Shopping (ad language follows the product feed). bidding_strategy: 'auto' picks Maximize Clicks; 'manual_cpc' REQUIRES cpc_bid and gives full bid control (the classic reason to prefer standard Shopping over PMax); 'target_roas' needs conversion history (~15 conversions/30 days). ad_account_id is the bare 10-digit customer ID. For Performance Max (incl. retail) use adsap_google_create_pmax_campaign; for Meta catalog ads use adsap_create_campaign.

Inputs: geo (required), campaign (required), ad_account_id (required), dry_run, +1 more.

adsap_google_get_account_activitiesGet Google Account ActivitiesAInspect

Change history for a Google Ads account: who changed what, and when. Returns recent account edits (campaign/ad group/ad/keyword/budget changes) with the editor's email, the surface used (web UI vs API), the operation (CREATE/UPDATE/REMOVE) and the exact fields changed. Google keeps this log for 30 days only — for older history point the user at the Google Ads UI (Tools > Change history). Changes can lag up to ~3 minutes. ad_account_id is the bare 10-digit customer ID.

Inputs: ad_account_id (required), limit, days_back, resource_type_filter.

adsap_google_get_conversion_breakdownGoogle Conversions by ActionAInspect

Break a Google Ads account's conversions down BY CONVERSION ACTION (Purchase vs Lead vs Sign-up vs phone call...) instead of one lumped total. The Google twin of Meta custom-conversion reporting, and the tool to reach for when the user asks which conversions the account is actually getting, whether a specific action is firing, or why All conversions is far above Conversions. Returns per action: name, category, all_conversions (+ value), conversions (+ value, primary-for-goal actions only, the ones bidding optimizes toward), view-through conversions, and each action's share of the total. level 'account' gives one row per action; level 'campaign' splits it per campaign. Google does NOT report cost split by conversion action, so there is no spend or CPA column here (use adsap_google_get_insights for cost). ad_account_id is the bare 10-digit customer ID.

Inputs: ad_account_id (required), level, limit, date_to, +3 more.

adsap_google_get_insightsGet Google Ads InsightsAInspect

Get Google Ads performance insights for an account, at campaign, ad-group, or keyword level (cache-first with auto-refresh from Google). Returns an account summary with previous-period comparison, a sortable per-entity table, and an optional daily timeseries. Metrics on both the summary and every row: cost, impressions, clicks, conversions, conversions_value + derived roas/ctr/cpc/cpm/cost_per_conversion/cvr; all_conversions, all_conversions_value, cost_per_all_conversion, view_through_conversions, cross_device_conversions (all_* counts EVERY conversion action, conversions counts only the ones included in bidding); engagements, engagement_rate, interactions, interaction_rate; video_views (TrueView/YouTube), video_view_rate, avg_cpv, video_p25/p50/p75/p100_rate; youtube_comments, youtube_likes, youtube_shares (v25 social engagement on Shorts ads on YouTube — 0 outside YouTube/Shorts delivery); and the competitive set search_impression_share, search_lost_is_budget, search_lost_is_rank, top_impression_pct, abs_top_impression_pct. The competitive metrics are Search-network only and read 0 for Display/PMax/Video delivery. search_lost_is_budget is CAMPAIGN LEVEL ONLY (the Google API does not report it for ad groups or keywords) so the key is ABSENT at the other levels rather than 0; at campaign level impression share plus the two lost shares add up to 100%. quality_score (1-10, null when Google reports none) appears only at keyword level. When Google capped most days in range, meta.share_metrics_note is set and rows carry search_share_is_approximate: report those three share figures as estimates. ad_account_id is the bare 10-digit customer ID from adsap_google_list_ad_accounts. Keyword-level row ids are "<ad_group_id>:<criterion_id>" — pass them as-is to adsap_google_set_entity_status / adsap_google_update_entity (entity_type keyword). Only entities with impressions in range appear (PMax has no ad groups/keywords by design). Note: Google reports plain Clicks/CTR/CPC (no Meta-style link-click split). For Meta insights use adsap_get_insights.

Inputs: ad_account_id (required), level, limit, cursor, +7 more.

adsap_google_keyword_ideasGet Google Ads Keyword IdeasAInspect

Get keyword suggestions with search volume from Google Keyword Planner for a Google Search campaign. Seed with keywords and/or a landing-page URL; returns keyword ideas with average monthly searches, competition and top-of-page bid range (in the account's currency). Pass geo_target_ids (from adsap_google_search_geo_targets) and language_id so volumes match the campaign's targeting. Feed chosen texts into adsap_google_create_search_campaign ad_group.keywords. ad_account_id is the bare 10-digit Google Ads customer ID. Google-only — Meta has no keyword-planner analog.

Inputs: ad_account_id (required), url, keywords, page_size, +3 more.

adsap_google_list_ad_accountsList Google Ads AccountsAInspect

SKILL FIRST: if a skill named adsap-ads is installed in this assistant, load it before calling this tool. List the Google Ads accounts connected in this workspace. Returns the bare 10-digit customer ID (use it as ad_account_id for adsap_google_list_campaigns / adsap_google_get_insights), name, currency, timezone, status. Use to pick a Google Ads account; ask the user if several. Only accounts that are set up in the Adsap web app are listed (the same list the web app shows); meta.accounts_requiring_setup counts the connected accounts hidden because their setup is unfinished, and the fix for those is: open Settings in Adsap, find the account under Accounts Requiring Setup, and click Start setup. For Meta accounts use adsap_list_ad_accounts instead. PLATFORM RULE: when the user's question does not name a platform, call this ALONGSIDE adsap_list_ad_accounts so Google accounts are never silently omitted from account resolution.

Inputs: limit, cursor.

adsap_google_list_ad_templatesList Google Campaign TemplatesAInspect

List saved Google campaign templates (wizard-saved setups per channel: budget, bidding, geo, languages, ad text, extensions, asset picks). The payload mirrors the wizard fields; feed it back to a user as a starting point or compare setups. Portable templates apply to any account; account-bound ones (asset ids) only to their customer_id.

Inputs: limit, cursor, channel, customer_id.

adsap_google_list_audiencesList Google Ads AudiencesAInspect

List a Google Ads account's audiences: both Audience resources (reusable segment+demographic combinations — these are the ids that adsap_google_create_pmax_campaign / adsap_google_create_demand_gen_campaign audience_ids inputs expect) and UserLists (remarketing lists / segments, with approximate sizes). Use to resolve audience NAMES to ids before creating PMax or Demand Gen campaigns with audience signals, or to review what remarketing lists exist. ad_account_id is the bare 10-digit customer ID. For Meta audiences use adsap_list_custom_audiences.

Inputs: ad_account_id (required).

adsap_google_list_campaignsList Google Ads CampaignsAInspect

List Google Ads campaigns in a Google Ads account (cache-first; auto-refreshes from Google when the cache is missing or older than 1 hour). Returns status, channel type (SEARCH, PERFORMANCE_MAX, ...), bidding strategy, daily budget. ad_account_id is the bare 10-digit Google Ads customer ID from adsap_google_list_ad_accounts. For Meta campaigns use adsap_list_campaigns instead.

Inputs: ad_account_id (required), limit, cursor, refresh, +1 more.

adsap_google_list_conversion_actionsList Google Conversion ActionsAInspect

List a Google Ads account's conversion actions (name, type, category, status, primary-for-goal, counting type, origin). Use BEFORE creating campaigns with conversion-based bidding: Maximize Conversions / target_cpa need at least one ENABLED primary conversion action, and target_roas additionally needs conversion VALUE history — zero enabled actions means those bidding modes will fail or a Search campaign will silently fall back. Also the first stop when a user asks why conversions aren't tracking. ad_account_id is the bare 10-digit customer ID. For Meta pixels/conversions use adsap_get_pixel_details / adsap_list_custom_conversions.

Inputs: ad_account_id (required), include_removed.

adsap_google_list_creative_assetsList Google Creative AssetsAInspect

List the creative assets already in a Google Ads account's library: IMAGE (with dimensions + which PMax/Demand Gen image slots each fits), YOUTUBE_VIDEO (video id + title) and TEXT assets. Google assets are account-scoped, immutable and cannot be deleted — to stop one serving, remove its LINK from the campaign (adsap_google_manage_extension for extension links; asset-group edits ship later). Pass usage_for_asset_id to see WHERE one asset is used (campaign / ad-group / PMax asset-group / account-level links AND inside ads) — the pre-flight for 'can I stop using this?'. Asset ids feed the *_asset_ids inputs of the PMax / Demand Gen / Display / App create tools, so re-using an existing image needs no re-upload. ad_account_id is the bare 10-digit customer ID.

Inputs: ad_account_id (required), limit, search, asset_type, +1 more.

adsap_google_list_extensionsList Google Ads ExtensionsAInspect

List the extensions (sitelinks, callouts, structured snippets, call, promotion, price, image/AD_IMAGE) linked to Google Ads campaigns AND at account level (rows with level 'account' + campaign_id null serve with all eligible campaigns; manage them via adsap_google_manage_extension level 'account'). Optionally filter to one campaign_id (campaign links only) and/or one field_type. Rows with source AUTOMATICALLY_CREATED are Google-automated extensions (treat as read-mostly — editing or unlinking them is usually not what the user wants). Feeds adsap_google_manage_extension (use the returned asset_id for link/unlink/update_asset; image assets are never updatable). No performance metrics in v1 — asset performance is a later phase. ad_account_id is the bare 10-digit Google Ads customer ID. Meta has no extensions analog.

Inputs: ad_account_id (required), limit, field_type, campaign_id.

adsap_google_list_feed_labelsList Merchant Center Feed LabelsAInspect

List the distinct Merchant Center feed labels visible to a Google Ads account (from the products synced via its Merchant Center link). Use before adsap_google_create_shopping_campaign when the user wants to restrict a standard Shopping campaign to one feed — pass a returned feed_label EXACTLY as-is (case-sensitive). An empty list usually means no Merchant Center link, no products submitted yet, or the product sync (which can lag a fresh link by hours) has not landed — say which is likely and note that omitting feed_label targets all feeds. ad_account_id is the bare 10-digit customer ID.

Inputs: ad_account_id (required).

adsap_google_manage_ad_templateGoogle: Manage Campaign Template (create / update / delete)AInspect

Create, update, or delete a saved Google campaign template (the wizard-saved setups adsap_google_list_ad_templates reads: budget, bidding, geo, languages, ad text, extensions, asset picks — per channel: search, pmax, demand_gen, shopping, app, display). Every write is validated against the exact wizard shape for the channel, so chat-written templates always load cleanly in the ADSAP web wizards. Update: pass payload_patch to merge top-level fields (null removes a field) and/or name to rename. Templates whose payload carries uploaded asset ids are account-bound and need customer_id; without asset ids they are portable across accounts. dry_run defaults TRUE: preview, confirm with the user, then call again with dry_run:false. Templates are launch presets only — deleting one never touches live campaigns.

Inputs: action (required), name, channel, dry_run, +4 more.

adsap_google_manage_extensionManage Google Ads ExtensionsAInspect

Manage Google Ads extensions (sitelinks, callouts, structured snippets, call, promotion, price) at CAMPAIGN level (default) or ACCOUNT level (level: 'account' — the link serves with ALL eligible campaigns; all six types accepted, probe-confirmed). Ops: 'create_and_link' creates new extension assets and links them to a campaign in one atomic call (max 20); 'link' attaches EXISTING assets to a campaign; 'unlink' detaches them from that campaign — this is how you stop an extension serving there, because Google Ads assets cannot be deleted; 'update_asset' edits an existing asset — WARNING: assets are account-scoped, so an update changes the extension EVERYWHERE it is linked, not just one campaign. Image extensions: bytes go through adsap_google_upload_asset first, then op 'link' with field_type AD_IMAGE — BUT Google allowlist-gates AD_IMAGE links via API (most accounts get UNSUPPORTED_FIELD_TYPE; not something ADSAP can fix), and image assets are never content-mutable. Promotion/price also link to PMax campaigns; AD_IMAGE does not. Use adsap_google_list_extensions first to see what exists (asset ids, field types). Use dry_run: true first for create — Google validates everything without changing anything. All-or-nothing: on error nothing is applied. ad_account_id is the bare 10-digit Google Ads customer ID. Meta has no extensions analog.

Inputs: op (required), ad_account_id (required), type, level, +29 more.

adsap_google_manage_keywordsManage Google Ads KeywordsAInspect

Manage Google Ads Search keywords AFTER creation. op 'add': add up to 100 keywords (and/or ad-group negatives via negative: true) to an EXISTING ad group — atomic batch, per-keyword optional cpc_bid. op 'add_negative': add campaign-LEVEL negative keywords (block queries across every ad group in the campaign). op 'replace': change one keyword's text and/or match type ATOMICALLY (Google keyword text/match type are immutable, so this is remove + re-add in one request — the keyword gets a NEW id and its performance history restarts; status and bid carry over). op 'remove': remove one ad-group keyword/negative (keyword_id) or one campaign negative (campaign_negative_id). Ids are composite "<parent_id>:<criterion_id>" — ad-group keyword ids come from adsap_google_get_insights level keyword; created ids are returned by the add ops. Always dry_run: true first. For pause/enable use adsap_google_set_entity_status; for per-keyword bid changes alone use adsap_google_update_entity with updates.cpc_bid.

Inputs: op (required), ad_account_id (required), dry_run, keywords, +5 more.

adsap_google_manage_targetingManage Google Ads TargetingAInspect

Manage a Google Ads campaign or ad group's targeting AFTER creation: GEO, LANGUAGE and AUDIENCES. op 'add' at campaign level (default): up to 100 locations (negative: true = exclude) and/or 50 languages, OR up to 50 audiences (audiences cannot combine with geo/languages in one call — separate calls). op 'add' at ad-group level (level: 'ad_group' + ad_group_id): audiences only. AUDIENCES: pass user_list_id items (audience segments from adsap_google_list_audiences) — campaign-level TARGETING works on Search/Shopping only; campaign-level EXCLUSION (negative: true) also on Display/Performance Max; ad-group level (target or exclude) on Search/Display/Shopping. DEMAND GEN is different: pass audience_id items (Audience resources) on the AD GROUP — nothing at campaign level. Video supports no audience edits. The same user list cannot be attached at BOTH campaign and ad-group level. 'mode' ('targeting' = narrow delivery to the audiences | 'observation' = full reach, bid adjustments only) sets the audience targeting setting — combinable with the audience add or standalone; Google's default with NO mode set is TARGETING, so pass mode: 'observation' for Search/Shopping unless the user explicitly wants to narrow reach. op 'remove': remove ONE criterion by composite id "<parent_id>:<criterion_id>" (level 'campaign' → campaign criterion, 'ad_group' → ad-group criterion). Geo/language criterion ids EQUAL their constant ids (France on campaign 123 = "123:2250"); AUDIENCE criterion ids are Google-internal — capture them from the add response (created_criteria[].entity_id). Criteria are immutable: to change one, remove it and add the replacement. Always dry_run: true first. For campaign negative KEYWORDS use adsap_google_manage_keywords op 'add_negative'.

Inputs: op (required), ad_account_id (required), mode, level, +7 more.

adsap_google_search_geo_targetsSearch Google Ads Geo TargetsAInspect

Find Google Ads geo target constants by location name (city, region, country, postal area) for Search campaign location targeting. Returns id, name, target type, country, reach and parent locations for each match — the id is exactly what adsap_google_create_search_campaign expects in geo.location_ids. Up to 25 names per call; pass country_code to disambiguate (e.g. Paris FR vs Paris TX). For Meta geo targeting use adsap_search_geo_locations instead.

Inputs: location_names (required), locale, country_code.

adsap_google_search_termsGet Google Search Terms ReportAInspect

Search terms report for a Google Ads account: the REAL user queries that triggered Search (and Shopping) ads, with impressions/clicks/cost/conversions per term. The classic optimization read — find irrelevant queries burning budget (candidates for negative keywords) and high-converting queries worth adding as exact keywords. The same term can appear once per ad group (implicit segmentation — not duplicates). Terms with zero impressions in range are omitted by Google. ad_account_id is the bare 10-digit customer ID.

Inputs: ad_account_id (required), limit, date_to, date_from, +2 more.

adsap_google_set_entity_statusPause or Activate Google Ads EntitiesAInspect

Pause or reactivate one or more Google Ads campaigns, ad groups, ads, or keywords (max 20 per call). Use dry_run: true to preview the change (current vs new status, validated by Google) without applying anything. Only set action to 'activate' when the user has explicitly requested to resume or enable. Keyword ids are composite "<ad_group_id>:<criterion_id>" (as returned by adsap_google_get_insights level keyword). ad_account_id is the bare 10-digit Google Ads customer ID. For Meta entities use adsap_set_entity_status instead.

Inputs: action (required), entity_ids (required), entity_type (required), ad_account_id (required), +1 more.

adsap_google_update_entityUpdate Google Ads EntityAInspect

Edit an existing Google Ads campaign, ad group, ad, or keyword: change status (PAUSED/ACTIVE), rename (campaign/ad group), set a campaign's daily budget (in account currency, e.g. 12.50), change a campaign's BIDDING scheme/targets (updates.bidding — swap scheme or edit tCPA/tROAS/ceiling; portfolio strategies rejected), edit ASSET AUTOMATION opt-ins (updates.asset_automation — campaign level on PMax/Search, ad level on Demand Gen ads), or set a keyword's max CPC (updates.cpc_bid — Manual CPC campaigns only, ignored under automated bidding). Keyword TEXT is immutable — use adsap_google_manage_keywords op 'replace' to change it; keyword entity_id is "<ad_group_id>:<criterion_id>" from adsap_google_get_insights level keyword. Put ONLY the fields you want to change in updates. Use dry_run: true to preview the diff (current vs new, validated by Google without applying). ad_account_id is the bare 10-digit Google Ads customer ID. For Meta entities use adsap_update_entity instead.

Inputs: updates (required), entity_id (required), entity_type (required), ad_account_id (required), +1 more.

adsap_google_upload_assetUpload Google Ads AssetsAInspect

Create Google Ads assets (images from the ADSAP creative library, text, YouTube videos) in one atomic request — the building blocks for adsap_google_create_pmax_campaign. Image assets report width/height and eligible_field_types so you know which PMax slot (landscape 1.91:1, square 1:1, portrait 4:5, logo) each image can fill; pass the returned asset_id values to the PMax create tool. Use dry_run: true to validate without creating. ad_account_id is the bare 10-digit customer ID. For Meta creative uploads use adsap_upload_creative instead.

Inputs: assets (required), ad_account_id (required), dry_run.

adsap_google_upload_videoUpload Video to YouTubeAInspect

Upload a video FILE (MP4 in the ADSAP creative library) to YouTube for use in Google Ads video slots, and get back a YouTube video asset. Use this when the user has a video file but NO YouTube channel — the video goes to a Google-managed 'ad storage' YouTube channel owned by the ad account, stays UNLISTED, and never appears on any public channel. If the user already has the video on YouTube, skip this tool and pass the YouTube id/asset directly to the campaign tool instead. TWO STEPS, always: (1) action 'upload' with the storage_path of the file — returns upload_resource_name immediately; (2) action 'status' with that upload_resource_name — YouTube processing usually takes a few MINUTES, so poll every ~30s; while it is still processing you get state UPLOADED and still_processing: true, and once it reaches PROCESSED the tool mints the video asset automatically and returns asset_id + video_id. Feed the result into a video slot: adsap_google_create_demand_gen_campaign uses the VIDEO ID (ad.youtube_video_ids), while adsap_google_create_display_campaign (youtube_video_asset_ids) and adsap_google_create_app_campaign (video_asset_ids) use the ASSET ID. The video title CANNOT be changed after upload (Google marks it immutable) — set it correctly on the upload call. Max 256 MB. ad_account_id is the bare 10-digit customer ID. For Meta video uploads use adsap_upload_creative instead.

Inputs: action (required), ad_account_id (required), job_id, dry_run, +6 more.

adsap_import_account_creativesImport Meta Account CreativesAInspect

Import ALL historical creative assets (images + videos) that already exist in a Meta ad account into the ADSAP Creative Library. Runs in the background (minutes for large accounts); check progress with adsap_get_import_status. Already-imported assets are skipped (content-hash dedup for images, video_id for videos), and after the first full import a daily sync picks up new assets automatically. Assets stay on Meta — the library stores metadata + a thumbnail, and imported assets are immediately reusable in new ads.

Inputs: ad_account_id (required).

adsap_list_ad_accountsList Ad AccountsAInspect

SKILL FIRST: if a skill named adsap-ads is installed in this assistant, load it before calling this tool. List Meta ad accounts the user manages. Returns status, currency, timezone. Use to pick an account. Only accounts that are set up in the Adsap web app are listed (the same list the web app shows); meta.accounts_requiring_setup counts the connected accounts hidden because their setup is unfinished, and the fix for those is: open Settings in Adsap, find the account under Accounts Requiring Setup, and click Start setup. PLATFORM RULE: when the user's question does not name a platform ('my ads', 'my accounts', 'how did my ads do'), this list is NOT the whole picture — ALSO call adsap_google_list_ad_accounts and present both platforms' accounts together, or explicitly say you are only covering Meta. Never let a platform-unspecified question silently become Meta-only.

Inputs: limit, cursor, status_filter.

adsap_list_adsList AdsAInspect

List ALL ads inside an ad set or a campaign, live from Meta, including ads created today that have no delivery yet (which insights-based views miss). Pass exactly ONE of ad_set_id or campaign_id. Returns each ad's id, name, status, effective_status, created_time and creative id. Use this to enumerate ads before duplicating an ad set, auditing what exists, or picking an ad_id for adsap_get_ad / adsap_get_ad_status / adsap_replace_ad_creative. Deleted/archived ads are excluded unless you ask for them via effective_status. FIND ADS BY THEIR TEXT: pass text to get only the ads whose primary texts, headlines or descriptions contain that phrase, every variant included (carousel cards and Flexible ads too). Each ad comes back with text_matches (the field, the card number for a carousel card, and the full text) and current_texts: its complete primary_texts, headlines and descriptions, exactly as adsap_replace_ad_creative takes them. To change a text, send those complete lists with the edit applied (dry_run true first): no adsap_get_ad call is needed. A match that is not in current_texts (a carousel card, a Flexible ad, a catalog ad, an ad made from an existing post) cannot be changed with adsap_replace_ad_creative; say so. Upper and lower case are ignored, and line breaks or repeated spaces count as one space; emojis, punctuation and digits must match exactly. One call searches up to 500 ads; when meta.has_next is true, pass meta.paging_after as after with the same text to search the rest. Ads whose text Meta does not return are listed in meta.not_searchable. On catalog ads the headline is usually Meta's {{product.name}} placeholder, so a product name never matches. Use text instead of one adsap_get_ad per ad, for example to find every ad that still says an old offer before changing it. To change the same text in several ads, use adsap_replace_ad_text: it searches, previews every ad and applies in a few calls.

Inputs: ad_account_id (required), text, after, limit, +3 more.

adsap_list_ad_setsList Ad SetsAInspect

List ad sets for a campaign (fast cached list). Returns name, status, budgets, optimization goal, billing event, destination type and promoted object; fields the cache does not hold (full targeting, placements, attribution_spec, bid strategy, spend limits, schedule, effective_status) come back null — read them live per ad set with adsap_get_ad_set. Renders an interactive card where the user can TICK rows to select ad sets; the current selection is recorded in the card's widget context. When the user refers to a ticked/chosen ad set ('this one', 'the one I picked'), READ the widget context first — never claim you cannot see in-card ticks without reading it. A selected ad set's id goes straight into adsap_create_ad / adsap_create_ad_from_ig_post.

Inputs: campaign_id (required), limit, cursor, ad_account_id, +1 more.

adsap_list_ad_sheetsList Ad SheetsCInspect

List bulk ad creation sheets for an ad account. Sheets contain rows of ad configurations.

Inputs: limit, cursor, ad_account_id.

adsap_list_ad_templatesList Ad TemplatesBInspect

List saved ad templates. Pass template_id to creation tools to auto-fill copy, identity, and enhancement presets.

Inputs: limit, cursor, ad_account_id.

adsap_list_appsList Advertisable AppsAInspect

List the apps an ad account can promote — use to pick application_id + object_store_url for App promotion (OUTCOME_APP_PROMOTION) campaigns/ad sets. Serves from the workspace cache (no Meta API call); pass refresh:true to re-sync live from Meta. Note: apps in Development mode appear in this list but Meta refuses to promote them (3858107) — the app must be in Live mode.

Inputs: ad_account_id (required), refresh.

adsap_list_automation_rulesList Automation RulesAInspect

List the automation rules on one ad account, and optionally what they have done. Each rule shows its conditions, whether it only reports (mode 'notify') or turns things off (mode 'auto_act'), and its guardrails: the spend floor it will not act below, its per-entity cooldown, how many recent days it ignores for conversion-based numbers, and whether it skips entities still in their learning phase. With include_activity true you also get recent evaluations: 'acted' means it was turned off, 'would_have_acted' means the rule matched but did not act (either it only reports, or the account-wide execute switch is off), and 'skipped' with a reason means a guardrail stopped it. Explain a rule in plain language and always mention its guardrails, since they are what makes it safe.

Inputs: account_id (required), enabled_only, activity_limit, include_activity.

adsap_list_campaignsList CampaignsAInspect

List Meta campaigns in an ad account (fast cached list). Returns name, objective, status, budgets, budget_type and Special Ad Categories; fields the cache does not hold (effective_status, buying_type, spend_cap, currency, schedule) come back null — read them live per campaign with adsap_get_campaign. Renders an interactive card where the user can TICK rows to select campaigns; the current selection is recorded in the card's widget context. When the user refers to a ticked/chosen campaign, READ the widget context first — never claim you cannot see in-card ticks without reading it.

Inputs: limit, cursor, ad_account_id, status_filter, +1 more.

adsap_list_catalogsList CatalogsAInspect

List Meta product catalogs and their product sets for an ad account — use to pick a catalog + product set when building catalog, DPA, or collection ads. Serves from the workspace cache (no Meta API call). Pass refresh:true to force a live re-sync from Meta when the cached list may be stale.

Inputs: ad_account_id (required), refresh.

adsap_list_creative_assetsList Creative AssetsAInspect

List uploaded Meta creative images and videos in the ad account asset library. Filters: name_contains (case-insensitive substring on the filename), image_hash / video_id (find the library entry for an existing Meta asset, e.g. from adsap_get_ad), group_id, created_after. For large libraries set skip_thumbnails: true to get a lightweight listing (no signed preview URLs — much smaller, no picker card images).

Inputs: limit, cursor, group_id, video_id, +6 more.

adsap_list_custom_audiencesList Custom AudiencesAInspect

List custom audiences and saved audiences in a Meta ad account. Returns audience type (website retargeting, customer list, lookalike, engagement), size, freshness, staleness flags. Essential for auditing audience strategy — detecting missing retargeting, stale seeds, untapped lookalikes.

Inputs: ad_account_id (required), limit, cursor, type_filter.

adsap_list_custom_conversionsList Custom ConversionsAInspect

List an ad account's custom conversions (live from Meta) — the CAPI/pixel conversion definitions used as optimization or attribution events (e.g. 'Purchase over $50', a specific URL rule). Returns id, name, event type, creation time, and rule. Use to look up a custom conversion id before building a sales/leads ad set, or to audit which conversions exist.

Inputs: ad_account_id (required), after, limit.

adsap_list_drive_filesList Google Drive FilesBInspect

Browse Google Drive for creative image/video files to upload to Meta. Google Drive shows ADSAP only the files the user picked in the web app (Creative Upload page): an empty list means nothing was picked yet, not an empty Drive.

Inputs: limit, folder_id, folder_path, type_filter, +1 more.

adsap_list_dropbox_filesList Dropbox FilesAInspect

Browse Dropbox for creative image/video files to upload to Meta. Returns each file's dropbox_path, which adsap_upload_creative accepts directly.

Inputs: limit, folder_path, type_filter, search_query.

adsap_list_experimentsList ExperimentsAInspect

List an ad account's Meta experiments / ad studies (live from Meta) — A/B split tests and conversion-lift studies, with type, status timestamps (start/end/canceled/observation-end), and description. Use to audit which experiments exist or ran, before analyzing results in Ads Manager. Read-only: experiments can only be CREATED in Meta Ads Manager (the public API does not support creation), so use this to inspect, not to set up tests.

Inputs: ad_account_id (required), after, limit.

adsap_list_ig_mediaList Instagram MediaAInspect

List an Instagram account's recent media/posts (live from Meta) — the posts, reels, and stories that can be promoted. Use after adsap_list_meta_assets (asset_type:"instagram_accounts") to pick a post to boost or to reference existing organic content. Returns each media item's id, type (IMAGE/VIDEO/CAROUSEL_ALBUM), placement (media_product_type: FEED/STORY/REELS), image/thumbnail URL, permalink, caption, timestamp, and like/comment counts, plus a pagination cursor.

Inputs: ad_account_id (required), ig_account_id (required), after, limit.

adsap_list_meta_assetsList Meta AssetsAInspect

List Meta pages, Instagram accounts, pixels, or forms for ad creation. Served from ADSAP's asset cache and automatically synced live from Meta when the cache is empty for the requested account.

Inputs: asset_type (required), limit, cursor, ad_account_id.

adsap_list_pixel_eventsList Pixel EventsBInspect

List conversion events for a Meta pixel for ad set optimization.

Inputs: pixel_id (required), limit, cursor.

adsap_manage_ad_templateManage Ad Template (create / update / delete)AInspect

Create, update, or delete a saved Meta ad template (copy, CTA, destination URL, page/Instagram identity, pixel, catalog refs, enhancement toggles, site links). Completes the pair with adsap_list_ad_templates (read). Update is a PARTIAL PATCH — only the fields you pass change; the copy arrays (primary_texts/headlines/descriptions) and sitelinks replace their whole list. Enhancement toggles use the same toggle keys adsap_list_ad_templates returns in enhancement_flags. dry_run defaults TRUE: call once to preview the exact writes, confirm with the user, then call again with dry_run:false. Deleting a template does NOT touch launched ads; draft ad-sheet rows that still reference it are unlinked (the preview reports how many).

Inputs: action (required), name, dry_run, pixel_id, +23 more.

adsap_manage_automation_ruleManage Automation RuleAInspect

Create, change, switch on/off or delete an automation rule for one ad account. A rule checks the account every day and, when every condition is true, either just reports it (mode 'notify') or turns the entity off (mode 'auto_act'). ALWAYS call with dry_run true first, read the parsed rule back to the user in plain language including its guardrails, and only call again with dry_run false after they explicitly confirm: a rule mis-parsed from a sentence can switch off a client's live spending. min_spend is REQUIRED and cannot be zero-ed away by design, because a rule with no spend floor fires on noise. Conditions are combined with AND. Cost-per-conversion, return-on-spend and conversion-count conditions automatically ignore the most recent day or two, because conversions take time to be counted. On Meta a rule never acts on something still in its learning phase or changed in the last 2 days. Google supports campaign and ad_set levels only.

Inputs: action (required), account_id (required), mode, name, +7 more.

adsap_manage_custom_audienceManage Custom Audience (create / update / delete)AInspect

Create, update, or delete a RULE-BASED custom audience: Website (pixel/site visitors), Engagement (Instagram/Facebook engagers), Lookalike (people similar to an existing audience), or App (mobile app users). Completes the pair with adsap_list_custom_audiences (read). For create, pick an audience_type and pass a rule (or lookalike fields). dry_run defaults TRUE: call once to preview, then again with dry_run:false to apply. Delete is PERMANENT and auto-pauses any ad sets using the audience — the dry_run preview lists them first. NOTE: this covers rule-based audiences only; uploading a customer list (hashed emails/phones) is NOT supported here. The account must accept Meta's Custom Audience Terms of Service once before any audience can be created (Meta returns an accept URL if not).

Inputs: action (required), ad_account_id (required), name, rule, +8 more.

adsap_manage_instant_formManage Instant Form (create / duplicate / archive / reactivate)AInspect

Create, duplicate, archive or reactivate a Meta Instant Form: the lead form people fill in without leaving Facebook or Instagram. Use it when the user wants a lead ad and has no suitable form yet, or wants a changed version of an existing form. IMPORTANT: Meta never lets a form be edited or deleted once created, only archived, so dry_run defaults TRUE: call once to preview (free, creates nothing), show the user the summary, then call again with dry_run:false after they confirm. To 'edit' a form, duplicate it with the changed sections and archive the old one. Before create, ask the user for the questions. The privacy policy link (Meta requires one) and the thank-you screen (headline, optional text, button or no button) can be saved once per Facebook Page by the user in Adsap, on the Instant Forms page: leave privacy_policy and thank_you out, and the preview applies the saved defaults and lists them (defaults_used, defaults_applied): show them to the user. If the preview says they are missing, ask the user for them. Never invent a privacy link or a thank-you text, and suggest wording only if the user asks you to. Not available: conditional logic (Meta keeps it for its own interface), and, not built in Adsap yet, appointment, store locator and national ID questions and file downloads on the thank-you screen. The returned form_id goes into creative_spec.leadgen_form_id of adsap_create_ad, on an ad set whose conversion location is Instant Forms (or Website and Instant Forms) and that promotes the SAME Page. List a Page's forms with adsap_list_meta_assets (asset_type instant_forms).

Inputs: action (required), ad_account_id (required), form, dry_run, +2 more.

adsap_manage_onboarding_planManage Onboarding PlanAInspect

Create, read, update, or delete a structured onboarding plan for a Meta ad account. Persisted in Supabase for cross-session continuity. After gathering business context (via adsap_analyze_website + adsap_get_account_health), use this to store a recommended setup plan with actionable steps.

Inputs: action (required), ad_account_id (required), plan_id, step_updates, +7 more.

adsap_pingPing ADSAP ServerA
Read-onlyIdempotent
Inspect

Verify ADSAP MCP server connectivity and API key. Also reports the caller's Google Ads connection state (token status + number of connected Google Ads accounts in this workspace).

Inputs: no named parameters.

adsap_replace_ad_creativeReplace Ad Creative (edit ad content)AInspect

DESTRUCTIVE. Edit the CONTENT of an existing Meta ad: primary text, headline, description, CTA, destination link, display link, UTM url_tags, the image/video itself, and Shop (shop: 'on' or 'off'). Meta creatives are immutable, so this builds a NEW creative and repoints the ad: the ad keeps its id but gets a new creative_id and the old creative is orphaned. Editing a live/spending ad can reset its social proof (likes/comments/shares) and restart the learning phase. Text fields are ARRAYS: send the COMPLETE set with your edits applied; entries you don't change are preserved verbatim (primary_texts, headlines, descriptions). To change the same text in several ads, use adsap_replace_ad_text instead: one preview and one confirmation for all of them. Media swaps use creative-library assets only and are like-for-like (image->image, video->video); for multi-image ads (square + vertical) use the media array, one entry per slot. ALWAYS call with dry_run: true first: the preview returns the before/after diff AND the current media slots (use those to build a media swap), then dry_run: false to apply. When the ad's format has no room for a change (for example two primary texts on an ad that holds one), the answer is EDIT_NOT_SUPPORTED and nothing is changed: tell the user, using the message as returned. Everything you do not ask to change stays exactly as it is: enhancements, Shop, the other text variations, the button and the media. Both answers check it. Shop: off means people always go to the website; on means Meta can send people to the business's Facebook or Instagram shop instead, if the business has one. The preview's settings_check.shop is the ad's current Shop setting and settings_check.shop_applies says whether Shop applies to the ad at all (website ads only). Say nothing about the check when it finds nothing. Only when settings_check.unexpected (preview) or after_apply_check.unexpected (apply) is above 0: tell the user which settings would change or changed, using the setting names and values as returned, and before an apply get the user's confirmation again. Entries marked expected: true are Meta bookkeeping (a new id Meta gives a video on every video edit, a retired summary switch Meta no longer accepts): never mention them unless the user asks.

Inputs: ad_id (required), ad_account_id (required), creative_spec (required), dry_run.

adsap_replace_ad_textFind and replace text in adsAInspect

Change the same text in many Meta ads at once, for example an old offer or a number that changed. Works on the ads of ONE ad set or ONE campaign per call. Step 1, preview (dry_run true, the default): pass find, replace_with and ad_set_id or campaign_id. It searches up to 500 ads with the same rule as adsap_list_ads text (upper and lower case ignored, line breaks and repeated spaces count as one space, emojis, punctuation and digits exact), replaces every occurrence by replace_with exactly as typed, and previews each ad without changing anything. It returns preview_id, the ads that would change with each text before and after, held (ads where another setting would also change), cannot_change (texts Adsap cannot change: carousel cards, Flexible ads, catalog ads, ads made from an existing post) and meta.active_ads (how many of these ads are running). Show the user ONE list: every ad with its before and after text, then the held and cannot_change ads with their reasons. Each changed ad gets a new creative: on a running ad this can restart learning and reset the likes and comments shown, so when meta.active_ads is above 0 say so. Apply only after the user confirms. Step 2, apply: pass the same ad_account_id, dry_run false and preview_id (within 30 minutes). Held ads are left out unless their ids are in ad_ids, and only after the user agreed to the other setting change; pass ad_ids also to apply only some ads. Each call changes ads for about 35 seconds and answers with what changed; when meta.remaining is above 0, call again with the same preview_id until it is 0. An ad changed by someone else after the preview is skipped, never overwritten. Every text you do not ask to change stays as it is, and so do the enhancements, Shop, the button, the link and the media. Say nothing about the settings checks when they find nothing. Only for ads listed under warnings (after the apply): tell the user which settings Meta reports as different, using the names and values returned. More than 50 ads to change: apply these, then preview again for the rest. One task is counted per ad changed. To change other fields (link, button, media) or one ad in a custom way, use adsap_replace_ad_creative.

Inputs: ad_account_id (required), find, after, ad_ids, +6 more.

adsap_search_ad_librarySearch Meta Ad LibraryAInspect

Search Meta's public Ad Library for ads (competitor research / ad transparency). Find the ads a competitor page is currently running, or ads matching a keyword, in given countries. Returns each ad's page, creative text, platforms, languages, delivery dates, days_running, eu_total_reach (people reached in the EU: with days_running, the public signal of which ads an advertiser is scaling), a public Ad Library permalink, and a pagination cursor. Filters: media_type (STATIC for image ads only, VIDEO for video only), exact-phrase matching, platform, language, delivery dates. A keyword search also returns data.pages, the distinct advertisers found, so you can re-run on one page_id. Read-only public data (not your own account's ads — use adsap_list_campaigns/adsap_get_insights for that). COVERAGE CEILING (Meta's rule, not ADSAP's): the public Ad Library API returns ordinary commercial ads ONLY where they reached the EU or UK. Ads that never reached the EU/UK are returned only when they are political or social-issue ads. So a US-only (or any non-EU/UK) commercial search returns zero results however it is phrased, and that empty result is NOT evidence the advertiser is inactive. Never promise non-EU/UK competitor research from this tool; point the user at the public Ad Library website for those markets.

Inputs: countries (required), ad_account_id (required), after, limit, +11 more.

adsap_search_behaviorsSearch Targeting BehaviorsBInspect

Search Meta behavior targeting by keyword/category. Returns IDs for use in targeting.behaviors.

Inputs: limit, query, category, ad_account_id.

adsap_search_catalog_productsSearch Catalog ProductsAInspect

Search or list the products in a Meta product catalog (live from Meta). Optionally narrow with a JSON filter rule (e.g. availability, brand, price) or look up a specific SKU via retailer_id. Returns matching products plus the TOTAL match count — use it before building a product set to preview how many products a filter resolves to.

Inputs: catalog_id (required), ad_account_id (required), after, limit, +2 more.

adsap_search_detailed_targetingSearch Detailed TargetingAInspect

Search Meta detailed targeting the way Ads Manager's search box does: interests, behaviors AND demographics (job titles, employers, industries, education level, schools, fields of study, life events, parents, relationship status, income) in one query. Each result has a type: put the item under that key inside a targeting.flexible_spec group of adsap_create_ad_sets, e.g. {"family_statuses": [{"id": "6002714398372", "name": "Parents (All)"}]}. Unrelated filler Meta pads results with is removed. For housing, employment or financial campaigns pass special_ad_category: Meta then offers approved interests only. To size an audience before creating it, pass the same groups to adsap_get_delivery_estimate.

Inputs: query (required), ad_account_id (required), limit, special_ad_category.

adsap_search_geo_locationsSearch Geo LocationsBInspect

Search Meta city/region location keys for targeting. Country ISO codes do NOT need lookup — use directly in targeting.countries.

Inputs: query (required), limit, country_code, location_types.

adsap_search_interestsSearch Targeting InterestsAInspect

Search Meta interest targeting by keyword. Returns IDs for use in targeting.interests.

Inputs: query (required), limit, ad_account_id.

adsap_set_entity_statusPause or Activate EntitiesAInspect

Pause or reactivate one or more Meta campaigns, ad sets, or ads in batch (max 50). Use dry_run: true to preview what would change without making any modifications. Only set action to 'activate' when the user has explicitly requested to resume or reactivate.

Inputs: action (required), entity_ids (required), entity_type (required), ad_account_id (required), +1 more.

adsap_update_entityUpdate EntityAInspect

Edit an existing Meta campaign, ad set, or ad: change name, status (PAUSED/ACTIVE), budget, schedule, ad-set targeting, or ad-set spend limits (daily/lifetime min spend and cap, absolute cents or min/max_spend_percentage of the campaign daily budget on Advantage-campaign-budget campaigns; 0 removes a limit). Put ONLY the fields you want to change in updates. Use dry_run: true to preview the diff (current vs new) without applying anything. Budgets are in cents and apply to campaign (CBO) or ad set (ABO) only; targeting and spend limits apply to ad sets only.

Inputs: updates (required), entity_id (required), entity_type (required), ad_account_id (required), +1 more.

adsap_upload_creativeUpload CreativeAInspect

Upload image/video from Google Drive or Dropbox to a Meta ad account. Provide exactly one of drive_file_id / dropbox_path. Google Drive shows ADSAP only the files the user picked in the web app's Creative Upload page, so never pass an id taken from a Drive link. Set pair:true on each file of a suffix-named square/vertical set to auto-group them. Videos are async: check with adsap_get_upload_status when complete.

Inputs: ad_account_id (required), name, pair, type, +4 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      F
      maintenance
      Connects Google Ads, Meta Ads, and LinkedIn Ads to AI assistants, enabling natural language ad campaign management, reporting, and optimization across platforms.
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI assistants to create, analyze, and optimize ad campaigns across Google Ads, Meta Ads, TikTok Ads, LinkedIn Ads, Amazon Ads, and ChatGPT Ads through natural language using 400+ tools.
      107
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Adsroid MCP connects Claude, ChatGPT, Cursor, or any MCP-compatible client directly to your advertising and marketing accounts, Google Ads, Meta Ads, Microsoft Ads, TikTok Ads, LinkedIn Ads, Google Search Console, Google Analytics 4, and HubSpot, through a single endpoint.
      -
    Try in Browser

    Glama MCP Gateway

    Add one secure layer between your agents and this server.

    Resources