Skip to main content
Glama

Server Details

Connect Google Analytics 4, Google Ads and Search Console to Claude in two minutes. Hosted MCP server with Google OAuth: no Cloud project, no keys, nothing to install.

Ownership verified
Status
Healthy
Uptime
100.0% over the last 24 hours
OAuth
Works in Glama
Last Tested
Transport
Streamable HTTP · MCP 2025-11-25
URL
ChatGPT
–
Claude
Caybl.ai

TDQS

A3.6/5.0

Scored across 103 tools

Disambiguation4/5

Despite 103 tools, boundaries are unusually well drawn: platform prefixes (msads_, gtm_) plus explicit cross-references in descriptions separate near-pairs like add_negative_keywords vs add_ad_group_negative_keywords, update_campaign vs update_campaign_status, and get_campaigns vs get_campaign_criteria. The residual risk is that the Google Ads surface is unprefixed while GA4/GSC/PageSpeed are also unprefixed, so similarly named tools (add_keywords vs msads_add_keywords, get_campaign_performance vs msads_get_campaign_performance) rely on the reader noticing the prefix.

Naming Consistency3/5

Microsoft Ads and GTM tools use a clean, predictable platform prefix, and the Google Ads tools are consistently verb_noun (create_campaign, update_keyword, add_sitelinks). But the convention breaks down across the rest of the surface: run_report, pagespeed_audit, inspect_url, find_zero_visibility_pages, gtm_container_overview mix verb_noun, noun_verb, and bare-noun forms, and the unprefixed namespace ambiguously means 'Google' rather than one product.

Tool Count2/5

103 tools is far beyond what an agent can navigate reliably in one selection step, even granting that the server spans six real product surfaces (Google Ads, Microsoft Ads, GA4, Search Console, PageSpeed, GTM). Per-platform depth is legitimate, but the aggregate set is heavy enough that tool selection, not capability, becomes the limiting factor; splitting by platform would be the natural fix.

Completeness4/5

Coverage is genuinely broad: full create/read/update/status lifecycles for campaigns, budgets, ad groups, keywords and ads on both ad platforms, plus conversion tracking, extensions, targeting, GA4 reporting/funnels/realtime, GSC analytics and inspection, CrUX history, and GTM draft-and-publish. Minor asymmetries exist — Microsoft Ads gets keyword-level performance and bid adjustments while Google Ads has no equivalent keyword performance tool, and run_gaql_report is the documented escape hatch for anything else.

Available Tools

103 tools
add_ad_group_negative_keywordsAdd negative keywords to one ad groupAInspect

Add negative keywords scoped to a single ad group, not the whole campaign - use this when a search term is wasteful for one ad group's theme but still relevant to another in the same campaign. For a term that's wasteful everywhere, add_negative_keywords (campaign-level) is fewer calls.

Inputs: keywords (required), adGroupId (required), customerId, extraFields, +1 more.

add_calloutsAdd callout extensions to a campaignAInspect

Add callouts (short trust/feature snippets shown under the ad, e.g. 'Read-only access', 'No card required') to a campaign. Free, and typically raises CTR/Quality Score the same way sitelinks do. Creates the assets and links them to the campaign in one atomic mutate, same as add_sitelinks.

Inputs: callouts (required), campaignId (required), customerId, extraFields, +1 more.

add_keywordsAdd keywords to an ad groupAInspect

Add positive keywords to an ad group. Match type matters: BROAD reaches widest and spends fastest, PHRASE is narrower, EXACT is tightest. Added PAUSED by default.

Inputs: keywords (required), adGroupId (required), status, customerId, +2 more.

add_negative_keywordsAdd negative keywords to a campaignAInspect

Add campaign-level negative keywords, which stop ads showing for those searches. This only ever reduces reach and spend, so it is the safest write tool here and the usual first response to wasteful search terms found via get_search_terms.

Inputs: keywords (required), campaignId (required), customerId, extraFields, +1 more.

create_ad_groupCreate an ad groupBInspect

Create a Search ad group inside a campaign. Created PAUSED by default. cpcBid is the default max CPC for keywords in this group, in account currency.

Inputs: name (required), campaignId (required), cpcBid, status, +3 more.

create_campaignCreate a Search campaignAInspect

Create a Search campaign against an existing budget. Created PAUSED by default so it cannot start spending before a human looks at it - pass status='ENABLED' only when that is intended. Create the budget first with create_campaign_budget.

Inputs: name (required), budgetId (required), status, endDate, +7 more.

create_campaign_budgetCreate a campaign budgetAInspect

Create a shared daily campaign budget. A campaign cannot be created without one, so this is normally the first write call. amount is a daily amount in account currency (not micros).

Inputs: name (required), amount (required), customerId, extraFields, +2 more.

create_responsive_search_adCreate a responsive search adAInspect

Create a responsive search ad in an ad group. Google requires 3 to 15 headlines (max 30 chars each) and 2 to 4 descriptions (max 90 chars each); those limits are enforced here before the call so a bad draft fails fast rather than as an opaque API error. Created PAUSED by default.

Inputs: finalUrl (required), adGroupId (required), headlines (required), descriptions (required), +6 more.

find_zero_visibility_pagesFind pages with zero search visibilityA
Read-only
Inspect

