aggregate_metrics
ChatGPTSums Google Ads performance for the account over a date window, as one total or split by date or by campaign. window.start and window.end are YYYY-MM-DD dates, inclusive, covering at most 90 days; a longer period takes several calls. source daily_performance splits by date and campaign_performance by campaign_name. metrics are 1-6 of impressions, clicks, cost_micros (cost in millionths of the account currency), conversions and conversions_value, each with op "sum"; every row also carries ctr, cpa and roas. filters are up to 3 exact matches on the source's own field. sort.field must be one of the requested metrics. limit is 1-100 rows.
compare_periods
ChatGPTCompare account performance between two time periods — spend, clicks, impressions, conversions, CTR, CPA, ROAS — with absolute and percent deltas. Defaults to week-over-week. Use when the user asks "how does this week compare to last week", "MoM", "WoW", "is it better than last month", or any period-over-period question.
get_account_audit
ChatGPTThe cached account-audit snapshot: overall score, counts of critical, warning and passed checks, top diagnostics and wasted spend. The audit is refreshed on a schedule, so this returns the last computed snapshot (currently a 30-day analysis window). When lookback_days is given and differs from the snapshot's window, the result includes window_mismatch and the snapshot's actual window.
get_account_brief
ChatGPTRead the stored account brief with fact status, data freshness and a link to confirm assumptions. No live Google Ads reads or changes.
get_account_summary
ChatGPTFetch headline performance metrics (spend, conversions, ROAS, CTR, CPC) and a per-campaign breakdown for the user's currently selected Google Ads account. Use this when the user asks "how is the account doing", wants a recap, or needs aggregate numbers. Returns money formatted in the account currency.
get_ads
ChatGPTList ads on the account with type, ad strength, every RSA headline and description (untruncated), status, and recent performance. RSA rows also carry headline/description counts, pins, display paths and final URLs. Use when the user asks "what ads are running", "show my ads", wants to spot weak creative, or is investigating low-strength RSAs. Removed ads are excluded.
get_anomalies
ChatGPTList recent unresolved anomalies detected on the account and explain whether this account is configured for monitoring. Use this when the user asks "anything weird going on", "any alerts", "what's broken", or wants a health check. An empty anomaly list is only meaningful when monitoring.account_monitored is true.
get_auction_insights
ChatGPTCompetitive auction insights — your share of voice (impression share, top-of-page rate, click share), impression-share lost to budget vs rank, and a per-campaign breakdown. Use when the user asks about market share, competition, "why am I losing impressions", or wants to know whether to invest more budget. Note: competitor-specific overlap data is not available via the Google Ads API; this returns your own share-of-voice metrics.
get_budget_pacing
ChatGPTPer-campaign budget pacing — daily budget vs recent average daily spend, with a pace ratio so the user can see who is overspending or starving. Each row has a signal: overspending (>1.5×), over_delivering (1.1–1.5×), on_pace, underspending (<0.85×), starving (<0.5×) or no_budget. over_delivering is NORMAL — Google can spend up to 2× a daily budget on a single day and it balances out across the month — so never present it as overspending or a problem. Use when the user asks "how is pacing", "are we hitting budget", "any campaigns overspending", or wants to reallocate budget.
get_campaign_settings
ChatGPTPer-campaign configuration: status, channel type (SEARCH / DISPLAY / SHOPPING / PERFORMANCE_MAX / VIDEO), bidding strategy (TARGET_CPA, TARGET_ROAS, MAXIMIZE_CONVERSIONS, MANUAL_CPC, etc.), target CPA / ROAS values and daily budget. Useful for checking which bid and budget levers a campaign supports.
get_change_history
ChatGPTRecent changes made on the account (budget adjustments, status changes, bid changes), newest first. Useful for "what changed recently" or "why did spend jump". Results are paged: when paging.has_more is true, the next page starts at paging.next_offset. When query_capped is true only the newest 500 events in the window were read. Google Ads keeps change history for 30 days.
get_competitor_review_latest
ChatGPTLoad the latest saved competitor review for this account and return a report block. Use this when the user asks to reopen or revisit the last competitor review.
get_conversion_actions
ChatGPTUse to inspect conversion actions configured on the account: name, category, status, primary-for-goal flag, counting type and default value. This lists configuration only; it does not show whether a tag fired or how many conversions were recorded.
get_devices
ChatGPTCompare performance across devices (mobile, desktop, tablet) — spend, clicks, conversions, CTR, CPA. Use this when the user asks "how is mobile doing vs desktop", wants a device split, or is investigating bid modifiers / device exclusions.
get_disapprovals
ChatGPTDisapproved ads, and optionally ads still under review, with their policy topics. Disapproved ads do not serve, so they reduce coverage. Use for ad approval questions or as part of a health check.
get_feed_audit
ChatGPTUse for Merchant Center feed quality, disapprovals or why a product is not showing: feed score (0-100), spend at risk, the top issues ranked by spend at risk with example products, account-wide issues and freshness. connected:false means Adszy has no Merchant Center data for the account. Reads Adszy's stored product snapshot: a fixed last-30-day window (segments also use days 31-90), refreshed overnight; it does not take start_date or end_date. The result gives the snapshot date. E-commerce accounts only; money is in account currency.
get_google_recommendations
ChatGPTFetch Google Ads' own optimization-score recommendations for the account — keyword adds, audience expansions, bidding-strategy changes, etc. These are the same recommendations shown in the Google Ads UI's Recommendations page. Use this when the user asks "what does Google recommend", "any optimization-score wins", or wants quick low-risk improvements.
get_keywords
ChatGPTThe account's active keywords with performance metrics: spend, clicks, conversions, and quality score where available. Use for keyword-level diagnostics and finding low performers.
get_landing_pages
ChatGPTUse to compare Google Ads landing-page performance by final URL: clicks, conversions, conversion rate and CPA. This does not test whether a page currently loads.
get_locations
ChatGPTGeographic performance breakdown — spend, clicks, conversions, CPA per location. Use this when the user wants to find under/over-performing regions, asks about location targeting, or is considering location exclusions.
get_mcp_usage
ChatGPTShow the current Adszy plan, MCP allowance, remaining calls, and reset date. This does not consume the MCP allowance.
get_negative_keyword_candidates
ChatGPTSearch terms flagged for negative-keyword review, in three groups: Clear mismatch, Needs judgement, and Keep or opportunity. The groups are discovery signals, not proof that a term is irrelevant; Needs judgement terms need the advertiser to confirm exact terms. totals gives search-term spend and zero-conversion spend for the window.
get_product_issues
ChatGPTUse for Merchant Center product serving problems: issues by code with Google's description and spend at risk, not-eligible products, and out-of-stock products still spending. Reads Adszy's stored product snapshot: a fixed last-30-day window (segments also use days 31-90), refreshed overnight; it does not take start_date or end_date. The result gives the snapshot date. E-commerce accounts only; money is in account currency.
get_products
ChatGPTUse for Shopping and Performance Max product performance: totals, hero/sidekick/villain/zombie segments with the reason and ROAS target, and top products by spend, ROAS or conversions. Reads Adszy's stored product snapshot: a fixed last-30-day window (segments also use days 31-90), refreshed overnight; it does not take start_date or end_date. The result gives the snapshot date. E-commerce accounts only; money is in account currency.
get_search_terms
ChatGPTSearch terms people typed, with cost, clicks and conversions, across the whole account rather than a top-spending sample. Use for questions about search terms, wasted spend or what people are searching for. Returns rows (individual terms ranked by sort_by), themes (every matching term grouped by shared phrase, ranked by recoverable spend) and totals. Each theme has a zero_conversion_verdict: converts (the phrase has converted), significant (enough clicks that zero conversions is a real signal) or inconclusive (too few clicks to judge). totals gives search-term spend, clicks, conversions and zero-conversion spend and share across every term examined before filters (totals.matching is the filtered set). It is search-term spend only, not total account spend; when totals.pool_capped is true it covers only the top pool_cap terms by cost.
get_shopping_search_terms
ChatGPTUse for search terms from Shopping and Performance Max campaigns: top terms by cost or conversions and the wasted list (spend, no conversions). Reads Adszy's stored product snapshot: a fixed last-30-day window (segments also use days 31-90), refreshed overnight; it does not take start_date or end_date. The result gives the snapshot date. E-commerce accounts only; money is in account currency.
get_weekly_change_contract
ChatGPTBuild a deterministic weekly account change report.
list_ad_accounts
ChatGPTList the Google Ads accounts connected to this Adszy user and show which account is the MCP default. This does not consume the MCP allowance.
summarize_period
ChatGPTUse for a weekly Google Ads digest or a recent account recap. Returns dated comparison deltas, top campaigns by spend, open anomalies, up to five Google recommendations and negative-keyword candidates for review, with the dates and coverage of each dataset.
aggregate_metrics
Claudecompare_periods
Claudeget_account_audit
Claudeget_account_summary
Claudeget_ads
Claudeget_anomalies
Claudeget_auction_insights
Claudeget_budget_pacing
Claudeget_campaign_settings
Claudeget_change_history
Claudeget_competitor_review_latest
Claudeget_conversion_actions
Claudeget_devices
Claudeget_disapprovals
Claudeget_feed_audit
Claudeget_google_recommendations
Claudeget_keywords
Claudeget_landing_pages
Claudeget_locations
Claudeget_mcp_usage
Claudeget_negative_keyword_candidates
Claudeget_product_issues
Claudeget_products
Claudeget_search_terms
Claudeget_shopping_search_terms
Claudeget_weekly_change_contract
Claudelist_ad_accounts
Claudesummarize_period
Claude
