Documentation menu

Tools Reference

AdsCove Product & Engineering · Last reviewed August 5, 2026

Browse the live AdsCove tool registry by platform, search for a task, and copy an example prompt or REST call. Read tools run immediately. Write tools are guarded: agents should preview first, then ask for confirmation before AdsCove creates a paused ad, draft product, or pending account change. Internal units are system safety signals, not the customer billing basis.

Runtime registry

262 guarded tools, generated from live code

Reads run immediately. Writes create previews or approval requests, and new ads and products start paused or as drafts.

Common25 tools

Account, approvals, business reports, and cross-platform workflows.

Create an AdsCove account, connect at least one platform, then add AdsCove to your AI client.

Shopify39 tools

Read orders and products, create drafts, install A/B tests, and update pages after approval.

Shopify is optional. Create a store-specific custom app from AdsCove Connections, authorize it, then link the store to matching ad accounts when you want revenue and MER context.

Meta Ads69 tools

Analyze campaigns, upload creatives, and create paused campaign/ad set/ad drafts.

Connect Meta Business Manager, activate the ad accounts to use, then choose the Page and Pixel before writes.

Google Ads129 tools

Analyze Search waste, create paused Search drafts, and apply negatives after approval.

Connect Google Ads, activate the customer account, and make sure billing and conversion tracking are ready.

Common (25)

list_connectionsreadinternal 0

List Connections

List platform connection status for the current user.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Runs immediately

Safety

No account changes

get_connection_healthreadinternal 0

Connection Health

Check token, scope, and platform health across connected accounts.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Runs immediately

Safety

No account changes

get_usage_statusreadinternal 0

Usage Status

Return current plan, binding usage, and internal protection status.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Runs immediately

Safety

No account changes

get_business_targetsreadinternal 0

Business Targets

Read the merchant-confirmed target ROAS, margin band, target CPA, and spend ceiling used by recommendations.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Runs immediately

Safety

No account changes

set_business_targetswrite gatedinternal 0

Set Business Targets

Save merchant-confirmed target ROAS, margin band, target CPA, or spend ceiling for recommendations.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

list_business_groupsreadinternal 0

Business Groups

List saved named Shopify + ad-account groups for reporting.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Runs immediately

Safety

No account changes

save_business_groupwrite gatedinternal 0

Save Business Group

Save a named group containing exactly one Shopify store and its Meta/Google accounts.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

delete_business_groupwrite gatedinternal 0

Delete Business Group

Delete a saved reporting business group.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

get_daily_business_reportreadinternal 1

Daily Business Report

Aggregate Shopify GMV, Meta spend, Google spend, and blended ROAS.

Best used when

Finding real spend, orders, ROAS, and campaign outliers.

Execution

Runs immediately

Safety

No account changes

get_campaign_performancereadinternal 1

Campaign Performance

Return cross-platform campaign performance in a shared schema.

Best used when

Finding real spend, orders, ROAS, and campaign outliers.

Execution

Runs immediately

Safety

No account changes

analyze_attribution_gapreadinternal 1

Attribution Gap

Compare platform ROAS against Shopify order attribution.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Runs immediately

Safety

No account changes

recommend_next_actionsreadinternal 1

Recommended Actions

Produce rule-based next actions without calling an LLM.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Runs immediately

Safety

No account changes

get_business_performance_insightsreadinternal 1

Business Performance Insights

One call returns the daily business report, cross-platform campaign performance, Google search-term diagnosis, and rule-based recommended actions. Use this FIRST for 'how are my accounts doing / what should I optimize' questions to avoid many separate round-trips.

Best used when

Finding real spend, orders, ROAS, and campaign outliers.

Execution

Runs immediately

Safety

No account changes

approve_actionwrite gatedinternal 0

Approve Pending Action

Execute a pending write after the user explicitly consents in conversation. Requires the execution_id returned by the pending action. NEVER call this without asking the user first.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

reject_actionwrite gatedinternal 0

Reject Pending Action

Reject a pending write on the user's behalf after they decline in conversation.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

create_ad_library_launch_batchwrite gatedinternal 1

Ad Library Launch Batch

Create Shopify draft products and paused Meta launch objects from structured ad-library records.

Best used when

Importing structured Ad Library records into draft products and paused ads.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

get_meta_help_articlereadinternal 0

Meta Help Lookup

Look up curated guidance and official Meta documentation links for an ads topic or Graph API error code. Free; works without a connected account.

Best used when

Auditing Meta campaigns or preparing paused creative tests.

Execution

Runs immediately

Safety

No account changes

list_adscove_capabilitiesreadinternal 0

List AdsCove Capabilities

List synced skill and workflow capabilities with mapped tools.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Runs immediately

Safety

No account changes

get_adscove_capabilityreadinternal 0

Get AdsCove Capability

Return one synced skill/workflow playbook.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Runs immediately

Safety

No account changes

plan_adscove_workflowreadinternal 1

Plan AdsCove Workflow

Map a natural-language goal to safe AdsCove tools and approval gates.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Runs immediately

Safety

No account changes

get_profit_reportreadinternal 1

Profit Report

Calculate Shopify revenue minus product cost and Meta/Google spend, accepting stored unit costs, a customer cost rate, or a customer gross margin.

Best used when

Finding real spend, orders, ROAS, and campaign outliers.

Execution

Runs immediately

Safety

No account changes

set_spend_guardrailwrite gatedinternal 1

Set Daily Budget Alert

Create or update a daily account/campaign budget for a saved Meta or Google account and alert when actual daily spend goes above it. Pause actions use R3 approval; notify-only uses R1.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

list_spend_guardrailsreadinternal 1

List Spend Guardrails

List active or triggered spend protection rules and dashboard notifications.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Runs immediately

Safety

No account changes

remove_spend_guardrailwrite gatedinternal 1

Remove Spend Guardrail

Disable an AdsCove spend guardrail and its native Meta automated rule when present.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

audit_tracking_urlsreadinternal 0

Audit Tracking URLs

Audit active Meta and Google ad URLs for missing or inconsistent UTMs, source mismatches, and unreachable landing pages.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Runs immediately

Safety

No account changes

Google Ads (129)

google_list_accessible_customersreadinternal 0

Google Accessible Customers

List accessible Google Ads customers.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Runs immediately

Safety

No account changes

google_list_campaignsreadinternal 1

Google Campaigns

List Google Ads campaigns.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Runs immediately

Safety

No account changes

google_list_ad_groupsreadinternal 1

Google Ad Groups

List Google Ads ad groups.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Runs immediately

Safety

No account changes

google_fetch_performancereadinternal 1

Google Performance

Fetch Google Ads performance.

Best used when

Finding real spend, orders, ROAS, and campaign outliers.

Execution

Runs immediately

Safety

No account changes

google_get_ad_performancereadinternal 1

Google Ad Performance

Pull ad-level performance with CTR, CPC, CPA, ROAS, ad type, and live status.

Best used when

Finding real spend, orders, ROAS, and campaign outliers.

Execution

Runs immediately

Safety

No account changes

google_analyze_wasted_spendreadinternal 1

Google Wasted Spend

Find search terms, keywords, or ads spending without enough conversions or ROAS.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Runs immediately

Safety

No account changes

google_search_terms_reportreadinternal 1

Google Search Terms

Fetch search terms report.

Best used when

Finding real spend, orders, ROAS, and campaign outliers.

Execution

Runs immediately

Safety

No account changes

google_analyze_search_termsreadinternal 1

Google Search Term Analysis

Summarize search-term waste, winners, and negative-keyword candidates.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Runs immediately

Safety

No account changes

google_explain_performance_anomalyreadinternal 1

Google Performance Anomaly

Compare recent Google Ads metrics against a prior baseline and explain likely causes.

Best used when

Finding real spend, orders, ROAS, and campaign outliers.

Execution

Runs immediately

Safety

No account changes

google_optimize_budget_allocationreadinternal 1

Google Budget Allocation Plan

Recommend budget shifts across campaigns from CPA/ROAS evidence without mutating budgets.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Runs immediately

Safety

No account changes

google_keyword_ideasreadinternal 1

Google Keyword Ideas

Generate keyword ideas.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Runs immediately

Safety

No account changes

google_research_keywordsreadinternal 1

Google Keyword Research

Alias-friendly keyword research with volume, competition, and bid estimates when Google returns them.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Runs immediately

Safety

No account changes

google_keyword_researchreadinternal 1

Google Keyword Research

Research keywords using Google Ads Keyword Planner. Expands seed keywords and returns search volume, competition, CPC and top-of-page bid ranges, historical trends, and related keyword ideas in one call. Does not create or modify campaigns. Every seed keyword is returned even when Google has no data for it, with an explicit status. Works without a connected Google Ads account. Prefer this over chaining google_keyword_ideas and google_keyword_historical_metrics.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Runs immediately

Safety

No account changes

google_keyword_historical_metricsreadinternal 1

Google Keyword Historical Metrics

Return exact avg monthly searches, 12-month search trend, competition, and top-of-page bid range for a keyword list. Growth plan.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Runs immediately

Safety

No account changes

google_forecast_keywordsreadinternal 1

Google Keyword Forecast

Forecast campaign-level impressions, clicks, cost, and conversions for a keyword list at a given CPC bid and daily budget. Growth plan.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Runs immediately

Safety

No account changes

google_plan_keyword_campaignreadinternal 1

Google Keyword Campaign Plan

Full-flow plan: keyword research + historical metrics + forecast, returning a ready-to-approve google_create_search_draft payload. Growth plan.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Runs immediately

Safety

No account changes

google_suggest_ad_contentreadinternal 0

Google Ad Content Suggestions

Generate Search/PMax/Display copy within Google Ads character limits from product and offer inputs.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Runs immediately

Safety

No account changes

google_get_ad_creativereadinternal 1

Google Ad Creative

Read existing Google ad creative composition, final URLs, text assets, and asset references.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Runs immediately

Safety

No account changes

google_discover_existing_assetsreadinternal 1

Google Asset Discovery

Browse reusable Google Ads image, text, YouTube video, sitelink, callout, and snippet assets.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Runs immediately

Safety

No account changes

google_validate_and_prepare_assetsreadinternal 1

Google Asset Validation

Validate copy, image asset references, and URL inputs before Search, PMax, or Display creation.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Runs immediately

Safety

No account changes

google_list_conversion_actionsreadinternal 1

Google Conversion Actions

List account conversion actions, tracking status, category, and inclusion settings.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Runs immediately

Safety

No account changes

google_get_conversion_tracking_configreadinternal 1

Google Conversion Tracking Config

Read account-level conversion tracking settings and detailed conversion-action configuration.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Runs immediately

Safety

No account changes

google_get_conversion_action_performancereadinternal 1

Google Conversion Action Performance

Break down conversions, value, CPA, and ROAS by conversion action.

Best used when

Finding real spend, orders, ROAS, and campaign outliers.

Execution

Runs immediately

Safety

No account changes

google_get_change_historyreadinternal 1

Google Change History

Read who changed what and when in Google Ads for the selected period.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Runs immediately

Safety

No account changes

google_get_shared_budgetsreadinternal 1

Google Shared Budgets

List campaign budgets, sharing state, reference counts, and delivery settings.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Runs immediately

Safety

No account changes

google_get_product_performancereadinternal 1

Google Product Performance

Return Shopping/PMax product spend, conversions, value, and ROAS by Merchant Center item.

Best used when

Finding real spend, orders, ROAS, and campaign outliers.

Execution

Runs immediately

Safety

No account changes

google_get_merchant_product_inventoryreadinternal 1

Linked Merchant Product Inventory

Auto-discover Merchant Center accounts linked to the selected Google Ads customer, scan every current shopping_product, filter by country/channel/status, aggregate unique item IDs by product_type L1-L5, and identify the category with the most SKUs using the existing Google Ads authorization. merchant_id is optional.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Runs immediately

Safety

No account changes

google_get_landing_page_performancereadinternal 1

Google Landing Page Performance

Return spend, clicks, conversions, value, and ROAS by final landing-page URL.

Best used when

Finding real spend, orders, ROAS, and campaign outliers.

Execution

Runs immediately

Safety

No account changes

google_list_brand_listsreadinternal 1

Google Brand Lists

List reusable Google Ads brand shared sets available for PMax brand exclusions.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Runs immediately

Safety

No account changes

google_suggest_brandsreadinternal 1

Google Brand Suggestions

Resolve a brand name prefix to Google's verified brand entity IDs.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Runs immediately

Safety

No account changes

google_get_campaign_targetingreadinternal 1

Google Campaign Targeting

Read campaign location, language, device, schedule, topic, and audience criteria.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Runs immediately

Safety

No account changes

google_build_search_planreadinternal 1

Google Search Plan

Build a search campaign plan.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Runs immediately

Safety

No account changes

google_build_display_planreadinternal 1

Google Display Plan

Build a basic paused Display/GDN draft plan without mutating Google Ads; detailed targeting is a manual follow-up.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Runs immediately

Safety

No account changes

google_create_search_draftwrite gatedinternal 1

Create Google Search Draft

Create a paused Google Search draft with the supported Search bidding strategies and AI Max enabled by default.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

google_create_standard_shopping_draftwrite gatedinternal 1

Create Standard Shopping Draft

Auto-discover a linked Merchant Center account and create an approval-gated, paused Standard Shopping campaign with sales country/feed label, location targets, Manual CPC/Maximize Clicks/Target ROAS bidding, Shopping AI Max, an Agent-friendly product_type/custom-label/item-ID filter, idempotency, audit, and post-write readback.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

google_create_pmax_asset_planreadinternal 1

Google PMax Asset Plan