Given the page URLs you track (e.g. a marketing site's master URL list), return which got zero impressions in Search Console over the window - worth a manual indexing check (noindex tag, orphaned internal links, thin/duplicate content) rather than assuming it's simply low demand. Caybl has no notion of your tracked-URL list on its own, which is why this takes urls rather than inferring them. Matches scheme (http/https) and trailing-slash variants of each URL automatically, since Search Console may report the same page in a different form than your list uses.

Inputs: urls (required), endDate, siteUrl, startDate.

generate_keyword_ideasKeyword ideas (Keyword Planner)A
Read-only
Inspect

Keyword Planner ideas for seed keywords and/or a URL: monthly search volume, a LOW/MEDIUM/HIGH competition score, and top-of-page bid estimates. Works pre-spend. Volume is bucketed by Google.

Inputs: limit, pageUrl, keywords, customerId, +2 more.

get_account_summariesList GA accounts & propertiesB
Read-only
Inspect

List the GA accounts and properties this connection can access.

Inputs: no named parameters.

get_ad_groupsList Ads ad groupsB
Read-only
Inspect

List ad groups for an account (optionally filtered to one campaign): id, name, status, type, and their parent campaign.

Inputs: campaignId, customerId, includeRemoved.

get_ad_performancePer-ad performanceA
Read-only
Inspect

Performance broken down by individual ad, not just by campaign - which specific responsive search ad (and its headlines/descriptions) is actually winning. get_campaign_performance only reports at the campaign level. Defaults to the last 30 days; filter to one campaign or ad group with the optional ids.

Inputs: limit, endDate, adGroupId, startDate, +2 more.

get_campaign_criteriaCampaign targeting (locations, devices, schedule, negatives)A
Read-only
Inspect

Everything that controls WHERE, WHEN, and to WHOM a campaign can serve: location targeting, excluded devices, ad schedule, and campaign-level negative keywords. get_campaigns only covers structural fields (name, status, budget) - a campaign can look perfectly configured there while having no location targeting at all, which defaults to Google's broadest reach, not 'no targeting'. Check this before enabling any campaign meant for specific markets or hours.

Inputs: campaignId (required), customerId.

get_campaign_performanceCampaign performanceA
Read-only
Inspect

Per-campaign performance over a date range: impressions, clicks, cost, conversions, CTR, and average CPC. Costs are in the account currency (converted from micros). Defaults to the last 30 days.

Inputs: endDate, startDate, customerId.

get_campaignsList Ads campaignsA
Read-only
Inspect

List campaigns for an account: id, name, status, channel type, bidding strategy, and daily budget. Structure only (no performance metrics) - use get_campaign_performance for spend/results.

Inputs: customerId, includeRemoved.

get_custom_dimensions_and_metricsList custom dimensions & metricsB
Read-only
Inspect

List the custom dimensions and custom metrics defined on a GA4 property.

Inputs: property.

get_impression_shareImpression shareA
Read-only
Inspect

Your own search impression-share metrics per campaign (share, top, absolute-top, and share lost to rank vs budget). NOTE: the Ads API does not expose the competitor-domain Auction Insights report - this is your account's share only, not named competitors. Defaults to the last 30 days.

Inputs: endDate, startDate, customerId.

get_property_detailsGet GA4 property detailsA
Read-only
Inspect

Return details about a specific GA4 property (name, timezone, currency, type, etc.).

Inputs: property.

get_resource_metadataDescribe an Ads resourceA
Read-only
Inspect

Describe a Google Ads API resource type (e.g. 'campaign', 'ad_group', 'search_term_view'): its category, the metrics and segments selectable with it, and related resources. Helps construct GAQL for run_gaql_report.

Inputs: resource (required), customerId.

get_search_console_property_detailsGet Search Console property detailsB
Read-only
Inspect

Return your permission level for a single Search Console property.

Inputs: siteUrl.

get_search_termsSearch terms reportA
Read-only
Inspect

The actual search queries that triggered your ads, with impressions/clicks/cost/conversions. Useful for spotting wasted spend and negative-keyword candidates. Defaults to the last 30 days.

Inputs: limit, endDate, startDate, customerId.

get_sitemapGet sitemap statusA
Read-only
Inspect

Status of one specific sitemap: last downloaded, errors/warnings, and URLs submitted vs. indexed.

Inputs: feedpath (required), siteUrl.

gtm_audit_containerAudit a Tag Manager containerA
Read-only
Inspect

Check the LIVE version of a GTM container for common tracking problems, worst first: paused tags, duplicate GA4 event tags (double counting), duplicate Google tags, retired Universal Analytics tags, tags that never fire, missing consent settings, unused triggers, Custom HTML sprawl and unpublished workspace changes - each with a one-line fix. Pair with GA4 (run_report by eventName) or Google Ads conversions to confirm the impact.

Inputs: container.

gtm_container_overviewTag Manager container overviewA
Read-only
Inspect

What's live in a GTM container: the published version (number, name, roughly when it was saved), how many tags, triggers and variables it has, how many tags are paused, and which workspaces have unpublished changes.

Inputs: container.

gtm_import_templateImport a Template Gallery template into the Caybl workspaceAInspect

Import a template found with gtm_template_lookup into the container's Caybl workspace (a draft, never live). Only templates that appear in the live gallery can be imported. Dry run by default. After applying, the result lists the template's settings and the sandbox permissions it asks for; show those to the user. Then create a tag with gtm_upsert_tag kind=template.

Inputs: template (required), container, workspace, validateOnly.

gtm_list_containersList Tag Manager containersA
Read-only
Inspect

List the Google Tag Manager containers this account can see: public id (GTM-XXXX), name, web or server, and domains. Pass one as container to the other gtm_ tools - only needed when there's more than one.

Inputs: no named parameters.

gtm_list_tagsList Tag Manager tagsA
Read-only
Inspect

Every tag in the LIVE version of a container, in plain words: type (e.g. 'GA4 event', 'Google Ads conversion', 'Custom HTML'), the event name / measurement id / conversion id it sends to, which triggers fire or block it, whether it's paused, and its consent settings. Filter by type or a search on the name. To check whether a GA4 event is actually arriving, compare with GA4 run_report (eventName).

Inputs: type, search, container.

gtm_list_triggers_and_variablesList Tag Manager triggers and variablesA
Read-only
Inspect

Triggers in the LIVE version with their conditions in plain words (e.g. 'Page Path starts with /checkout/thank-you') and which tags use each one, plus user-defined variables (type and source) and the enabled built-in variables.

Inputs: container.

gtm_pause_tagPause or unpause a Tag Manager tagA
Idempotent
Inspect

Pause (or unpause) one tag, as a draft in the container's Caybl workspace - nothing goes live until the user publishes in Tag Manager. Dry run by default (validateOnly=true).

Inputs: tag (required), paused, container, workspace, +1 more.

gtm_publishPublish a Tag Manager workspace, or roll back to an earlier versionA
Destructive
Inspect

Publish to the LIVE site. Two ways: (1) publish a workspace's drafts as a new named version - by default the "Caybl changes" workspace Caybl's edit tools draft into; or (2) pass version to re-publish an earlier version, which is how to undo a bad publish. Dry run by default: Google compiles the workspace and reports errors or merge conflicts, and the result lists exactly what would change on the live site. Only call with validateOnly=false after the user has seen that list and said yes.

Inputs: notes, version, container, workspace, +2 more.

gtm_template_lookupSearch the Tag Manager Template GalleryA
Read-only
Inspect

Search Tag Manager's own Community Template Gallery (live, the same list as Tag Manager's Search Gallery) for a ready-made template BEFORE writing Custom HTML. Give query (a product name such as 'meta pixel' or 'clarity') or paste a snippet and it finds templates for the vendors in it. Also shows which templates are already imported in the container's Caybl workspace. Prefer the official template, usually owned by the vendor. Then: gtm_import_template, then gtm_upsert_tag kind=template. If nothing matches, propose Custom HTML.

