Documentation / Tool Reference

Google Ads tools

Secure tools for the Google Ads API: connection, reporting, campaign creation, keyword & bid management, extensions, and recommendations.

Connection & Account · 1

connect_google_adsfree

Generates a one-time authorization link to connect a Google Ads account.

Reporting & Audit · 9

account_audit3 credits

Account hygiene audit: finds wasteful keywords and low Quality Score.

customer_iddaysperiod
get_ad_details1 credits

GOOGLE ADS ONLY — reads the full content of Google Ads ads (RSA headlines/descriptions, URL, status).

customer_idad_group_idad_id
get_change_history2 credits

GOOGLE ADS ONLY — lists Google Ads account changes over the last N days IN DEPTH: who (user_email), from where (client_type), when, operation (CREATE/UPDATE/REMOVE), resource, CHANGED FIELDS, and old→new values.

customer_iddayslimitresource_typeoperation
keyword_planner3 credits

Generates keyword ideas + monthly search volume/competition (defaults to Turkey/Turkish).

customer_idseed_keywordslanguage_idgeo_id
keyword_report2 credits

Keyword performance + Quality Score; flags low QS and zero-conversion spend.

customer_iddaysperiodlimitoffsetinclude_zero_impressions
list_entities1 credits

Lists the entities (campaigns, ad groups/ad sets, ads, keywords) of ANY connected ad platform with their IDs — use this instead of looking for a platform-specific list tool.

customer_identitylimitoffsetplatformaccountparent_id
list_recommendations2 credits

Lists Google's campaign recommendations + optimization score, WITH PROJECTED IMPACT (estimated +conversions / +clicks / +cost if the recommendation is applied).

customer_idrec_typeinclude_dismissedlimit
performance_report2 credits

Performance report (cost, clicks, impressions, conversions).

customer_iddayslevelsegmentperiodlimitoffset
search_terms_report2 credits

Search terms report.

customer_iddaysmin_wasteperiodsortmin_clickslimit

Campaign · 9

create_app_campaign8 credits

Creates an App (UAC) campaign (PAUSED).

customer_idnamedaily_budgetapp_idapp_storetarget_cpaconfirm
create_demand_gen_campaign8 credits

Creates a Demand Gen campaign (PAUSED) + a daily budget.

customer_idnamedaily_budgetbid_strategytarget_cpaconfirm
create_pmax_campaign10 credits

Creates a Performance Max campaign (PAUSED): budget + campaign + asset group + text and image assets.

customer_idnamedaily_budgetfinal_urlbusiness_nameheadlineslong_headlinesdescriptionsmarketing_image_assetssquare_image_assetslogo_assetsconfirm
create_search_campaign8 credits

Creates a new Search campaign (starts PAUSED for safety) + daily budget.

customer_idnamedaily_budgetlocationslanguagessearch_partnerspresence_onlybusiness_namelogo_asset_idconfirm
get_campaign_targeting1 credits

