Documentation
Everything you need to connect mobile-metrix to your AI assistant and start asking questions.
1. How to connect
- Head to /install 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. Keep that URL — it's your only way back in. Use the recovery-email widget on /install if you want a backup link.
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 /install, 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 /connect. 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.
If you saved a recovery email, check your inbox for a recovery link. If not, you'll need to start over at /install — OAuth connections can be re-linked to a new install.