run_gaql

MCP tool from Adloop by kLOsk

Arbitrary GAQL queries for anything else

How to use it

run_gaql is exposed by the Adloop MCP server. Add the server to your MCP client (Claude Desktop, Cursor, Windsurf and others), and the run_gaql tool becomes available to the model automatically. See the full listing for setup details and every tool this server provides.

Install Adloop

$claude mcp add --transport stdio adloop -- /absolute/path/to/adloop/.venv/bin/python -m adloop

FULL ADLOOP LISTING

Other tools in Adloop (39)

analyze_campaign_conversions

Maps Ads clicks → GA4 sessions → conversions per campaign. Detects GDPR consent gaps, computes real CPA, compares paid vs organic channels.

attribution_check

Compares Ads-reported conversions vs GA4 events. Diagnoses whether discrepancies are from GDPR consent, attribution windows, or broken tracking.

audit_event_coverage

The flagship. Three-way join: codebase events ↔ GTM tags ↔ GA4 actual fires. For each event name in expectedevents, returns one of 10 statuses (ok, notagnofire, tagpaused, tagactivebutnotfiring, gtmonlyfiring, ga4only, etc.) plus auto-generated insights for the gaps.

generate_tracking_code

Generate ready-to-paste GA4 gtag JavaScript for any event, with recommended parameters for well-known events (signup, purchase, etc.) and optional trigger wrappers.

get_account_summaries

List GA4 accounts and properties

get_ad_performance

Ad copy analysis — headlines, descriptions, CTR

get_asset_performance

Per-asset details for PMax — field type, serving status, content

get_audience_performance

Audience segment performance — remarketing, in-market, affinity, demographics

get_campaign_performance

Campaign metrics — impressions, clicks, cost, conversions, CPA

get_demographic_targeting

List demographic criteria (age/gender/parental status/income) on an ad group or campaign

get_detailed_asset_performance

Top-performing asset combinations — which headline+description+image combos Google selects most

get_gtm_tag

Full raw config for a single tag — every parameter, firing/blocking triggers with filter conditions, priority, pause status, sampling

get_gtm_trigger

Full trigger config + reverse lookup of every tag that uses it. Includes parsed elementvisibility block (selector, on-screen ratio, firing frequency) for elementVisibility triggers and groupmembertriggerids for triggerGroup types

get_gtm_version

Full metadata + tag/trigger names for a single historical container version

get_gtm_workspace_diff

Drafted-but-not-published changes — common cause of "I edited a tag but nothing happened". Returns isclean: true when nothing is pending.

get_keyword_performance

Keywords — quality scores, competitive metrics

get_negative_keyword_list_campaigns

List which campaigns a shared negative keyword list is attached to

get_negative_keyword_list_keywords

List the keywords inside a specific shared negative keyword list

get_negative_keyword_lists

List all shared negative keyword lists (SharedSets) — names, IDs, status, keyword count

get_negative_keywords

List direct campaign-level negative keywords

get_pmax_performance

Performance Max campaign metrics with network breakdown + asset group ad strength

get_recommendations

Google's auto-generated recommendations with type, estimated impact, and campaign context

get_search_terms

What users actually searched before clicking

get_tracking_events

All configured events and their volume

health_check

Test OAuth, GA4, and Ads connectivity in one call — actionable error messages if anything is broken. Also reports the pinned Google Ads API version and warns if a newer version is available.

landing_page_analysis

Joins ad final URLs with GA4 page data. Shows conversion rate, bounce rate, and engagement per landing page. Flags pages with paid traffic but zero conversions.

list_accounts

Discover accessible Ads accounts

list_gsc_sites

List Search Console properties the connected account can access

list_gtm_accounts

Discover accessible GTM accounts

list_gtm_containers

List containers under an account — returns numeric containerid (needed by other tools), public GTM-XXXXXXX ID, and usage context (web/iOS/Android/server)

list_gtm_tags

Every tag in the live container with parsed event names and resolved firing/blocking trigger names

list_gtm_triggers

Every trigger with filter conditions parsed to readable text (e.g. {{Page Path}} contains service-promotions, {{Form ID}} NOT contains wf-form-...). Renders the negate flag explicitly.

list_gtm_variables

Custom variables (data layer, constants, JS) plus enabled built-in variables

list_gtm_versions

Publish history with version IDs and entity counts. Use to correlate a metric drop with a recent publish.

list_gtm_workspaces

List drafts (workspaces) under a container — workspace IDs are needed by getgtmworkspacediff

run_ga4_report

Custom reports — sessions, users, conversions, page performance

run_gsc_report

Organic search analytics — clicks, impressions, CTR, position by query/page/country/device/date

run_realtime_report

Live data — verify tracking fires after deploys

validate_tracking

Compare event names found in your codebase against what GA4 actually records. Returns matched, missing, and unexpected events with diagnostics.