Create a non-retail PMax asset plan without mutating Google Ads.

Best used when

Building PMax assets and paused campaigns after creative validation.

Execution

Runs immediately

Safety

No account changes

google_create_pmax_draftwrite gatedinternal 1

Create Google PMax Draft

Create a paused non-retail Performance Max campaign with Maximize Conversions/optional tCPA or Maximize Conversion Value/optional tROAS, plus Google-recommended asset automation enabled by default. Use payload.validate_with_google=true in dry_run for Google validate-only.

Best used when

Building PMax assets and paused campaigns after creative validation.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

google_create_display_draftwrite gatedinternal 1

Create Google Display Draft

Create a paused basic Display campaign with a responsive display ad and no detailed audience/topic/keyword/placement targeting. Use payload.validate_with_google=true in dry_run for Google validate-only.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

google_list_campaign_extensionsreadinternal 1

Google Campaign Assets

List sitelink, callout, and structured-snippet assets linked to a campaign.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Runs immediately

Safety

No account changes

google_add_sitelinkswrite gatedinternal 1

Add Google Sitelinks

Create and link sitelink assets to a campaign after approval.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

google_remove_sitelinkswrite gatedinternal 1

Remove Google Sitelinks

Remove matching sitelink campaign-asset links after approval.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

google_add_callout_extensionswrite gatedinternal 1

Add Google Callouts

Create and link callout assets to a campaign after approval.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

google_remove_calloutswrite gatedinternal 1

Remove Google Callouts

Remove matching callout campaign-asset links after approval.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

google_add_structured_snippetswrite gatedinternal 1

Add Google Structured Snippets

Create and link structured-snippet assets to a campaign after approval.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

google_remove_structured_snippetswrite gatedinternal 1

Remove Google Structured Snippets

Remove matching structured-snippet campaign-asset links after approval.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

google_add_search_campaign_imagewrite gatedinternal 1

Add Google Search Image Asset

Link uploaded image or logo assets to a Search campaign after approval.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

google_apply_negative_keywordswrite gatedinternal 1

Apply Negative Keywords

Apply negative keywords to a campaign or ad group.

Best used when

Cleaning wasted Google Search spend without touching winners.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

google_update_bid_strategywrite gatedinternal 1

Update Google Bid Strategy

Change a campaign standard bidding strategy after approval.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

google_update_budget_or_bidwrite gatedinternal 1

Update Google Budget or Bid

Change Google budget or bidding limits.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

google_update_statuswrite gatedinternal 1

Update Google Campaign Status

Change a Google campaign status.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

google_update_ad_group_statuswrite gatedinternal 1

Update Google Ad Group Status

Pause or enable a Google ad group after approval.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

google_create_ad_groupwrite gatedinternal 1

Create Google Ad Group

Create a paused ad group under an existing Google campaign.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

google_add_keywordswrite gatedinternal 1

Add Google Keywords

Add up to 500 paused positive keywords to an existing ad group.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

google_update_keywordwrite gatedinternal 1

Update Google Keyword

Update a positive keyword's status or CPC bid.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

google_remove_keywordswrite gatedinternal 1

Remove Google Keywords

Remove selected positive keywords from an existing ad group.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

google_update_keyword_statuswrite gatedinternal 1

Update Google Keyword Status

Pause, enable, or remove a Google keyword after approval.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

google_create_rsawrite gatedinternal 1

Create Google RSA

Create a paused responsive search ad in an existing ad group.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

google_update_rsawrite gatedinternal 1

Update Google RSA

Update the URLs, headlines, descriptions, or paths of an existing responsive search ad.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

google_update_ad_statuswrite gatedinternal 1

Update Google Ad Status

Pause, enable, or remove a Google ad after approval.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

google_apply_pmax_brand_exclusionwrite gatedinternal 1

Apply PMax Brand Exclusion

Attach an existing Google brand list as a negative campaign criterion.

Best used when

Building PMax assets and paused campaigns after creative validation.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

google_create_pmax_brand_exclusionwrite gatedinternal 1

Create PMax Brand Exclusion

Create a reusable brand list from verified Google brand IDs and optionally attach it to a PMax campaign.

Best used when

Building PMax assets and paused campaigns after creative validation.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

google_list_asset_groupsreadinternal 1

Google Asset Groups

List Performance Max asset groups with their final URLs, mobile URLs, display paths, status, and ad strength.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Runs immediately

Safety

No account changes

google_get_pmax_listing_groupsreadinternal 1

Google PMax Product Groups

Read the Performance Max product group (listing group filter) tree for an asset group, including which products are currently excluded.

Best used when

Building PMax assets and paused campaigns after creative validation.

Execution

Runs immediately

Safety

No account changes

google_update_asset_groupwrite gatedinternal 1

Update Google Asset Group

Change a Performance Max asset group's final URLs, final mobile URLs, name, display paths, or status.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

google_update_url_expansionwrite gatedinternal 1

Update Final URL Expansion

Turn Performance Max final URL expansion on or off for a campaign without resetting its other asset automation settings.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

google_update_pmax_listing_groupwrite gatedinternal 1

Update PMax Product Groups

Edit a Performance Max product group tree: exclude products, put excluded products back, or reset the asset group to a single all-products group.

Best used when

Building PMax assets and paused campaigns after creative validation.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

google_exclude_pmax_productswrite gatedinternal 1

Exclude PMax Products

Exclude Merchant Center item IDs (or brands, product types, custom labels, channels, conditions) from a Performance Max asset group.

Best used when

Building PMax assets and paused campaigns after creative validation.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

google_update_asset_group_assetswrite gatedinternal 1

Update Asset Group Assets

Add or remove headlines, long headlines, descriptions, images, logos, and YouTube videos on a live Performance Max asset group.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

google_search_geo_targetsreadinternal 1

Google Geo Target Search

Resolve location names such as California or Toronto into the geo target constant IDs the campaign and targeting tools require.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Runs immediately

Safety

No account changes

google_get_placement_performancereadinternal 1

Google Placement Performance

Return Display, Video, and PMax spend, clicks, conversions, and ROAS by placement, website, app, or YouTube channel.

Best used when

Finding real spend, orders, ROAS, and campaign outliers.

Execution

Runs immediately

Safety

No account changes

google_list_negative_keyword_listsreadinternal 1

Google Negative Keyword Lists

List reusable negative keyword shared sets with member and campaign reference counts.

Best used when

Cleaning wasted Google Search spend without touching winners.

Execution

Runs immediately

Safety

No account changes

google_update_campaign_targetingwrite gatedinternal 1

Update Google Campaign Targeting

Add or remove campaign locations, excluded locations, and languages, or replace the ad schedule.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

google_update_device_bid_adjustmentswrite gatedinternal 1

Update Device Bid Adjustments

Set mobile, desktop, tablet, or connected-TV bid modifiers on a campaign, updating the existing criterion when one is present.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

google_exclude_placementswrite gatedinternal 1

