Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
GOOGLE_ADS_CLIENT_IDNoOAuth2 client ID for Google Ads.
QUANTUM_ADS_READ_ONLYNoIf 'true', mutations are refused until set to 'false'. Default is true.true
GOOGLE_ADS_API_VERSIONNoGoogle Ads API version. Default is v24.v24
QUANTUM_ADS_CONNECTORSNoComma-separated list of connectors to mount. Default is all connectors.
GOOGLE_ADS_CLIENT_SECRETNoOAuth2 client secret for Google Ads.
GOOGLE_ADS_REFRESH_TOKENNoOAuth2 refresh token for Google Ads.
GOOGLE_ADS_USE_PROTO_PLUSNoSet to 'True' to use proto-plus. Default is True.True
GOOGLE_ADS_DEVELOPER_TOKENNoDeveloper 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

CapabilityDetails
tools
{
  "listChanged": true
}
logging
{}
prompts
{
  "listChanged": true
}
resources
{
  "subscribe": false,
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
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...). api is the short name from google.api.list (e.g. analyticsadmin), method the id from google.api.methods (e.g. properties.customDimensions.create), params only the URL path/query parameters (e.g. parent), body the request object. Contract-checked, guarded, audited, reversible where the API allows; deletes need allow_delete.

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

NameDescription
weekly_account_auditFull weekly audit of a Google Ads account with prioritised fixes.
pmax_diagnosisDiagnose a Performance Max campaign and its asset groups.
search_terms_miningMine search terms for negatives and new keyword opportunities.
budget_reallocationReallocate budget across campaigns using performance and marginal ROI.
merchant_feed_optimizationFix product issues and improve titles/descriptions in Merchant Center.
ga4_ads_reconciliationReconcile Google Ads conversions with GA4 and find tracking gaps.
launch_search_campaignResearch, build and launch a complete Search campaign.
demand_researchResearch demand and seasonality before launching or scaling.
creative_studioProduce a complete creative pack (copy, images, video) for a product or offer.

Resources

Contextual data attached and managed by the client

NameDescription
capabilitiesEvery connector, its domain and tools (read vs write).
google_ads_versionsGoogle Ads API versions, sunset dates and the version this server targets.
google_ads_field_deltasCurated 2026 Google Ads surface changes (new views, metrics, removals).
sessionWho the server acts as: tenant, scopes, write mode and the effective policy.

TDQS

C2.5/5.0

Scored across 163 tools

Disambiguation2/5

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.

Naming Consistency3/5

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.

Tool Count1/5

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.

Completeness4/5

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.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues