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
338 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.
Account, approvals, business reports, and cross-platform workflows.
Create an AdsCove account, connect at least one platform, then add AdsCove to your AI client.
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.
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.
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 (32)
list_connectionsreadinternal 0List Connections
List platform connection status for the current user.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
hide_connectionwrite gatedinternal 0Hide or unhide a connection
After explicit approval, hide an account from lists and chat selection. Hiding does not pause ads or disable rules or schedules. Set hidden=true to hide or false to restore.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
get_connection_healthreadinternal 0Connection Health
Check token, scope, and platform health across connected accounts.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
get_usage_statusreadinternal 0Usage Status
Return current plan, binding usage, and internal protection status.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
get_business_targetsreadinternal 0Business Targets
Read the merchant-confirmed target ROAS, margin band, target CPA, and spend ceiling used by recommendations.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
set_business_targetswrite gatedinternal 0Set Business Targets
Save merchant-confirmed target ROAS, margin band, target CPA, or spend ceiling for recommendations.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
list_business_groupsreadinternal 0Business Groups
List saved named Shopify + ad-account groups for reporting.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
save_business_groupwrite gatedinternal 0Save Business Group
Save a named group containing exactly one Shopify store and its Meta/Google accounts.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
delete_business_groupwrite gatedinternal 0Delete Business Group
Delete a saved reporting business group.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
get_daily_business_reportreadinternal 1Daily Business Report
Aggregate Shopify GMV, Meta spend, Google spend, and blended ROAS.
Finding real spend, orders, ROAS, and campaign outliers.
Runs immediately
No account changes
get_campaign_performancereadinternal 1Campaign Performance
Return cross-platform campaign performance in a shared schema.
Finding real spend, orders, ROAS, and campaign outliers.
Runs immediately
No account changes
analyze_attribution_gapreadinternal 1Attribution Gap
Compare platform ROAS against Shopify order attribution.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
recommend_next_actionsreadinternal 1Recommended Actions
Produce rule-based next actions without calling an LLM.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
get_business_performance_insightsreadinternal 1Business 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.
Finding real spend, orders, ROAS, and campaign outliers.
Runs immediately
No account changes
approve_actionwrite gatedinternal 0Approve Pending Action
Execute a pending write after the user explicitly consents in conversation. Pass the execution_id returned by the pending action, or execution_ids (up to 50) to approve a whole task the user agreed to once, e.g. every create in one launch. Items run in order; if the route time budget is reached the rest stay pending and come back as remaining_execution_ids — call again with them, no new consent needed. Clients with a stale schema can send execution_ids through run_adscove_tool. NEVER call this without asking the user first.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
reject_actionwrite gatedinternal 0Reject Pending Action
Reject a pending write (execution_id) or a set of them (execution_ids) on the user's behalf after they decline in conversation.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
request_video_upload_ticketwrite gatedinternal 1Request Local Video Upload Ticket
Use AdsCove OAuth to create a one-hour R2 upload ticket for one local video (mp4/mov/webm, up to 500 MiB) or image (jpg/png, up to 30 MiB). PUT the file to the signed URL with the returned headers, then pass storage_key to meta_upload_video / google_upload_youtube_video / tiktok_upload_video (videos) or meta_upload_creative / tiktok_upload_image (images). No API key is needed.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
complete_video_uploadwrite gatedinternal 1Complete Local Video Upload
Optional: verify a local video uploaded to its AdsCove R2 ticket and keep it in the media library. Not required before meta_upload_video; the same storage_key works for Meta, Google, and TikTok.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
create_ad_library_launch_batchwrite gatedinternal 1Ad Library Launch Batch
Create Shopify draft products and paused Meta launch objects from structured ad-library records.
Importing structured Ad Library records into draft products and paused ads.
Preview, then approval
Creates paused or draft changes first
get_meta_help_articlereadinternal 0Meta 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.
Auditing Meta campaigns or preparing paused creative tests.
Runs immediately
No account changes
list_adscove_capabilitiesreadinternal 0List AdsCove Capabilities
List synced skill and workflow capabilities with mapped tools.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
get_adscove_capabilityreadinternal 0Get AdsCove Capability
Return one synced skill/workflow playbook.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
plan_adscove_workflowreadinternal 1Plan AdsCove Workflow
Map a natural-language goal to safe AdsCove tools and approval gates.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
discover_adscove_toolsreadinternal 0Discover AdsCove Tools
Progressive disclosure: search the full launch tool catalog by platform/query/mode without loading every schema into tools/list. Returns tool names for run_adscove_tool.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
get_profit_reportreadinternal 1Profit Report
Calculate Shopify revenue minus product cost and Meta/Google spend, accepting stored unit costs, a customer cost rate, or a customer gross margin.
Finding real spend, orders, ROAS, and campaign outliers.
Runs immediately
No account changes
set_spend_guardrailwrite gatedinternal 1Set 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.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
list_spend_guardrailsreadinternal 1List Spend Guardrails
List active or triggered spend protection rules and dashboard notifications.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
remove_spend_guardrailwrite gatedinternal 1Remove Spend Guardrail
Disable an AdsCove spend guardrail and its native Meta automated rule when present.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
create_automation_rulewrite gatedinternal 0Create Rule Draft
Create a disabled condition-based rule draft, run static checks, and perform a Dry Run. Activation is a separate approved action.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
activate_automation_rulewrite gatedinternal 0Activate Rule
Enable a rule after static checks, account currency verification, successful Dry Run for auto mode, and database readback.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
create_automation_schedulewrite gatedinternal 0Create Scheduled Task
Create a recurring scheduled task that runs a Skill or instructions on a cadence. Starts after user confirmation.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
audit_tracking_urlsreadinternal 0Audit Tracking URLs
Audit active Meta and Google ad URLs for missing or inconsistent UTMs, source mismatches, and unreachable landing pages.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
Google Ads (151)
google_list_accessible_customersreadinternal 0Google Accessible Customers
List accessible Google Ads customers.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
google_searchreadinternal 1Google Ads GAQL Search
Execute a Google Ads Query Language (GAQL) search against the connected customer. Pass query with the SELECT ... FROM ... statement.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
google_get_resource_metadatareadinternal 0Google Ads Resource Metadata
Describe fields available on a Google Ads resource type such as campaign, ad_group, ad_group_ad, or keyword_view.
Auditing Meta campaigns or preparing paused creative tests.
Runs immediately
No account changes
google_list_campaignsreadinternal 1Google Campaigns
List Google Ads campaigns.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
google_list_ad_groupsreadinternal 1Google Ad Groups
List Google Ads ad groups.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
google_fetch_performancereadinternal 1Google Performance
Fetch Google Ads performance.
Finding real spend, orders, ROAS, and campaign outliers.
Runs immediately
No account changes
google_get_ad_performancereadinternal 1Google Ad Performance
Pull ad-level performance with CTR, CPC, CPA, ROAS, ad type, and live status.
Finding real spend, orders, ROAS, and campaign outliers.
Runs immediately
No account changes
google_analyze_wasted_spendreadinternal 1Google Wasted Spend
Find search terms, keywords, or ads spending without enough conversions or ROAS.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
google_search_terms_reportreadinternal 1Google Search Terms
Fetch search terms report.
Finding real spend, orders, ROAS, and campaign outliers.
Runs immediately
No account changes
google_analyze_search_termsreadinternal 1Google Search Term Analysis
Summarize search-term waste, winners, and negative-keyword candidates.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
google_explain_performance_anomalyreadinternal 1Google Performance Anomaly
Compare recent Google Ads metrics against a prior baseline and explain likely causes.
Finding real spend, orders, ROAS, and campaign outliers.
Runs immediately
No account changes
google_optimize_budget_allocationreadinternal 1Google Budget Allocation Plan
Recommend budget shifts across campaigns from CPA/ROAS evidence without mutating budgets.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
google_keyword_ideasreadinternal 1Google Keyword Ideas
Generate keyword ideas.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
google_research_keywordsreadinternal 1Google Keyword Research
Alias-friendly keyword research with volume, competition, and bid estimates when Google returns them.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
google_keyword_researchreadinternal 1Google 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.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
google_keyword_historical_metricsreadinternal 1Google 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.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
google_forecast_keywordsreadinternal 1Google Keyword Forecast
Forecast campaign-level impressions, clicks, cost, and conversions for a keyword list at a given CPC bid and daily budget. Growth plan.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
google_plan_keyword_campaignreadinternal 1Google Keyword Campaign Plan
Full-flow plan: keyword research + historical metrics + forecast, returning a ready-to-approve google_create_search_draft payload. Growth plan.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
google_suggest_ad_contentreadinternal 0Google Ad Content Suggestions
Generate Search/PMax/Display copy within Google Ads character limits from product and offer inputs.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
google_get_ad_creativereadinternal 1Google Ad Creative
Read existing Google ad creative composition, final URLs, text assets, and asset references.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
google_discover_existing_assetsreadinternal 1Google Asset Discovery
Browse reusable Google Ads image, text, YouTube video, sitelink, callout, and snippet assets.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
google_validate_and_prepare_assetsreadinternal 1Google Asset Validation
Validate copy, image asset references, and URL inputs before Search, PMax, or Display creation.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
google_list_conversion_actionsreadinternal 1Google Conversion Actions
List account conversion actions, tracking status, category, and inclusion settings.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
google_get_conversion_tracking_configreadinternal 1Google Conversion Tracking Config
Read account-level conversion tracking settings and detailed conversion-action configuration.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
google_get_conversion_action_performancereadinternal 1Google Conversion Action Performance
Break down conversions, value, CPA, and ROAS by conversion action.
Finding real spend, orders, ROAS, and campaign outliers.
Runs immediately
No account changes
google_get_change_historyreadinternal 1Google Change History
Read who changed what and when in Google Ads for the selected period.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
google_get_shared_budgetsreadinternal 1Google Shared Budgets
List campaign budgets, sharing state, reference counts, and delivery settings.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
google_get_product_performancereadinternal 1Google Product Performance
Return Shopping/PMax product spend, conversions, value, and ROAS by Merchant Center item.
Finding real spend, orders, ROAS, and campaign outliers.
Runs immediately
No account changes
google_get_merchant_product_inventoryreadinternal 1Linked 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.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
google_get_landing_page_performancereadinternal 1Google Landing Page Performance
Return spend, clicks, conversions, value, and ROAS by final landing-page URL.
Finding real spend, orders, ROAS, and campaign outliers.
Runs immediately
No account changes
google_list_brand_listsreadinternal 1Google Brand Lists
List reusable Google Ads brand shared sets available for PMax brand exclusions.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
google_suggest_brandsreadinternal 1Google Brand Suggestions
Resolve a brand name prefix to Google's verified brand entity IDs.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
google_get_campaign_targetingreadinternal 1Google Campaign Targeting
Read campaign location, language, device, schedule, topic, and audience criteria.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
google_build_search_planreadinternal 1Google Search Plan
Build a search campaign plan.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
google_build_display_planreadinternal 1Google Display Plan
Build a basic paused Display/GDN draft plan without mutating Google Ads; detailed targeting is a manual follow-up.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
google_create_search_draftwrite gatedinternal 1Create Google Search Draft
Create a paused Google Search campaign in one atomic change: one or more ad groups (payload.ad_groups), per-keyword match types, RSAs, languages, and campaign negative keywords. AI Max is on by default (payload.enable_ai_max=false to opt out). Only the campaign is paused; enable it to launch.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
google_create_standard_shopping_draftwrite gatedinternal 1Create 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.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
google_create_pmax_asset_planreadinternal 1Google PMax Asset Plan
Create a non-retail PMax asset plan without mutating Google Ads.
Building PMax assets and paused campaigns after creative validation.
Runs immediately
No account changes
google_create_pmax_draftwrite gatedinternal 1Create 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.
Building PMax assets and paused campaigns after creative validation.
Preview, then approval
Creates paused or draft changes first
google_upload_youtube_videowrite gatedinternal 1Upload Google Ads Video
Upload a completed AdsCove R2 video through Google Ads API v23+ using the approved adwords permission. Defaults to an unlisted Google-managed channel; optionally set channel_id for an advertiser-owned YouTube channel. Then check processing status before creating a paused PMax or Demand Gen draft.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
google_get_youtube_video_upload_statusreadinternal 1Google Ads Video Upload Status
Check whether a Google Ads video upload is PROCESSED and retrieve its YouTube video ID for PMax or Demand Gen drafts.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
google_create_demand_gen_draftwrite gatedinternal 1Create Google Demand Gen Video Draft
Create a paused YouTube-only Demand Gen video campaign using YouTube video IDs. The campaign, ad group, and ad remain paused until reviewed and enabled.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
google_create_demand_gen_image_campaignwrite gatedinternal 1Create Google Demand Gen Image Campaign
Create a paused IMAGE Demand Gen campaign with a campaign target CPA and 1-10 ad groups. Each ad group has its own target CPA, a custom segment (search terms and/or competitor URLs), location and language targeting, and a multi-asset image ad. Only the campaign is paused; ad groups and ads are enabled, so enabling the campaign starts delivery. Use payload.validate_with_google=true in dry_run for Google validate-only.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
google_update_ad_group_target_cpawrite gatedinternal 1Update Google Ad Group Target CPA
Change one Google ad group's target CPA after approval. Reads the current value first and returns before/after; raising it by more than 100% in one step needs payload.allow_large_change=true.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
google_update_demand_gen_ad_videoswrite gatedinternal 1Update Demand Gen Ad Videos
Swap YouTube videos on a live Demand Gen video ad: pass ad_group_id, ad_id, payload.add_youtube_video_ids and/or payload.remove_youtube_video_ids (at most 5 videos stay on the ad). Missing YouTube video assets are created; headlines, URLs and status stay unchanged. The ad goes back to policy review.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
google_get_ad_policy_statusreadinternal 1Google Ad Policy Status
Show why ads or their assets are disapproved or limited: per-ad approval status and policy topics, plus per-asset (video, image, text) review status, policy topics, impressions and spend. Filter by campaign_id, ad_group_id or ad_id.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
google_create_display_draftwrite gatedinternal 1Create 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.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
google_list_campaign_extensionsreadinternal 1Google Campaign Assets
List sitelink, callout, and structured-snippet assets linked to a campaign.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
google_add_sitelinkswrite gatedinternal 1Add Google Sitelinks
Create and link sitelink assets to a campaign after approval.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
google_remove_sitelinkswrite gatedinternal 1Remove Google Sitelinks
Remove matching sitelink campaign-asset links after approval.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
google_add_callout_extensionswrite gatedinternal 1Add Google Callouts
Create and link callout assets to a campaign after approval.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
google_remove_calloutswrite gatedinternal 1Remove Google Callouts
Remove matching callout campaign-asset links after approval.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
google_add_structured_snippetswrite gatedinternal 1Add Google Structured Snippets
Create and link structured-snippet assets to a campaign after approval.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
google_remove_structured_snippetswrite gatedinternal 1Remove Google Structured Snippets
Remove matching structured-snippet campaign-asset links after approval.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
google_add_search_campaign_imagewrite gatedinternal 1Add Google Search Image Asset
Link uploaded image or logo assets to a Search campaign after approval.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
google_apply_negative_keywordswrite gatedinternal 1Apply Negative Keywords
Apply negative keywords to a campaign or ad group.
Cleaning wasted Google Search spend without touching winners.
Preview, then approval
Creates paused or draft changes first
google_update_bid_strategywrite gatedinternal 1Update Google Bid Strategy
Change a campaign standard bidding strategy after approval.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
google_update_budget_or_bidwrite gatedinternal 1Update Google Budget or Bid
Change Google budget or bidding limits.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
google_update_statuswrite gatedinternal 1Update Google Campaign Status
Change a Google campaign status.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
google_launch_campaignwrite gatedinternal 1Launch Google Campaign
Enable a paused Google campaign together with its paused ad groups, ads, and positive keywords in one atomic change and one approval. dry_run lists exactly what will be enabled; payload.exclude_ad_group_ids keeps chosen ad groups paused.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
google_update_ad_group_statuswrite gatedinternal 1Update Google Ad Group Status
Pause or enable a Google ad group after approval.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
google_create_ad_groupwrite gatedinternal 1Create Google Ad Group
Create a paused ad group under an existing Google campaign.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
google_add_keywordswrite gatedinternal 1Add Google Keywords
Add up to 500 paused positive keywords to an existing ad group.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
google_update_keywordwrite gatedinternal 1Update Google Keyword
Update a positive keyword's status or CPC bid.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
google_remove_keywordswrite gatedinternal 1Remove Google Keywords
Remove selected positive keywords from an existing ad group.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
google_update_keyword_statuswrite gatedinternal 1Update Google Keyword Status
Pause, enable, or remove a Google keyword after approval.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
google_create_rsawrite gatedinternal 1Create Google RSA
Create a paused responsive search ad in an existing ad group.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
google_update_rsawrite gatedinternal 1Update Google RSA
Update the URLs, headlines, descriptions, or paths of an existing responsive search ad.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
google_update_ad_statuswrite gatedinternal 1Update Google Ad Status
Pause, enable, or remove a Google ad after approval.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
google_apply_pmax_brand_exclusionwrite gatedinternal 1Apply PMax Brand Exclusion
Attach an existing Google brand list as a negative campaign criterion.
Building PMax assets and paused campaigns after creative validation.
Preview, then approval
Creates paused or draft changes first
google_create_pmax_brand_exclusionwrite gatedinternal 1Create PMax Brand Exclusion
Create a reusable brand list from verified Google brand IDs and optionally attach it to a PMax campaign.
Building PMax assets and paused campaigns after creative validation.
Preview, then approval
Creates paused or draft changes first
google_list_asset_groupsreadinternal 1Google Asset Groups
List Performance Max asset groups with their final URLs, mobile URLs, display paths, status, and ad strength.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
google_get_pmax_listing_groupsreadinternal 1Google PMax Product Groups
Read the Performance Max product group (listing group filter) tree for an asset group, including which products are currently excluded.
Building PMax assets and paused campaigns after creative validation.
Runs immediately
No account changes
google_update_asset_groupwrite gatedinternal 1Update Google Asset Group
Change a Performance Max asset group's final URLs, final mobile URLs, name, display paths, or status.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
google_update_url_expansionwrite gatedinternal 1Update Final URL Expansion
Turn Performance Max final URL expansion on or off for a campaign without resetting its other asset automation settings.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
google_update_pmax_listing_groupwrite gatedinternal 1Update 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.
Building PMax assets and paused campaigns after creative validation.
Preview, then approval
Creates paused or draft changes first
google_exclude_pmax_productswrite gatedinternal 1Exclude PMax Products
Exclude Merchant Center item IDs (or brands, product types, custom labels, channels, conditions) from a Performance Max asset group. Works on trees already split by product type or custom label: each advertised product group gets an extra item-ID split, and the rest of the tree is kept.
Building PMax assets and paused campaigns after creative validation.
Preview, then approval
Creates paused or draft changes first
google_get_shopping_listing_groupsreadinternal 1Google Shopping Product Groups
Read the Standard Shopping product group (listing group) tree for an ad group, including which products are currently excluded.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
google_update_shopping_listing_groupwrite gatedinternal 1Update Shopping Product Groups
Edit a Standard Shopping product group tree: exclude products, reinstate excluded products, or reset the ad group to a single all-products group.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
google_exclude_shopping_productswrite gatedinternal 1Exclude Shopping Products
Exclude Merchant Center item IDs (or brands, product types, custom labels, channels, conditions) from a Standard Shopping ad group. Works on trees already split by product type or custom label: each advertised product group gets an extra item-ID split, and the rest of the tree is kept. Not for Performance Max — use google_exclude_pmax_products.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
google_update_asset_group_assetswrite gatedinternal 1Update Asset Group Assets
Add or remove headlines, long headlines, descriptions, images, logos, and YouTube videos on a live Performance Max asset group.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
google_search_geo_targetsreadinternal 1Google Geo Target Search
Resolve location names such as California or Toronto into the geo target constant IDs the campaign and targeting tools require.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
google_get_placement_performancereadinternal 1Google Placement Performance
Return Display, Video, and PMax spend, clicks, conversions, and ROAS by placement, website, app, or YouTube channel.
Finding real spend, orders, ROAS, and campaign outliers.
Runs immediately
No account changes
google_list_negative_keyword_listsreadinternal 1Google Negative Keyword Lists
List reusable negative keyword shared sets with member and campaign reference counts.
Cleaning wasted Google Search spend without touching winners.
Runs immediately
No account changes
google_update_campaign_targetingwrite gatedinternal 1Update Google Campaign Targeting
Add or remove campaign locations, excluded locations, and languages, or replace the ad schedule.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
google_update_device_bid_adjustmentswrite gatedinternal 1Update Device Bid Adjustments
Set mobile, desktop, tablet, or connected-TV bid modifiers on a campaign, updating the existing criterion when one is present.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
google_exclude_placementswrite gatedinternal 1Exclude Google Placements
Exclude websites, mobile apps, YouTube channels, or YouTube videos from a campaign as negative criteria.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
google_create_negative_keyword_listwrite gatedinternal 1Create Negative Keyword List
Create a reusable negative keyword shared set and optionally attach it to a campaign.
Cleaning wasted Google Search spend without touching winners.
Preview, then approval
Creates paused or draft changes first
google_apply_negative_keyword_listwrite gatedinternal 1Apply Negative Keyword List
Attach an existing negative keyword shared set to a campaign.
Cleaning wasted Google Search spend without touching winners.
Preview, then approval
Creates paused or draft changes first
google_update_conversion_actionwrite gatedinternal 1Update Conversion Action
Change a conversion action's status, name, counting type, lookback windows, or whether it counts as a primary conversion for bidding.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
google_update_conversion_goalwrite gatedinternal 1Update Conversion Goal
Set whether an account-default or campaign conversion goal (category + origin) is biddable. Use for YouTube-hosted goals that cannot be edited as conversion actions.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
google_update_tracking_urlswrite gatedinternal 1Update Google Tracking URLs
Set or clear the tracking template and final URL suffix on a campaign or ad group.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
get_ad_performancereadinternal 1Google Ad Performance
Alias for google_get_ad_performance.
Finding real spend, orders, ROAS, and campaign outliers.
Runs immediately
No account changes
analyze_wasted_spendreadinternal 1Google Wasted Spend
Alias for google_analyze_wasted_spend.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
analyze_search_termsreadinternal 1Google Search Term Analysis
Alias for google_analyze_search_terms.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
explain_performance_anomalyreadinternal 1Google Performance Anomaly
Alias for google_explain_performance_anomaly.
Finding real spend, orders, ROAS, and campaign outliers.
Runs immediately
No account changes
optimize_budget_allocationreadinternal 1Google Budget Allocation Plan
Alias for google_optimize_budget_allocation.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
research_keywordsreadinternal 1Google Keyword Research
Alias for google_research_keywords.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
keyword_researchreadinternal 1Google Keyword Research
Alias for google_keyword_research.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
keyword_historical_metricsreadinternal 1Google Keyword Historical Metrics
Alias for google_keyword_historical_metrics.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
forecast_keywordsreadinternal 1Google Keyword Forecast
Alias for google_forecast_keywords.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
plan_keyword_campaignreadinternal 1Google Keyword Campaign Plan
Alias for google_plan_keyword_campaign.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
suggest_ad_contentreadinternal 0Google Ad Content Suggestions
Alias for google_suggest_ad_content.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
get_ad_creativereadinternal 1Google Ad Creative
Alias for google_get_ad_creative.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
discover_existing_assetsreadinternal 1Google Asset Discovery
Alias for google_discover_existing_assets.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
validate_and_prepare_assetsreadinternal 1Google Asset Validation
Alias for google_validate_and_prepare_assets.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
create_search_campaignwrite gatedinternal 1Create Google Search Campaign
Alias for google_create_search_draft.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
create_pmax_campaignwrite gatedinternal 1Create Google PMax Campaign
Alias for the paused non-retail google_create_pmax_draft workflow.
Building PMax assets and paused campaigns after creative validation.
Preview, then approval
Creates paused or draft changes first
update_campaign_budgetwrite gatedinternal 1Update Campaign Budget
Alias for google_update_budget_or_bid.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
pause_campaignwrite gatedinternal 1Pause Google Campaign
Alias for google_update_status with PAUSED.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
resume_campaignwrite gatedinternal 1Resume Google Campaign
Alias for google_update_status with ACTIVE.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
pause_ad_groupwrite gatedinternal 1Pause Google Ad Group
Alias for google_update_ad_group_status with PAUSED.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
resume_ad_groupwrite gatedinternal 1Resume Google Ad Group
Alias for google_update_ad_group_status with ACTIVE.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
add_negative_keywordswrite gatedinternal 1Add Negative Keywords
Alias for google_apply_negative_keywords.
Cleaning wasted Google Search spend without touching winners.
Preview, then approval
Creates paused or draft changes first
update_bid_strategywrite gatedinternal 1Update Bid Strategy
Alias for google_update_bid_strategy.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
add_sitelinkswrite gatedinternal 1Add Sitelinks
Alias for google_add_sitelinks.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
remove_sitelinkswrite gatedinternal 1Remove Sitelinks
Alias for google_remove_sitelinks.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
add_callout_extensionswrite gatedinternal 1Add Callouts
Alias for google_add_callout_extensions.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
remove_calloutswrite gatedinternal 1Remove Callouts
Alias for google_remove_callouts.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
add_structured_snippetswrite gatedinternal 1Add Structured Snippets
Alias for google_add_structured_snippets.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
remove_structured_snippetswrite gatedinternal 1Remove Structured Snippets
Alias for google_remove_structured_snippets.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
list_campaign_extensionsreadinternal 1Google Campaign Assets
Alias for google_list_campaign_extensions.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
add_search_campaign_imagewrite gatedinternal 1Add Search Campaign Image
Alias for google_add_search_campaign_image.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
get_campaign_targetingreadinternal 1Google Campaign Targeting
Alias for google_get_campaign_targeting.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
list_conversion_actionsreadinternal 1Google Conversion Actions
Alias for google_list_conversion_actions.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
get_conversion_action_performancereadinternal 1Google Conversion Action Performance
Alias for google_get_conversion_action_performance.
Finding real spend, orders, ROAS, and campaign outliers.
Runs immediately
No account changes
list_asset_groupsreadinternal 1Google Asset Groups
Alias for google_list_asset_groups.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
get_pmax_listing_groupsreadinternal 1Google PMax Product Groups
Alias for google_get_pmax_listing_groups.
Building PMax assets and paused campaigns after creative validation.
Runs immediately
No account changes
update_asset_groupwrite gatedinternal 1Update Google Asset Group
Alias for google_update_asset_group.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
update_url_expansionwrite gatedinternal 1Update Final URL Expansion
Alias for google_update_url_expansion.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
update_pmax_listing_groupwrite gatedinternal 1Update PMax Product Groups
Alias for google_update_pmax_listing_group.
Building PMax assets and paused campaigns after creative validation.
Preview, then approval
Creates paused or draft changes first
exclude_pmax_productswrite gatedinternal 1Exclude PMax Products
Alias for google_exclude_pmax_products.
Building PMax assets and paused campaigns after creative validation.
Preview, then approval
Creates paused or draft changes first
get_shopping_listing_groupsreadinternal 1Google Shopping Product Groups
Alias for google_get_shopping_listing_groups.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
update_shopping_listing_groupwrite gatedinternal 1Update Shopping Product Groups
Alias for google_update_shopping_listing_group.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
exclude_shopping_productswrite gatedinternal 1Exclude Shopping Products
Alias for google_exclude_shopping_products.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
update_asset_group_assetswrite gatedinternal 1Update Asset Group Assets
Alias for google_update_asset_group_assets.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
search_geo_targetsreadinternal 1Google Geo Target Search
Alias for google_search_geo_targets.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
get_placement_performancereadinternal 1Google Placement Performance
Alias for google_get_placement_performance.
Finding real spend, orders, ROAS, and campaign outliers.
Runs immediately
No account changes
list_negative_keyword_listsreadinternal 1Google Negative Keyword Lists
Alias for google_list_negative_keyword_lists.
Cleaning wasted Google Search spend without touching winners.
Runs immediately
No account changes
update_campaign_targetingwrite gatedinternal 1Update Google Campaign Targeting
Alias for google_update_campaign_targeting.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
update_device_bid_adjustmentswrite gatedinternal 1Update Device Bid Adjustments
Alias for google_update_device_bid_adjustments.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
exclude_placementswrite gatedinternal 1Exclude Google Placements
Alias for google_exclude_placements.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
create_negative_keyword_listwrite gatedinternal 1Create Negative Keyword List
Alias for google_create_negative_keyword_list.
Cleaning wasted Google Search spend without touching winners.
Preview, then approval
Creates paused or draft changes first
apply_negative_keyword_listwrite gatedinternal 1Apply Negative Keyword List
Alias for google_apply_negative_keyword_list.
Cleaning wasted Google Search spend without touching winners.
Preview, then approval
Creates paused or draft changes first
update_conversion_actionwrite gatedinternal 1Update Conversion Action
Alias for google_update_conversion_action.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
update_conversion_goalwrite gatedinternal 1Update Conversion Goal
Alias for google_update_conversion_goal.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
update_tracking_urlswrite gatedinternal 1Update Google Tracking URLs
Alias for google_update_tracking_urls.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
list_search_console_propertiesreadinternal 0Search Console Properties
List saved Google Search Console properties connected in AdsCove. Returns connection_id, site_url, domain, and enabled status.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
query_search_console_performancereadinternal 1Search Console Performance
Read finalized Search Console query/page rows for a saved property. Pass connection_id or site_url; optional date_from/date_to (YYYY-MM-DD) and row_limit (max 1000, default 250).
Finding real spend, orders, ROAS, and campaign outliers.
Runs immediately
No account changes
inspect_search_console_urlsreadinternal 1Search Console URL Inspection
Inspect Google index status for URLs of a saved Search Console property: verdict, coverage, indexing, robots.txt, fetch state, last crawl, canonicals, and sitemaps, plus a summary. Pass connection_id or site_url; optional urls (absolute URLs on the property domain, max 200). If urls is omitted, reads https://<domain>/sitemap.xml (one level into a sitemap index). url_limit caps URLs inspected (default 100, max 200). URLs outside the property domain are skipped and listed in skipped.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
list_search_console_sitemapsreadinternal 0Search Console Sitemaps
List sitemaps submitted to a saved Search Console property with last submitted/downloaded times, pending state, errors, warnings, and submitted/indexed counts per content type. Pass connection_id or site_url.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
Meta Ads (73)
meta_list_campaignsreadinternal 1Meta Campaigns
List Meta campaigns with status and effective_status. Optional fields= overrides the Graph field list.
Auditing Meta campaigns or preparing paused creative tests.
Runs immediately
No account changes
meta_list_adsetsreadinternal 1Meta Ad Sets
List Meta ad sets (scope with campaign_id) with status and effective_status. Optional fields= overrides the Graph field list.
Auditing Meta campaigns or preparing paused creative tests.
Runs immediately
No account changes
meta_list_adsreadinternal 1Meta Ads
List Meta ads (scope with adset_id or campaign_id) with status and effective_status (PENDING_REVIEW, DISAPPROVED, ...). Optional fields= overrides the Graph field list, e.g. add ad_review_feedback.
Auditing Meta campaigns or preparing paused creative tests.
Runs immediately
No account changes
meta_fetch_insightsreadinternal 1Meta Insights
Fetch Meta Ads insights.
Auditing Meta campaigns or preparing paused creative tests.
Runs immediately
No account changes
meta_get_campaign_performancereadinternal 1Meta Campaign Performance
Pull campaign-level Meta metrics with conversion, CPA, and ROAS helpers.
Finding real spend, orders, ROAS, and campaign outliers.
Runs immediately
No account changes
meta_get_adset_performancereadinternal 1Meta Ad Set Performance
Pull ad-set performance within a campaign or account.
Finding real spend, orders, ROAS, and campaign outliers.
Runs immediately
No account changes
meta_get_ad_performancereadinternal 1Meta Ad Performance
Pull ad-level Meta metrics with spend, CTR, CPA, ROAS, and live status.
Finding real spend, orders, ROAS, and campaign outliers.
Runs immediately
No account changes
meta_analyze_ad_performancereadinternal 1Meta Ad Performance Analysis
Analyze ad-level spend, CTR, CPA, ROAS, and conversion action mix.
Finding real spend, orders, ROAS, and campaign outliers.
Runs immediately
No account changes
meta_get_audience_insightsreadinternal 1Meta Audience Insights
Break Meta performance down by age, gender, country, or placement.
Auditing Meta campaigns or preparing paused creative tests.
Runs immediately
No account changes
meta_analyze_audiencesreadinternal 1Meta Audience Analysis
Rank audience segments and surface weak/high-ROAS demographic pockets.
Auditing Meta campaigns or preparing paused creative tests.
Runs immediately
No account changes
meta_analyze_wasted_spendreadinternal 1Meta Wasted Spend
Find Meta campaigns, ad sets, or ads spending without enough conversions or ROAS.
Auditing Meta campaigns or preparing paused creative tests.
Runs immediately
No account changes
meta_detect_creative_fatiguereadinternal 1Meta Creative Fatigue
Detect ads with declining CTR/CVR over daily trend data.
Auditing Meta campaigns or preparing paused creative tests.
Runs immediately
No account changes
meta_explain_anomalyreadinternal 1Meta Performance Anomaly
Explain recent CPA, CTR, spend, or conversion spikes against the previous period.
Auditing Meta campaigns or preparing paused creative tests.
Runs immediately
No account changes
meta_get_ad_creativesreadinternal 1Meta Ad Creatives
Return ad creative composition, thumbnails, story IDs, image URLs, and asset feed specs.
Auditing Meta campaigns or preparing paused creative tests.
Runs immediately
No account changes
meta_search_interestsreadinternal 1Meta Interests
Search Meta targeting interests.
Auditing Meta campaigns or preparing paused creative tests.
Runs immediately
No account changes
meta_search_targetingreadinternal 1Meta Targeting Search
Search Meta targeting interests, demographics, and behaviors by keyword.
Auditing Meta campaigns or preparing paused creative tests.
Runs immediately
No account changes
meta_browse_targetingreadinternal 1Meta Targeting Browse
Browse Meta targeting categories such as interests, behaviors, and demographics.
Auditing Meta campaigns or preparing paused creative tests.
Runs immediately
No account changes
meta_list_custom_audiencesreadinternal 1Meta Custom Audiences
List existing custom, lookalike, website, and engagement audiences.
Auditing Meta campaigns or preparing paused creative tests.
Runs immediately
No account changes
meta_create_custom_audiencewrite gatedinternal 1Create Meta Website Audience
Create a website-behavior custom audience from a Pixel using all-visitors, URL-contains, event, or raw rule input.
Auditing Meta campaigns or preparing paused creative tests.
Preview, then approval
Creates paused or draft changes first
meta_create_lookalikewrite gatedinternal 1Create Meta Lookalike
Create a 1%-20% lookalike from an existing origin audience. Use meta_list_custom_audiences first to select the origin.
Auditing Meta campaigns or preparing paused creative tests.
Preview, then approval
Creates paused or draft changes first
meta_list_pages_and_pixelsreadinternal 1Meta Pages and Pixels
List available Pages and Pixels.
Auditing Meta campaigns or preparing paused creative tests.
Runs immediately
No account changes
meta_list_pixelsreadinternal 1Meta Pixels
List Meta Pixels configured for the connected ad account.
Auditing Meta campaigns or preparing paused creative tests.
Runs immediately
No account changes
meta_list_instagram_accountsreadinternal 1Meta Instagram Accounts
List Instagram accounts connected to the Meta ad account.
Auditing Meta campaigns or preparing paused creative tests.
Runs immediately
No account changes
meta_discover_assetsreadinternal 1Meta Asset Discovery
Discover images, videos, and ad creatives already available in the ad account.
Auditing Meta campaigns or preparing paused creative tests.
Runs immediately
No account changes
meta_validate_assetsreadinternal 1Meta Asset Validation
Validate image, video, and carousel asset inputs before creating Meta campaigns.
Auditing Meta campaigns or preparing paused creative tests.
Runs immediately
No account changes
meta_select_campaign_typereadinternal 0Meta Campaign Type Selector
Choose image, video, carousel, or DCO flow based on supplied creative inputs.
Auditing Meta campaigns or preparing paused creative tests.
Runs immediately
No account changes
meta_get_campaign_detailsreadinternal 1Meta Campaign Details
Read detailed campaign settings, budgets, status, and objective.
Auditing Meta campaigns or preparing paused creative tests.
Runs immediately
No account changes
meta_get_campaign_targetingreadinternal 1Meta Campaign Targeting
Read ad-set targeting under a campaign, including geo, audiences, placements, and promoted objects.
Auditing Meta campaigns or preparing paused creative tests.
Runs immediately
No account changes
meta_list_automated_rulesreadinternal 1Meta Automated Rules
List native Meta automated ad rules for the connected ad account.
Auditing Meta campaigns or preparing paused creative tests.
Runs immediately
No account changes
meta_build_launch_planreadinternal 1Meta Launch Plan
Build a structured launch plan from provided inputs.
Auditing Meta campaigns or preparing paused creative tests.
Runs immediately
No account changes
get_meta_campaign_performancereadinternal 1Meta Campaign Performance
Alias for meta_get_campaign_performance.
Finding real spend, orders, ROAS, and campaign outliers.
Runs immediately
No account changes
get_meta_adset_performancereadinternal 1Meta Ad Set Performance
Alias for meta_get_adset_performance.
Finding real spend, orders, ROAS, and campaign outliers.
Runs immediately
No account changes
analyze_meta_ad_performancereadinternal 1Meta Ad Performance Analysis
Alias for meta_analyze_ad_performance.
Finding real spend, orders, ROAS, and campaign outliers.
Runs immediately
No account changes
search_meta_targetingreadinternal 1Meta Targeting Search
Alias for meta_search_targeting.
Auditing Meta campaigns or preparing paused creative tests.
Runs immediately
No account changes
list_meta_campaignsreadinternal 1Meta Campaigns
Alias for meta_list_campaigns.
Auditing Meta campaigns or preparing paused creative tests.
Runs immediately
No account changes
list_meta_ad_setsreadinternal 1Meta Ad Sets
Alias for meta_list_adsets.
Auditing Meta campaigns or preparing paused creative tests.
Runs immediately
No account changes
list_meta_adsreadinternal 1Meta Ads
Alias for meta_list_ads.
Auditing Meta campaigns or preparing paused creative tests.
Runs immediately
No account changes
meta_upload_creativewrite gatedinternal 1Upload Meta Creative
Upload an image to the Meta ad account library and return its image_hash. Pass payload.storage_key from request_video_upload_ticket (jpg/png) for a local file, or payload.image_url for a public HTTPS JPG/PNG (AdsCove downloads it and sends the bytes; redirects and private hosts are refused).
Auditing Meta campaigns or preparing paused creative tests.
Preview, then approval
Creates paused or draft changes first
meta_upload_videowrite gatedinternal 1Upload Meta Video
Upload a video URL or an AdsCove R2 object (storage_key from request_video_upload_ticket) to the Meta video library. Retrying with the same storage_key is safe.
Auditing Meta campaigns or preparing paused creative tests.
Preview, then approval
Creates paused or draft changes first
meta_get_video_statusreadinternal 0Get Meta Video Status
Check Meta video processing status before creating an ad.
Auditing Meta campaigns or preparing paused creative tests.
Runs immediately
No account changes
meta_create_paused_campaignwrite gatedinternal 1Create Paused Meta Campaign
Create a paused Meta campaign draft.
Auditing Meta campaigns or preparing paused creative tests.
Preview, then approval
Creates paused or draft changes first
meta_create_paused_adsetwrite gatedinternal 1Create Paused Meta Ad Set
Create a paused Meta ad set under an existing campaign. Name it with payload.adset_name (or name). Under a campaign budget (CBO), payload.daily_min_spend / payload.daily_spend_limit set the ad set's daily spend floor/cap in account currency. Ad transparency: EU countries need payload.dsa_beneficiary + payload.dsa_payor; Australia needs payload.regional_regulation_identity_id (verified advertiser id) — when omitted, both are reused from an existing ad set in the account.
Auditing Meta campaigns or preparing paused creative tests.
Preview, then approval
Creates paused or draft changes first
meta_create_paused_adwrite gatedinternal 1Create Paused Meta Ad
Create a paused Meta ad, creating the creative first when needed. Name it with payload.ad_name (or name); the new creative gets the same name. Image ads: pass payload.image_hash, or payload.image_url / payload.image_storage_key and the image is uploaded for you. Video ads: payload.video_id plus image_url or image_hash as the cover.
Auditing Meta campaigns or preparing paused creative tests.
Preview, then approval
Creates paused or draft changes first
meta_clone_existing_post_adswrite gatedinternal 1Clone Existing Post Ads
Clone ads from an existing post (resource_id = page_post id) into paused ads in payload.adset_ids. Name them with payload.ad_name (or name); with several ad sets the ad set id is appended.
Auditing Meta campaigns or preparing paused creative tests.
Preview, then approval
Creates paused or draft changes first
meta_duplicate_entitywrite gatedinternal 1Duplicate Meta Entity
Deep-copy a Meta campaign, ad set, or ad into PAUSED status. Supports rename options and optional destination campaign/ad set overrides.
Auditing Meta campaigns or preparing paused creative tests.
Preview, then approval
Creates paused or draft changes first
meta_bulk_update_statuswrite gatedinternal 1Bulk 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.
Auditing Meta campaigns or preparing paused creative tests.
Preview, then approval
Creates paused or draft changes first
meta_create_test_matrixwrite gatedinternal 1Create Meta Test Matrix
Create up to 5 paused ad sets × 6 paused creatives (30 paused ads maximum) under an existing or new paused campaign.
Auditing Meta campaigns or preparing paused creative tests.
Preview, then approval
Creates paused or draft changes first
meta_create_automated_rulewrite gatedinternal 1Create Meta Automated Rule
Create a native Meta automated rule for stop-loss, notification, or budget scaling.
Auditing Meta campaigns or preparing paused creative tests.
Preview, then approval
Creates paused or draft changes first
meta_update_automated_rulewrite gatedinternal 1Update Meta Automated Rule
Update a native Meta automated rule's status, schedule, conditions, or action.
Auditing Meta campaigns or preparing paused creative tests.
Preview, then approval
Creates paused or draft changes first
meta_disable_automated_rulewrite gatedinternal 1Disable Meta Automated Rule
Disable a native Meta automated rule without deleting it.
Auditing Meta campaigns or preparing paused creative tests.
Preview, then approval
Creates paused or draft changes first
meta_update_statuswrite gatedinternal 1Update Meta Status
Change Meta campaign, ad set, or ad status.
Auditing Meta campaigns or preparing paused creative tests.
Preview, then approval
Creates paused or draft changes first
meta_update_budgetwrite gatedinternal 1Update Meta Budget
Change Meta campaign or ad set budget.
Auditing Meta campaigns or preparing paused creative tests.
Preview, then approval
Creates paused or draft changes first
meta_switch_budget_modewrite gatedinternal 1Switch Meta Budget Mode
Switch an existing Meta campaign between campaign budget (CBO) and ad set budgets (ABO) in place, keeping its ads and data. ABO needs payload.adset_daily_budget or payload.adset_budgets for every ad set (max 70); CBO needs payload.daily_budget.
Auditing Meta campaigns or preparing paused creative tests.
Preview, then approval
Creates paused or draft changes first
meta_upload_offline_conversionswrite gatedinternal 1Upload 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.
Auditing Meta campaigns or preparing paused creative tests.
Preview, then approval
Creates paused or draft changes first
meta_update_entitywrite gatedinternal 1Update Meta Entity
General update for a campaign, ad set, or ad: name, status, schedule, bid strategy, targeting, budget, or a CBO ad set's daily spend floor/cap (payload.daily_min_spend / payload.daily_spend_limit, account currency) in one call. Also dsa_beneficiary / dsa_payor and regional_regulated_categories / regional_regulation_identities; adding EU or Australia countries to targeting fills missing ones from the account.
Auditing Meta campaigns or preparing paused creative tests.
Preview, then approval
Creates paused or draft changes first
meta_get_dataset_qualityreadinternal 1Meta Dataset Quality
Read EMQ (event match quality) score, match-key feedback, event coverage, dedup, and freshness for a Pixel/dataset.
Auditing Meta campaigns or preparing paused creative tests.
Runs immediately
No account changes
meta_get_dataset_statsreadinternal 1Meta Dataset Stats
Read Pixel/dataset event statistics with an aggregation such as event_total_counts, event_source, or match_keys.
Auditing Meta campaigns or preparing paused creative tests.
Runs immediately
No account changes
meta_get_dataset_errorsreadinternal 1Meta Dataset Errors
Surface Pixel/CAPI event processing problems and match-quality diagnostics for a dataset.
Auditing Meta campaigns or preparing paused creative tests.
Runs immediately
No account changes
meta_list_catalogsreadinternal 1Meta Catalogs
List product catalogs owned by the connected Business.
Auditing Meta campaigns or preparing paused creative tests.
Runs immediately
No account changes
meta_get_catalog_detailsreadinternal 1Meta Catalog Details
Read one product catalog's name, vertical, and product count.
Auditing Meta campaigns or preparing paused creative tests.
Runs immediately
No account changes
meta_get_catalog_diagnosticsreadinternal 1Meta Catalog Diagnostics
List catalog errors and warnings that block products from ads.
Auditing Meta campaigns or preparing paused creative tests.
Runs immediately
No account changes
meta_list_catalog_productsreadinternal 1Meta Catalog Products
List products in a catalog with price, availability, visibility, and review status.
Auditing Meta campaigns or preparing paused creative tests.
Runs immediately
No account changes
meta_get_product_detailsreadinternal 1Meta Product Details
Read one catalog product's full details including review status.
Auditing Meta campaigns or preparing paused creative tests.
Runs immediately
No account changes
meta_list_product_setsreadinternal 1Meta Product Sets
List product sets in a catalog with product counts and filters.
Auditing Meta campaigns or preparing paused creative tests.
Runs immediately
No account changes
meta_get_product_set_productsreadinternal 1Meta Product Set Products
List the products inside a product set.
Auditing Meta campaigns or preparing paused creative tests.
Runs immediately
No account changes
meta_list_product_feedsreadinternal 1Meta Product Feeds
List catalog data feeds with schedule and latest upload.
Auditing Meta campaigns or preparing paused creative tests.
Runs immediately
No account changes
meta_get_product_feed_detailsreadinternal 1Meta Product Feed Details
Read one data feed's schedule, recent uploads, and latest upload errors.
Auditing Meta campaigns or preparing paused creative tests.
Runs immediately
No account changes
meta_list_ab_testsreadinternal 1Meta A/B Tests
List Meta ad studies (split tests) for the connected Business.
Auditing Meta campaigns or preparing paused creative tests.
Runs immediately
No account changes
meta_create_ab_testwrite gatedinternal 1Create Meta A/B Test
Create a Meta split test (ad study) with named cells over existing campaigns or ad sets.
Auditing Meta campaigns or preparing paused creative tests.
Preview, then approval
Creates paused or draft changes first
meta_get_activity_logreadinternal 1Meta Activity Log
Read the ad account change history (who changed what, when) mirroring Ads Manager activity.
Auditing Meta campaigns or preparing paused creative tests.
Runs immediately
No account changes
meta_get_opportunity_scorereadinternal 1Meta Opportunity Score
Return Meta ad-account recommendations and opportunity signals (Ads Manager optimization guidance equivalent).
Auditing Meta campaigns or preparing paused creative tests.
Runs immediately
No account changes
meta_get_ad_previewreadinternal 1Meta Ad Preview
Render an HTML preview for an ad or creative in a placement format such as DESKTOP_FEED_STANDARD or INSTAGRAM_REELS.
Auditing Meta campaigns or preparing paused creative tests.
Runs immediately
No account changes
meta_insights_performance_trendreadinternal 1Meta Performance Trend
Track CPC, CPM, CTR, spend, conversions, and ROAS over time for campaigns, ad sets, or ads.
Finding real spend, orders, ROAS, and campaign outliers.
Runs immediately
No account changes
TikTok Ads (31)
tiktok_list_campaignsreadinternal 1TikTok Campaigns
List campaigns in a saved TikTok advertiser account. Pass account_id when multiple advertisers are connected; use payload.filtering to narrow results.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
tiktok_list_adgroupsreadinternal 1TikTok Ad Groups
List TikTok ad groups. Pass account_id when needed and payload.filtering for campaign, status, or ID filters.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
tiktok_list_adsreadinternal 1TikTok Ads
List TikTok ads. Pass account_id when needed and payload.filtering for ad-group, status, or ID filters.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
tiktok_fetch_insightsreadinternal 1TikTok Insights
Fetch TikTok reporting for date_from/date_to. Optional payload fields: data_level, dimensions, and metrics.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
tiktok_get_campaign_performancereadinternal 1TikTok Campaign Performance
Return normalized TikTok campaign spend, conversions, CPA, ROAS, and reported revenue for date_from/date_to.
Finding real spend, orders, ROAS, and campaign outliers.
Runs immediately
No account changes
tiktok_get_ad_performancereadinternal 1TikTok Ad Performance
Return normalized TikTok ad-level spend, CTR, CPA, ROAS, and reported revenue for date_from/date_to.
Finding real spend, orders, ROAS, and campaign outliers.
Runs immediately
No account changes
tiktok_analyze_wasted_spendreadinternal 1TikTok Wasted Spend
Find TikTok campaigns above min_spend with zero conversions or ROAS below min_roas.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
tiktok_search_interestsreadinternal 1TikTok Interest Search
Recommend TikTok interest keywords for audience planning from query, optional language, and limit.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
tiktok_create_paused_campaignwrite gatedinternal 1Create Disabled TikTok Campaign
Create a TikTok campaign with operation_status=DISABLE. Pass campaign_name, daily_budget, and optional payload.objective_type or payload.budget_mode.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
tiktok_create_paused_adgroupwrite gatedinternal 1Create Disabled TikTok Ad Group
Create a disabled TikTok ad group. Pass campaign_id, ad_group_name, daily_budget, and targeting or placement fields in payload.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
tiktok_upload_videowrite gatedinternal 1Upload TikTok Video
Upload a video to the TikTok ad library and return its video_id. Pass payload.storage_key from request_video_upload_ticket for a local file, or payload.video_url for a public HTTPS URL.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
tiktok_upload_imagewrite gatedinternal 1Upload TikTok Image
Upload a JPG/PNG to the TikTok ad library and return its image_id. Pass payload.storage_key from request_video_upload_ticket or payload.image_url.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
tiktok_search_videosreadinternal 1TikTok Video Library
List videos in this TikTok advertiser account's own video library (newest first) to recover video_ids. These are the user's own assets, not competitor or public ad-library data. Optional query matches file_name; payload.filtering passes TikTok filters such as video_ids or material_ids.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
tiktok_get_advertiser_inforeadinternal 1TikTok Advertiser Info
Read the TikTok advertiser account: status, balance, currency, timezone, and rejection reason. Use it when ads are approved but nothing spends.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
tiktok_list_pixelsreadinternal 1TikTok Pixels
List TikTok website pixels in this advertiser account: pixel_id, pixel_code, pixel_name, events, and activity status. Optional payload.pixel_code, payload.page, and payload.page_size.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
tiktok_create_pixelwrite gatedinternal 1Create TikTok Website Pixel
Create a TikTok website pixel. Pass payload.pixel_name (max 128 characters), optional payload.pixel_category (default ONLINE_STORE) and payload.partner_name. Returns pixel_id and pixel_code for ttq.load(pixel_code); the Events API access token must be generated in TikTok Events Manager.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
tiktok_create_pixel_eventwrite gatedinternal 1Create TikTok Pixel Event
Create a website event on an existing TikTok pixel so ad groups can optimize for it. Pass payload.pixel_code and payload.optimization_event (for example ON_WEB_REGISTER, INITIATE_ORDER, SHOPPING, ON_WEB_CART); optional payload.event_name (defaults to optimization_event), currency_value, currency, and statistic_type. Needed when a new pixel has no events yet, otherwise tiktok_create_paused_adgroup fails with 'This pixel event type does not exist'.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
tiktok_list_identitiesreadinternal 1TikTok Identities
List TikTok identities (ad profiles) in this advertiser account. Optional payload.identity_type (for example CUSTOMIZED_USER, BC_AUTH_TT, TT_USER), payload.page, and payload.page_size (1-100, default 20). Returns identity_id, identity_type, and display_name for tiktok_create_paused_ad.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
tiktok_create_identitywrite gatedinternal 1Create TikTok Custom Identity
Create a custom TikTok identity (ad display name and avatar). Pass payload.display_name (required, max 40 characters) and optional payload.image_uri (the image_id from tiktok_upload_image). Returns identity_id; use identity_type CUSTOMIZED_USER with it in tiktok_create_paused_ad.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
tiktok_get_ad_review_inforeadinternal 1TikTok Ad Review
Read why TikTok rejected ads: review status and reject reasons/suggestions per ad. Pass ad_id or payload.ad_ids.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
tiktok_get_video_inforeadinternal 1TikTok Video Info
Read TikTok ad-library videos (cover URL, duration, size) by video_id or payload.video_ids.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
tiktok_create_paused_adwrite gatedinternal 1Create Disabled TikTok Ad
Create a disabled TikTok ad under an ad group. Pass adgroup_id, ad_name, and payload.creatives (or flat video_id / image_ids, identity_id, identity_type, ad_text, landing_page_url, call_to_action). When a video creative has no image_ids, its library cover is uploaded and used. The ad is paused right after creation and its id is returned as ad_id.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
tiktok_update_statuswrite gatedinternal 1Update TikTok Status
Enable or disable TikTok campaigns, ad groups, or ads. Pass resource_type, resource_id or resource_ids, and status (ACTIVE/ENABLE or PAUSED/DISABLE).
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
tiktok_update_budgetwrite gatedinternal 1Update TikTok Budget
Update one TikTok campaign or ad-group budget. Pass resource_type, resource_id, and daily_budget.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
tiktok_update_adgroupwrite gatedinternal 1Update TikTok Ad Group
Change an existing TikTok ad group in place. Pass adgroup_id and payload fields such as conversion_bid_price (cost cap), bid_price, budget, adgroup_name, age_groups, operating_systems, location_ids, or dayparting. A cost cap must stay below the daily budget.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
tiktok_duplicate_adgroupwrite gatedinternal 1Duplicate TikTok Ad Group
Copy an ad group's settings and its enabled ads into a new disabled ad group. Pass adgroup_id (source), ad_group_name, and optional payload overrides such as conversion_bid_price, budget, or schedule_start_time (UTC). Copied ads reuse approved creatives; enable the new ad group with tiktok_update_status.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
tiktok_evaluate_stop_lossreadinternal 1TikTok Stop-Loss Check
Check enabled ad groups against funnel stop-loss rules and list which to disable. Filter with payload.name_prefix, campaign_id, or payload.adgroup_ids. Default payload.rules: no_add_to_cart_spend 5, no_checkout_spend 10, no_purchase_spend 15, min_cpm 3 and min_ctr 0.5 after 2000 impressions, max_cpa 40 after 45 spend; set a rule to null to skip it.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
tiktok_list_automated_rulesreadinternal 1TikTok Automated Rules
List the advertiser's native TikTok automated rules.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
tiktok_get_automated_rule_resultsreadinternal 1TikTok Automated Rule Results
List recent executions of native TikTok automated rules: which objects were turned off or changed and when.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
tiktok_create_automated_rulewrite gatedinternal 1Create TikTok Automated Rule
Create native TikTok automated rules that TikTok runs server-side (for example, turn off ad groups whose name starts with a prefix after lifetime cost exceeds X with no conversion). Pass payload.rules with name, apply_objects, conditions, actions, notification, and rule_exec_info in TikTok's optimizer/rule/create format.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
tiktok_update_automated_rulewrite gatedinternal 1Update TikTok Automated Rule
Replace native TikTok automated rules. Pass payload.rules, each with rule_id and the full rule definition.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
Shopify (42)
shopify_get_store_inforeadinternal 0Shopify Store Info
Get Shopify store metadata.
Connecting store data, product pages, landing pages, or A/B tests.
Runs immediately
No account changes
shopify_get_shipping_coveragereadinternal 0Shopify Shipping Coverage
List the countries the store can ship to (checkout-enabled), and check payload.countries (ISO codes) for gaps before targeting ads there. Includes shipping zones and rates when the read_shipping scope is granted.
Connecting store data, product pages, landing pages, or A/B tests.
Runs immediately
No account changes
shopify_list_productsreadinternal 1Shopify Products
List Shopify products.
Connecting store data, product pages, landing pages, or A/B tests.
Runs immediately
No account changes
shopify_get_product_contextreadinternal 1Shopify Product Context
Fetch product, variant, media, and inventory context.
Connecting store data, product pages, landing pages, or A/B tests.
Runs immediately
No account changes
shopify_list_ordersreadinternal 1Shopify Orders
List Shopify orders.
Connecting store data, product pages, landing pages, or A/B tests.
Runs immediately
No account changes
shopify_get_analyticsreadinternal 1Shopify Analytics
Calculate orders, gross sales, AOV, daily trends, and UTM source/medium/campaign attribution from order data.
Connecting store data, product pages, landing pages, or A/B tests.
Runs immediately
No account changes
shopify_list_collectionsreadinternal 1Shopify Collections
List Shopify collections.
Connecting store data, product pages, landing pages, or A/B tests.
Runs immediately
No account changes
shopify_create_collectionwrite gatedinternal 1Create Shopify Collection
Create a manual or rule-based Shopify collection.
Connecting store data, product pages, landing pages, or A/B tests.
Preview, then approval
Creates paused or draft changes first
shopify_update_collectionwrite gatedinternal 1Update Shopify Collection
Update a Shopify collection's title, description, SEO, template, or rules.
Connecting store data, product pages, landing pages, or A/B tests.
Preview, then approval
Creates paused or draft changes first
shopify_update_collection_productswrite gatedinternal 1Update Collection Products
Add or remove products from a manual Shopify collection.
Connecting store data, product pages, landing pages, or A/B tests.
Preview, then approval
Creates paused or draft changes first
shopify_list_pagesreadinternal 1Shopify Pages
List Shopify pages.
Connecting store data, product pages, landing pages, or A/B tests.
Runs immediately
No account changes
shopify_get_pagereadinternal 1Get Shopify Page
Read a complete Shopify page, including its HTML/Liquid body.
Connecting store data, product pages, landing pages, or A/B tests.
Runs immediately
No account changes
shopify_create_page_draftwrite gatedinternal 1Create Shopify Page Draft
Create an unpublished Shopify page draft.
Connecting store data, product pages, landing pages, or A/B tests.
Preview, then approval
Creates paused or draft changes first
shopify_create_pagewrite gatedinternal 1Create Shopify Page
Compatibility alias for shopify_create_page_draft. Always creates an unpublished Shopify page.
Connecting store data, product pages, landing pages, or A/B tests.
Preview, then approval
Creates paused or draft changes first
shopify_delete_pagewrite gatedinternal 1Delete Shopify Page
Delete a Shopify page after approval and return its before snapshot.
Connecting store data, product pages, landing pages, or A/B tests.
Preview, then approval
Creates paused or draft changes first
shopify_create_product_draftwrite gatedinternal 1Create Product Draft
Create a Shopify product as a draft with optional media.
Connecting store data, product pages, landing pages, or A/B tests.
Preview, then approval
Creates paused or draft changes first
shopify_publish_productwrite gatedinternal 1Publish Product
Publish a Shopify product to the online store.
Connecting store data, product pages, landing pages, or A/B tests.
Preview, then approval
Creates paused or draft changes first
shopify_list_blogsreadinternal 1Shopify Blogs
List Shopify blogs for article publishing.
Connecting store data, product pages, landing pages, or A/B tests.
Runs immediately
No account changes
shopify_create_blog_articlewrite gatedinternal 1Create Blog Article
Create a Shopify blog article as draft or published content.
Connecting store data, product pages, landing pages, or A/B tests.
Preview, then approval
Creates paused or draft changes first
shopify_list_themesreadinternal 1Shopify Themes
List Shopify online store themes.
Connecting store data, product pages, landing pages, or A/B tests.
Runs immediately
No account changes
shopify_get_theme_assetreadinternal 1Get Theme Asset
Read a Shopify theme section, template, snippet, or asset.
Connecting store data, product pages, landing pages, or A/B tests.
Runs immediately
No account changes
shopify_build_landing_page_planreadinternal 1Landing Page Plan
Build a reusable Shopify landing page draft plan.
Connecting store data, product pages, landing pages, or A/B tests.
Runs immediately
No account changes
shopify_build_abtest_planreadinternal 1A/B Test Plan
Build a Shopify landing page A/B test and tracking plan.
Connecting store data, product pages, landing pages, or A/B tests.
Runs immediately
No account changes
shopify_get_abtest_webhook_readinessreadinternal 1A/B Webhook Readiness
Verify Shopify order and refund webhook coverage for server-side experiment attribution.
Connecting store data, product pages, landing pages, or A/B tests.
Runs immediately
No account changes
shopify_register_abtest_webhookswrite gatedinternal 1Register A/B Webhooks
Register the Shopify order and refund webhooks required for server-verified experiment attribution.
Connecting store data, product pages, landing pages, or A/B tests.
Preview, then approval
Creates paused or draft changes first
shopify_install_abtest_splitterwrite gatedinternal 1Install A/B Splitter
Install a generic Shopify A/B splitter and tracking snippet.
Connecting store data, product pages, landing pages, or A/B tests.
Preview, then approval
Creates paused or draft changes first
shopify_upsert_theme_assetwrite gatedinternal 1Upsert Theme Asset
Create or update a Shopify theme section/template/snippet asset.
Connecting store data, product pages, landing pages, or A/B tests.
Preview, then approval
Creates paused or draft changes first
shopify_create_product_templatewrite gatedinternal 1Create Product Template
Create or replace a Shopify JSON product template and optionally assign its template suffix to a product. Pass payload.template_json, or payload.source_template_suffix to copy an existing template with optional payload.text_replacements [{find, replace}] (plain text, applied to every string value; each find must match).
Connecting store data, product pages, landing pages, or A/B tests.
Preview, then approval
Creates paused or draft changes first
shopify_duplicate_productwrite gatedinternal 1Duplicate Product
Duplicate a Shopify product (images, description, options, template) as a DRAFT copy, not published to any channel. payload: new_title (required), optional handle, template_suffix, seo_title, seo_description, include_images (default true), and product_options + variants (same shape as shopify_create_product_draft) to replace the copy's variants and prices.
Connecting store data, product pages, landing pages, or A/B tests.
Preview, then approval
Creates paused or draft changes first
shopify_update_product_copywrite gatedinternal 1Update Product Copy
Update Shopify product copy, SEO, or assigned product template suffix. Payload fields are strict snake_case; unknown fields are rejected.
Connecting store data, product pages, landing pages, or A/B tests.
Preview, then approval
Creates paused or draft changes first
shopify_update_productwrite gatedinternal 1Update 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.
Connecting store data, product pages, landing pages, or A/B tests.
Preview, then approval
Creates paused or draft changes first
shopify_set_product_mediawrite gatedinternal 1Set Shopify Product Media
Replace product images: attach new images (HTTPS URL or existing Shopify file_id from direct upload), set the featured image, assign an image to each variant (Google Shopping uses it as that SKU's main image), and detach old images (files stay in Shopify Files). Default is dry_run; use execution_mode=review then approve_action.
Connecting store data, product pages, landing pages, or A/B tests.
Preview, then approval
Creates paused or draft changes first
shopify_upload_filewrite gatedinternal 1Upload Shopify File
Import an HTTPS image, video, or file URL into Shopify Files. Default is dry_run preview only. To create the file: call with execution_mode=review (or confirmed=true / dry_run=false), then approve_action with the pending execution_id.
Connecting store data, product pages, landing pages, or A/B tests.
Preview, then approval
Creates paused or draft changes first
shopify_create_basic_discountwrite gatedinternal 1Create Shopify Discount
Create a percentage or fixed-amount Shopify discount code.
Connecting store data, product pages, landing pages, or A/B tests.
Preview, then approval
Creates paused or draft changes first
shopify_list_discountsreadinternal 1Shopify Discounts
List code and automatic discounts with status, codes, usage counts, and the active window.
Connecting store data, product pages, landing pages, or A/B tests.
Runs immediately
No account changes
shopify_update_discountwrite gatedinternal 1Update Shopify Discount
Activate or deactivate a discount code, or change its title, end date, or usage limit.
Connecting store data, product pages, landing pages, or A/B tests.
Preview, then approval
Creates paused or draft changes first
shopify_list_filesreadinternal 1Shopify Files
List images, videos, and files already hosted in Shopify so they can be reused as ad creative.
Connecting store data, product pages, landing pages, or A/B tests.
Runs immediately
No account changes
shopify_list_locationsreadinternal 1Shopify Locations
List store locations, including which ones ship inventory and fulfill online orders.
Connecting store data, product pages, landing pages, or A/B tests.
Runs immediately
No account changes
shopify_get_inventoryreadinternal 1Shopify Inventory
Read available, on-hand, and committed stock per variant and location.
Connecting store data, product pages, landing pages, or A/B tests.
Runs immediately
No account changes
shopify_adjust_inventorywrite gatedinternal 1Adjust Shopify Inventory
Set an absolute available quantity or apply a relative change for one variant at one location.
Connecting store data, product pages, landing pages, or A/B tests.
Preview, then approval
Creates paused or draft changes first
shopify_update_pagewrite gatedinternal 1Update Shopify Page
Update one Shopify page content field set or its SEO title/description as an independently approved atomic operation.
Connecting store data, product pages, landing pages, or A/B tests.
Preview, then approval
Creates paused or draft changes first
shopify_publish_landing_pagewrite gatedinternal 1Publish Landing Page
Publish a Shopify landing page.
Connecting store data, product pages, landing pages, or A/B tests.
Preview, then approval
Creates paused or draft changes first
WooCommerce (9)
woocommerce_list_productsreadinternal 1woocommerce_list_products
List WooCommerce products with pagination.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
woocommerce_get_productreadinternal 1woocommerce_get_product
Read a WooCommerce product.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
woocommerce_list_variationsreadinternal 1woocommerce_list_variations
Read plug types, bundles and stock variations.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
woocommerce_list_ordersreadinternal 1woocommerce_list_orders
List order summaries without customer address/contact data.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
woocommerce_get_orderreadinternal 1woocommerce_get_order
Read an order summary without customer contact/address data.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
woocommerce_get_analyticsreadinternal 1woocommerce_get_analytics
Summarize paid orders created in a UTC date range, by currency, with refunds. Not profit or payment-date revenue.
Mapping a natural-language agent request to a guarded AdsCove operation.
Runs immediately
No account changes
woocommerce_update_productwrite gatedinternal 1woocommerce_update_product
Preview then require approval to update a product. Variable product prices require variation support and cannot be changed here.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
woocommerce_update_orderwrite gatedinternal 1woocommerce_update_order
Preview then require approval to update order status or customer note. Changing status can trigger customer email and fulfillment. Cannot charge, refund or mark paid.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first
woocommerce_update_variationwrite gatedinternal 1woocommerce_update_variation
Preview then require approval to update one plug/bundle variation price or stock.
Mapping a natural-language agent request to a guarded AdsCove operation.
Preview, then approval
Creates paused or draft changes first