amekala/ads-mcp/adspirer-google-analytics

Google Analytics 4

The router is google_analytics. It appears only when GA4 is connected. Follow adspirer-mcp: {"action": "list_tools"} first, then execute an exact name from that list. get_tool_schema before you execute.

If the router is missing, or it says GA4 isn't connected, say so and point the user at https://adspirer.ai/connections. Don't insist the tool exists.

Typical reads, using whatever the live list actually calls them: list property options, then run a report with property set to properties/<id>. Send an account_id only when several GA accounts are connected and the schema asks for it.

Pick the property out loud

If several properties come back, show the list (name and id) and let the user choose. Never guess a property id. If they say "all", warn that it costs one call per property and confirm before you loop.

Confirm the dates, the timezone, the currency, and that the dimensions and metrics you chose are valid together.

What to pull for a paid-media question

Acquisition (session source and medium, paid versus organic), landing page, engagement, and key events. That is enough for most "is paid sending the right traffic?" questions.

Keep users, sessions, events, and key events separate. Never add incompatible metrics together. Explain that GA4 attribution and reporting lag differ from the ad platform. If the response says it was sampled or thresholded, say that.

Don't mix it into the ad totals

GA4 key events are not Google Ads conversions and not Meta results. Report them beside the ad numbers, labeled as GA4. Never add them to ad conversions, and never use a GA4 count to fill a missing ad conversion.

A key event that doesn't appear in one report doesn't prove the ad tag is broken. Tracking method is adspirer-ads-manager-browser. Tag configuration is adspirer-tag-manager.

Start read-only. A configuration change needs its own yes, and only if the live tool list even offers one. Follow adspirer-agent on evidence and on not retrying a write you haven't read back.