rankloop-mcp
Provides tools for running GA4 reports and realtime queries, listing valid dimensions and metrics, and managing GA4 admin resources such as properties, key events, custom dimensions, and chart annotations.
Provides tools for querying Search Console performance data such as clicks, impressions, CTR, and position by query, page, country, device, date, and search appearance. Also supports inspecting a URL's index status and listing, submitting, or deleting sitemaps.
Provides Lighthouse lab metrics and real-user Core Web Vitals such as LCP, INP, and CLS for URLs through PageSpeed Insights.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
rankloop-mcp
MCP server that gives Claude Code, Claude Desktop, Cursor and other MCP clients direct access to Google Search Console, GA4 and PageSpeed Insights.
Phase 1 (this release): read and manage your Google SEO data. Audits, auto-fixes, competitor research and AEO/GEO are on the roadmap.
Tools
Tool | What it does |
| Shows which credentials work and lists your Search Console sites and GA4 properties. Run first. |
| Clicks, impressions, CTR and position by query, page, country, device, date, search appearance |
| Google's index status for one URL (2,000/day per property, tracked locally) |
| List, submit, delete sitemaps |
| GA4 reports, realtime, and the list of valid dimensions/metrics |
| List properties, key events, custom dimensions; create them; add chart annotations |
| Lighthouse lab metrics + real-user Core Web Vitals (LCP, INP, CLS) |
Related MCP server: mcp-server-google-search-console
Requirements
Node.js 22.18 or newer.
1. Google Cloud setup (once)
Create or pick a project at https://console.cloud.google.com.
Enable: Google Search Console API, Google Analytics Data API, Google Analytics Admin API, PageSpeed Insights API.
Choose one way to sign in:
Option A: OAuth (your own Google account)
APIs & Services → OAuth consent screen: user type External, add yourself as a test user.
Set publishing status to In production. In "Testing", Google expires refresh tokens after 7 days. For personal use you can skip verification; Google shows an "unverified app" warning you can click through.
Credentials → Create credentials → OAuth client ID → Desktop app. Copy the client ID and secret.
Run once (PowerShell shown; use
exporton macOS/Linux):$env:GOOGLE_OAUTH_CLIENT_ID="..."; $env:GOOGLE_OAUTH_CLIENT_SECRET="..."; npx -y rankloop-mcp authA browser opens; approve. The token is saved to
~/.rankloop-mcp/token.json.
Option B: Service account (servers, CI, agencies)
IAM & Admin → Service accounts → create one → Keys → Add key → JSON.
Search Console → Settings → Users and permissions → add the service-account email.
GA4 → Admin → Property access management → add the service-account email as Viewer (Editor if you enable writes).
Set
GOOGLE_APPLICATION_CREDENTIALSto the JSON file path in the MCP config below.
For pagespeed: create an API key (APIs & Services → Credentials → API key) and set PAGESPEED_API_KEY. Calls without a key share one global Google quota and usually fail with 429.
2. Add to your MCP client
Claude Code:
claude mcp add --transport stdio rankloop-mcp -- npx -y rankloop-mcpClaude Desktop / Cursor (mcpServers in the client's config file):
{
"mcpServers": {
"rankloop-mcp": {
"command": "npx",
"args": ["-y", "rankloop-mcp"],
"env": { "PAGESPEED_API_KEY": "your-api-key" }
}
}
}For a service account, add "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/key.json" to env.
Then ask: "Run setup_check, then show my top 20 queries in Search Console for the last 28 days."
Environment variables
Variable | Default | Purpose |
| unset | Service-account JSON path (takes precedence over OAuth) |
| unset | Only needed when running |
| unset | Needed for |
|
| Allow sitemap submit/delete and GA4 creates |
|
| Token and local database location |
Safety
Read-only by default. Writes need
RANKLOOP_MCP_ALLOW_WRITES=trueand a token with write scopes (re-runrankloop-mcp authafter enabling).Every write defaults to
dryRun: trueand shows what would change.Credentials stay on your machine. Nothing is sent anywhere except Google's APIs.
Roadmap
✅ Google: Search Console, GA4, PageSpeed
Site audit (crawl, rules, health score) + opportunities (striking-distance keywords, CTR gaps, cannibalization, decay)
Fix loop: fix specs for your repo + WordPress auto-apply with rollback
Competitor + keyword research (DataForSEO, SerpAPI, Ahrefs)
AEO/GEO: AI crawler access, llms.txt, citability, AI answer visibility
Development
npm install
npm test
npm run typecheck
npm run buildLicense
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Google Search Console, GA4, Bing Webmaster and PageSpeed MCP for Claude, ChatGPT, Cursor. Free.
Ask Claude, ChatGPT or any MCP client about your Google Analytics 4 and Search Console data, plus Bing Webmaster Tools when connected, for every site you manage, with one Google sign-in. Read only: traffic changes, why a page dropped, top queries and pages, quick-win queries, AI assistant referral traffic, URL indexing, sitemaps, custom GA4 reports and client reports. Built for site owners and agencies with many sites. Free for 1 site.
SEO & marketing toolkit for AI agents: GA4, Search Console, AdSense, GTM, PageSpeed, Trends.
Google Search Console, Bing, GA4 and SEO reports for Claude, ChatGPT and any MCP client
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables interaction with Google Search Console to query search analytics, inspect URL indexing status, and manage sitemaps. It allows users to monitor SEO performance and site health through natural language commands in MCP-compatible clients.3MIT
- AlicenseNot gradedqualityCmaintenanceEnables interaction with Google Search Console via MCP, offering search analytics, performance summaries, URL inspection, sitemap management, and property listing for SEO workflows.318 npm1MIT
- AlicenseNot gradedqualityCmaintenanceEnables natural-language querying of Google Search Console data, including search analytics, site properties, URL inspection, and sitemap status, through MCP-compatible clients like ChatGPT and Claude.MIT
- AlicenseAqualityBmaintenanceEnables Claude and other MCP clients to read Google Search Console and Bing Webmaster Tools data, analyze query/page performance, compare periods, inspect indexing and canonical status, and retrieve sitemap and keyword statistics.2368 npmMIT