Inputs: query, snippet, container, workspace.

gtm_upsert_tagCreate or edit a GA4 event, Google Ads conversion, Custom HTML or template tagAInspect

Create a GA4 event, Google Ads conversion, Custom HTML or imported-template tag, or edit an existing one of those types, as a draft in the container's Caybl workspace (never published - the user publishes in Tag Manager). Dry run by default: returns the tag exactly as it would be saved, a diff when editing, and warnings for missing triggers or variables. Custom HTML takes any snippet: it is code that runs on the customer's site once published, so always show it to the user first. Gallery templates come first: a pasted snippet whose vendor has a template in the Tag Manager Template Gallery is refused with the matching templates; use kind=custom_html only when none match, or the user explicitly asks for HTML (useHtmlAnyway=true).

Inputs: kind (required), name (required), firingTriggers (required), tag, +15 more.

gtm_upsert_triggerCreate or edit a Tag Manager triggerAInspect

Create or edit a page view, link click, all-clicks, form submission or custom event trigger, as a draft in the container's Caybl workspace (never published). Dry run by default: returns the trigger in plain words and as saved, and warns when a condition uses a variable that isn't enabled (e.g. Click URL).

Inputs: kind (required), name (required), trigger, container, +4 more.

gtm_version_historyTag Manager version history and diffA
Read-only
Inspect

Recent published versions of a container, and exactly what changed between two of them: tags, triggers and variables added, removed or changed (paused, different triggers, different event or conversion id). Default compares the live version with the one before it. Use it for 'conversions dropped on the 14th - what changed?': match the version's date with the drop in GA4 or Google Ads.

Inputs: container, toVersion, fromVersion.

inspect_urlInspect a URL's index statusA
Read-only
Inspect

Live index status for one URL: whether it's indexed, its Google-selected canonical, mobile usability, and any rich results detected. The tool for answering 'why isn't this page performing' before deciding what to change on it.

Inputs: url (required), siteUrl, languageCode.

list_accessible_customersList accessible Ads accountsA
Read-only
Inspect

List the Google Ads accounts (customer ids) this connection can access. Pass one as customerId for the other tools - only required when more than one account is reachable; the other tools auto-pick a single reachable account on their own.

Inputs: no named parameters.

list_sitemapsList sitemapsB
Read-only
Inspect

List the sitemaps Search Console knows about for a property, with their last-read status.

Inputs: siteUrl.

list_sitesList Search Console propertiesA
Read-only
Inspect

List the Search Console properties (domain or URL-prefix) this connection can access, with your permission level on each. Pass one as siteUrl for the other tools - only required when more than one property is reachable; the other tools auto-pick a single reachable property on their own.

Inputs: no named parameters.

mark_key_eventMark a GA4 event as a key eventAInspect

