ga4_check_compatibility
ChatGPTWhether a dimension/metric combination can appear in one report together — GA4 forbids many pairings. Run this before a complex report instead of burning quota on a rejected request.
ga4_compare_first_and_session_channels
ChatGPTPreset acquisition-scope report: conversions, totalRevenue, and sessions grouped jointly by firstUserDefaultChannelGroup and sessionDefaultChannelGroup, ordered by conversions descending. Use to examine first-user and session acquisition channel combinations. It does not compare attribution models or calculate changes in conversion credit. Returns snake_case top-level report fields: rows are records keyed by GA4 dimension and metric API names, with values returned as strings; row_count is the unpaged total, and totals is populated only when Google returns aggregates.
ga4_estimate_report_rows
ChatGPTRuns a one-row GA4 report request and returns its unpaged row_count and property_quota, without returning report rows. This preflight consumes Data API quota. Use it to size a high-cardinality report (e.g. pagePath by date) before fetching the full report.
ga4_get_campaign_performance
ChatGPTPreset acquisition report: sessions, totalUsers, conversions, totalRevenue, and averageSessionDuration grouped by sessionCampaignName and sessionSourceMedium, ordered by sessions descending. Use for campaign acquisition outcomes, with a dimension_filter to focus on paid traffic. Ad spend, ROAS and a Google Ads campaign-record join are not included. Returns snake_case top-level report fields: rows are records keyed by GA4 dimension and metric API names, with values returned as strings; row_count is the unpaged total, and totals is populated only when Google returns aggregates.
ga4_get_conversions_by_channel_and_campaign
ChatGPTPreset channel/campaign report: conversions, totalRevenue, and sessions grouped by sessionDefaultChannelGroup and sessionCampaignName, ordered by conversions descending. Use to compare session channel and campaign conversion outcomes. Aggregate rows only, not multi-step conversion paths or assisted-conversion credit. Returns snake_case top-level report fields: rows are records keyed by GA4 dimension and metric API names, with values returned as strings; row_count is the unpaged total, and totals is populated only when Google returns aggregates.
ga4_get_custom_dimensions_and_metrics
ChatGPTThe property's registered custom dimensions and custom metrics, with scope and the event parameter each is bound to. Read this when a business-specific question needs fields the standard schema lacks.
ga4_get_ecommerce_performance
ChatGPTPreset e-commerce report: itemsViewed, itemsAddedToCart, itemsPurchased, and itemRevenue grouped by itemName, ordered by itemRevenue descending. Use to compare product engagement and sales; source/campaign breakdowns and transaction counts are not included. Returns snake_case top-level report fields: rows are records keyed by GA4 dimension and metric API names, with values returned as strings; row_count is the unpaged total, and totals is populated only when Google returns aggregates.
ga4_get_landing_page_performance
ChatGPTPreset landing-page report: sessions, totalUsers, engagementRate, averageSessionDuration, conversions, and totalRevenue grouped by landingPagePlusQueryString, ordered by sessions descending. Use to compare entry-page engagement and conversion outcomes; query strings are part of the page grouping. Returns snake_case top-level report fields: rows are records keyed by GA4 dimension and metric API names, with values returned as strings; row_count is the unpaged total, and totals is populated only when Google returns aggregates.
ga4_get_metadata
ChatGPTEvery dimension and metric API name this property can report on, standard and custom, with descriptions. Check names here BEFORE building a report — guessing an API name is the top cause of rejected report requests.
ga4_get_property_details
ChatGPTOne property's configuration: display name, time zone, currency, industry category, and creation time. The time zone matters before any daily report — GA4 buckets days in the property's zone, not UTC.
ga4_list_account_summaries
ChatGPTThe user's connected GA4 accounts with their properties — each property row carries the exact property_id ('properties/<digits>') every other ga4_* tool takes. Start here in every conversation: an empty list means the user has not connected Google Analytics yet — tell them to reconnect this connector from their MCP client's settings and complete its connect step — and plan_notice explains properties held back by the user's plan.
ga4_list_google_ads_links
ChatGPTThe Google Ads accounts linked to one property, with each link's personalization and auto-tagging settings. No links means Ads campaign data cannot appear in this property's acquisition reports.
ga4_run_funnel_report
ChatGPTStep-by-step funnel analysis: how many users complete and abandon each step of a journey you define (e.g. view item → add to cart → purchase). Takes the GA4 Data API's Funnel object; returns Google's funnel table and visualization objects.
ga4_run_realtime_report
ChatGPTRecent property activity: active users and events over the last 30 minutes by default, or the supplied minute_ranges. Realtime accepts its own smaller set of dimensions and metrics, at most 4 dimensions and no date ranges. Standard report metrics such as sessions and totalRevenue are not valid here. Returns snake_case top-level report fields: rows are records keyed by GA4 dimension and metric API names, with values returned as strings; row_count is the unpaged total, and totals is populated only when Google returns aggregates.
ga4_run_report
ChatGPTThe general GA4 report: any dimensions and metrics over 1-4 date ranges, with Google's filter, ordering, and pagination objects passed through verbatim. The workhorse for custom questions — reach for the preset ga4_get_* tools first when one fits. Returns snake_case top-level report fields: rows are records keyed by GA4 dimension and metric API names, with values returned as strings; row_count is the unpaged total, and totals is populated only when Google returns aggregates.
hypd_search_help
ChatGPTSearches HYPD's help center for articles that answer a question about HYPD itself: connecting or reconnecting ad accounts, plans, billing and credits, privacy and data access, what HYPD can do, and setting HYPD up in Claude, ChatGPT or other AI clients. Returns the matching articles' text and links; answer from them and cite them. Not for advertising advice or the user's account data; use the platform tools for those.
init
ChatGPTReturns the GA4 guide for this server — call it first in a new conversation. Covers what each ga4_* tool reads, the recommended workflow (list properties, verify the schema, run reports), the property_id and date conventions, what to do when no properties are connected, and starter prompts.