Documentation
Everything you need to connect mobile-metrix to your AI assistant and start asking questions.
1. How to connect
- Head to /setup and pick your AI client.
- Copy the snippet shown and paste it into your client (terminal or config file, depending on the client).
- Click Continue to setup and connect your Google account (GA4 + Play Console).
- Confirm the apps auto-matched across your platforms, then Save all apps.
- Paste List all my connected apps into your AI assistant to verify it's wired up.
The install snippet embeds a unique install_id. Sign in at /signin any time to see all your installs.
2. Available tools
Your AI can call these MCP tools on your behalf. You don't call them directly — just ask questions in natural language.
ga4_query
Runs queries against Google Analytics 4. Supports several report types:
- overview — users, sessions, engagement by day
- funnels — step-by-step drop-off for any event sequence
- retention — day-N cohort retention
- revenue — in-app purchases and ad revenue
- device_dropoff — where users drop out by device/OS
revenuecat_metrics
MRR, active trials, churn, LTV. Coming soon — pending RevenueCat OAuth.
apple_search_ads
Ad spend, CPI, keyword performance, ROAS (when combined with RevenueCat). Coming soon.
list_apps
Returns the apps you've linked. Useful as a sanity check that your install is wired up.
3. Troubleshooting
My AI says it doesn't have a tool called mobile-metrix.
Your MCP client hasn't picked up the server. Re-run the install command from /setup, then restart the client. On Claude Code, make sure you used --scope user so the server is available from every directory.
Google connection says "token expired or scopes changed".
Click Reconnect Google on /manage. This re-runs OAuth and stores a fresh refresh token.
My GA4 property doesn't appear in the dropdown.
Make sure the Google account you connected has at least Viewer access to the GA4 property. If you own the property under a different Google account, connect that account instead.
I lost my install URL.
Sign in at /signin to see all your installs. Your Google account is linked to every install you've created.