Google Ads tools

Google Ads accounts the connected Google user can access, including client accounts under MCC/manager accounts (id, name, currency, time zone, manager, login_customer_id) and which one is selected. Requires a connected Google Ads account; otherwise returns connected=false, never invented numbers.

This tool takes no parameters.

Google Ads performance (spend, clicks, impressions, conversions, revenue, CTR, CPC, CPA, ROAS) by campaign, ad group, keyword, device, location, hour, day of week, or account (all MCC client accounts ranked). Date range by days or start/end; compare_previous adds the prior period. Requires a connected Google Ads account; otherwise returns connected=false, never invented numbers.

Google Ads performance split by device (mobile, desktop, tablet, connected TV) with CPA and ROAS per device. Requires a connected Google Ads account; otherwise returns connected=false, never invented numbers.

Who changed what and when in the Google Ads account (last 30 days max): user, tool (UI/API), resource, operation and old → new values. Requires a connected Google Ads account; otherwise returns connected=false, never invented numbers.

Google's own optimization recommendations (type, campaign, estimated impact). Apply chosen ones with apply_google_ads_recommendation. Requires a connected Google Ads account; otherwise returns connected=false, never invented numbers.

Keyword Quality Score (1-10) with its components (expected CTR, ad relevance, landing page experience) and spend; summarises low-score keywords and which component drags them down. Requires a connected Google Ads account; otherwise returns connected=false, never invented numbers.

Google Ads Keyword Planner ideas: real average monthly searches, competition and top-of-page bid range for seed keywords or a URL. Requires a connected Google Ads account; otherwise returns connected=false, never invented numbers.

IP exclusions on Google Ads campaigns. Requires a connected Google Ads account; otherwise returns connected=false, never invented numbers.

Ad groups (id, name, status, default CPC) of the Google Ads account or one campaign. Requires a connected Google Ads account; otherwise returns connected=false, never invented numbers.

Shared negative keyword lists in the Google Ads account with keyword counts and attached campaigns. Requires a connected Google Ads account; otherwise returns connected=false, never invented numbers.

Responsive search ads with every headline/description and Google's performance label (LOW/GOOD/BEST), ad strength and final URL. Requires a connected Google Ads account; otherwise returns connected=false, never invented numbers.

Conversion actions of the Google Ads account: type, category, status, primary/secondary, counting, value settings, click-through window. Requires a connected Google Ads account; otherwise returns connected=false, never invented numbers.

This tool takes no parameters.

Performance Max asset groups with ad strength, final URLs and their text/image assets per field type. Requires a connected Google Ads account; otherwise returns connected=false, never invented numbers.

Switch the Google Ads client account all further reads and writes use (agency/MCC: the right login-customer-id is set automatically). Local setting; nothing changes on Google.

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Apply selected Google Ads recommendations (up to 100). Creates an approval item with a preview (current → new); applied to Google Ads only after approval and only with a connected account (dry run otherwise).

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Create a Google Search campaign in one flow: budget, campaign, location + language targeting, bidding strategy, ad group, keywords and responsive search ad (copy defaults to the brand profile). Created PAUSED after approval. Creates an approval item with a preview (current → new); applied to Google Ads only after approval and only with a connected account (dry run otherwise).

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Create a Performance Max campaign: budget + campaign + asset group + text assets + images (downloaded from the given URLs and uploaded) in one atomic request, created PAUSED. Creates an approval item with a preview (current → new); applied to Google Ads only after approval and only with a connected account (dry run otherwise).

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Rename, pause/enable or set/clear the end date of a Google Ads campaign; the preview shows current → new. Creates an approval item with a preview (current → new); applied to Google Ads only after approval and only with a connected account (dry run otherwise).

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Bulk-rename Google Ads campaigns (explicit list, a naming pattern, or find/replace). The preview is an old → new table; names must stay unique. Creates an approval item with a preview (current → new); applied to Google Ads only after approval and only with a connected account (dry run otherwise).

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