Exclude Google Placements

Exclude websites, mobile apps, YouTube channels, or YouTube videos from a campaign as negative criteria.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

google_create_negative_keyword_listwrite gatedinternal 1

Create Negative Keyword List

Create a reusable negative keyword shared set and optionally attach it to a campaign.

Best used when

Cleaning wasted Google Search spend without touching winners.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

google_apply_negative_keyword_listwrite gatedinternal 1

Apply Negative Keyword List

Attach an existing negative keyword shared set to a campaign.

Best used when

Cleaning wasted Google Search spend without touching winners.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

google_update_conversion_actionwrite gatedinternal 1

Update Conversion Action

Change a conversion action's status, name, counting type, lookback windows, or whether it counts as a primary conversion for bidding.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

google_update_tracking_urlswrite gatedinternal 1

Update Google Tracking URLs

Set or clear the tracking template and final URL suffix on a campaign or ad group.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

get_ad_performancereadinternal 1

Google Ad Performance

Alias for google_get_ad_performance.

Best used when

Finding real spend, orders, ROAS, and campaign outliers.

Execution

Runs immediately

Safety

No account changes

analyze_wasted_spendreadinternal 1

Google Wasted Spend

Alias for google_analyze_wasted_spend.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Runs immediately

Safety

No account changes

analyze_search_termsreadinternal 1

Google Search Term Analysis

Alias for google_analyze_search_terms.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Runs immediately

Safety

No account changes

explain_performance_anomalyreadinternal 1

Google Performance Anomaly

Alias for google_explain_performance_anomaly.

Best used when

Finding real spend, orders, ROAS, and campaign outliers.

Execution

Runs immediately

Safety

No account changes

optimize_budget_allocationreadinternal 1

Google Budget Allocation Plan

Alias for google_optimize_budget_allocation.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Runs immediately

Safety

No account changes

research_keywordsreadinternal 1

Google Keyword Research

Alias for google_research_keywords.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Runs immediately

Safety

No account changes

keyword_researchreadinternal 1

Google Keyword Research

Alias for google_keyword_research.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Runs immediately

Safety

No account changes

keyword_historical_metricsreadinternal 1

Google Keyword Historical Metrics

Alias for google_keyword_historical_metrics.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Runs immediately

Safety

No account changes

forecast_keywordsreadinternal 1

Google Keyword Forecast

Alias for google_forecast_keywords.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Runs immediately

Safety

No account changes

plan_keyword_campaignreadinternal 1

Google Keyword Campaign Plan

Alias for google_plan_keyword_campaign.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Runs immediately

Safety

No account changes

suggest_ad_contentreadinternal 0

Google Ad Content Suggestions

Alias for google_suggest_ad_content.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Runs immediately

Safety

No account changes

get_ad_creativereadinternal 1

Google Ad Creative

Alias for google_get_ad_creative.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Runs immediately

Safety

No account changes

discover_existing_assetsreadinternal 1

Google Asset Discovery

Alias for google_discover_existing_assets.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Runs immediately

Safety

No account changes

validate_and_prepare_assetsreadinternal 1

Google Asset Validation

Alias for google_validate_and_prepare_assets.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Runs immediately

Safety

No account changes

create_search_campaignwrite gatedinternal 1

Create Google Search Campaign

Alias for google_create_search_draft.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

create_pmax_campaignwrite gatedinternal 1

Create Google PMax Campaign

Alias for the paused non-retail google_create_pmax_draft workflow.

Best used when

Building PMax assets and paused campaigns after creative validation.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

update_campaign_budgetwrite gatedinternal 1

Update Campaign Budget

Alias for google_update_budget_or_bid.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

pause_campaignwrite gatedinternal 1

Pause Google Campaign

Alias for google_update_status with PAUSED.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

resume_campaignwrite gatedinternal 1

Resume Google Campaign

Alias for google_update_status with ACTIVE.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

pause_ad_groupwrite gatedinternal 1

Pause Google Ad Group

Alias for google_update_ad_group_status with PAUSED.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

resume_ad_groupwrite gatedinternal 1

Resume Google Ad Group

Alias for google_update_ad_group_status with ACTIVE.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

add_negative_keywordswrite gatedinternal 1

Add Negative Keywords

Alias for google_apply_negative_keywords.

Best used when

Cleaning wasted Google Search spend without touching winners.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

update_bid_strategywrite gatedinternal 1

Update Bid Strategy

Alias for google_update_bid_strategy.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

add_sitelinkswrite gatedinternal 1

Add Sitelinks

Alias for google_add_sitelinks.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

remove_sitelinkswrite gatedinternal 1

Remove Sitelinks

Alias for google_remove_sitelinks.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

add_callout_extensionswrite gatedinternal 1

Add Callouts

Alias for google_add_callout_extensions.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

remove_calloutswrite gatedinternal 1

Remove Callouts

Alias for google_remove_callouts.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

add_structured_snippetswrite gatedinternal 1

Add Structured Snippets

Alias for google_add_structured_snippets.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

remove_structured_snippetswrite gatedinternal 1

Remove Structured Snippets

Alias for google_remove_structured_snippets.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

list_campaign_extensionsreadinternal 1

Google Campaign Assets

Alias for google_list_campaign_extensions.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Runs immediately

Safety

No account changes

add_search_campaign_imagewrite gatedinternal 1

Add Search Campaign Image

Alias for google_add_search_campaign_image.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

get_campaign_targetingreadinternal 1

Google Campaign Targeting

Alias for google_get_campaign_targeting.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Runs immediately

Safety

No account changes

list_conversion_actionsreadinternal 1

Google Conversion Actions

Alias for google_list_conversion_actions.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Runs immediately

Safety

No account changes

get_conversion_action_performancereadinternal 1

Google Conversion Action Performance

Alias for google_get_conversion_action_performance.

Best used when

Finding real spend, orders, ROAS, and campaign outliers.

Execution

Runs immediately

Safety

No account changes

list_asset_groupsreadinternal 1

Google Asset Groups

Alias for google_list_asset_groups.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Runs immediately

Safety

No account changes

get_pmax_listing_groupsreadinternal 1

Google PMax Product Groups

Alias for google_get_pmax_listing_groups.

Best used when

Building PMax assets and paused campaigns after creative validation.

Execution

Runs immediately

Safety

No account changes

update_asset_groupwrite gatedinternal 1

Update Google Asset Group

Alias for google_update_asset_group.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

update_url_expansionwrite gatedinternal 1

Update Final URL Expansion

Alias for google_update_url_expansion.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

update_pmax_listing_groupwrite gatedinternal 1

Update PMax Product Groups

Alias for google_update_pmax_listing_group.

Best used when

Building PMax assets and paused campaigns after creative validation.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

exclude_pmax_productswrite gatedinternal 1

Exclude PMax Products

Alias for google_exclude_pmax_products.

Best used when

Building PMax assets and paused campaigns after creative validation.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

