Docs
Rankvisit connects Google Search Console and privacy-friendly analytics to your AI assistant. Everything is read-only.
How it works
- Sign in with Google. This creates your Rankvisit account.
- Connect your data. Allow read-only access to Google Search Console. Optionally add a Fathom Analytics or Simple Analytics API key.
- Choose a plan. Monthly or yearly.
- Add Rankvisit to your assistant. Your assistant opens a browser window: sign in with Google and click Allow.
- Ask. Your assistant calls Rankvisit's tools when your question needs search or analytics data.
Setup
MCP address for all assistants: https://rankvisit.com/mcp
Claude Code, Codex and Cursor (agents)
Send this instruction to your agent. It adds Rankvisit and starts the sign-in for you:
Read https://rankvisit.com/INSTALL.md and connect Rankvisit.
Or do it yourself:
- Claude Code:
claude mcp add --transport http --scope user rankvisit https://rankvisit.com/mcp, thenclaude mcp login rankvisit - Codex:
codex mcp add rankvisit --url https://rankvisit.com/mcp, thencodex mcp login rankvisit - Cursor: add
"rankvisit": { "url": "https://rankvisit.com/mcp" }undermcpServersin~/.cursor/mcp.json, then click Connect in Cursor Settings → MCP.
Claude.ai
- Open Claude and go to Settings → Connectors.
- Click "Add custom connector".
- Name it "Rankvisit", paste the MCP address, and click Add.
- Click Connect and sign in with Google.
ChatGPT
- Open ChatGPT and go to Settings → Apps & Connectors.
- Choose "Create" to add a custom connector.
- Name it "Rankvisit", paste the MCP address, and choose OAuth.
- In a new chat, pick Rankvisit from the tools menu and sign in with Google.
Custom connectors may require a paid ChatGPT plan.
Tools
All tools are read-only. Analytics tools appear only when you connected that tool. After you connect a new one, reconnect your assistant so that it loads the new tools.
Google Search Console
google_search_console_list_properties: lists your properties. Your assistant uses it to find the right site.google_search_console_query: clicks, impressions, CTR and average position, optionally grouped by query, page, country, device or date, with filters. Up to 1,000 rows.
Fathom Analytics
fathom_list_sites: lists your Fathom sites.fathom_get_stats: visits, unique visitors and pageviews, optionally for each page.
Simple Analytics
simpleanalytics_list_sites: lists your websites.simpleanalytics_get_stats: pageviews and visitors, optionally for each page.
Rankvisit
rankvisit_compare_pages: joins Search Console clicks, impressions and position with real visits from your analytics tool, page by page (matched by URL path). Use it to find pages with many impressions but few visits.
Example prompts
- "Which pages get many Google impressions but few real visits?"
- "Which pages lost Google clicks this month compared to last month?"
- "What are the top 20 queries for example.com in the last 28 days, with CTR and position?"
- "Compare Google clicks and Simple Analytics visitors for my blog pages."
- "How many pageviews did example.com have last week compared to the week before?"
Tip: name the site and the period in your question.
Data and limits
- Search Console data is about 2–3 days behind. The most recent days can be incomplete.
- A date range can be at most 500 days. Search Console keeps about 16 months of data.
- Analytics dates use the time zone of the site in Fathom or Simple Analytics.
- Rankvisit does not store copies of your search or analytics data. Every answer reads fresh data.
Troubleshooting
"subscription_required"
Your plan is not active. Choose a plan in Rankvisit, then ask again.
"source_not_connected"
The tool needs a connection that is missing. Open the dashboard and add it under Connections.
The assistant does not show the Fathom or Simple Analytics tools
Reconnect your assistant after you added the analytics tool. Assistants load the tool list when they connect.
The assistant asks to sign in again
This is expected after you removed the assistant in the dashboard, or after a long time without use. Sign in with Google and click Allow.
Still stuck?
See support.
What Rankvisit does not do
- It never changes data in Search Console or your analytics tool.
- It does not show data of sites that you cannot access yourself (no competitor data).
- It supports Fathom Analytics and Simple Analytics today. Plausible is coming soon.