Skip to main content
Glama

Opus Growth, Ad Platforms MCP Connector

Google Ads Query (GAQL)

google_ads_query
Read-onlyIdempotent

Runs ANY read-only Google Ads Query Language (GAQL) SELECT against a connected Google Ads account and returns the raw rows — the escape hatch for data no other tool exposes: any resource (campaign, ad_group, ad_group_ad, ad_group_criterion, keyword_view, search_term_view, change_event, change_status, asset, conversion_action, customer_client, bidding_strategy, geographic_view, user_location_view, landing_page_view, recommendation, ...), any metric and any segment the Google Ads API supports. GAQL can only READ; it cannot change the account. Reference: https://developers.google.com/google-ads/api/docs/query/overview and the field list per resource at https://developers.google.com/google-ads/api/fields (use the version this server runs; field names occasionally change between API versions, e.g. campaign.start_date_time). Rules: start with SELECT; metrics need a date filter or segments.date range for meaningful periods (e.g. WHERE segments.date DURING LAST_30_DAYS); money fields are in micros (divide by 1,000,000, account currency). Prefer list_entities / get_report when they already answer the question — they normalise statuses (is_serving) and currencies. limit = rows returned to you (max 2000); total_rows tells you if more exist — narrow the query instead of paging through huge results. customer_id empty = the default connected account.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
limitNo
queryYes
customer_idNo

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. Added

TDQS

Score is being calculated.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.