update_asset_group_assetswrite gatedinternal 1

Update Asset Group Assets

Alias for google_update_asset_group_assets.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

search_geo_targetsreadinternal 1

Google Geo Target Search

Alias for google_search_geo_targets.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Runs immediately

Safety

No account changes

get_placement_performancereadinternal 1

Google Placement Performance

Alias for google_get_placement_performance.

Best used when

Finding real spend, orders, ROAS, and campaign outliers.

Execution

Runs immediately

Safety

No account changes

list_negative_keyword_listsreadinternal 1

Google Negative Keyword Lists

Alias for google_list_negative_keyword_lists.

Best used when

Cleaning wasted Google Search spend without touching winners.

Execution

Runs immediately

Safety

No account changes

update_campaign_targetingwrite gatedinternal 1

Update Google Campaign Targeting

Alias for google_update_campaign_targeting.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

update_device_bid_adjustmentswrite gatedinternal 1

Update Device Bid Adjustments

Alias for google_update_device_bid_adjustments.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

exclude_placementswrite gatedinternal 1

Exclude Google Placements

Alias for google_exclude_placements.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

create_negative_keyword_listwrite gatedinternal 1

Create Negative Keyword List

Alias for google_create_negative_keyword_list.

Best used when

Cleaning wasted Google Search spend without touching winners.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

apply_negative_keyword_listwrite gatedinternal 1

Apply Negative Keyword List

Alias for google_apply_negative_keyword_list.

Best used when

Cleaning wasted Google Search spend without touching winners.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

update_conversion_actionwrite gatedinternal 1

Update Conversion Action

Alias for google_update_conversion_action.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

update_tracking_urlswrite gatedinternal 1

Update Google Tracking URLs

Alias for google_update_tracking_urls.

Best used when

Mapping a natural-language agent request to a guarded AdsCove operation.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

Meta Ads (69)

meta_list_campaignsreadinternal 1

Meta Campaigns

List Meta campaigns.

Best used when

Auditing Meta campaigns or preparing paused creative tests.

Execution

Runs immediately

Safety

No account changes

meta_list_adsetsreadinternal 1

Meta Ad Sets

List Meta ad sets.

Best used when

Auditing Meta campaigns or preparing paused creative tests.

Execution

Runs immediately

Safety

No account changes

meta_list_adsreadinternal 1

Meta Ads

List Meta ads.

Best used when

Auditing Meta campaigns or preparing paused creative tests.

Execution

Runs immediately

Safety

No account changes

meta_fetch_insightsreadinternal 1

Meta Insights

Fetch Meta Ads insights.

Best used when

Auditing Meta campaigns or preparing paused creative tests.

Execution

Runs immediately

Safety

No account changes

meta_get_campaign_performancereadinternal 1

Meta Campaign Performance

Pull campaign-level Meta metrics with conversion, CPA, and ROAS helpers.

Best used when

Finding real spend, orders, ROAS, and campaign outliers.

Execution

Runs immediately

Safety

No account changes

meta_get_adset_performancereadinternal 1

Meta Ad Set Performance

Pull ad-set performance within a campaign or account.

Best used when

Finding real spend, orders, ROAS, and campaign outliers.

Execution

Runs immediately

Safety

No account changes

meta_get_ad_performancereadinternal 1

Meta Ad Performance

Pull ad-level Meta metrics with spend, CTR, CPA, ROAS, and live status.

Best used when

Finding real spend, orders, ROAS, and campaign outliers.

Execution

Runs immediately

Safety

No account changes

meta_analyze_ad_performancereadinternal 1

Meta Ad Performance Analysis

Analyze ad-level spend, CTR, CPA, ROAS, and conversion action mix.

Best used when

Finding real spend, orders, ROAS, and campaign outliers.

Execution

Runs immediately

Safety

No account changes

meta_get_audience_insightsreadinternal 1

Meta Audience Insights

Break Meta performance down by age, gender, country, or placement.

Best used when

Auditing Meta campaigns or preparing paused creative tests.

Execution

Runs immediately

Safety

No account changes

meta_analyze_audiencesreadinternal 1

Meta Audience Analysis

Rank audience segments and surface weak/high-ROAS demographic pockets.

Best used when

Auditing Meta campaigns or preparing paused creative tests.

Execution

Runs immediately

Safety

No account changes

meta_analyze_wasted_spendreadinternal 1

Meta Wasted Spend

Find Meta campaigns, ad sets, or ads spending without enough conversions or ROAS.

Best used when

Auditing Meta campaigns or preparing paused creative tests.

Execution

Runs immediately

Safety

No account changes

meta_detect_creative_fatiguereadinternal 1

Meta Creative Fatigue

Detect ads with declining CTR/CVR over daily trend data.

Best used when

Auditing Meta campaigns or preparing paused creative tests.

Execution

Runs immediately

Safety

No account changes

meta_explain_anomalyreadinternal 1

Meta Performance Anomaly

Explain recent CPA, CTR, spend, or conversion spikes against the previous period.

Best used when

Auditing Meta campaigns or preparing paused creative tests.

Execution

Runs immediately

Safety

No account changes

meta_get_ad_creativesreadinternal 1

Meta Ad Creatives

Return ad creative composition, thumbnails, story IDs, image URLs, and asset feed specs.

Best used when

Auditing Meta campaigns or preparing paused creative tests.

Execution

Runs immediately

Safety

No account changes

meta_search_interestsreadinternal 1

Meta Interests

Search Meta targeting interests.

Best used when

Auditing Meta campaigns or preparing paused creative tests.

Execution

Runs immediately

Safety

No account changes

meta_search_targetingreadinternal 1

Meta Targeting Search

Search Meta targeting interests, demographics, and behaviors by keyword.

Best used when

Auditing Meta campaigns or preparing paused creative tests.

Execution

Runs immediately

Safety

No account changes

meta_browse_targetingreadinternal 1

Meta Targeting Browse

Browse Meta targeting categories such as interests, behaviors, and demographics.

Best used when

Auditing Meta campaigns or preparing paused creative tests.

Execution

Runs immediately

Safety

No account changes

meta_list_custom_audiencesreadinternal 1

Meta Custom Audiences

List existing custom, lookalike, website, and engagement audiences.

Best used when

Auditing Meta campaigns or preparing paused creative tests.

Execution

Runs immediately

Safety

No account changes

meta_create_custom_audiencewrite gatedinternal 1

Create Meta Website Audience

Create a website-behavior custom audience from a Pixel using all-visitors, URL-contains, event, or raw rule input.

Best used when

Auditing Meta campaigns or preparing paused creative tests.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

meta_create_lookalikewrite gatedinternal 1

Create Meta Lookalike

Create a 1%-20% lookalike from an existing origin audience. Use meta_list_custom_audiences first to select the origin.

Best used when

Auditing Meta campaigns or preparing paused creative tests.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

meta_list_pages_and_pixelsreadinternal 1

