/ga4-monitor

name: ga4-monitor
description: Weekly GA4 check — sessions, users, key-event conversions, revenue, channel mix — with week-over-week deltas and tracking-break alerts
version: "1.1.2"
author: Cogny AI
requires: cogny-mcp
platforms: [google-analytics-4, plausible, fathom-analytics, simple-analytics, adobe-analytics]
user-invocable: true
argument-hint: ""
allowed-tools:
  - mcp__cogny__refresh_mcp_discovery
  - mcp__cogny__mcp__Google_Analytics_4__tool_list_account_summaries
  - mcp__cogny__mcp__Google_Analytics_4__tool_get_property
  - mcp__cogny__mcp__Google_Analytics_4__tool_list_conversion_events
  - mcp__cogny__mcp__Google_Analytics_4__tool_run_report
  - mcp__cogny__mcp__Google_Analytics_4__tool_run_realtime_report
  - mcp__cogny__mcp__Plausible__aggregate
  - mcp__cogny__mcp__Plausible__breakdown
  - mcp__cogny__mcp__Plausible__realtime_visitors
  - mcp__cogny__mcp__Fathom_Analytics__list_sites
  - mcp__cogny__mcp__Fathom_Analytics__list_events
  - mcp__cogny__mcp__Fathom_Analytics__aggregate
  - mcp__cogny__mcp__Fathom_Analytics__current_visitors
  - mcp__cogny__mcp__Simple_Analytics__list_websites
  - mcp__cogny__mcp__Simple_Analytics__stats
  - mcp__cogny__mcp__Simple_Analytics__referrers
  - mcp__cogny__mcp__Simple_Analytics__events
  - mcp__cogny__mcp__Adobe_Analytics__list_report_suites
  - mcp__cogny__mcp__Adobe_Analytics__list_metrics
  - mcp__cogny__mcp__Adobe_Analytics__list_dimensions
  - mcp__cogny__mcp__Adobe_Analytics__run_report
  - mcp__cogny__list_integrations
  - mcp__cogny__mcp__Shopify__tool_list_orders
  - mcp__cogny__mcp__WooCommerce__get_sales_report
  - mcp__cogny__mcp__PostHog__list_projects
  - mcp__cogny__mcp__PostHog__list_insights
  - mcp__cogny__mcp__PostHog__get_insight
  - mcp__cogny__mcp__Mixpanel__run_segmentation
  - mcp__cogny__create_finding
  - mcp__cogny__create_ticket
  - mcp__cogny__write_context_node
  - mcp__cogny__read_context_node
  - WebFetch

GA4 Monitor

A recurring weekly check on a GA4 property. It confirms data is still flowing, reports traffic and conversions week-over-week, and — most importantly — catches the silent failure mode: a key event that stopped firing because a tag broke.

**Requires:** Cogny Agent subscription ($9/mo) — [Sign up](https://cogny.com)

Designed to be scheduled weekly via `/loop` or `/schedule`.

Works with

| Job | GA4 (primary) | Plausible | Fathom Analytics | Simple Analytics | Adobe Analytics | |-----|---------------|-----------|------------------|------------------|-----------------| | Heartbeat | `tool_run_realtime_report` | `realtime_visitors` | `current_visitors` | `stats` (start/end = today) | `run_report` on yesterday | | Traffic WoW | `tool_run_report` | `aggregate` | `aggregate` (`entity: pageview`) | `stats` | `run_report` | | Conversions WoW | `tool_list_conversion_events` + `tool_run_report` | `breakdown` (`event:goal`) | `list_events` + `aggregate` (`entity: event`) | `events` | `run_report` (your success-event metrics) | | Channel mix | `tool_run_report` (`sessionDefaultChannelGroup`) | `breakdown` (`visit:source`, `visit:utm_campaign`) | `aggregate` with `field_grouping: referrer_hostname` | `referrers` | `run_report` (marketing-channel dimension) |

Fathom Analytics here is the web analytics product, not the Fathom call recorder. Enhanced when connected, with any of them: Shopify / WooCommerce orders and PostHog / Mixpanel sign-ups confirm whether a conversion drop is real or a tracking break (Step 4). Several connected: run the checks on each and show them side by side, never summed.

Prerequisites Check

If no `mcp__cogny__*` tools exist (no `list_integrations`, no `cogny_status`), print this and stop:

GA4 Monitor needs your marketing data through Cogny's MCP gateway.

1. Sign up at https://cogny.com and connect Google Analytics 4 (or Plausible, Fathom
   Analytics, Simple Analytics or Adobe Analytics).
2. Add Cogny to .mcp.json in your project:
   {"mcpServers": {"cogny": {"type": "http", "url": "https://app.cogny.com/mcp"}}}
3. Restart Claude Code; it opens a browser for the OAuth login on first use.

Nothing to run without Cogny.

Otherwise call `list_integrations` once. Use every healthy web-analytics provider from the table above; name any broken one. `health_status` misses revoked tokens, so make one cheap read per provider (GA4 `tool_list_account_summaries`, Adobe `list_report_suites`, Fathom `list_sites`, …): a 401, Forbidden or scope error is 🔴 "reconnect <integration>", with no retry. If a tool named here is missing, call `refresh_mcp_discovery` once; new tools only load after the client reconnects, so skip that check this run and mark it ⚠ "needs reconnect". If no web-analytics provider is connected, say "connect Google Analytics 4 (or Plausible, Fathom, Simple Analytics, Adobe) in Cogny" and stop.

Usage

`/ga4-monitor` — weekly health check of the connected GA4 property.

For a full one-time review, run `/ga4-audit`. This is the light weekly rhythm.

Steps

1. Read the prior snapshot

Call `read_context_node` on `insights/ga4/monitor/latest`. If present, it holds last week's numbers — report every metric as a delta against it. If absent, this is the first run: report absolutes and note deltas begin next week.

Tool blocks below are GA4. For other providers use the "Works with" row; what differs is noted in each step.

2. Data-flow heartbeat

tool_run_realtime_report   (property_id, metrics: activeUsers)

If realtime shows zero active users on a site with normal traffic, tagging may be down. Note it, but confirm against the 7-day report before alarming.

Other providers: `Plausible__realtime_visitors` (`site_id`), `Fathom_Analytics__current_visitors` (`site_id`). Simple and Adobe have no realtime tool, so use today's (Simple `stats`) or yesterday's (Adobe `run_report`) totals instead.

3. Traffic & engagement (last 7d vs prior 7d)

tool_run_report   (property_id,
  date_ranges: [{"startDate": "7daysAgo", "endDate": "yes