GA4 MCP Skills Library

15 analytical recipes, each one a page plus an MCP resource at skill://<slug>. Load one in a session with search_skills("<slug>"); the text below is the same content the agent receives.

Analytical recipes for common GA4 analysis patterns. Each skill gives you the exact dimensions, metrics, filters, and interpretation logic to answer a specific question using the tools already available in this MCP.

To use a skill: call search_skills("skill-name") to fetch the full instructions. To browse: call search_skills("") to see this index.

• AI Referral Analysis

  Measure traffic arriving from AI tools — ChatGPT, Claude, Perplexity, Gemini, Copilot, and others — and understand how it behaves compared to other channels.

  skill://ai-referral-analysis

• Attribution Scope

  GA4 has three distinct attribution scopes. Using the wrong scope gives misleading results. Choose based on the question you are answering.

  skill://attribution-scope

• Bot Traffic Detection

  Identify and exclude bot, scraper, and spam sessions from GA4 data.

  skill://bot-traffic-detection

• Channel Acquisition Analysis

  Break down sessions and users by traffic source, medium, and channel group to understand where your audience comes from and which channels perform best.

  skill://channel-acquisition

• Common Metric & Dimension Names

  The correct GA4 Data API names for fields models most often get wrong. Use these before calling getga4data — wrong names return a hard error.

  skill://common-metric-names

• Compatible Dimension and Metric Combinations

  GA4 enforces strict rules about which dimensions and metrics can appear in the same request. Incompatible combinations return a 400 error: \"The request's dimensions & metrics are incompatible.\

  skill://compatible-combinations

• Content Performance Analysis

  Identify top-performing pages, find underperforming content, and understand engagement patterns across your site.

  skill://content-performance

• Custom Dimensions and Event Parameters

  How to find and query property-specific custom dimensions in GA4.

  skill://custom-dimensions

• Date Ranges

  How to specify date ranges in getga4data and how to structure period-over-period comparisons.

  skill://date-ranges

• Ecommerce Analysis

  Revenue, conversion rate, AOV, and funnel drop-off using GA4 ecommerce events.

  skill://ecommerce-analysis

• Filter Structures

  The correct shape for dimensionfilter in getga4data. Wrong structure returns an \"Invalid dimensionfilter\" error. Use these templates.

  skill://filter-structures

• GA4 API Limitations

  What this MCP cannot do via the GA4 Data API, and where to go instead. Attempting these will either fail or produce meaningless aggregate data.

  skill://ga4-limitations

• Geo and Device Segmentation

  Break down user behaviour by country, city, device category, and OS to understand regional patterns and optimise for your key markets.

  skill://geo-device-segmentation

• Traffic Change Diagnosis

  Systematically diagnose why traffic changed — spike, drop, or shift in mix. Follow these steps in order. Each step narrows the hypothesis.

  skill://traffic-diagnosis

• UA to GA4 Field Name Mapping

  Universal Analytics (UA) and GA4 use different names for equivalent concepts. UA was sunset on 2023-07-01; models trained before or around then guess UA field names that no longer exist in the GA4 Data API. On 2024-05-06 GA4 also renamed \"conversions\" to \"key events\" (see the conversions rows below). If a name feels obviously right but returns \"Invalid metric/dimension\", assume your training predates the change and verify with searchschema. This skill gives the correct GA4 Data API name for every common UA metric and dimension.

  skill://ua-to-ga4

Machine-readable index: /data/skills.json. Markdown twin: /skills/index.md.