Meta Pages and Pixels

List available Pages and Pixels.

Best used when

Auditing Meta campaigns or preparing paused creative tests.

Execution

Runs immediately

Safety

No account changes

meta_list_pixelsreadinternal 1

Meta Pixels

List Meta Pixels configured for the connected ad account.

Best used when

Auditing Meta campaigns or preparing paused creative tests.

Execution

Runs immediately

Safety

No account changes

meta_list_instagram_accountsreadinternal 1

Meta Instagram Accounts

List Instagram accounts connected to the Meta ad account.

Best used when

Auditing Meta campaigns or preparing paused creative tests.

Execution

Runs immediately

Safety

No account changes

meta_discover_assetsreadinternal 1

Meta Asset Discovery

Discover images, videos, and ad creatives already available in the ad account.

Best used when

Auditing Meta campaigns or preparing paused creative tests.

Execution

Runs immediately

Safety

No account changes

meta_validate_assetsreadinternal 1

Meta Asset Validation

Validate image, video, and carousel asset inputs before creating Meta campaigns.

Best used when

Auditing Meta campaigns or preparing paused creative tests.

Execution

Runs immediately

Safety

No account changes

meta_select_campaign_typereadinternal 0

Meta Campaign Type Selector

Choose image, video, carousel, or DCO flow based on supplied creative inputs.

Best used when

Auditing Meta campaigns or preparing paused creative tests.

Execution

Runs immediately

Safety

No account changes

meta_get_campaign_detailsreadinternal 1

Meta Campaign Details

Read detailed campaign settings, budgets, status, and objective.

Best used when

Auditing Meta campaigns or preparing paused creative tests.

Execution

Runs immediately

Safety

No account changes

meta_get_campaign_targetingreadinternal 1

Meta Campaign Targeting

Read ad-set targeting under a campaign, including geo, audiences, placements, and promoted objects.

Best used when

Auditing Meta campaigns or preparing paused creative tests.

Execution

Runs immediately

Safety

No account changes

meta_list_automated_rulesreadinternal 1

Meta Automated Rules

List native Meta automated ad rules for the connected ad account.

Best used when

Auditing Meta campaigns or preparing paused creative tests.

Execution

Runs immediately

Safety

No account changes

meta_build_launch_planreadinternal 1

Meta Launch Plan

Build a structured launch plan from provided inputs.

Best used when

Auditing Meta campaigns or preparing paused creative tests.

Execution

Runs immediately

Safety

No account changes

get_meta_campaign_performancereadinternal 1

Meta Campaign Performance

Alias for meta_get_campaign_performance.

Best used when

Finding real spend, orders, ROAS, and campaign outliers.

Execution

Runs immediately

Safety

No account changes

get_meta_adset_performancereadinternal 1

Meta Ad Set Performance

Alias for meta_get_adset_performance.

Best used when

Finding real spend, orders, ROAS, and campaign outliers.

Execution

Runs immediately

Safety

No account changes

analyze_meta_ad_performancereadinternal 1

Meta Ad Performance Analysis

Alias for meta_analyze_ad_performance.

Best used when

Finding real spend, orders, ROAS, and campaign outliers.

Execution

Runs immediately

Safety

No account changes

search_meta_targetingreadinternal 1

Meta Targeting Search

Alias for meta_search_targeting.

Best used when

Auditing Meta campaigns or preparing paused creative tests.

Execution

Runs immediately

Safety

No account changes

list_meta_campaignsreadinternal 1

Meta Campaigns

Alias for meta_list_campaigns.

Best used when

Auditing Meta campaigns or preparing paused creative tests.

Execution

Runs immediately

Safety

No account changes

list_meta_ad_setsreadinternal 1

Meta Ad Sets

Alias for meta_list_adsets.

Best used when

Auditing Meta campaigns or preparing paused creative tests.

Execution

Runs immediately

Safety

No account changes

list_meta_adsreadinternal 1

Meta Ads

Alias for meta_list_ads.

Best used when

Auditing Meta campaigns or preparing paused creative tests.

Execution

Runs immediately

Safety

No account changes

meta_upload_creativewrite gatedinternal 1

Upload Meta Creative

Upload a creative asset for later use.

Best used when

Auditing Meta campaigns or preparing paused creative tests.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

meta_upload_videowrite gatedinternal 1

Upload Meta Video

Upload a video URL or an AdsCove R2 object to the Meta video library.

Best used when

Auditing Meta campaigns or preparing paused creative tests.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

meta_get_video_statusreadinternal 0

Get Meta Video Status

Check Meta video processing status before creating an ad.

Best used when

Auditing Meta campaigns or preparing paused creative tests.

Execution

Runs immediately

Safety

No account changes

meta_create_paused_campaignwrite gatedinternal 1

Create Paused Meta Campaign

Create a paused Meta campaign draft.

Best used when

Auditing Meta campaigns or preparing paused creative tests.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

meta_create_paused_adsetwrite gatedinternal 1

Create Paused Meta Ad Set

Create a paused Meta ad set under an existing campaign.

Best used when

Auditing Meta campaigns or preparing paused creative tests.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

meta_create_paused_adwrite gatedinternal 1

Create Paused Meta Ad

Create a paused Meta ad, creating the creative first when needed.

Best used when

Auditing Meta campaigns or preparing paused creative tests.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

meta_clone_existing_post_adswrite gatedinternal 1

Clone Existing Post Ads

Clone ads from an existing post into paused ads.

Best used when

Auditing Meta campaigns or preparing paused creative tests.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

meta_duplicate_entitywrite gatedinternal 1

Duplicate Meta Entity

Deep-copy a Meta campaign, ad set, or ad into PAUSED status. Supports rename options and optional destination campaign/ad set overrides.

Best used when

Auditing Meta campaigns or preparing paused creative tests.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

meta_bulk_update_statuswrite gatedinternal 1

Bulk Update Meta Status

Serially update 1-50 Meta campaigns, ad sets, or ads to ACTIVE, PAUSED, or ARCHIVED; individual failures do not stop the batch.

Best used when

Auditing Meta campaigns or preparing paused creative tests.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

meta_create_test_matrixwrite gatedinternal 1

Create Meta Test Matrix

Create up to 5 paused ad sets × 6 paused creatives (30 paused ads maximum) under an existing or new paused campaign.

Best used when

Auditing Meta campaigns or preparing paused creative tests.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

meta_create_automated_rulewrite gatedinternal 1

Create Meta Automated Rule

Create a native Meta automated rule for stop-loss, notification, or budget scaling.

Best used when

Auditing Meta campaigns or preparing paused creative tests.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

meta_update_automated_rulewrite gatedinternal 1

Update Meta Automated Rule

Update a native Meta automated rule's status, schedule, conditions, or action.

Best used when

Auditing Meta campaigns or preparing paused creative tests.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

meta_disable_automated_rulewrite gatedinternal 1

Disable Meta Automated Rule

Disable a native Meta automated rule without deleting it.

Best used when

Auditing Meta campaigns or preparing paused creative tests.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

meta_update_statuswrite gatedinternal 1

Update Meta Status

Change Meta campaign, ad set, or ad status.

Best used when

Auditing Meta campaigns or preparing paused creative tests.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

meta_update_budgetwrite gatedinternal 1

Update Meta Budget

Change Meta campaign or ad set budget.

Best used when

Auditing Meta campaigns or preparing paused creative tests.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

meta_upload_offline_conversionswrite gatedinternal 1

Upload Meta Offline Conversions

Upload up to 500 CRM, phone, or store conversions to a Meta Pixel/dataset. Email and phone values are normalized and SHA-256 hashed only in memory; dry-run returns a redacted coverage summary.

Best used when

Auditing Meta campaigns or preparing paused creative tests.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

meta_update_entitywrite gatedinternal 1

Update Meta Entity

General update for a campaign, ad set, or ad: name, status, schedule, bid strategy, targeting, or budget in one call.

Best used when

Auditing Meta campaigns or preparing paused creative tests.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

meta_get_dataset_qualityreadinternal 1

Meta Dataset Quality

Read EMQ (event match quality) score, match-key feedback, event coverage, dedup, and freshness for a Pixel/dataset.

Best used when

Auditing Meta campaigns or preparing paused creative tests.

Execution

Runs immediately

Safety

No account changes

meta_get_dataset_statsreadinternal 1

Meta Dataset Stats

Read Pixel/dataset event statistics with an aggregation such as event_total_counts, event_source, or match_keys.

Best used when

Auditing Meta campaigns or preparing paused creative tests.

Execution

Runs immediately

Safety

No account changes

meta_get_dataset_errorsreadinternal 1

Meta Dataset Errors

Surface Pixel/CAPI event processing problems and match-quality diagnostics for a dataset.

Best used when

Auditing Meta campaigns or preparing paused creative tests.

Execution

Runs immediately

Safety

No account changes

meta_list_catalogsreadinternal 1

Meta Catalogs

List product catalogs owned by the connected Business.

Best used when

Auditing Meta campaigns or preparing paused creative tests.

Execution

Runs immediately

Safety

No account changes

meta_get_catalog_detailsreadinternal 1

Meta Catalog Details

Read one product catalog's name, vertical, and product count.

Best used when

Auditing Meta campaigns or preparing paused creative tests.

Execution

Runs immediately

Safety

No account changes

meta_get_catalog_diagnosticsreadinternal 1

Meta Catalog Diagnostics

List catalog errors and warnings that block products from ads.

Best used when

Auditing Meta campaigns or preparing paused creative tests.

Execution

Runs immediately

Safety

No account changes

meta_list_catalog_productsreadinternal 1

Meta Catalog Products

List products in a catalog with price, availability, visibility, and review status.

Best used when

Auditing Meta campaigns or preparing paused creative tests.

Execution

Runs immediately

Safety

No account changes

meta_get_product_detailsreadinternal 1

Meta Product Details

Read one catalog product's full details including review status.

Best used when

Auditing Meta campaigns or preparing paused creative tests.

Execution

Runs immediately

Safety

No account changes

meta_list_product_setsreadinternal 1

Meta Product Sets

List product sets in a catalog with product counts and filters.

Best used when

Auditing Meta campaigns or preparing paused creative tests.

Execution

Runs immediately

Safety

No account changes

meta_get_product_set_productsreadinternal 1

Meta Product Set Products

List the products inside a product set.

Best used when

Auditing Meta campaigns or preparing paused creative tests.

Execution

Runs immediately

Safety

No account changes

meta_list_product_feedsreadinternal 1

Meta Product Feeds

List catalog data feeds with schedule and latest upload.

Best used when

Auditing Meta campaigns or preparing paused creative tests.

Execution

Runs immediately

Safety

No account changes

meta_get_product_feed_detailsreadinternal 1

Meta Product Feed Details

Read one data feed's schedule, recent uploads, and latest upload errors.

Best used when

Auditing Meta campaigns or preparing paused creative tests.

Execution

Runs immediately

Safety

No account changes

meta_list_ab_testsreadinternal 1

Meta A/B Tests

List Meta ad studies (split tests) for the connected Business.

Best used when

Auditing Meta campaigns or preparing paused creative tests.

Execution

Runs immediately

Safety

No account changes

meta_create_ab_testwrite gatedinternal 1

Create Meta A/B Test

Create a Meta split test (ad study) with named cells over existing campaigns or ad sets.

Best used when

Auditing Meta campaigns or preparing paused creative tests.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

meta_get_activity_logreadinternal 1

Meta Activity Log

Read the ad account change history (who changed what, when) mirroring Ads Manager activity.

Best used when

Auditing Meta campaigns or preparing paused creative tests.

Execution

Runs immediately

Safety

No account changes

Shopify (39)

shopify_get_store_inforeadinternal 0

Shopify Store Info

Get Shopify store metadata.

Best used when

Connecting store data, product pages, landing pages, or A/B tests.

Execution

Runs immediately

Safety

No account changes

shopify_list_productsreadinternal 1

Shopify Products

List Shopify products.

Best used when

Connecting store data, product pages, landing pages, or A/B tests.

Execution

Runs immediately

Safety

No account changes

shopify_get_product_contextreadinternal 1

Shopify Product Context

Fetch product, variant, media, and inventory context.

Best used when

Connecting store data, product pages, landing pages, or A/B tests.

Execution

Runs immediately

Safety

No account changes

shopify_list_ordersreadinternal 1

Shopify Orders

List Shopify orders.

Best used when

Connecting store data, product pages, landing pages, or A/B tests.

Execution

Runs immediately

Safety

No account changes

shopify_get_analyticsreadinternal 1

Shopify Analytics

Calculate orders, gross sales, AOV, daily trends, and UTM source/medium/campaign attribution from order data.

Best used when

Connecting store data, product pages, landing pages, or A/B tests.

Execution

Runs immediately

Safety

No account changes

shopify_list_collectionsreadinternal 1

Shopify Collections

List Shopify collections.

Best used when

Connecting store data, product pages, landing pages, or A/B tests.

Execution

Runs immediately

Safety

No account changes

shopify_create_collectionwrite gatedinternal 1

Create Shopify Collection

Create a manual or rule-based Shopify collection.

Best used when

Connecting store data, product pages, landing pages, or A/B tests.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

shopify_update_collectionwrite gatedinternal 1

Update Shopify Collection

Update a Shopify collection's title, description, SEO, template, or rules.

Best used when

Connecting store data, product pages, landing pages, or A/B tests.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

shopify_update_collection_productswrite gatedinternal 1

Update Collection Products

Add or remove products from a manual Shopify collection.

Best used when

Connecting store data, product pages, landing pages, or A/B tests.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

shopify_list_pagesreadinternal 1

