Quantum ADS MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| GOOGLE_ADS_CLIENT_ID | No | OAuth2 client ID for Google Ads. | |
| QUANTUM_ADS_READ_ONLY | No | If 'true', mutations are refused until set to 'false'. Default is true. | true |
| GOOGLE_ADS_API_VERSION | No | Google Ads API version. Default is v24. | v24 |
| QUANTUM_ADS_CONNECTORS | No | Comma-separated list of connectors to mount. Default is all connectors. | |
| GOOGLE_ADS_CLIENT_SECRET | No | OAuth2 client secret for Google Ads. | |
| GOOGLE_ADS_REFRESH_TOKEN | No | OAuth2 refresh token for Google Ads. | |
| GOOGLE_ADS_USE_PROTO_PLUS | No | Set to 'True' to use proto-plus. Default is True. | True |
| GOOGLE_ADS_DEVELOPER_TOKEN | No | Developer token for Google Ads API. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| logging | {} |
| prompts | {
"listChanged": true
} |
| resources | {
"subscribe": false,
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| healthB | Server + Google Ads API version health. |
| list_capabilitiesC | List connector capabilities and their tools. |
| describe_toolC | Describe a registered tool by name. |
| audit.statusC | Signed audit ledger: persistence, path, chain verification, public key. |
| audit.anchorA | Anchor the audit chain head in Bitcoin via OpenTimestamps (only its SHA-256 leaves). |
| audit.anchor_statusC | Upgrade pending OpenTimestamps proofs; report pending vs Bitcoin-confirmed anchors. |
| ads.gaql.queryC | Run an arbitrary read-only GAQL query. |
| ads.report.campaignD | Campaign performance report. |
| ads.report.search_termsC | Search-terms report (incl. AI Max source). |
| ads.report.pmax_asset_groupsC | Performance Max asset-group report. |
| ads.report.ai_maxC | AI Max matched-location-interest report. |
| ads.report.conversionsD | Conversions by conversion date. |
| ads.change_historyD | Change history (audit=change_event, delta=change_status). |
| ads.fields.deltasB | Curated 2026 field/view/resource deltas (v22 to v26). |
| ads.fields.new_viewsC | New 2026 reporting views. |
| ads.api.version_deltaA | Exact resources/services/enums added or removed between two API versions (computed from the installed SDK; plan an upgrade without a token). |
| ads.recommendations.listC | Active Google Ads recommendations with their estimated conversion/cost impact. |
| ads.keyword_ideasB | Keyword Planner ideas from seed keywords and/or a URL: monthly searches, competition, top-of-page bid range. |
| ads.batch.statusB | Status of a BatchJob and, once done, its per-operation results. |
| ads.reach.locationsB | Reach Planner: plannable locations (ids for ads.reach.products / forecast). |
| ads.reach.productsC | Reach Planner: plannable video/display products for a location. |
| ads.reach.forecastB | Reach Planner forecast (reach curve, on-target impressions) for a media plan: products [{code, budget_micros}], location, currency, duration. |
| ads.mutate.schemaA | List the mutate operation kinds, or the fields of one kind, for the pinned version. |
| ads.campaign.set_statusB | Pause/enable a campaign (guarded: validate_only preview + confirm token). |
| ads.budget.updateC | Update a campaign budget amount in micros (guarded). |
| ads.mutateB | Create/update/remove ANY Google Ads resource: MutateOperation JSON list (e.g. {'campaign_operation': {'create': {...}}}), temporary ids (-1) link new objects, atomic unless partial_failure. See ads.mutate.schema. |
| ads.campaign.create_searchA | Create a complete Search campaign in one atomic call: budget, bidding, geo/language targeting, negatives, ad group, keywords and a responsive search ad. |
| ads.campaign.create_pmaxA | Create a complete Performance Max campaign in one atomic call: budget, bidding, targeting, text + image assets (base64, e.g. from vertex.imagen.generate), asset group, and brand assets (business name, logo) under brand guidelines. |
| ads.rollbackA | Undo a Google Ads change from the signed audit trail (latest reversible change of this tenant, or audit_index): restores updated fields, removes created objects. |
| ads.recommendations.applyC | Apply Google Ads recommendations by resource name (from ads.recommendations.list). |
| ads.recommendations.dismissC | Dismiss Google Ads recommendations by resource name. |
| ads.campaign.create_demand_genB | Create a complete Demand Gen campaign in one atomic call: budget, campaign, ad group targeting, image/logo assets and a multi-asset ad. |
| ads.experiment.createB | Create an A/B experiment on a campaign: control + treatment arms with a traffic split. Edit the treatment draft (arm in_design_campaigns) with ads.mutate, then schedule. |
| ads.experiment.scheduleC | Start (schedule) an experiment. |
| ads.experiment.promoteC | Promote an experiment's treatment changes to the base campaign. |
| ads.experiment.endC | End a running experiment. |
| ads.batch.submitA | Submit a large mutation (thousands of MutateOperations) as an asynchronous BatchJob; track it with ads.batch.status. |
| ga4.reportC | GA4 Data API report (runReport over a date range). |
| ga4.realtimeC | GA4 Data API realtime report (runRealtimeReport). |
| ga4.admin.list_propertiesC | List GA4 properties under an Admin account. |
| ga4.admin.list_data_streamsC | List data streams under a GA4 property. |
| ga4.admin.list_key_eventsC | List key events (conversions) under a GA4 property. |
| ga4.admin.create_key_eventB | Create a key event (conversion) on a property (guarded: preview + confirm token). |
| ga4.admin.create_audienceC | Create an audience with filter clauses on a property (guarded). |
| gtm.list_accountsB | List accessible GTM accounts. |
| gtm.list_containersC | List containers under an account path. |
| gtm.list_workspacesC | List workspaces under a container path. |
| gtm.list_tagsC | List tags under a workspace path. |
| gtm.list_triggersC | List triggers under a workspace path. |
| gtm.list_variablesB | List user-defined variables under a workspace path. |
| gtm.list_versionsB | List container version headers under a container path. |
| gtm.create_tagB | Create a tag in a workspace (guarded: validate_only preview + confirm token). |
| gtm.update_tagC | Update an existing tag by path (guarded). |
| gtm.create_versionC | Freeze a workspace into a new container version (guarded). |
| gtm.publish_versionC | Publish a container version (guarded). |
| merchant.products.listB | List products under a Merchant Center account. |
| merchant.product.getC | Get a single product by its resource name. |
| merchant.product_statuses.listB | List item-level product statuses/issues for an account. |
| merchant.accounts.getC | Get a Merchant Center account. |
| merchant.product.insertB | Insert a product via productInput (guarded: validate_only preview + confirm token). |
| merchant.product.updateB | Update a product by resource name with a partial field set (guarded). |
| merchant.product.deleteC | Delete a product by resource name (guarded). |
| datamanager.statusB | Report the Data Manager upload plane identity + operator contract (hashing/consent). |
| datamanager.request_statusC | Retrieve a Data Manager ingestion request's status (optional read backend). |
| datamanager.audience.upload_membersB | Upload Customer Match audience members (guarded). Identifiers must be SHA-256 hashed/normalized; consent (ad_user_data/ad_personalization) required for EEA. |
| datamanager.audience.remove_membersC | Remove Customer Match audience members by hashed identifier (guarded). |
| datamanager.conversions.uploadB | Upload offline + enhanced conversions (guarded). Enhanced-conversion identifiers must be SHA-256 hashed/normalized; consent required for EEA. |
| searchconsole.search_analyticsC | Query Search Analytics (organic clicks/impressions/ctr/position) for a property. |
| searchconsole.sites.listA | List Search Console properties the authenticated user can access. |
| searchconsole.sitemaps.listB | List sitemaps submitted for a property. |
| searchconsole.url_inspectC | Inspect a URL's index status for a property (URL Inspection API). |
| searchconsole.sitemaps.submitA | Submit a sitemap feed path for a property (guarded: preview + confirm token). |
| searchconsole.sitemaps.deleteC | Delete a sitemap feed path for a property (guarded). |
| youtube.channel.getB | Get a channel's snippet/statistics + uploads-playlist id (Data API v3). |
| youtube.videos.listB | List full video resources for a batch of video ids (Data API v3). |
| youtube.playlist_items.listB | Enumerate playlist items (use the uploads playlist; avoid quota-scarce search.list). |
| youtube.analytics.queryC | Query organic video performance (views/watch time/etc.) from YouTube Analytics. |
| youtube.reporting.ensure_jobsC | Ensure Reporting API bulk-report jobs exist (reports retained 30/60d — persist early). |
| youtube.video.updateB | Update video metadata (title/description/tags) — guarded; no media upload. |
| youtube.playlist.add_itemC | Add a video to a playlist (playlistItems.insert) — guarded. |
| dv360.advertisers.listC | List advertisers under a DV360 partner. |
| dv360.campaigns.listC | List campaigns under a DV360 advertiser. |
| dv360.insertion_orders.listC | List insertion orders under a DV360 advertiser. |
| dv360.line_items.listC | List line items under a DV360 advertiser. |
| dv360.line_item.updateB | Update a line item by id with a partial field set (guarded: preview + confirm token). |
| dv360.line_item.set_statusC | Set a line item's entityStatus (activate/pause/archive) (guarded). |
| cm360.user_profiles.listA | List the CM360 user profiles the authenticated user can access. |
| cm360.campaigns.listB | List campaigns visible to a CM360 user profile. |
| cm360.placements.listB | List placements (ad-serving slots) visible to a CM360 user profile. |
| cm360.reports.listB | List report definitions visible to a CM360 user profile. |
| cm360.report.runB | Run a report definition by id under a CM360 user profile (returns the report file). |
| cm360.floodlight_activities.listB | List Floodlight activities (conversion tags) visible to a CM360 user profile. |
| cm360.placement.updateB | Update a placement by id with a partial field set (guarded: preview + confirm token). |
| cm360.report.insertA | Create a report definition from a report body (guarded: preview + confirm token). |
| sa360.searchB | Run an arbitrary read-only SA360 query (SA360 query language: SELECT ... FROM ...). |
| sa360.customers.list_accessibleA | List SA360 customers (accounts) the authenticated user can access. |
| sa360.report.campaignC | Campaign performance report (SA360). |
| sa360.report.ad_groupC | Ad-group performance report (SA360). |
| sa360.conversion.uploadB | Upload SA360 conversions (guarded: preview + confirm token). |
| bigquery.datasets.listB | List datasets in a BigQuery project. |
| bigquery.tables.listC | List tables in a BigQuery dataset. |
| bigquery.query.dry_runA | Dry-run a query: estimate scanned bytes + USD cost ($6.25/TiB), billing nothing. |
| bigquery.query.runB | Run a query only if it scans under max_bytes_billed (default 1e9 bytes). |
| bigquery.dataset.createB | Create a dataset under a project (guarded: validate_only preview + confirm token). |
| bigquery.table.createC | Create a table with a schema under a dataset (guarded). |
| vertex.gemini.generateB | Generate text with Gemini (creative copy/long-form). Incurs Vertex generation cost. |
| vertex.imagen.generateA | Generate n images, returned as base64 (default model gemini-3.1-flash-image; pass model to override). Incurs Vertex cost per image. |
| vertex.veo.generateB | Generate a video clip with Veo 3.1 (returns an operation to poll with vertex.veo.status). Incurs Vertex cost. |
| vertex.veo.statusB | Poll a Veo operation; when done, returns the generated video URIs/bytes. No cost. |
| vertex.gemini.generate_ad_copyC | Build a structured brief and ask Gemini for n ad-copy variants. Incurs Vertex cost. |
| video.generateB | Generate a short video from a text prompt for free (Wan 2.2 -> LTX-Video on Hugging Face ZeroGPU; no billing). Returns the mp4 path (+ base64 on request). Daily GPU quota applies. |
| insights.anomaliesA | Campaign anomalies: latest day vs each campaign's own history (robust z on cost, conversions, clicks). |
| insights.pacingB | Month-to-date spend vs daily budgets, projected to month end; over/under-pacing campaigns. |
| insights.search_termsB | Search-term mining: wasted terms -> negative keywords, converting untargeted terms -> new keywords, each with a ready ads.mutate operation. |
| insights.ga4_reconcileB | Daily Google Ads conversions vs GA4 key events from google / cpc, with flagged gaps. |
| creative.search_adsB | Generate validated responsive-search-ad copy (15 headlines <=30, 4 descriptions <=90) with Gemini. |
| creative.pmax_packB | Generate a Performance Max pack: validated headlines, long headlines, descriptions, and images fitted to 1200x628 / 1200x1200. |
| insights.apply_negativesA | Find wasted search terms (cost, no conversion) and add them as exact negative keywords in one guarded, audited write (undo with ads.rollback). |
| google.api.listB | Google APIs reachable through the generic plane, with default versions. |
| google.api.methodsC | Methods of a Google API from its Discovery contract (filter by resource, writes only). |
| google.api.describeC | One method's parameters (location, required, pattern, enum) and request body fields. |
| google.api.readC | Run a read-only method of any listed Google API, validated against its Discovery contract. |
| google.api.callA | Run a write method of any listed Google API (GA4 Admin, GTM, Merchant, YouTube, DV360, CM360, Business Profile, Search Console, Sheets/Drive/Slides...). |
| google.api.rollbackB | Undo the latest reversible google.api.call of this tenant (or audit_index) from the audit. |
| trends.interest_over_timeB | Relative search interest over time for a comparison set (demand / seasonality). |
| trends.related_queriesB | Top + rising related search queries for a keyword (keyword expansion). |
| trends.trending_nowB | Currently trending searches for a country (breakout demand). |
| trends.interest_by_regionC | Geographic breakdown of interest in a keyword (geo-targeting). |
| gbp.accounts.listA | List Google Business Profile accounts the authenticated user can access. |
| gbp.locations.listB | List locations under a Google Business Profile account. |
| gbp.location.getB | Fetch a single GBP location's details by resource name. |
| gbp.performance.fetchC | Fetch daily performance metrics (calls/directions/clicks/impressions) for a location. |
| gbp.reviews.listA | List reviews for a location (legacy v4 host — requires Google allowlist approval). |
| gbp.review.replyC | Reply to a review by resource name (guarded: preview + confirm token). |
| gbp.location.updateB | Update a location's fields by resource name (guarded: preview + confirm token). |
| looker.dashboards.listB | List dashboards on the Looker instance. |
| looker.looks.listB | List saved looks on the Looker instance. |
| looker.look.runB | Run a saved look by id (result_format defaults to json). |
| looker.query.runC | Run an inline model/view query with fields + filters. |
| looker.dashboard.createB | Create a dashboard under a model (guarded: validate_only preview + confirm token). |
| meridian.model.summaryB | Fit-summary rows for an already-fitted MMM (by model_id). Read-only; cheap. |
| meridian.roi.by_channelB | Per-channel ROI / contribution rows for a fitted MMM (by model_id). Read-only. |
| meridian.budget.optimizeA | Optimal per-channel allocation for total_budget under a fitted MMM. Read-only (recommends only); may run posterior simulations. |
| meridian.fitA | Fit a Bayesian MMM on dataset_ref with config; returns a model/job handle. Read-only (no account mutation) but COMPUTE-HEAVY: MCMC sampling, minutes-to-hours. |
| language.translateA | Translate text into a target language (auto-detects source if omitted). Incurs Cloud Translation API cost. |
| language.detect_languageB | Detect the dominant language of a text. Incurs Cloud Translation API cost. |
| language.analyze_sentimentA | Analyze sentiment (score + magnitude) of ad content. Incurs Cloud Natural Language API cost. |
| language.analyze_entitiesA | Extract salient entities from ad content. Incurs Cloud Natural Language API cost. |
| language.batch_translateA | Translate many texts into a target language in one call for multi-market reach. Incurs Cloud Translation API cost per text. |
| workspace.drive.list_filesB | List Drive files the authenticated user can access (optional files.list query). |
| workspace.sheets.read_rangeB | Read a cell range (A1 notation) from a spreadsheet. |
| workspace.sheets.get_metadataB | Fetch spreadsheet metadata (title, sheet tabs, grid sizes). |
| workspace.sheets.write_rangeB | Write values into an A1 range of a spreadsheet (guarded: preview + confirm token). |
| workspace.sheets.createC | Create a new spreadsheet with a title (guarded). |
| workspace.slides.create_deckC | Create a new Slides deck with a title (guarded). |
| recaptcha.keys.listB | List the reCAPTCHA site keys configured under a project. |
| recaptcha.assessment.createB | Score a reCAPTCHA token: risk score 0.0-1.0 + reasons (the lead-quality signal). |
| recaptcha.assessment.annotateC | Annotate an assessment LEGITIMATE/FRAUDULENT to improve the model (guarded). |
| adh.customers.listA | List Ads Data Hub customers (accounts) the authenticated user can access. |
| adh.queries.listB | List the stored analysis queries owned by an ADH customer. |
| adh.query.startA | Start a stored ADH analysis query over a date range; returns an operation/job ref (async, privacy-checked run — poll adh.jobs.get for the result). |
| adh.jobs.getA | Poll a started ADH analysis-query run by operation name (status + result reference). |
| adh.query.createB | Create a stored ADH analysis query (guarded: validate_only preview + confirm token). Creates only; does not run the query. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| weekly_account_audit | Full weekly audit of a Google Ads account with prioritised fixes. |
| pmax_diagnosis | Diagnose a Performance Max campaign and its asset groups. |
| search_terms_mining | Mine search terms for negatives and new keyword opportunities. |
| budget_reallocation | Reallocate budget across campaigns using performance and marginal ROI. |
| merchant_feed_optimization | Fix product issues and improve titles/descriptions in Merchant Center. |
| ga4_ads_reconciliation | Reconcile Google Ads conversions with GA4 and find tracking gaps. |
| launch_search_campaign | Research, build and launch a complete Search campaign. |
| demand_research | Research demand and seasonality before launching or scaling. |
| creative_studio | Produce a complete creative pack (copy, images, video) for a product or offer. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| capabilities | Every connector, its domain and tools (read vs write). |
| google_ads_versions | Google Ads API versions, sunset dates and the version this server targets. |
| google_ads_field_deltas | Curated 2026 Google Ads surface changes (new views, metrics, removals). |
| session | Who the server acts as: tenant, scopes, write mode and the effective policy. |
TDQS
Scored across 163 tools
Several tools have overlapping boundaries: google.api.read/call can duplicate platform-specific list/write tools, ads.mutate overlaps with ads.campaign.create_* and ads.budget.update/set_status, and multiple ad-copy/video generators serve similar goals. Descriptions help, but the generic planes create real misselection risk across a 163-tool surface.
Most tools use lowercase dot-separated namespaces such as merchant.product.insert or ga4.admin.list_properties, but the pattern varies: gtm.list_accounts, youtube.channel.get, looker.dashboards.list, and unprefixed tools like health/list_capabilities/describe_tool. The naming is still readable, but it is not one predictable convention.
At 163 tools, this is far beyond a well-scoped tool set and is extremely difficult for an agent to navigate reliably. Even if each tool serves a broad multi-platform ads suite, the count represents extreme over-provisioning.
The surface covers core read, write, reporting, analytics, and audit workflows across Google Ads, DV360, CM360, SA360, GA4, GTM, Merchant, Search Console, YouTube, BigQuery, and more, often with a generic Google API fallback. Some platform-specific CRUD or lifecycle operations are thin, such as DV360/CM360 create paths, but agents can generally work around them.