PERMANENTLY remove a Google Ads campaign (cannot be undone or re-enabled; history stays in reports). Never auto-applied: always waits for the user's explicit approval. Prefer update_google_campaign(status=pause) when unsure. Creates an approval item with a preview (current → new); applied to Google Ads only after approval and only with a connected account (dry run otherwise).

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Switch a Google Ads campaign's bidding: maximize conversions (optional target CPA), maximize conversion value (optional target ROAS), target CPA, target ROAS, manual CPC, maximize clicks. Creates an approval item with a preview (current → new); applied to Google Ads only after approval and only with a connected account (dry run otherwise).

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Set a Google Ads campaign ad schedule (day/time slots with optional bid adjustment); ads don't serve outside the slots. Creates an approval item with a preview (current → new); applied to Google Ads only after approval and only with a connected account (dry run otherwise).

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Target or exclude locations on a Google Ads campaign; names are resolved with Google's geo target suggestions and shown in the preview. Creates an approval item with a preview (current → new); applied to Google Ads only after approval and only with a connected account (dry run otherwise).

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Safe campaign merge: pause the source campaigns and move their daily budget to the target (Google can't move ad groups between campaigns). Subject to the budget guardrail (max +50% per change); never auto-applied. Creates an approval item with a preview (current → new); applied to Google Ads only after approval and only with a connected account (dry run otherwise).

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Exclude IP addresses (click-fraud protection) from a Google Ads campaign (campaign-level negative IP block, max 500). Creates an approval item with a preview (current → new); applied to Google Ads only after approval and only with a connected account (dry run otherwise).

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Add a search ad group to a Google Ads campaign, optionally with keywords and a responsive search ad. Creates an approval item with a preview (current → new); applied to Google Ads only after approval and only with a connected account (dry run otherwise).

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Pause or enable Google Ads ad groups. Creates an approval item with a preview (current → new); applied to Google Ads only after approval and only with a connected account (dry run otherwise).

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Pause several Google Ads ad groups at once (e.g. zero-conversion groups from google_ads_report breakdown=ad_group). Creates an approval item with a preview (current → new); applied to Google Ads only after approval and only with a connected account (dry run otherwise).

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Add keywords (text, BROAD|PHRASE|EXACT, optional CPC bid) to a Google Ads ad group. Creates an approval item with a preview (current → new); applied to Google Ads only after approval and only with a connected account (dry run otherwise).

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Pause/enable a Google Ads keyword, change its CPC bid, or change its match type (Google requires remove + re-add; done in one atomic request). Creates an approval item with a preview (current → new); applied to Google Ads only after approval and only with a connected account (dry run otherwise).

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Remove negative keywords (matched by text, optionally match type) from a Google Ads campaign or a shared negative list — the undo for a wrong negative. Creates an approval item with a preview (current → new); applied to Google Ads only after approval and only with a connected account (dry run otherwise).

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Add negatives (each with its own match type) to an account-wide shared negative list — or create one — and attach it to campaigns. Existing terms are skipped. Creates an approval item with a preview (current → new); applied to Google Ads only after approval and only with a connected account (dry run otherwise).

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Create a responsive search ad (3-15 headlines ≤30, 2-4 descriptions ≤90, optional pinning) in a Google Ads ad group. Creates an approval item with a preview (current → new); applied to Google Ads only after approval and only with a connected account (dry run otherwise).

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Refresh weak RSA headlines/descriptions: Google doesn't allow editing RSA text, so a new ad is created with the new set and the old one paused, in one request. Preview shows old → new copy. Creates an approval item with a preview (current → new); applied to Google Ads only after approval and only with a connected account (dry run otherwise).

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Add sitelink assets (text ≤25, optional two descriptions ≤35, final URL) to a Google Ads campaign. Creates an approval item with a preview (current → new); applied to Google Ads only after approval and only with a connected account (dry run otherwise).

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Add callout assets (≤25 chars) to a Google Ads campaign. Creates an approval item with a preview (current → new); applied to Google Ads only after approval and only with a connected account (dry run otherwise).

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Create a website conversion action; the result carries the tag snippet to install (e.g. with the Tag Manager tools). Creates an approval item with a preview (current → new); applied to Google Ads only after approval and only with a connected account (dry run otherwise).

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Change a Google Ads conversion action: primary vs secondary (primary_for_goal), status, category, counting, value settings, click-through window. Creates an approval item with a preview (current → new); applied to Google Ads only after approval and only with a connected account (dry run otherwise).

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Add headlines, long headlines, descriptions and images (downloaded from URLs and uploaded) to a Performance Max asset group in one atomic request. Creates an approval item with a preview (current → new); applied to Google Ads only after approval and only with a connected account (dry run otherwise).

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.