Shopify Pages

List Shopify pages.

Best used when

Connecting store data, product pages, landing pages, or A/B tests.

Execution

Runs immediately

Safety

No account changes

shopify_get_pagereadinternal 1

Get Shopify Page

Read a complete Shopify page, including its HTML/Liquid body.

Best used when

Connecting store data, product pages, landing pages, or A/B tests.

Execution

Runs immediately

Safety

No account changes

shopify_create_page_draftwrite gatedinternal 1

Create Shopify Page Draft

Create an unpublished Shopify page draft.

Best used when

Connecting store data, product pages, landing pages, or A/B tests.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

shopify_create_pagewrite gatedinternal 1

Create Shopify Page

Compatibility alias for shopify_create_page_draft. Always creates an unpublished Shopify page.

Best used when

Connecting store data, product pages, landing pages, or A/B tests.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

shopify_delete_pagewrite gatedinternal 1

Delete Shopify Page

Delete a Shopify page after approval and return its before snapshot.

Best used when

Connecting store data, product pages, landing pages, or A/B tests.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

shopify_create_product_draftwrite gatedinternal 1

Create Product Draft

Create a Shopify product as a draft with optional media.

Best used when

Connecting store data, product pages, landing pages, or A/B tests.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

shopify_publish_productwrite gatedinternal 1

Publish Product

Publish a Shopify product to the online store.

Best used when

Connecting store data, product pages, landing pages, or A/B tests.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

shopify_list_blogsreadinternal 1

Shopify Blogs

List Shopify blogs for article publishing.

Best used when

Connecting store data, product pages, landing pages, or A/B tests.

Execution

Runs immediately

Safety

No account changes

shopify_create_blog_articlewrite gatedinternal 1

Create Blog Article

Create a Shopify blog article as draft or published content.

Best used when

Connecting store data, product pages, landing pages, or A/B tests.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

shopify_list_themesreadinternal 1

Shopify Themes

List Shopify online store themes.

Best used when

Connecting store data, product pages, landing pages, or A/B tests.

Execution

Runs immediately

Safety

No account changes

shopify_get_theme_assetreadinternal 1

Get Theme Asset

Read a Shopify theme section, template, snippet, or asset.

Best used when

Connecting store data, product pages, landing pages, or A/B tests.

Execution

Runs immediately

Safety

No account changes

shopify_build_landing_page_planreadinternal 1

Landing Page Plan

Build a reusable Shopify landing page draft plan.

Best used when

Connecting store data, product pages, landing pages, or A/B tests.

Execution

Runs immediately

Safety

No account changes

shopify_build_abtest_planreadinternal 1

A/B Test Plan

Build a Shopify landing page A/B test and tracking plan.

Best used when

Connecting store data, product pages, landing pages, or A/B tests.

Execution

Runs immediately

Safety

No account changes

shopify_get_abtest_webhook_readinessreadinternal 1

A/B Webhook Readiness

Verify Shopify order and refund webhook coverage for server-side experiment attribution.

Best used when

Connecting store data, product pages, landing pages, or A/B tests.

Execution

Runs immediately

Safety

No account changes

shopify_register_abtest_webhookswrite gatedinternal 1

Register A/B Webhooks

Register the Shopify order and refund webhooks required for server-verified experiment attribution.

Best used when

Connecting store data, product pages, landing pages, or A/B tests.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

shopify_install_abtest_splitterwrite gatedinternal 1

Install A/B Splitter

Install a generic Shopify A/B splitter and tracking snippet.

Best used when

Connecting store data, product pages, landing pages, or A/B tests.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

shopify_upsert_theme_assetwrite gatedinternal 1

Upsert Theme Asset

Create or update a Shopify theme section/template/snippet asset.

Best used when

Connecting store data, product pages, landing pages, or A/B tests.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

shopify_create_product_templatewrite gatedinternal 1

Create Product Template

Create or replace a Shopify JSON product template and optionally assign its template suffix to a product.

Best used when

Connecting store data, product pages, landing pages, or A/B tests.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

shopify_update_product_copywrite gatedinternal 1

Update Product Copy

Update Shopify product copy, SEO, or assigned product template suffix. Payload fields are strict snake_case; unknown fields are rejected.

Best used when

Connecting store data, product pages, landing pages, or A/B tests.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

shopify_update_productwrite gatedinternal 1

Update Shopify Product

Update complete Shopify product fields and variant prices, SKU, barcode, tax, and inventory policy. Payload fields are strict snake_case; unknown fields are rejected.

Best used when

Connecting store data, product pages, landing pages, or A/B tests.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

shopify_upload_filewrite gatedinternal 1

Upload Shopify File

Import an HTTPS image, video, or file URL into Shopify Files.

Best used when

Connecting store data, product pages, landing pages, or A/B tests.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

shopify_create_basic_discountwrite gatedinternal 1

Create Shopify Discount

Create a percentage or fixed-amount Shopify discount code.

Best used when

Connecting store data, product pages, landing pages, or A/B tests.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

shopify_list_discountsreadinternal 1

Shopify Discounts

List code and automatic discounts with status, codes, usage counts, and the active window.

Best used when

Connecting store data, product pages, landing pages, or A/B tests.

Execution

Runs immediately

Safety

No account changes

shopify_update_discountwrite gatedinternal 1

Update Shopify Discount

Activate or deactivate a discount code, or change its title, end date, or usage limit.

Best used when

Connecting store data, product pages, landing pages, or A/B tests.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

shopify_list_filesreadinternal 1

Shopify Files

List images, videos, and files already hosted in Shopify so they can be reused as ad creative.

Best used when

Connecting store data, product pages, landing pages, or A/B tests.

Execution

Runs immediately

Safety

No account changes

shopify_list_locationsreadinternal 1

Shopify Locations

List store locations, including which ones ship inventory and fulfill online orders.

Best used when

Connecting store data, product pages, landing pages, or A/B tests.

Execution

Runs immediately

Safety

No account changes

shopify_get_inventoryreadinternal 1

Shopify Inventory

Read available, on-hand, and committed stock per variant and location.

Best used when

Connecting store data, product pages, landing pages, or A/B tests.

Execution

Runs immediately

Safety

No account changes

shopify_adjust_inventorywrite gatedinternal 1

Adjust Shopify Inventory

Set an absolute available quantity or apply a relative change for one variant at one location.

Best used when

Connecting store data, product pages, landing pages, or A/B tests.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

shopify_update_pagewrite gatedinternal 1

Update Shopify Page

Update a Shopify page.

Best used when

Connecting store data, product pages, landing pages, or A/B tests.

Execution

Preview, then approval

Safety

Creates paused or draft changes first

shopify_publish_landing_pagewrite gatedinternal 1

Publish Landing Page

Publish a Shopify landing page.

Best used when

Connecting store data, product pages, landing pages, or A/B tests.

Execution

Preview, then approval

Safety

Creates paused or draft changes first