Adplane Google Ads

Name: Adplane Google Ads
Author: adplane

Adplane connects Google Ads to Claude and other MCP clients.

От сообществаРаботаетБез входаГлобальныйБесплатноМожет изменять данные

Что умеет

Ping: Health check: confirms the OAuth connection works end to end.
Google List Accounts: Lists the Google Ads accounts this user has connected, with their IDs, names, currencies, and time zones. Call this first in a conversation to resolve which customer_id to use; d
Google Get Report Schema: Returns the report types (resources) you can query with google_run_report and the exact fields each supports. You MUST call this before using a field you have not already use

Какие данные видит

Нужен ли аккаунт

Не нужен: сервер работает без входа

Adplane connects Google Ads to Claude and other MCP clients. Ask questions in plain language and get answers from live account data, then build and change campaigns in the same conversation. Everything Adplane creates starts paused; nothing spends until you explicitly turn it on. One-click OAuth, no developer token, no setup. 14 day free trial, no card required.

Список инструментов сервера (12)

Технические названия из tools/list. Нужны только разработчикам.

ping	Health check: confirms the OAuth connection works end to end.
google_list_accounts	Lists the Google Ads accounts this user has connected, with their IDs, names, currencies, and time zones. Call this first in a conversation to resolve which customer_id to use; do not guess or reuse IDs from earlier conversations. All monetary values from other tools are reported in each account's currency_code shown here. If the account the user mentions is not listed, tell them to add it at https://adplane.ai/accounts. Do not try other IDs.
google_get_report_schema	Returns the report types (resources) you can query with google_run_report and the exact fields each supports. You MUST call this before using a field you have not already used successfully in this conversation; field names that are not returned by this tool will be rejected. Common resources: campaign, ad_group, keyword_view, search_term_view, ad_group_ad, customer, geographic_view, campaign_budget. For Performance Max: asset_group, campaign_search_term_insight, and performance_max_placement_view.
google_run_report	Runs a read-only report against one Google Ads account. Money fields are returned in the account currency, already converted (never micros). date_range accepts a preset like LAST_30_DAYS or an explicit "2026-06-01..2026-06-30"; the response echoes the exact dates used; always state them when presenting results to the user. Data reflects the account's own time zone and may lag real time by ~3 hours. If results are truncated, either refine with filters or pass the returned cursor to get the next page. Use google_get_report_schema to find valid fields; do not invent field names.
google_run_gaql	Executes a raw GAQL (Google Ads Query Language) SELECT query against the Google Ads API (query language reference: https://developers.google.com/google-ads/api/docs/query/overview). Read-only: mutations are impossible through this tool. Prefer google_run_report unless you need GAQL features it lacks. Same response format as google_run_report, including automatic conversion of *_micros money fields to account currency (column names lose the _micros suffix). Keep queries narrow (explicit date range, LIMIT); oversized results are truncated with a cursor. Use google_get_report_schema for valid fields.
google_update_object	Changes one existing Google Ads campaign, ad group, ad, or keyword. This is the ONLY tool that can start spending: setting status to ENABLED makes the object eligible to serve, so only do it when the user has explicitly asked to launch or resume, and say plainly that it will begin spending. PAUSED stops serving and is reversible. There is no REMOVED status here; nothing this tool does can delete. The changeable fields depend on object_type: a campaign takes name, status, and daily_budget; an ad_group takes name, status, and cpc_bid; an ad takes status only; a keyword takes status and cpc_bid. Money is in the account currency (50 means 50.00, never micros). A campaign on a shared budget is refused for daily_budget, because changing it would change every campaign on that budget. For ads and keywords, object_id can be the composite adGroupId~id form shown in report resource_names; a bare id also works when it is unambiguous. The response is Google's own view of the object after the change, read back from the API, so report those values rather than what was requested.
google_add_negative_keywords	Adds negative keywords to one Google Ads account, at campaign, ad group, or shared-list scope. Negative keywords only restrict where ads show; nothing this tool does can spend money. items is a list of up to 100 objects, each {scope, scope_id, text, match_type}: scope is campaign, ad_group, or shared_list; scope_id is the id of that campaign, ad group, or existing shared negative-keyword list (this tool does not create new lists); match_type is EXACT, PHRASE, or BROAD. Keyword text follows Google's limits (80 characters, 10 words). The batch is applied atomically and charges one operation per item. The response reads the stored negatives back from Google, so report those values rather than what was requested.
google_create_campaign	Creates a new Google Ads Search campaign with its own daily budget. It is ALWAYS created PAUSED and cannot serve or spend until google_update_object enables it, which you should do only when the user explicitly asks to launch. daily_budget is in the account currency (50 means 50.00, never micros). campaign_type is SEARCH (the only supported type). bidding_strategy is MAXIMIZE_CLICKS by default, or MAXIMIZE_CONVERSIONS or MANUAL_CPC. locations is an optional list of two-letter ISO country codes; if you omit it, Google targets ALL locations, and the response says so, so confirm targeting with the user before enabling. Networks default to Google Search only (no search partners, no Display). The campaign is declared as not containing EU political advertising, which Google requires on every create; EU political ads are banned on Google and cannot be created with this tool. After creating, build the structure with google_create_ad_group, google_add_keywords, and google_create_ad. The response is Google's own stored view of the campaign, read back from the API, so report those values.
google_create_ad_group	Creates an ad group inside an existing Search campaign, ALWAYS PAUSED. cpc_bid is an optional default bid for the ad group's keywords, in the account currency (2.5 means 2.50, never micros). Add keywords with google_add_keywords and an ad with google_create_ad; nothing serves until google_update_object enables the campaign, the ad group, and the keywords. The response is Google's own stored view, read back from the API, so report those values.
google_add_keywords	Adds search keywords to an existing ad group. Every keyword is ALWAYS created PAUSED, even when the ad group is already paused: enabling keywords goes through google_update_object one at a time, because that is the only path to spending. keywords is a list of up to 100 objects, each {text, match_type, cpc_bid?}: match_type is EXACT, PHRASE, or BROAD; cpc_bid is optional and in the account currency (never micros). Keyword text follows Google's limits (80 characters, 10 words). The batch is applied atomically and charges one operation per keyword. The response reads the stored keywords back from Google, so report those values.
google_create_ad	Creates a responsive search ad in an existing ad group, ALWAYS PAUSED. This completes the campaign structure but nothing serves until google_update_object enables it, which you should do only when the user explicitly asks to launch. Google's limits are enforced: 3 to 15 headlines of up to 30 characters, 2 to 4 descriptions of up to 90 characters, an absolute http(s) final_url, and optional display paths of up to 15 characters (path2 requires path1). Google mixes headlines and descriptions per query, so write each to stand alone. The response includes the ad's policy approval status read back from Google; policy rejections name the policy topics.
google_remove_campaign	Permanently removes ONE Google Ads campaign that has never spent money, for cleaning up an abandoned scaffold that was never launched. Google has no undo for this: REMOVED is permanent, hides the campaign, and cannot be reversed, so use this only when the user explicitly asks to remove or delete, and prefer pausing (google_update_object with status PAUSED) whenever the campaign might be wanted again. Campaigns only; there is no way to remove ad groups, ads, or keywords with this tool. The campaign must have zero lifetime spend: if it has ever spent, or its spend cannot be read or verified, the removal is refused and you are told to pause instead. Removing a campaign also removes its ad groups, keywords, and ads. The response's confirmed_removed reports whether a follow-up read saw the REMOVED status.