Reads a campaign's CURRENT targeting: location (geo), radius/proximity targeting (radius + units + lat/lng), language, device, and audience (user_list) criteria + negative (excluded) ones — plus the campaign's geo_target_type (PRESENCE = pe

customer_idcampaign_id
pause_campaign5 credits

Pauses a campaign.

customer_idcampaign_idconfirm
set_campaign_budget5 credits

Sets a campaign's daily budget.

customer_idcampaign_iddaily_amountconfirm
set_campaign_targeting5 credits

Sets geographic and language targeting on a campaign.

customer_idcampaign_idlocationsnegative_locationslanguagesmodeconfirm
update_campaign_status5 credits

Turns a Google Ads campaign ON or OFF: status 'ENABLED' to enable / resume / unpause / reactivate / start serving a paused campaign again, or 'PAUSED' to pause / stop / turn it off.

customer_idcampaign_idstatusconfirm

Ad group & Ad · 13

add_pmax_images5 credits

Attaches IMAGES to a Performance Max asset group (required for the campaign to be eligible to run).

customer_idasset_group_idmarketing_image_assetssquare_image_assetslogo_assetsconfirm
create_ad_group5 credits

Creates a new AD GROUP inside a Google Ads campaign — the layer between the campaign and its keywords/ads.

customer_idcampaign_idnamecpc_bidconfirm
create_responsive_search_ad8 credits

Adds a Responsive Search Ad (RSA) to an ad group.

customer_idad_group_idfinal_urlheadlinesdescriptionsheadline_pinsdescription_pinspath1path2final_mobile_urltracking_url_templatestatusconfirm
get_pmax_assets1 credits

Reads a Performance Max ASSET GROUP: its creative content (headlines/descriptions, images, videos) AND its SIGNALS — the audience signal and the search themes that actually steer the campaign.

customer_idasset_group_idsignals
list_assets2 credits

Lists the account's ASSET LIBRARY ("Öğeler" / Assets) — ALL asset types across the whole account (not just one campaign): sitelinks, callouts, structured snippets, calls, IMAGES, promotions, prices, lead forms, and text assets.

customer_idasset_typelimitinclude_usage
rsa_asset_performance2 credits

RESPONSIVE SEARCH AD (RSA) asset report — per HEADLINE and DESCRIPTION: impressions, clicks, cost, conversions, conversion value, cost per conversion, conversion rate and CTR, plus each ad's Ad Strength.

customer_idcampaign_iddayslimitmin_impressions
update_ad_group5 credits

Rename a Google Ads AD GROUP and/or change its default max CPC bid.

customer_idad_group_idnamecpc_bidstatusconfirm
update_ad_group_status5 credits

Turns a Google Ads AD GROUP on or off: status 'ENABLED' to enable / resume / unpause / reactivate the group, or 'PAUSED' to pause / stop / turn off a whole ad group at once.

customer_idad_group_idstatusconfirm
update_ad_status5 credits

Turns a single Google Ads AD on or off, or DELETES it: status 'ENABLED' to enable / publish / resume / unpause an ad, 'PAUSED' to pause / stop it, 'REMOVED' to delete it for good.

customer_idad_group_idad_idstatusconfirm
update_pmax_assets5 credits

Adds AND removes text assets in an existing Performance Max asset group.

customer_idasset_group_idheadlineslong_headlinesdescriptionsremove_resource_namesconfirm
update_rsa5 credits

EDITS the copy of an existing Google Ads RESPONSIVE SEARCH AD (RSA) in place — swap, drop or add a headline or description while keeping the SAME ad and its performance history.

customer_idad_idheadlinesdescriptionsfinal_urlpath1path2headline_pinsdescription_pinsremove_headlinesadd_headlinesremove_descriptionsadd_descriptionsconfirm
upload_imagefree

Turns an image into a public image URL you can pass to any tool that needs one (gbp_create_post image_url, gbp_upload_photo, upload_image_asset, upload_meta_image...).

ticketimage_base64filenamesource_url
upload_image_asset3 credits

Uploads an image to the Google Ads asset library → returns the asset resource_name.

customer_idimage_urlnameconfirm

Keywords & Negatives · 11

add_keywords5 credits

ADD POSITIVE KEYWORDS to a Google Ads ad group (bulk) — the keywords your ads should SHOW for.

customer_idad_group_idkeywordsmatch_typeconfirm
add_negative_keyword5 credits

Adds negative keywords at CAMPAIGN or AD GROUP level (to stop wasted spend) — ONE keyword or a WHOLE BATCH in a single call.

customer_idcampaign_idtextmatch_typeconfirmad_group_idkeywordsskip_existing
get_shared_negative_listfree

Reads the actual NEGATIVE KEYWORDS inside a shared negative keyword list (shared set).

customer_idshared_set_idlimit
keyword_opportunities2 credits

Keyword OPPORTUNITIES — from the customer's OWN search-term + keyword data (does NOT require Keyword Planner approval, works with existing access): (1) search terms that converted but aren't added as keywords → ADD (expansion); (2) keywords

customer_iddaysmin_waste
keyword_quality_report2 credits

Google Ads keyword QUALITY SCORE OVER TIME — for diagnosing WHEN a Quality Score dropped and WHICH component caused it.

customer_idad_group_iddayslimit
list_negative_keywords1 credits

Lists ALL negative keywords that apply to the account: ad-group level, campaign level AND the SHARED negative keyword lists (Shared Library) attached to campaigns.

customer_idcampaign_id
list_shared_negative_listsfree

Lists the account's SHARED negative keyword lists (Shared Library → "Negative keyword lists" / shared sets, type NEGATIVE_KEYWORDS) — the account-level lists that list_negative_keywords CANNOT see (it only covers campaign/ad-group level).

customer_id
manage_keywords5 credits

PAUSE / ENABLE / REMOVE an EXISTING Google Ads keyword, or change its max CPC bid.

customer_idad_group_idcriterion_idsactioncpc_bidconfirm
manage_shared_negative_listfree

Manages SHARED negative keyword lists (Shared Library, account-level — the lists list_shared_negative_lists reads).

customer_idactionshared_set_idnamekeywordscampaign_idconfirm
remove_negative_keyword5 credits

Removes CAMPAIGN-level negative keywords (the undo of add_negative_keyword) — one or a WHOLE BATCH in a single call.

customer_idcampaign_idcriterion_idconfirmcriterion_idskeywords
smart_negative_keywords2 credits

SMART NEGATIVE KEYWORD suggestions — finds SEARCH TERMS that trigger the ad and spend MONEY but bring NO CONVERSIONS, ranked by estimated savings.

customer_iddaysmin_wastelimit

Optimization · 23

apply_recommendation5 credits

Applies or dismisses Google recommendations.

customer_idresource_namesactionconfirm
conversion_tracking_health2 credits

Conversion tracking health — audits conversion actions: paused/removed, and zero recorded data over the lookback window.

customer_iddays
dismiss_recommendations2 credits

Dismisses one or more Google Ads recommendations.

customer_idresource_namesconfirm
get_ad_schedule1 credits

Reads a campaign's CURRENT ad schedule (day/hour blocks + minutes + bid modifier + criterion_id).

customer_idcampaign_id
get_conversion_settings1 credits

Reads the SETTINGS detail of conversion actions: category, counting type (every/one), click/view-through lookback window (days), attribution model, default value/currency, and whether it's primary for the goal.

customer_id
get_conversion_tags1 credits

Reads the Google Ads tag info for conversion actions: Conversion ID (AW-...) + label — the 'send_to' value needed for GTM / gtag (Google tag) setup.

customer_idconversion_action_ids
list_ad_extensions1 credits

Reads the extension assets LINKED to a campaign (sitelink / callout / structured snippet / call / promotion / price).

customer_idcampaign_id
list_conversion_actions2 credits

Lists Google Ads CONVERSION ACTIONS with the columns of the Goals > Conversions > Summary table: name, id, category (Request quotes / Submit lead forms / Sign-ups / Contacts / Page views…), status, type, whether it is INCLUDED in the Conver

customer_iddays
list_conversion_goals1 credits

Lists Google Ads CONVERSION GOALS — the modern lever that decides which conversion CATEGORY is PRIMARY (biddable: counted in the Conversions column + feeds Smart Bidding) vs SECONDARY.

customer_idcampaign_id
list_custom_conversion_goals1 credits

Lists the CUSTOM conversion goals of a Google Ads account — the named bundles of conversion actions that campaigns can optimise for, with the actions inside each one and the campaigns using it.

customer_id
list_extension_assets1 credits

Lists a campaign's CURRENT extension assets (sitelinks, callouts, call, structured snippets, promotions, prices, app, hotel callout, lead form) with the asset id and the resource_name needed to remove each one.

customer_idcampaign_id
manage_bidding_strategies5 credits

Changes a campaign's bidding strategy.

customer_idcampaign_idstrategytarget_cpatarget_roasmax_cpcimpression_share_locationimpression_share_percentconfirm
manage_conversion_actions5 credits

Creates a new conversion action.

customer_idnamecategorydefault_valuetypephone_call_durationconfirm
manage_extension_assets5 credits

Adds extension assets to a campaign.

customer_idcampaign_idcalloutssitelinksphone_numberphone_countrysnippet_headersnippet_valuespromotionslink_asset_idslink_field_typeconfirm
manage_portfolio_bidding_strategy5 credits

Creates, updates, lists and assigns PORTFOLIO (shared) bidding strategies — Google Ads' Shared library → Bid strategies.

customer_idactionnamestrategymax_cpcmin_cpctarget_cpatarget_roascampaign_idbidding_strategy_idimpression_share_locationimpression_share_percentconfirm
remove_extension_assets3 credits

Removes (unlinks) extension assets from a campaign — the 'remove' counterpart to manage_extension_assets (e.g.

customer_idcampaign_idresource_namesfield_typeconfirm
set_ad_schedule5 credits

Sets a campaign's ad schedule (day/hour) — 'run only during business hours', or 'bid 50% less at night'.

customer_idcampaign_idschedulemodebid_modifier_pctconfirm
set_conversion_settings5 credits

Edits a conversion action's VALUE/COUNTING settings — only the fields you provide change: default_value (+ default_currency_code, e.g.

customer_idconversion_action_iddefault_valuedefault_currency_codealways_use_default_valuecounting_typeclick_lookback_daysview_lookback_daysphone_call_durationconfirm
update_conversion_action5 credits

Makes a conversion action PRIMARY/SECONDARY (primary_for_goal).

customer_idconversion_action_idroleconfirm
update_conversion_goal5 credits

Makes a conversion CATEGORY primary or secondary — the CORRECT lever for Smart Bidding in a goal-based account.

customer_idcategoryoriginrolecampaign_idconfirm
update_custom_conversion_goal5 credits

Edits a CUSTOM conversion goal: change which conversion actions it contains, rename it, or delete it.

customer_idgoal_idconversion_actionsnameremoveconfirm
upload_conversion_adjustmentsfree

ADJUSTS conversions you already reported — the refund/cancellation half of the closed loop.

customer_idconversion_actionadjustmentscurrency_codeconfirm
upload_offline_conversionsfree

UPLOADS OFFLINE CONVERSIONS to Google Ads — the closed loop between your CRM and your ads.

customer_idconversion_actionconversionscurrency_codeconfirm

Account health & Alerts · 2

budget_pacing_alerts2 credits

BUDGET PACING — projects this month's spend against the daily budget; flags campaigns that will OVERspend (over) or UNDERspend (under) by month-end.

customer_idthreshold_pct
impression_share_analysis2 credits

IMPRESSION SHARE analysis — for Search campaigns, your impression share, top-of-page and absolute-top share, exact-match share, and whether the loss is due to BUDGET or RANK (bid/quality) + DISAPPROVED (blocked) ads.

customer_iddayslevel

Audiences & Campaign settings · 7

create_customer_match_audience5 credits

Customer Match audience — creates an EMPTY list shell.

customer_idnamemembership_daysupload_key_typeconfirm
create_lookalike_audience5 credits

Creates a Lookalike audience from seed audiences.

customer_idnameseed_user_list_idscountry_codesexpansion_levelmembership_daysconfirm
create_website_audience5 credits

Creates a rule-based remarketing audience from website visitors (by page URL).

customer_idnameurl_containsmembership_dayslookback_daysstring_operatorconfirm
list_audiences1 credits

Lists the account's audiences (remarketing / rule-based / customer-match / lookalike): id, name, type, membership status, membership duration (days), Display/Search network size.

customer_idlimitdefinition
list_experiments1 credits

Lists AND ends campaign experiments (A/B tests).

customer_idactionexperiment_idconfirm
manage_audience_targetingfree

ATTACHES an audience to a campaign or ad group (or removes it) — the missing link that makes your audience lists actually do something.

customer_idaudiencecampaign_idad_group_idactionmodebid_modifierconfirm
manage_campaign_settings3 credits

Campaign-level settings, plus tracking-template reading: • geo_target_type: 'PRESENCE' (those PRESENT in the target location) | 'PRESENCE_OR_INTEREST' (also those interested).

customer_idcampaign_idgeo_target_typesearch_partnersdisplay_expansiontracking_url_templateconfirm

Agency reports & Competitor analysis · 1

competitor_ads1 credits

Competitor AD intelligence — fetches a brand's/domain's LIVE ads from public ad libraries.

queryplatformregionlimit

Other

call_write_toolfree

Run a WRITING Opus tool by name (create / update / pause / remove) — the gateway to every write capability that is not in your visible core set.

namearguments
connect_business_profilefree

Generates an authorization link to connect Google Business Profile (My Business) — editing business info/hours/website, publishing posts, and replying to reviews.

connect_ga4free

Generates a one-time authorization link to connect Google Analytics 4.

connect_search_consolefree

Generates a one-time authorization link to connect Google Search Console (organic search queries/clicks/impressions/position + sitemap management + URL index inspection).

connect_tag_managerfree

Generates a one-time authorization link to connect Google Tag Manager (full A-to-Z management: accounts/containers/workspaces, tags/triggers/variables, versioning + PUBLISH).

connect_youtubefree

Generates a one-time authorization link to connect YouTube (channel + video performance: views, watch time, subscribers, traffic sources — read-only).

create_google_ads_account5 credits

Creates a NEW Google Ads client account under a manager (MCC) account — for agencies onboarding a client without leaving the chat.

manager_customer_idnamecurrency_codetime_zonetracking_url_templateconfirm
create_lead_form5 credits

Creates a Google Ads LEAD FORM — the form that opens INSIDE the ad, so someone can leave their name and phone number without ever reaching the website — and optionally attaches it to a campaign or ad group in the same call.

customer_idbusiness_nameheadlinedescriptionprivacy_policy_urlctacta_descriptionfieldsquestionspost_submit_headlinepost_submit_descriptionpost_submit_ctafinal_urlwebhook_url
describefree

Explains what the unified read tools can do: with no argument it lists every platform get_report / list_entities support; with a platform it returns that platform's account-id field, the row levels and the breakdown dimensions it accepts, p

platform
get_report2 credits

ONE report tool for EVERY connected platform — use this for any "how did X perform" question instead of hunting for a platform-specific report tool.

platformaccountdayslevelbreakdownstart_dateend_datelimit
list_ad_policy_issues2 credits

Google Ads ad POLICY / DISAPPROVAL report — which ads were DISAPPROVED or limited, and WHY.

customer_idonly_problemslimit
list_lead_form_submissions2 credits

Reads the LEADS people submitted through a Google Ads lead form — name, phone, email and the answers to your qualifying questions — so they can be worked without opening the Google Ads interface.

customer_iddaysasset_idlimit
manage_campaign_proximityfree

Manage a campaign's PROXIMITY (radius / lat-lng circle) targeting — the radius targets that get_campaign_targeting reads but set_campaign_targeting CANNOT change.

customer_idcampaign_idactionlatlngradiusunitscriterion_idpointsconfirm
manage_device_targetingfree

Set a campaign's per-DEVICE bid adjustment — the WRITE side of the device criteria that get_campaign_targeting reads.

customer_idcampaign_iddevicebid_modifier_pctconfirm
select_google_resourcefree

Switches WHICH single Google resource this account works on: a Business Profile location, a Search Console property, a GA4 property, a YouTube channel or a Tag Manager container.

serviceresourceconfirm
set_call_reporting3 credits

Turns account-level CALL REPORTING on/off — the prerequisite for Google to track phone calls from ads as conversions.

customer_idcall_reportingcall_conversionconfirm
update_pmax_asset_groupfree

Updates — or REMOVES — a Performance Max ASSET GROUP itself (not its individual assets): landing page (final_url), name, status and the display path segments path1/path2.

customer_idasset_group_idfinal_urlnamestatuspath1path2confirm
update_sitelinkfree

Edits an EXISTING sitelink in place: change its link text, its two DESCRIPTION lines, or the page it points to, without deleting and recreating it.

customer_idasset_idlink_textdescription1description2final_urlconfirm