Google Analytics
Read ../shared/operating-contract.md. Use the live NotFair Google Analytics MCP at https://notfair.co/api/mcp/google_analytics as the source of truth.
Select the property and question
- Resolve
~~google-analytics to the actual GA4 connector and inspect its current tools. Confirm access with listProperties or the equivalent harmless property-list read.
- Select the exact
properties/123456789 resource returned by the connector. Never substitute a G- measurement ID or Google account ID.
- Define the business question, primary metric, conversion or key-event definition, property timezone, date range, and comparison window. If the connector is missing or unauthorized, provide the endpoint/setup path and stop before claiming live data.
Pull decision-grade evidence
Use runScript for multi-report analysis and correlation. Fan out the smallest useful set of reports across channel, source/medium, campaign, landing page, device, geography, or event; use the typed runReport, realtime, or metadata reads for a single narrow task.
- Compare complete equivalent periods and show absolute values plus deltas.
- Use metadata before guessing an unfamiliar dimension/metric pair. Respect the current API's dimension, metric, fan-out, and quota limits exposed by the tool.
- Check response metadata for sampling, thresholding, or quota warnings. A collapsed
(other) row means detailed rows may not sum to the total.
- Treat recent/intraday data as provisional and state the property's timezone.
- Keep GA4 attribution separate from ad-platform attribution. Explain discrepancies instead of blending incompatible numbers.
- Do not claim causality from a correlated channel or page change without supporting evidence.
Lead with what changed, where it changed, the evidence-backed likely driver, confidence, and the next measurement or business action. Include the report definition so another operator can reproduce it.
Change measurement configuration
Use only dedicated mutation tools for supported key-event and custom-dimension changes. Show the exact property, current state, proposed state, downstream reporting impact, and rollback before asking for approval.
- Creating and deleting a key event are reversible counterparts when the same event definition is available.
- Archiving a custom dimension is irreversible in GA4 and its parameter name cannot be reused. Require explicit approval that names the property and dimension before archiving.
- Never wrap a mutation in
runScript.
- Confirm success from returned before/after evidence or a fresh configuration read; report partial failures without retrying blindly.
Do not describe a report as saved or a dashboard as published unless the connected tool explicitly supports that operation and confirms it.
1---2name: google-analytics3description: Analyze connected Google Analytics 4 traffic, acquisition, engagement, landing pages, ecommerce, events, and conversions, and safely manage supported GA4 key events or custom dimensions through NotFair MCP. Use for GA4, Google Analytics, traffic or conversion drops, channel attribution, realtime activity, report requests, measurement configuration, or Analytics MCP setup.4---5
6# Google Analytics
7
8Read `../shared/operating-contract.md`. Use the live NotFair Google Analytics MCP at `https://notfair.co/api/mcp/google_analytics` as the source of truth.
9
10## Select the property and question
11
121. Resolve `~~google-analytics` to the actual GA4 connector and inspect its current tools. Confirm access with `listProperties` or the equivalent harmless property-list read.
132. Select the exact `properties/123456789` resource returned by the connector. Never substitute a `G-` measurement ID or Google account ID.
143. Define the business question, primary metric, conversion or key-event definition, property timezone, date range, and comparison window. If the connector is missing or unauthorized, provide the endpoint/setup path and stop before claiming live data.
15
16## Pull decision-grade evidence
17
18Use `runScript` for multi-report analysis and correlation. Fan out the smallest useful set of reports across channel, source/medium, campaign, landing page, device, geography, or event; use the typed `runReport`, realtime, or metadata reads for a single narrow task.
19
20- Compare complete equivalent periods and show absolute values plus deltas.
21- Use metadata before guessing an unfamiliar dimension/metric pair. Respect the current API's dimension, metric, fan-out, and quota limits exposed by the tool.
22- Check response metadata for sampling, thresholding, or quota warnings. A collapsed `(other)` row means detailed rows may not sum to the total.
23- Treat recent/intraday data as provisional and state the property's timezone.
24- Keep GA4 attribution separate from ad-platform attribution. Explain discrepancies instead of blending incompatible numbers.
25- Do not claim causality from a correlated channel or page change without supporting evidence.
26
27Lead with what changed, where it changed, the evidence-backed likely driver, confidence, and the next measurement or business action. Include the report definition so another operator can reproduce it.
28
29## Change measurement configuration
30
31Use only dedicated mutation tools for supported key-event and custom-dimension changes. Show the exact property, current state, proposed state, downstream reporting impact, and rollback before asking for approval.
32
33- Creating and deleting a key event are reversible counterparts when the same event definition is available.
34- Archiving a custom dimension is irreversible in GA4 and its parameter name cannot be reused. Require explicit approval that names the property and dimension before archiving.
35- Never wrap a mutation in `runScript`.
36- Confirm success from returned before/after evidence or a fresh configuration read; report partial failures without retrying blindly.
37
38Do not describe a report as saved or a dashboard as published unless the connected tool explicitly supports that operation and confirms it.
majiayu000