Google Ads: MCP tool reference
The Valkiria MCP server at https://valkiria.pro/mcp gives a connected assistant 33 tools for accounts, campaigns, ad groups, keywords, negative keywords, ads and budgets in Google Ads. 14 of them only read. The assistant picks the tool itself; this page lists what exists, under the names it reports in its tool calls.
01
Tools that read (14)
These only return data. They are not counted against the monthly allowance.
- google_ads_list_accounts: Google Ads accounts connected to this Valkiria workspace, with the customer id every other google_ads_* tool needs and the access mode the owner set (full, read_only, manual, excluded). Read-only.
- google_ads_campaigns: Campaigns of one Google Ads account, live from Google: status, type, bid strategy, daily budget and impressions, clicks, cost and conversions for the period. Cost and budget are in the account currency.
- google_ads_campaign_structure: One campaign as a tree: ad groups, and under each its ads (responsive search ad headlines, descriptions, final URLs, status) and keywords (text, match type, status, bid). Gives the ids the propose tools take: adGroupId, adId and keywordId.
- google_ads_keywords: Keywords of an account, campaign or ad group with quality score, bid and impressions, clicks, cost and conversions for the period, highest cost first.
- google_ads_search_terms: The real searches that triggered ads (search terms report) for an account, campaign or ad group, with impressions, clicks, cost and conversions, highest cost first. Use it to find new keywords and negative keywords.
- google_ads_wasted_spend: Search terms and keywords that spent money in the period and brought no conversions, highest cost first, with the total. Zero conversions means none were recorded: check google_ads_conversion_actions before calling it waste.
- google_ads_negative_keywords: Negative keywords of one campaign: those set on the campaign itself and those set on its ad groups, with match type and the ids google_ads_propose_remove_negative_keywords needs.
- google_ads_extensions: Ad extensions linked to one campaign and to the whole account: sitelinks, callouts, structured snippets, calls, prices and promotions, with their texts and status.
- google_ads_pmax_asset_groups: Asset groups of Performance Max campaigns (one campaign or the whole account) with status, ad strength, final URLs and their search themes. Gives the assetGroupId the search-theme propose tools take.
- google_ads_campaign_targeting: Where and when one campaign shows: targeted locations and languages (with the criterionId google_ads_propose_remove_targeting takes), excluded locations, the ad schedule and whether it targets presence only.
- google_ads_keyword_ideas: Keyword Planner ideas from seed keywords and/or a landing page URL for one location and language: average monthly searches, competition and the top-of-page bid range in the account currency.
- google_ads_conversion_actions: Conversion actions of the account (name, type, category, status, counting) with whether each recorded conversions in the last 30 days, and the tracking problems found: no enabled action, actions that record nothing, every conversion counted more than once.
- google_ads_account_history: What was changed in the account recently (up to 30 days back): when, through which client (Google Ads UI, API, editor), which kind of resource, the operation and the fields changed, newest first.
- google_ads_impression_share: Search impression share per campaign for the last 30 days, and how much was lost to budget and to ad rank, in percent. Empty values mean Google reported nothing (non-search campaigns, thin data).
02
Tools that change or generate (19)
A change requested through these tools follows the safety rules below: it is a proposal unless the write policy you set for the account allows it.
- google_ads_propose_add_keywords: Propose new keywords for one ad group (text, match type, optional bid in account currency). Keywords the ad group already has are left out. After approval they are added in the chosen status (ENABLED by default, which can start spend). Creates a proposal only: nothing changes in Google Ads until the account owner approves it on the Approvals page. Returns proposal_id and approve_url.
- google_ads_propose_update_keyword: Propose one change to one keyword: a new bid (account currency), pause or enable it, or another match type. Pass exactly one of cpcBid, status, matchType. Google cannot edit a match type, so that one is applied as: create the keyword with the new type, confirm it, remove the old one (its statistics stay with the removed keyword). Creates a proposal only: nothing changes in Google Ads until the account owner approves it on the Approvals page. Returns proposal_id and approve_url.
- google_ads_propose_remove_keywords: Propose removing up to 20 keywords for good. A removed keyword cannot be restored in Google Ads (only added again without its history); to stop a keyword and keep it, pause it with google_ads_propose_update_keyword. Creates a proposal only: nothing changes in Google Ads until the account owner approves it on the Approvals page. Returns proposal_id and approve_url.
- google_ads_propose_add_negative_keywords: Propose negative keywords for a campaign or for one ad group, so ads stop showing on those searches. Negatives already present are left out. Can be undone from the operations history after it is applied. Creates a proposal only: nothing changes in Google Ads until the account owner approves it on the Approvals page. Returns proposal_id and approve_url.
- google_ads_propose_remove_negative_keywords: Propose removing negative keywords from a campaign or an ad group, named by text and match type (see google_ads_negative_keywords). Ads can then show on those searches again, which can raise spend. Can be undone after it is applied. Creates a proposal only: nothing changes in Google Ads until the account owner approves it on the Approvals page. Returns proposal_id and approve_url.
- google_ads_propose_add_pmax_search_themes: Propose search themes for one Performance Max asset group: phrases that tell Google which searches the campaign is for (up to 50 per asset group, 80 characters each). Themes already present are left out. Creates a proposal only: nothing changes in Google Ads until the account owner approves it on the Approvals page. Returns proposal_id and approve_url.
- google_ads_propose_remove_pmax_search_themes: Propose removing search themes from one Performance Max asset group, named by their text (see google_ads_pmax_asset_groups). Creates a proposal only: nothing changes in Google Ads until the account owner approves it on the Approvals page. Returns proposal_id and approve_url.
- google_ads_propose_campaign_status: Propose pausing or enabling one campaign. Enabling can start spend. Can be undone from the operations history after it is applied. Creates a proposal only: nothing changes in Google Ads until the account owner approves it on the Approvals page. Returns proposal_id and approve_url.
- google_ads_propose_ad_group_status: Propose pausing or enabling one ad group. Enabling can start spend. Can be undone from the operations history after it is applied. Creates a proposal only: nothing changes in Google Ads until the account owner approves it on the Approvals page. Returns proposal_id and approve_url.
- google_ads_propose_ad_status: Propose pausing or enabling one ad. Enabling can start spend. Can be undone from the operations history after it is applied. Creates a proposal only: nothing changes in Google Ads until the account owner approves it on the Approvals page. Returns proposal_id and approve_url.
- google_ads_propose_bulk_status: Propose pausing or enabling up to 20 campaigns, ad groups, ads or keywords of one kind at once. One proposal is created per entity, so the owner can approve or reject each and undo each; entities already in that status are skipped. Creates a proposal only: nothing changes in Google Ads until the account owner approves it on the Approvals page. Returns proposal_id and approve_url.
- google_ads_propose_campaign_budget: Propose a new daily budget for one campaign, in the account currency (rounded to the currency's smallest unit). Refused for a budget shared by several campaigns. Raising it raises spend. Can be undone after it is applied. Creates a proposal only: nothing changes in Google Ads until the account owner approves it on the Approvals page. Returns proposal_id and approve_url.
- google_ads_propose_bid_strategy: Propose another bid strategy for one campaign: MAXIMIZE_CLICKS, MAXIMIZE_CONVERSIONS, TARGET_CPA (needs targetCpa in account currency), MAXIMIZE_CONVERSION_VALUE, TARGET_ROAS (needs targetRoas, 4 = 400%) or MANUAL_CPC. A new strategy restarts learning and can change spend. Creates a proposal only: nothing changes in Google Ads until the account owner approves it on the Approvals page. Returns proposal_id and approve_url.
- google_ads_propose_create_ad_group: Propose a new search ad group in one campaign, with an optional default bid in account currency. It is created PAUSED and empty: add keywords and an ad, then enable it with google_ads_propose_ad_group_status. Creates a proposal only: nothing changes in Google Ads until the account owner approves it on the Approvals page. Returns proposal_id and approve_url.
- google_ads_propose_create_search_ad: Propose a responsive search ad for one ad group: 3-15 headlines (30 characters each), 2-4 descriptions (90 each), a final URL and optional display paths (15 each). Texts are never cut: too long is refused. The ad is created PAUSED; enable it with google_ads_propose_ad_status. Creates a proposal only: nothing changes in Google Ads until the account owner approves it on the Approvals page. Returns proposal_id and approve_url.
- google_ads_propose_update_search_ad: Propose replacing the headlines and/or the descriptions of one responsive search ad. Send the full new set (3-15 headlines of 30 characters, 2-4 descriptions of 90): it replaces the current one, and the ad goes through Google review again. Creates a proposal only: nothing changes in Google Ads until the account owner approves it on the Approvals page. Returns proposal_id and approve_url.
- google_ads_propose_add_extensions: Propose ad extensions for one campaign: sitelinks (text 25 characters, URL, optionally both description lines of 35), callouts (25) and structured snippets (a header such as Amenities, Brands, Courses, Degree programs in the campaign language, with 3-10 values of 25). Texts are never cut. Creates a proposal only: nothing changes in Google Ads until the account owner approves it on the Approvals page. Returns proposal_id and approve_url.
- google_ads_propose_add_targeting: Propose more targeted locations (country, region or city names) and/or languages (names or ISO codes) for one campaign. Google resolves the names when the change is applied; a name it cannot resolve is reported, never silently skipped. A wider area can raise spend. Creates a proposal only: nothing changes in Google Ads until the account owner approves it on the Approvals page. Returns proposal_id and approve_url.
- google_ads_propose_remove_targeting: Propose removing targeted locations or languages from one campaign, named by criterionId (see google_ads_campaign_targeting). The last location is never removed: a campaign without one shows worldwide. Creates a proposal only: nothing changes in Google Ads until the account owner approves it on the Approvals page. Returns proposal_id and approve_url.
03
How changes stay safe
- Two scopes, chosen by you at sign-in: read, and propose. With read alone the assistant cannot request any change.
- A change requested from an assistant is a proposal. It waits in Approvals in Valkiria until the account owner approves it, unless the write policy you set for that account allows that kind of change by itself.
- New campaigns are created paused. Starting new spend and deleting always wait for a person.
- The assistant can list what is waiting for approval and reject a proposal. It cannot approve one: approval stays with the owner in Valkiria.
- The change history shows who or what made each change and the value before and after, with Undo where the change can be reversed.
- You can disconnect an assistant at any time on the Connect AI page; a developer API key can be deleted the same way.
04
Limits
- The assistant sees only your own Valkiria workspace, and only the ad accounts connected there.
- Numbers are as fresh as the last sync or import; the assistant can tell you when that was.
- Money stays in each account's own currency. Different currencies are not converted or added up.
- Reading data is not counted against the monthly allowance; changes and AI generations are. Allowances per plan are on the pricing page.
05
FAQ
Connect an assistant and call the first tool
Create a free account, connect an ad account and add the connector. The first pass only reads.