Mark a GA4 custom event (e.g. connect_success or first_tool_call_success, already flowing in via src/analytics/measurementProtocol.ts and GTM) as a key event - together with create_google_ads_link, the prerequisite for Google to automatically sync it into a Google Ads conversion action (there's no API call to trigger that sync; it happens once both exist). Once synced, see update_ga4_conversion_action (Google Ads connector) to set it as a primary MAXIMIZE_CONVERSIONS goal. Needs the analytics scope; a connection made before that scope was requested will refuse this until reconnected (see needsReconsent).

Inputs: eventName (required), property, countingMethod.

msads_add_ad_extensionsCreate Microsoft Advertising sitelinks and calloutsA
Idempotent
Inspect

Create sitelinks and/or callouts in the account's extension library. They are created UNATTACHED, so they do not serve until attached to a campaign or ad group with msads_set_ad_extension_attachment. Limits are checked first: sitelink text up to 25 characters (35 without descriptions), descriptions up to 35 and given together or not at all, callout text up to 25. Callouts only serve once there are at least 2 on a campaign or ad group. Use dryRun to review.

Inputs: dryRun, callouts, accountId, sitelinks.

msads_add_keywordsAdd Microsoft Advertising keywordsA
Idempotent
Inspect

Add keywords to an ad group. They are created PAUSED unless status is 'Active', so nothing starts spending until someone turns it on. Keywords already in the ad group with the same text and match type are skipped. Each keyword can have its own bid (otherwise it uses the ad group's) and final URL. Up to 50 per call. Use dryRun to see what would be added.

Inputs: keywords (required), adGroupId (required), dryRun, status, +1 more.

msads_add_negative_keywordsAdd Microsoft Advertising negative keywordsA
Idempotent
Inspect

Add negative keywords to a campaign or an ad group, so ads stop showing for those searches (the usual fix for wasted spend found with msads_get_search_terms). Exact blocks only that search, Phrase blocks searches containing the words in order, Broad blocks searches containing all the words in any order - Exact is the safe default. Up to 50 per call; ones already present are skipped. Adding negatives can reduce traffic, so check the list with dryRun when unsure. Needs campaignId for an ad group as well as the ad group id.

Inputs: level (required), entityId (required), keywords (required), dryRun, +3 more.

msads_create_ad_groupCreate a Microsoft Advertising ad groupA
Idempotent
Inspect

Create an ad group in a campaign. It is ALWAYS created paused. Give it a default max CPC bid (keywords without a bid of their own use it). Names must be unique within the campaign. Language is only needed if the campaign has none set. Use dryRun to review.

Inputs: name (required), cpcBid (required), campaignId (required), dryRun, +3 more.

msads_create_campaignCreate a Microsoft Advertising search campaignA
Idempotent
Inspect

Create a search campaign. It is ALWAYS created paused: it cannot spend until someone adds an ad group, keywords and an ad and turns it on with msads_set_status. Give it either its own dailyBudget or a sharedBudgetId (from msads_get_budgets). The time zone defaults to the account's. Bid strategy: EnhancedCpc (default), MaxClicks, or MaxConversions (needs a UET tag and conversion goal, and works best with 30+ conversions a month). Names must be unique in the account. A new budget above 50 per day needs allowLargeChange. Use dryRun to review.

Inputs: name (required), dryRun, maxCpc, timeZone, +6 more.

msads_create_conversion_goalCreate a Microsoft Advertising page-visit conversion goalA
Idempotent
Inspect

Create a conversion goal that counts a visit to a page (for example a thank-you page) as a conversion, tied to a UET tag (see msads_get_conversion_tracking for tag ids). It is created PAUSED, so it records nothing until turned on with msads_set_conversion_goal_status. The goal's scope is the account and cannot be changed later. Microsoft turns on automatic click tagging (an msclkid parameter on your landing page URLs) for the account when a conversion goal is added. Because that changes a setting beyond the goal, you must pass acknowledgeAutoTagging: true. Other goal types (events, duration, pages per visit) are not offered here. Use dryRun to review.

Inputs: name (required), tagId (required), category (required), urlExpression (required), +7 more.

msads_create_responsive_search_adCreate a Microsoft Advertising responsive search adA
Idempotent
Inspect

Create a responsive search ad in an ad group from headlines and descriptions that Microsoft mixes and matches. It is created PAUSED unless status is 'Active', so it does not serve until someone turns it on. Text limits are checked before anything is sent. Use dryRun to review the ad first. Write ads for the business honestly: do not invent offers, prices or claims the user did not give you.

Inputs: finalUrl (required), adGroupId (required), headlines (required), descriptions (required), +5 more.

msads_create_shared_budgetCreate a Microsoft Advertising shared budgetA
Idempotent
Inspect

Create a shared daily budget that several campaigns can draw on. Creating it spends nothing: it only matters once a campaign is linked to it with msads_set_campaign_budget_link. Names must be unique in the account. An amount above 50 per day needs allowLargeChange. Use dryRun to review.

Inputs: name (required), dailyAmount (required), dryRun, accountId, +1 more.

msads_create_uet_tagCreate a Microsoft Advertising UET tagA
Idempotent
Inspect

Create a UET tag, the tracking snippet Microsoft Advertising needs on your website to record conversions. This only creates the tag and returns its id and the snippet; it does NOT install it on the site, which is a change to the website someone must make. One tag can serve all goals. Names must be unique for the customer. Use dryRun to review.

Inputs: name (required), dryRun, accountId, description.

msads_get_account_statusMicrosoft Advertising account statusA
Read-only
Inspect

The account's standing: lifecycle status (Active, Pause, ...), any pause reason code, financial status, account mode, payment method type, and when and by whom it was last modified, plus a short needsAttention list. Use it when asked whether the account is in good standing or why ads aren't serving. It cannot read advertiser identity verification, change history, the diagnostics widget or invoices: those are only in the Microsoft Advertising UI, and the result lists them under cannotRead so you can say so. For why a campaign is paused, see msads_get_campaigns (statusMeaning) and msads_get_import_jobs.

Inputs: accountId.

msads_get_ad_extensionsList Microsoft Advertising ad extensionsA
Read-only
Inspect

List ad extensions (sitelinks, callouts, structured snippets, calls, prices, promotions). With no campaignId or adGroupId this is the account's whole extension library; with one, only the extensions attached to it (ad group attachments override campaign ones). Each extension is shown in one flat shape: id, type, status and its text. An extension in the library that is attached to nothing does not serve.

Inputs: limit, types, accountId, adGroupId, +1 more.

msads_get_ad_group_performanceMicrosoft Advertising ad group performanceA
Read-only
Inspect

Ad group performance for a date range (optionally one campaign): impressions, clicks, CTR, average CPC, cost, conversions and cost per conversion, highest spend first.

Inputs: limit, endDate, accountId, startDate, +1 more.

msads_get_ad_groupsList Microsoft Advertising ad groupsA
Read-only
Inspect

List a campaign's ad groups: id, name, status, default CPC bid, network and language. Structure only - use msads_get_ad_group_performance for results.

Inputs: campaignId (required), accountId.

msads_get_adsList Microsoft Advertising adsA
Read-only
Inspect

List an ad group's ads: id, type, status, final URLs and the ad text (headlines and descriptions for responsive search ads; title parts and text for expanded and text ads).

Inputs: adGroupId (required), accountId.

msads_get_budgetsList Microsoft Advertising shared budgetsA
Read-only
Inspect

List the account's SHARED budgets: id, name, daily amount, and how many campaigns draw on each. A campaign on a shared budget shows a budgetId in msads_get_campaigns and its own daily budget cannot be changed separately. Campaigns with their own budget are not listed here.

Inputs: accountId.

msads_get_campaign_performanceMicrosoft Advertising campaign performanceA
Read-only
Inspect

Campaign performance for a date range: impressions, clicks, CTR, average CPC, cost (in the account's currency), conversions, conversion value and cost per conversion, highest spend first. byDay: true returns one row per campaign per day instead of one per campaign. Microsoft generates this as an async report, which usually takes a few seconds.

Inputs: byDay, limit, endDate, accountId, +1 more.

msads_get_campaignsList Microsoft Advertising campaignsA
Read-only
Inspect

List campaigns for an account: id, name, status, type, daily budget and bidding scheme. Structure only (no performance metrics) - use msads_get_campaign_performance for spend and results.

Inputs: accountId.

msads_get_conversion_trackingList Microsoft Advertising conversion goals and UET tagsA
Read-only
Inspect

List the conversion goals (what counts as a conversion: a page visit, an event, time on site, and so on, with its status, count type and value) and the UET tags that feed them, including each tag's tracking status. Use this to find out why conversions are missing: a goal that is paused, or a tag that is not recording, shows here. Conversion numbers themselves are in msads_get_campaign_performance.

Inputs: accountId.

msads_get_import_jobsList Microsoft Advertising Google Ads importsA
Read-only
Inspect

List the Google Ads import jobs set up on the account: name, status, schedule, last run, who created it, which Google account it reads, and which settings it syncs (campaign status, budgets, bids, locations, deletions), with a plain-English effects list. Use it when a campaign changed or was paused and nobody did it: a scheduled import that syncs status copies a Google Ads pause across at its next run. Only Google Ads imports are listed, not file imports.

Inputs: accountId.

msads_get_impression_shareMicrosoft Advertising impression shareA
Read-only
Inspect

Search impression share per campaign for a date range, with the share lost to budget and the share lost to rank (bid and quality), all as percentages 0-100. Null where Microsoft reports no value (too little traffic). Low share lost to budget means raise budget; low share lost to rank means raise bids or improve quality score.

Inputs: limit, endDate, accountId, startDate.

msads_get_keyword_ideasMicrosoft Advertising keyword ideasA
Read-only
Inspect

Keyword ideas for up to 20 seed words or phrases, each with average monthly searches (and the 12 monthly counts), Microsoft's suggested bid, competition and relevance, highest volume first. Needs Microsoft's numeric locationIds (from its Geographical Location Codes list), because volumes are per location. Microsoft's docs list keyword ideas as available for the United States, United Kingdom, Canada, Australia, France and Germany. Volumes are estimates and lag by up to about three days.

Inputs: queries (required), limit, language, accountId, +1 more.

msads_get_keyword_performanceMicrosoft Advertising keyword performance and quality scoreA
Read-only
Inspect

Keyword performance for a date range (optionally one campaign): match type, quality score (1-10) with its expected CTR, ad relevance and landing page experience ratings, current max CPC bid, and impressions, clicks, CTR, average CPC, cost and conversions, highest spend first. Quality score is null for keywords with too little traffic to score.

Inputs: limit, endDate, accountId, startDate, +1 more.

msads_get_keywordsList Microsoft Advertising keywordsA
Read-only
Inspect

List an ad group's keywords: id, text, match type, status and the keyword's own bid (null = inherits the ad group's). Quality score is NOT part of the keyword record in Microsoft's API - use msads_get_keyword_performance, which reports quality score and its three components.

Inputs: adGroupId (required), accountId.

msads_get_location_performanceMicrosoft Advertising location performanceA
Read-only
Inspect

Performance by the geographic location of the searcher (country and city) for a date range, optionally one campaign: impressions, clicks, CTR, average CPC, cost and conversions, highest spend first.

Inputs: limit, endDate, accountId, startDate, +1 more.

msads_get_negative_keywordsList Microsoft Advertising negative keywordsA
Read-only
Inspect

List the negative keywords on a campaign, or on one of its ad groups when adGroupId is given: id, text and match type. Negatives block searches; check these before adding more with msads_add_negative_keywords or when wondering why a search term gets no traffic. Shared negative keyword lists are not included.

Inputs: campaignId (required), accountId, adGroupId.

msads_get_search_termsMicrosoft Advertising search termsA
Read-only
Inspect

The search queries that triggered ads, for a date range (optionally one campaign): the query, the keyword and match type that matched it, and impressions, clicks, CTR, cost and conversions, highest spend first. Use it to find wasted spend (cost with no conversions) and new keyword ideas.

Inputs: limit, endDate, accountId, startDate, +1 more.

msads_get_targetingList Microsoft Advertising targeting and bid adjustmentsA
Read-only
Inspect

List a campaign's targeting (locations, radius, device, day and time, age, gender), or an ad group's when adGroupId is given, with each criterion's bid adjustment in percent (+20 = bid 20% more, -100 on a device = excluded) and whether it is an exclusion. A type with nothing set has no restriction. Ad group targeting of a type overrides the campaign's.

Inputs: campaignId (required), types, accountId, adGroupId.

msads_list_accountsList Microsoft Advertising accountsA
Read-only
Inspect

List the Microsoft Advertising accounts this connection can read: account id, name, account number, currency, time zone and status. Use the accountId with the other msads_ tools when there is more than one.

Inputs: no named parameters.

msads_remove_ad_groupRemove a Microsoft Advertising ad groupA
DestructiveIdempotent
Inspect

Permanently delete an ad group, along with its keywords and ads. This cannot be undone and its history stays only in reports. Safety checks: the ad group must already be Paused (use msads_set_status first, so you never delete something that is serving), and confirmName must match the ad group's name exactly. To stop an ad group without losing it, pause it instead. Always run dryRun first: it shows what would be deleted (keyword and ad counts).

Inputs: adGroupId (required), campaignId (required), confirmName (required), dryRun, +1 more.

msads_remove_negative_keywordsRemove Microsoft Advertising negative keywordsA
DestructiveIdempotent
Inspect

Remove negative keywords from a campaign (or an ad group when adGroupId is given), so ads can show for those searches again. Match them by text; add matchType to remove only that match type. Removing negatives can increase traffic and spend. Returns exactly what was removed so it can be put back with msads_add_negative_keywords. Use dryRun first when unsure.

Inputs: keywords (required), campaignId (required), dryRun, accountId, +2 more.

msads_set_ad_extension_attachmentAttach or detach Microsoft Advertising extensionsA
DestructiveIdempotent
Inspect

Attach library extensions to a campaign or an ad group (they start serving there), or detach them (they stop serving there and stay in the library). Use ids from msads_get_ad_extensions. Attaching to an ad group overrides what the campaign has. Use dryRun first when unsure.

Inputs: action (required), extensionIds (required), dryRun, accountId, +2 more.

msads_set_ad_group_bidChange a Microsoft Advertising ad group bidA
DestructiveIdempotent
Inspect

Set an ad group's default max CPC bid, used by every keyword in it that has no bid of its own. A change that more than doubles the current bid is refused unless allowLargeChange is true. Returns the previous bid so it can be undone. Use dryRun first when unsure. Keyword and ad group bids steer delivery under Manual or Enhanced CPC bidding; under an automated bid strategy Microsoft may ignore them.

Inputs: cpcBid (required), adGroupId (required), campaignId (required), dryRun, +2 more.

msads_set_bid_adjustmentChange a Microsoft Advertising bid adjustmentA
DestructiveIdempotent
Inspect

Set a campaign's bid adjustment, in percent (20 = bid 20% more, -20 = 20% less, 0 = none), for a device, a location or a day/time slot. For devices this creates the adjustment if there is none. For a location or a day/time slot only an EXISTING one can be changed (see msads_get_targeting): adding one would also change where or when ads show, which this tool does not do. An adjustment above +100, or -100 on a device (which stops ads on it), needs allowLargeChange. Returns the previous adjustment so it can be restored. Use dryRun first when unsure.

Inputs: criterion (required), campaignId (required), adjustmentPercent (required), day, +7 more.

msads_set_bidding_strategyChange a Microsoft Advertising campaign's bid strategyA
DestructiveIdempotent
Inspect

Switch a campaign between MaxClicks, MaxConversions, EnhancedCpc and ManualCpc. This changes how every bid is set, so it affects spend and delivery, and Microsoft re-learns after a change. Read the campaign first (msads_get_campaigns shows the current strategy). MaxConversions needs an active conversion goal (refused without one) and about 15+ conversions in the last 30 days (refused below that unless acknowledgeLowConversionVolume is true, which should only be set when the user has seen the count and still wants it). Optional targetCpa applies to MaxConversions only (Microsoft no longer offers a separate Target CPA strategy). A campaign's existing max CPC cap is kept when moving between MaxClicks and MaxConversions; Microsoft cannot add a cap back once removed, so removing it needs removeMaxCpc. Returns the previous strategy so it can be undone. Use dryRun first.

Inputs: strategy (required), campaignId (required), dryRun, accountId, +3 more.

msads_set_campaign_budgetChange a Microsoft Advertising campaign's daily budgetA
DestructiveIdempotent
Inspect

Set a campaign's daily budget. This directly changes how much the campaign can spend per day. Only campaigns with their own standard daily budget can be changed here: a campaign on a shared budget, or a lifetime or accelerated budget, is refused with an explanation. A change that more than doubles the budget is refused unless allowLargeChange is true. Returns the previous budget so it can be undone. Use dryRun first when unsure. Microsoft treats a daily budget as a target: actual daily spend can run up to about 20% over it.

Inputs: campaignId (required), dailyBudget (required), dryRun, accountId, +1 more.

msads_set_conversion_goal_statusPause or resume a Microsoft Advertising conversion goalA
DestructiveIdempotent
Inspect

Turn a conversion goal on (Active) or off (Paused). A paused goal records no conversions, which changes what msads_get_campaign_performance reports and what automated bidding learns from. Returns the previous status. Use dryRun first.

Inputs: goalId (required), status (required), dryRun, accountId.

msads_set_keyword_bidChange a Microsoft Advertising keyword bidA
DestructiveIdempotent
Inspect

Set one keyword's own max CPC bid. This changes what the keyword can spend per click. A change that more than doubles the current bid is refused unless allowLargeChange is true. Returns the previous bid so it can be undone. Use dryRun first when unsure. Keyword and ad group bids steer delivery under Manual or Enhanced CPC bidding; under an automated bid strategy Microsoft may ignore them.

Inputs: bid (required), adGroupId (required), keywordId (required), dryRun, +2 more.

msads_set_shared_budget_amountChange a Microsoft Advertising shared budgetA
DestructiveIdempotent
Inspect

Change a shared budget's daily amount. This changes the budget of EVERY campaign linked to it (the response says how many). A change that more than doubles it is refused unless allowLargeChange is true. Returns the previous amount so it can be restored. Use dryRun first when unsure.

Inputs: budgetId (required), dailyAmount (required), dryRun, accountId, +1 more.

msads_set_statusPause or resume a Microsoft Advertising campaign, ad group, keyword or adA
DestructiveIdempotent
Inspect

Pause or resume one campaign, ad group, keyword or ad. Pausing stops it serving and spending; resuming lets it serve again, which can start spending. Only Active and Paused can be set, and an item whose status is something else (for example paused by the budget) is refused rather than overridden. Returns the previous status so the change can be undone. Use dryRun first when unsure. Needs campaignId for an ad group, and adGroupId for a keyword or ad.

Inputs: status (required), entityId (required), entityType (required), dryRun, +3 more.

msads_update_responsive_search_adEdit a Microsoft Advertising responsive search adA
DestructiveIdempotent
Inspect

Change a responsive search ad's headlines, descriptions, final URL or display paths. Only what you pass is changed, but a list of headlines or descriptions REPLACES the whole existing list, so send the complete new set. Editing a live ad sends it back for Microsoft's review. Returns the previous text so it can be restored. Use dryRun first.

Inputs: adId (required), adGroupId (required), path1, path2, +5 more.

pagespeed_auditPageSpeed audit (Lighthouse)A
Read-only
Inspect

Run Google PageSpeed Insights (Lighthouse) on one public page right now: performance, SEO, accessibility and best-practices scores (0-100), lab LCP / TBT / CLS, and the top fixes ranked by estimated time saved (e.g. 'Properly size images - save ~1.4 s'), plus the failed SEO and accessibility checks. Also includes the page's real-user field data when Google has it. Takes 10-30 seconds. Use it to explain WHY a page is slow; for whether it's slow for real users, or for many pages at once, use pagespeed_core_web_vitals.

Inputs: url (required), strategy, categories.

pagespeed_core_web_vitalsCore Web Vitals (real-user data)A
Read-only
Inspect

Real-user Core Web Vitals from the Chrome UX Report: the 75th-percentile LCP, INP and CLS (plus FCP and TTFB) that Chrome users actually experienced over the last 28 days, each rated good / needs improvement / poor, and whether the page passes Google's Core Web Vitals assessment. This is the data Google uses in ranking. Fast (about a second) and works for ANY public site, including competitors. Pass up to 10 URLs to compare pages - for 'which of my busiest pages are slow?', first get top landing pages from Google Analytics (run_report with landingPage) or Search Console, then pass their full URLs here. A URL with too little traffic falls back to its whole site (origin) and says so. Use pagespeed_audit for the reasons a page is slow.

Inputs: urls (required), formFactor.

pagespeed_core_web_vitals_historyCore Web Vitals trendA
Read-only
Inspect

Weekly trend of real-user LCP, INP and CLS (75th percentile, each point a rolling 28-day window) for a page or a whole site, for up to about 9 months. Answers 'did our site get slower, and when?' - flags the week a metric crossed into a worse rating. Compare the date with GA4 conversions or a deploy to find the cause.

Inputs: url (required), weeks, formFactor.

remove_campaign_criterionRemove a campaign-level targeting criterionA
Destructive
Inspect

Undo one location, device exclusion, ad schedule block, or negative keyword set by set_campaign_targeting or add_negative_keywords - e.g. 'actually don't exclude mobile after all'. Criteria don't have a paused state like campaigns/ads do; this removes it outright.

Inputs: campaignId (required), criterionId (required), customerId, extraFields, +1 more.

run_funnel_reportRun GA4 funnel reportA
Read-only
Inspect

Run a GA4 funnel report (Data API v1alpha). Provide ordered funnelSteps (simple form: {name, dimension, matchValue}) or a raw funnel object for advanced funnels. NOTE: funnels use the Exploration schema, which supports fewer dimensions than run_report - pagePath is NOT valid here and is mapped to unifiedPagePathScreen. Use eventName to match events.

Inputs: funnel, endDate, property, startDate, +1 more.

run_gaql_reportRun a GAQL queryA
Read-only
Inspect

Run an arbitrary read-only Google Ads Query Language (GAQL) SELECT against an account and return the raw rows. The power tool for anything the structured tools don't cover. Only SELECT is allowed.

Inputs: gaql (required), customerId.

run_realtime_reportRun GA4 realtime reportA
Read-only
Inspect

Run a GA4 realtime report (active users right now, by dimension). The Realtime API only supports a small fixed schema - dimensions: appVersion, audienceId, audienceName, audienceResourceName, city, cityId, country, countryId, deviceCategory, eventName, minutesAgo, platform, streamId, streamName, unifiedScreenName, plus customUser:<parameter_name>; metrics: activeUsers, eventCount, keyEvents, screenPageViews. Most of run_report's ~150 dimensions/metrics (e.g. pagePath, sessionSource) aren't valid here - use run_report instead for anything outside this list.

Inputs: limit, metrics, property, dimensions.

run_reportRun GA4 reportA
Read-only
Inspect

Run a GA4 report via the Data API. Dimensions × metrics over a date range, with optional dimensionFilter/metricFilter (GA4 FilterExpression objects), orderBys, offset pagination, and multiple dateRanges. Example: device usage by page = dimensions [pagePath, deviceCategory], metric [screenPageViews]. GA4 allows at most 4 dateRanges per run_report call - split more into separate calls and combine the results. GA4 counts dimensions referenced in dimensionFilter toward the 9-dimension nested-request limit, on top of the dimensions array - reduce the dimensions requested or simplify the filter. A numericFilter needs its comparison value wrapped as { int64Value: '10' } (string) or { doubleValue: 10.5 }, not a bare number - e.g. { fieldName: 'sessions', numericFilter: { operation: 'GREATER_THAN', value: { int64Value: '10' } } }. A bare value: 10 passes schema validation here but GA4 rejects it at request time with "value is missing from NumericFilter" since it never finds anything under int64Value/doubleValue.

Inputs: metrics (required), dimensions (required), limit, offset, +8 more.

run_search_analytics_reportSearch analytics reportA
Read-only
Inspect

Organic search performance for a property: clicks, impressions, CTR, and average position, broken down by the dimensions you choose (query, page, country, device, date, searchAppearance). Filter to a search type (web/image/video/news/discover/googleNews) - discover and googleNews cover Google's Discover feed and Google News; searchAppearance as a dimension is the closest proxy the API currently offers for isolating AI Overview / rich-result rows, since there is no dedicated AI Overview search type yet. Defaults to the last 28 days (Search Console's own default). Use pageFilters to narrow to (or exclude) a URL pattern server-side - e.g. notContains on /dashboard/ and /authenticate/ to drop internal traffic that would otherwise crowd out marketing pages - rather than requesting the maximum rowLimit and filtering client-side. For an exact-URL allowlist ("only these known-good pages"), use the in operator instead of a hand-written regex - it avoids the notContains-as-denylist mismatch and chunks itself automatically to stay under Google's undocumented filter-size ceiling (may take more than one upstream call for a large list). Large requests are paged internally in batches of up to 5000 rows and will stop early with nextStartRow set if they run long, rather than risk a request timeout - pass that back as startRow to continue. collapseVariants merges query-string/scheme duplicates of the same page; brandKeywords adds a derived branded/non-branded field per query row.

Inputs: type, endDate, siteUrl, rowLimit, +6 more.

set_campaign_targetingSet campaign locations, excluded devices, and ad scheduleA
Destructive
Inspect

Add location targeting, device exclusions, and/or an ad schedule (day-parting) to a Google Ads campaign. A campaign with no locations serves everywhere Google allows, so set locations before enabling a campaign meant for specific markets. Locations and schedule blocks are added alongside existing ones. Excluding a device sets that device's bid adjustment to -100%, which overwrites any adjustment already set for it. Undo any of these with remove_campaign_criterion.

Inputs: campaignId (required), adSchedule, customerId, extraFields, +3 more.

submit_sitemapSubmit (resubmit) a sitemapA
Idempotent
Inspect

Tell Google to (re)fetch a sitemap - the natural next step after editing pages based on performance data, so the change is picked up rather than waiting for the next crawl. Requires write access on this property (auth/scopes.ts) - refuses cleanly if the connection or this specific property has changes switched off.

Inputs: feedpath (required), siteUrl.

update_ad_groupChange an ad group's status or bidB
Destructive
Inspect

Change an ad group's status and/or its default max CPC. Raising the bid raises what each click can cost. REMOVED is permanent.

Inputs: adGroupId (required), cpcBid, status, customerId, +2 more.

update_ad_statusEnable, pause or remove an adB
Destructive
Inspect

Change a single ad's status within its ad group. REMOVED is permanent.

Inputs: adId (required), status (required), adGroupId (required), customerId, +2 more.

update_campaignRename a campaign, or change its budget or bidding strategyA
Destructive
Inspect

Change a campaign's name, reassign it to a different budget, or switch its bidding strategy - everything about a campaign except status (use update_campaign_status for that). Useful for the common pattern of starting on MANUAL_CPC to see real auction behaviour, then moving to an automated strategy once there's data to bid on, without recreating the campaign.

Inputs: campaignId (required), name, budgetId, customerId, +3 more.

update_campaign_budgetChange a campaign budget amountA
Destructive
Inspect

Change the daily amount on an existing campaign budget. This directly changes how much the campaigns on that budget can spend per day - dry-run it first if you are unsure.

Inputs: amount (required), budgetId (required), customerId, extraFields, +1 more.

update_campaign_statusEnable, pause or remove a campaignA
Destructive
Inspect

Change a campaign's status. ENABLED starts it serving and spending; PAUSED stops delivery and is reversible; REMOVED is permanent and cannot be undone through the API or the Ads UI.

Inputs: status (required), campaignId (required), customerId, extraFields, +1 more.

update_ga4_conversion_actionTune a GA4-sourced conversion actionA
Destructive
Inspect

Update settings on a Google Ads conversion action that Google has already synced from a linked GA4 property's key event (see create_google_ads_link and mark_key_event in the Google Analytics connector - Google imports it automatically once both exist; there is no Ads API call to create or trigger that import). Use this to set primaryForGoal true, which is what actually makes it usable as a MAXIMIZE_CONVERSIONS bidding goal. Find the conversion action id first with run_gaql_report, e.g. "SELECT conversion_action.id, conversion_action.name, conversion_action.google_analytics_4_settings.event_name FROM conversion_action WHERE conversion_action.type IN ('GOOGLE_ANALYTICS_4_CUSTOM','GOOGLE_ANALYTICS_4_PURCHASE','GOOGLE_ANALYTICS_4_GENERATE_LEAD','GOOGLE_ANALYTICS_4_QUALIFY_LEAD','GOOGLE_ANALYTICS_4_CLOSE_CONVERT_LEAD')" (enum fields reject LIKE/wildcards - see run_gaql_report). Note: includeInConversionsMetric is immutable on a GA4-synced action once Google has set it - expect an IMMUTABLE_FIELD error if you try to change it; primaryForGoal and status remain changeable.

Inputs: conversionActionId (required), status, customerId, extraFields, +3 more.

update_keywordChange a keyword's status or bid, or remove itA
Destructive
Inspect

Change an existing keyword's status (PAUSED/ENABLED, or REMOVED to delete it permanently) and/or its max CPC bid. add_keywords can only add new keywords - this is how to act on one that's already there, e.g. pausing an underperformer found via get_search_terms.

Inputs: adGroupId (required), keywordId (required), cpcBid, status, +3 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Remote MCP server that lets AI assistants read tracked competitive intelligence — competitor news, reviews, website changes, social posts and ads — and act on it by managing projects, competitors, battle cards, reports and canvases. Every answer carries a source and a date, and write actions only publish when explicitly shared.
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables brand visibility monitoring across major AI platforms like ChatGPT, Claude, Gemini, and Perplexity. It allows users to track visibility scores, analyze competitor data, and receive actionable insights to improve AI-generated brand recommendations.
      16
      9 npm
      1
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Browse IndustryLens's published competitive-intelligence reports and head-to-head competitor comparisons from any AI agent — real, source-backed data.
      MIT
    Try in Browser

    Glama MCP Gateway

    Add one secure layer between your agents and this server.

    Resources