Returns the ids of Google Ads accounts directly accessible by the authenticated user.

Use this tool first to discover available customer IDs if the user hasn't provided one. Most other tools require a valid customer ID.

Returns: List[str]: A list of customer IDs (10-digit strings, no dashes).

Lists all client accounts under a (manager) account, including the account itself.

Useful when the authenticated user works through an MCC/manager account: run this against the manager's customer ID to find the child account IDs to use with reporting and management tools.

Lists the account's conversion actions with category, type, status, and whether each is primary for optimization (primary_for_goal).

Use this to check what Smart Bidding is actually optimizing toward — e.g. whether phone calls are primary and page-view style actions are secondary.

Lists a campaign's targeting criteria: locations, proximity radii, ad schedules, devices, and negative criteria.

Resolves human-readable location names (e.g. 'Phoenix, Arizona', 'Gilbert, Arizona') to Google Ads geo target constant IDs, for use with add_location_targeting.

Retrieves the selectable, filterable, and sortable fields for a specific Google Ads resource, including compatible metrics and segments.

Use this tool to find out which fields you can select, filter by, or sort by when querying a specific resource (e.g., 'campaign', 'ad_group') with the search tool. Metric and segment field names start with 'metrics.' and 'segments.' respectively.

Do not guess fields — use this tool to discover them before constructing a query. Responses can be cached; they rarely change.

Campaign-level performance report: impressions, clicks, CTR, cost, conversions, conversion value, plus campaign status, bidding strategy and daily budget. Ordered by cost, highest first.

Cost and budget fields are in micros: divide by 1,000,000 for the account currency amount.

Ad-group-level performance report with the core metrics (impressions, clicks, CTR, cost, conversions). Ordered by cost.

Keyword-level performance report: keyword text, match type, status, quality score, and the core metrics. Ordered by cost, highest first.

Search terms report: the actual user queries that triggered ads, with the core metrics. The main input for finding negative keyword candidates and new keyword opportunities. Ordered by cost.

Recent changes made to the account (by users, tools, or this server): what changed, when, and by whom. Useful for a weekly review of account activity.

Fetches data from the Google Ads API using the search method.

Creates a standard search ad group (ENABLED) in a campaign.

Updates an ad group's status and/or default max CPC bid.

Creates a responsive search ad in PAUSED state (enable it with set_ad_status after review).

Pauses, enables, or removes an ad.

Creates a call asset (clickable phone number shown with ads). Returns its resource name; attach it to a campaign with link_asset_to_campaign.

Links an asset (e.g. a call asset) to a campaign so it serves with that campaign's ads.

Creates a daily campaign budget. Returns its resource name, which is required when creating a campaign.

Changes the daily amount of an existing campaign budget.

Find the budget id via the search tool (campaign_budget.id) or from a campaign's campaign.campaign_budget resource name.

Creates a new campaign in PAUSED state (so it never spends money before a human reviews and enables it). Create a budget first with create_campaign_budget.

Sets (or updates) the target CPA on a campaign that uses the Maximize Conversions bidding strategy.

Only do this once the campaign has ~30+ conversions of history; setting a tCPA too early or too low throttles delivery.

Pauses, enables, or removes a campaign.

Marks a conversion action as primary (optimized toward by Smart Bidding) or secondary (observed/reported only).

This is the main lever for making campaigns optimize toward real outcomes (e.g. phone calls) instead of soft actions (page views, direction clicks). Find ids with list_conversion_actions.

Note: some system-generated conversion actions cannot be edited via the API; the error will say so if this one can't.

Overrides, per campaign, which conversion goals Smart Bidding optimizes toward — regardless of the account-level primary/secondary settings.

Use this when account-level conversion actions can't be edited (e.g. system-generated "Local actions") but a campaign must optimize only to real outcomes such as phone calls. This switches the campaign to campaign-level goal configuration and sets each listed goal's biddable flag; include every category/origin combination that exists in the account, marking the ones to optimize toward biddable=true and the rest biddable=false.

Adds keywords to an ad group (ENABLED).

Pauses, enables, or removes a keyword.

Find criterion ids with get_keyword_performance (ad_group_criterion.criterion_id).

Adds campaign-level negative keywords, preventing ads from showing on those queries. The usual follow-up to reviewing get_search_terms_report.

Adds location targeting criteria to a campaign.

Resolve human-readable places to ids first with suggest_geo_targets.

Removes a single targeting criterion (e.g. a wrong location or an obsolete ad schedule) from a campaign.

Find criterion ids with list_campaign_criteria. Removing a criterion only changes targeting; it does not touch ads, keywords, or budgets.

Adds ad schedule criteria to a campaign (which days/hours ads run).

A campaign with no ad schedule runs 24/7. Once any schedule entries exist, ads run ONLY during the scheduled windows — so include every window you want covered. Hours are in the account's time zone.