Tool reference
The Adsap AI copilot gives your assistant 91 tools for Meta and Google Ads. This page lists every tool as the server registers it, at server version 0.69.1. Each row shows the platform and whether the tool reads or writes. It also shows the plan that includes the tool, and whether a call consumes one of the workspace’s monthly tasks. Read tools never consume a task. 57 tools have their own page with parameters and example prompts. The rest are listed here only.
Names follow one pattern: adsap_ for Meta and workspace tools, adsap_google_ for Google Ads. Meta ad account IDs start with act_; Google Ads customer IDs are ten digits. A tool marked “Preview” accepts a preview call that validates the request without changing anything on the platform.
| Tool | Platform | Read or write | Plan | Task | Preview | Summary |
|---|---|---|---|---|---|---|
adsap_analyze_website | Meta | Read | All plans | No | No | Fetch and analyze a website URL to extract business context, tracking scripts (Meta Pixel, GTM, GA4, TikTok), product/pricing signals, value proposition… |
adsap_create_ad | Meta | Write | All plans | Yes | Yes | Create a Meta ad (image/video) in an ad set. |
adsap_create_ad_from_ig_post | Meta | Write | Early Access | Yes | Yes | Turn an existing Instagram post, video, or reel into an ad inside an EXISTING ad set: Meta Ads Manager’s “Use existing post”. |
adsap_create_ad_sets | Meta | Write | All plans | Yes | Yes | Create one or more Meta ad sets under an existing campaign. |
adsap_create_campaign | Meta | Write | All plans | Yes | Yes | Create Meta campaign. |
adsap_get_account_activities | Meta | Read | Early Access | No | No | Retrieve change log for a Meta ad account: budget changes, status toggles, ad creation/deletion, billing events, policy actions. |
adsap_get_account_health | Meta | Read | All plans | No | No | Full health check on a Meta ad account. |
adsap_get_account_summary | Meta | Read | All plans | No | No | Structural snapshot of a Meta ad account: campaign counts by status/objective, ad set counts, active ad count, budget allocation, top spending campaigns (last… |
adsap_get_ad_library_snapshot | Meta | Read | Early Access | No | No | Show what an Ad Library ad ACTUALLY LOOKS LIKE (creative, copy, page name), in a SELF-CONTAINED card. |
adsap_get_ad_preview | Meta | Read | All plans | No | No | 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). |
adsap_get_ad_review_status | Meta | Read | All plans | No | No | Check review and policy status of all active (optionally paused) ads in an account. |
adsap_get_ad_sheet_schema | Meta | Read | All plans | No | No | Retrieve column schema, constraints, and dependencies for an ad sheet: use it to read or explain a sheet’s structure. |
adsap_get_ad_status | Meta | Read | All plans | No | No | Check the current delivery, review, and effective status of a single Meta ad. |
adsap_get_catalog_data_sources | Meta | Read | Early Access | No | No | List all data sources connected to a Meta product catalog: product feeds, Batch API, partner integrations (Shopify/WooCommerce), smart pixel, website crawling… |
adsap_get_catalog_details | Meta | Read | Early Access | No | No | Get a Meta product catalog’s metadata: name, vertical, total product count, and owning business: live from Meta. |
adsap_get_catalog_diagnostics | Meta | Read | Early Access | No | No | Get data-quality diagnostics for a Meta product catalog: errors and warnings that can block products from ads (broken images, missing required fields, policy… |
adsap_get_creative_performance | Meta | Read | Early Access | No | No | Ranked creative performance analysis with fatigue detection. |
adsap_get_custom_audience_ads | Meta | Read | Early Access | No | No | List the ads that use/target a given custom audience (live from Meta): each with its ad set and campaign id. |
adsap_get_delivery_estimate | Meta | Read | All plans | No | No | Get Meta’s delivery estimate for a proposed audience and optimization configuration. |
adsap_get_import_status | Meta | Read | Early Access | No | No | Check progress of a Meta historical-asset import started with adsap_import_account_creatives: status, phase (images then videos), imported/skipped/failed… |
adsap_get_insights | Meta | Read | All plans | No | No | Retrieve aggregated spend and performance metrics for accounts, campaigns, ad sets, or ads over a date range. |
adsap_get_insights_breakdown | Meta | Read | Early Access | No | No | Live Meta API call: get spend and performance metrics sliced by demographic or placement dimensions (age, gender, platform, country). |
adsap_get_pixel_details | Meta | Read | Early Access | No | No | Get a Meta pixel’s configuration details (live from Meta): whether automatic advanced matching is enabled and which customer-info fields it matches on… |
adsap_get_pixel_health | Meta | Read | Early Access | No | No | 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… |
adsap_get_pixel_stats | Meta | Read | Early Access | No | No | Get event volume for a Meta pixel / dataset (live from Meta): how many of each event type (PageView, Purchase, Lead, CompleteRegistration, …) the pixel has… |
adsap_get_preview_clip | Meta | Read | All plans | No | No | Fetch the animated placement-preview clip (recorded video of the real Meta preview) for an ad+placement previously rendered with adsap_get_ad_preview. |
adsap_get_product_details | Meta | Read | Early Access | No | No | Fetch the full details of one catalog product by its numeric Meta product ID (FBID): live from Meta. |
adsap_get_product_set_products | Meta | Read | Early Access | No | No | List the products inside a Meta catalog product set (live from Meta). |
adsap_get_recommendations | Meta and Google Ads | Read | Early Access | No | No | Verified recommendations AND alerts computed by Adsap’s daily/weekly checks from the client’s own data. |
adsap_get_upload_status | Meta | Read | All plans | No | No | Check status of an async video upload. |
adsap_google_create_ad_group | Google Ads | Write | All plans | Yes | Yes | 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… |
adsap_google_create_app_campaign | Google Ads | Write | Early Access | Yes | Yes | Create a complete Google App campaign in ONE atomic request: budget, campaign (ALWAYS created PAUSED: activate later with adsap_google_set_entity_status)… |
adsap_google_create_demand_gen_campaign | Google Ads | Write | Early Access | Yes | Yes | Create a complete Google Ads Demand Gen campaign (YouTube, Discover, Gmail, Maps and the Google Display Network) in ONE atomic request: budget, campaign… |
adsap_google_create_display_campaign | Google Ads | Write | Early Access | Yes | Yes | Create a classic standalone Google Display campaign in ONE atomic request: budget, campaign (ALWAYS created PAUSED: activate later with… |
adsap_google_create_pmax_campaign | Google Ads | Write | Early Access | Yes | Yes | Create a complete Google Ads Performance Max campaign in ONE atomic request: budget, campaign (ALWAYS created PAUSED: activate later with… |
adsap_google_create_search_campaign | Google Ads | Write | All plans | Yes | Yes | Create a complete Google Ads Search campaign in ONE atomic request: budget, campaign (ALWAYS created PAUSED: activate later with… |
adsap_google_create_shopping_campaign | Google Ads | Write | Early Access | Yes | Yes | Create a complete standard Google Shopping campaign in ONE atomic request: budget, campaign (ALWAYS created PAUSED: activate later with… |
adsap_google_get_account_activities | Google Ads | Read | Early Access | No | No | Change history for a Google Ads account: who changed what, and when. |
adsap_google_get_conversion_breakdown | Google Ads | Read | Early Access | No | No | 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. |
adsap_google_get_insights | Google Ads | Read | All plans | No | No | Get Google Ads performance insights for an account, at campaign, ad-group, or keyword level (cache-first with auto-refresh from Google). |
adsap_google_keyword_ideas | Google Ads | Read | All plans | No | No | Get keyword suggestions with search volume from Google Keyword Planner for a Google Search campaign. |
adsap_google_list_ad_accounts | Google Ads | Read | All plans | No | No | List Google Ads accounts linked in this workspace. |
adsap_google_list_ad_templates | Google Ads | Read | Early Access | No | No | List saved Google campaign templates (wizard-saved setups per channel: budget, bidding, geo, languages, ad text, extensions, asset picks). |
adsap_google_list_audiences | Google Ads | Read | Early Access | No | No | List a Google Ads account’s audiences: both Audience resources (reusable segment+demographic combinations: these are the ids that… |
adsap_google_list_campaigns | Google Ads | Read | All plans | No | No | 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). |
adsap_google_list_conversion_actions | Google Ads | Read | All plans | No | No | List a Google Ads account’s conversion actions (name, type, category, status, primary-for-goal, counting type, origin). |
adsap_google_list_creative_assets | Google Ads | Read | Early Access | No | No | 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… |
adsap_google_list_extensions | Google Ads | Read | Early Access | No | No | List the extensions (sitelinks, callouts, structured snippets, call, promotion, price, image/AD_IMAGE) linked to Google Ads campaigns AND at account level… |
adsap_google_list_feed_labels | Google Ads | Read | Early Access | No | No | List the distinct Merchant Center feed labels visible to a Google Ads account (from the products synced via its Merchant Center link). |
adsap_google_manage_ad_template | Google Ads | Write | Early Access | No | Yes | Create, update, or delete a saved Google campaign template (the wizard-saved setups adsap_google_list_ad_templates reads: budget, bidding, geo, languages, ad… |
adsap_google_manage_extension | Google Ads | Write | Early Access | Yes | Yes | Manage Google Ads extensions (sitelinks, callouts, structured snippets, call, promotion, price) at CAMPAIGN level (default) or ACCOUNT level (level: ‘account’… |
adsap_google_manage_keywords | Google Ads | Write | All plans | Yes | Yes | Manage Google Ads Search keywords AFTER creation. |
adsap_google_manage_targeting | Google Ads | Write | Early Access | Yes | Yes | Manage a Google Ads campaign or ad group’s targeting AFTER creation: GEO, LANGUAGE and AUDIENCES. |
adsap_google_search_geo_targets | Google Ads | Read | All plans | No | No | Find Google Ads geo target constants by location name (city, region, country, postal area) for Search campaign location targeting. |
adsap_google_search_terms | Google Ads | Read | Early Access | No | No | 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. |
adsap_google_set_entity_status | Google Ads | Write | All plans | Yes | Yes | Pause or reactivate one or more Google Ads campaigns, ad groups, ads, or keywords (max 20 per call). |
adsap_google_update_entity | Google Ads | Write | All plans | Yes | Yes | 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… |
adsap_google_upload_asset | Google Ads | Write | Early Access | No | Yes | Create Google Ads assets (images from the Adsap creative library, text, YouTube videos) in one atomic request: the building blocks for… |
adsap_google_upload_video | Google Ads | Write | Early Access | No | Yes | 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. |
adsap_import_account_creatives | Meta | Write | Early Access | No | No | Import ALL historical creative assets (images + videos) that already exist in a Meta ad account into the Adsap Creative Library. |
adsap_list_ad_accounts | Meta | Read | All plans | No | No | List Meta ad accounts the user manages. |
adsap_list_ad_sets | Meta | Read | All plans | No | No | List ad sets for a campaign. |
adsap_list_ad_sheets | Meta | Read | All plans | No | No | List bulk ad creation sheets for an ad account. |
adsap_list_ad_templates | Meta | Read | Early Access | No | No | List saved ad templates. |
adsap_list_apps | Meta | Read | Early Access | No | No | 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. |
adsap_list_automation_rules | Meta | Read | Early Access | No | No | List the automation rules on one ad account, and optionally what they have done. |
adsap_list_campaigns | Meta | Read | All plans | No | No | List Meta campaigns in an ad account. |
adsap_list_catalogs | Meta | Read | Early Access | No | No | 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. |
adsap_list_creative_assets | Meta | Read | All plans | No | No | List uploaded Meta creative images and videos in the ad account asset library. |
adsap_list_custom_audiences | Meta | Read | Early Access | No | No | List custom audiences and saved audiences in a Meta ad account. |
adsap_list_custom_conversions | Meta | Read | Early Access | No | No | 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… |
adsap_list_drive_files | Meta | Read | Early Access | No | No | Browse Google Drive for creative image/video files to upload to Meta. |
adsap_list_dropbox_files | Meta | Read | Early Access | No | No | Browse Dropbox for creative image/video files to upload to Meta. |
adsap_list_experiments | Meta | Read | Early Access | No | No | List an ad account’s Meta experiments / ad studies (live from Meta): A/B split tests and conversion-lift studies, with type, status timestamps… |
adsap_list_ig_media | Meta | Read | Early Access | No | No | List an Instagram account’s recent media/posts (live from Meta): the posts, reels, and stories that can be promoted. |
adsap_list_meta_assets | Meta | Read | All plans | No | No | List Meta pages, Instagram accounts, pixels, or forms for ad creation. |
adsap_list_pixel_events | Meta | Read | Early Access | No | No | List conversion events for a Meta pixel for ad set optimization. |
adsap_manage_ad_template | Meta | Write | Early Access | No | Yes | Create, update, or delete a saved Meta ad template (copy, CTA, destination URL, page/Instagram identity, pixel, catalog refs, enhancement toggles, site links). |
adsap_manage_automation_rule | Meta | Write | Early Access | No | Yes | Create, change, switch on/off or delete an automation rule for one ad account. |
adsap_manage_custom_audience | Meta | Write | Early Access | Yes | Yes | Create, update, or delete a RULE-BASED custom audience: Website (pixel/site visitors), Engagement (Instagram/Facebook engagers), Lookalike (people similar to… |
adsap_manage_onboarding_plan | Meta | Write | All plans | No | No | Create, read, update, or delete a structured onboarding plan for a Meta ad account. |
adsap_ping | Meta and Google Ads | Read | All plans | No | No | Verify Adsap MCP server connectivity and API key. |
adsap_replace_ad_creative | Meta | Write | Early Access | Yes | Yes | DESTRUCTIVE. |
adsap_search_ad_library | Meta | Read | Early Access | No | No | Search Meta’s public Ad Library for ads (competitor research / ad transparency). |
adsap_search_behaviors | Meta | Read | All plans | No | No | Search Meta behavior targeting by keyword/category. |
adsap_search_catalog_products | Meta | Read | Early Access | No | No | Search or list the products in a Meta product catalog (live from Meta). |
adsap_search_geo_locations | Meta | Read | All plans | No | No | Search Meta city/region location keys for targeting. |
adsap_search_interests | Meta | Read | All plans | No | No | Search Meta interest targeting by keyword. |
adsap_set_entity_status | Meta | Write | All plans | Yes | Yes | Pause or reactivate one or more Meta campaigns, ad sets, or ads in batch (max 50). |
adsap_update_entity | Meta | Write | All plans | Yes | Yes | Edit an existing Meta campaign, ad set, or ad: change name, status (PAUSED/ACTIVE), budget, schedule, or ad-set targeting. |
adsap_upload_creative | Meta | Write | All plans | No | No | Upload image/video from Google Drive or Dropbox to a Meta ad account. |
Plans are described on the Pricing page. Setup lives in AI Copilot setup and prompts by job in AI Copilot usage.
Last updated on