# Tool reference

Every tool the Adsap AI copilot exposes to Claude, ChatGPT and Perplexity: 91 tools across Meta and Google Ads, with platform, plan and preview support.

Canonical: https://adsap.ai/docs/tools
Updated: 2026-09-13

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`](/tools/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`](/tools/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`](/tools/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`](/tools/adsap_create_ad_sets) | Meta | Write | All plans | Yes | Yes | Create one or more Meta ad sets under an existing campaign. |
| [`adsap_create_campaign`](/tools/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`](/tools/adsap_get_account_health) | Meta | Read | All plans | No | No | Full health check on a Meta ad account. |
| [`adsap_get_account_summary`](/tools/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`](/tools/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`](/tools/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`](/tools/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`](/tools/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`](/tools/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`](/tools/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`](/tools/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`](/tools/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`](/tools/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`](/tools/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`](/tools/adsap_get_upload_status) | Meta | Read | All plans | No | No | Check status of an async video upload. |
| [`adsap_google_create_ad_group`](/tools/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`](/tools/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`](/tools/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`](/tools/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`](/tools/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`](/tools/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`](/tools/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`](/tools/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`](/tools/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`](/tools/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`](/tools/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`](/tools/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`](/tools/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`](/tools/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`](/tools/adsap_google_manage_keywords) | Google Ads | Write | All plans | Yes | Yes | Manage Google Ads Search keywords AFTER creation. |
| [`adsap_google_manage_targeting`](/tools/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`](/tools/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`](/tools/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`](/tools/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`](/tools/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`](/tools/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`](/tools/adsap_list_ad_accounts) | Meta | Read | All plans | No | No | List Meta ad accounts the user manages. |
| [`adsap_list_ad_sets`](/tools/adsap_list_ad_sets) | Meta | Read | All plans | No | No | List ad sets for a campaign. |
| [`adsap_list_ad_sheets`](/tools/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`](/tools/adsap_list_campaigns) | Meta | Read | All plans | No | No | List Meta campaigns in an ad account. |
| [`adsap_list_catalogs`](/tools/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`](/tools/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`](/tools/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`](/tools/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`](/tools/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`](/tools/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`](/tools/adsap_ping) | Meta and Google Ads | Read | All plans | No | No | Verify Adsap MCP server connectivity and API key. |
| [`adsap_replace_ad_creative`](/tools/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`](/tools/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`](/tools/adsap_search_geo_locations) | Meta | Read | All plans | No | No | Search Meta city/region location keys for targeting. |
| [`adsap_search_interests`](/tools/adsap_search_interests) | Meta | Read | All plans | No | No | Search Meta interest targeting by keyword. |
| [`adsap_set_entity_status`](/tools/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`](/tools/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`](/tools/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](/pricing) page. Setup lives in [AI Copilot setup](/guides/ai-copilot/setup) and prompts by job in [AI Copilot usage](/guides/ai-copilot/usage).