Back to Browse
Free
Server data from the Official MCP Registry
GSC, GA4, Bing Webmaster and Microsoft Clarity in one MCP server, with built-in SEO analyst tools
About
GSC, GA4, Bing Webmaster and Microsoft Clarity in one MCP server, with built-in SEO analyst tools
Security Report
0.0
Use Caution0.0Moderate Risk74 tools verified · Open access · No issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Remote servers are capped at 8.0 because source code is not available for review. The score reflects endpoint verification only.
What You'll Need
Set these up before or after installing:
Path to a Google service-account JSON key (enables GSC + GA4)
Environment variable: GOOGLE_APPLICATION_CREDENTIALS
Path to a Google OAuth desktop client secrets JSON (alternative to service account)
Environment variable: SEO_STACK_OAUTH_CLIENT
Default GA4 property ID
Environment variable: GA4_PROPERTY_ID
Default Search Console property (e.g. sc-domain:example.com)
Environment variable: GSC_SITE_URL
Bing Webmaster Tools API key (enables Bing tools)Required
Environment variable: BING_WEBMASTER_API_KEY
Default Bing site URL
Environment variable: BING_SITE_URL
Microsoft Clarity Data Export API token (enables Clarity tools)Required
Environment variable: CLARITY_API_TOKEN
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-raffaele86-seo-stack-mcp": {
"env": {
"GSC_SITE_URL": "your-gsc-site-url-here",
"BING_SITE_URL": "your-bing-site-url-here",
"GA4_PROPERTY_ID": "your-ga4-property-id-here",
"CLARITY_API_TOKEN": "your-clarity-api-token-here",
"BING_WEBMASTER_API_KEY": "your-bing-webmaster-api-key-here",
"SEO_STACK_OAUTH_CLIENT": "your-seo-stack-oauth-client-here",
"GOOGLE_APPLICATION_CREDENTIALS": "your-google-application-credentials-here"
},
"args": [
"seo-stack-mcp"
],
"command": "uvx"
}
}
}Documentation
View on GitHubFrom the project's GitHub README.
seo-stack-mcp
The complete open-source SEO data stack for AI agents. Google Search Console, Google Analytics 4, Bing Webmaster Tools and Microsoft Clarity in a single MCP server — with built-in analyst tools (cannibalization check, low-hanging fruit, content gap, weekly report), not just raw API wrappers.
Self-hosted, free, MIT. Works with Claude Desktop, Claude Code, Cursor, and any MCP client.
Why this instead of N separate servers?
- One install, one config — instead of wiring up 4 different MCP servers with 4 auth setups.
- Analyst tools included — ask "which queries are declining this month?" or "find my low-hanging-fruit keywords" and get an answer computed server-side, not a raw data dump your agent has to crunch.
- Sources are optional — configure only what you use; tools appear only for configured sources.
- Self-hosted — your tokens stay on your machine. No third-party hosted gateway reading your Search Console.
Quickstart (60 seconds)
Add to your MCP client config (Claude Desktop claude_desktop_config.json, Cursor mcp.json, or claude mcp add):
{
"mcpServers": {
"seo-stack": {
"command": "uvx",
"args": ["seo-stack-mcp"],
"env": {
"GOOGLE_APPLICATION_CREDENTIALS": "/path/to/service-account.json",
"GA4_PROPERTY_ID": "123456789",
"BING_WEBMASTER_API_KEY": "your-key",
"CLARITY_API_TOKEN": "your-token"
}
}
}
}
Every env var is optional — set only the sources you want. That's it: restart your client and ask "what are my top queries this week?".
To run the latest development version straight from GitHub, use "args": ["--from", "git+https://github.com/Raffaele86/seo-stack-mcp", "seo-stack-mcp"] instead.
Credentials
| Source | What you need | Where to get it |
|---|---|---|
| GSC + GA4 | Service account JSON (recommended) → GOOGLE_APPLICATION_CREDENTIALS | Google Cloud Console → create service account → enable Search Console API + Analytics Data API → add the SA email as a user in GSC / GA4 |
| GSC + GA4 (alt) | OAuth desktop client JSON → SEO_STACK_OAUTH_CLIENT | First run opens a browser for consent; refresh token cached in ~/.config/seo-stack-mcp/ |
| Bing | BING_WEBMASTER_API_KEY | Bing Webmaster Tools → Settings → API access |
| Clarity | CLARITY_API_TOKEN | Microsoft Clarity → project → Settings → Data Export API |
Optional defaults: GSC_SITE_URL, BING_SITE_URL (so you don't repeat the site on every question).
Tools
Google Search Console (29 tools)
| Tool | Description |
|---|---|
gsc_bulk_inspect_urls | Inspect multiple URLs in batch via the URL Inspection API. Max 50 URLs per call. |
gsc_bulk_request_indexing | Request indexing for multiple URLs via the Google Indexing API. Max 50 URLs. |
gsc_cannibalization_check | Find queries where multiple pages compete (keyword cannibalization). Shows queries with 2+ ranking pages. |
gsc_compare_periods | Compare two periods: shows deltas of clicks, impressions, CTR and position per item. |
gsc_content_gap_analysis | Content gap analysis: queries where the competitor ranks but you don't (or you are far behind). |
gsc_country_performance | Performance by country: clicks, impressions, CTR and average position. Default: last 28 days. |
gsc_daily_stats | Aggregated daily site statistics: clicks, impressions, CTR and average position per day. |
gsc_declining_queries | Queries losing clicks/positions: compares last N days vs the equivalent previous period. |
gsc_delete_sitemap | Remove a sitemap from Google Search Console. Requires write scope on the credentials. |
gsc_device_performance | Compare performance across MOBILE vs DESKTOP vs TABLET. Default: last 28 days. |
gsc_indexing_status_summary | Indexing status summary for multiple URLs: how many indexed, not indexed, and errored. |
gsc_inspect_url | Inspect a URL via the Google Search Console URL Inspection API. |
gsc_keyword_opportunities | Queries with high impressions but low CTR in position 5-20: optimization opportunities. |
gsc_list_sitemaps | List all sitemaps of a site in Google Search Console. |
gsc_list_sites | List all Google Search Console properties available to the configured credentials. |
gsc_low_hanging_fruit | Queries in position 3-10 with high impression volume: small optimizations can push them into the top 3. |
gsc_page_trend | Daily trend for a specific page over the last N days (default 90). |
gsc_pages_for_query | Which pages rank for a specific query? Shows all pages with performance data. |
gsc_queries_for_page | Which queries drive traffic to a specific page? Shows all keywords with performance data. |
gsc_query_trend | Daily trend for a specific query over the last N days (default 90). |
gsc_request_indexing | Request indexing of a URL via the Google Indexing API. |
gsc_rising_queries | Rising queries: compares last N days vs the equivalent previous period. |
gsc_search_analytics | Query Search Analytics: clicks, impressions, CTR and position for the requested dimensions. |
gsc_search_analytics_filtered | Search Analytics with advanced filters. Filters: query_contains, query_regex, page_contains, page_regex, country (e.g. 'ita'), device (MOBILE/DESKTOP/TABLET). |
gsc_search_appearance | Performance by SERP result type (rich snippet, video, FAQ, etc.). Default: last 28 days. |
gsc_submit_sitemap | Submit a sitemap to Google Search Console. Requires write scope on the credentials. |
gsc_top_pages | Top pages by clicks or impressions. order_by: clicks, impressions, ctr, position. Default: last 28 days. |
gsc_top_queries | Top queries by clicks or impressions. order_by: clicks, impressions, ctr, position. Default: last 28 days. |
gsc_weekly_report | Automatic weekly report: last 7 days vs previous 7 days metrics with deltas and top queries/pages. |
Google Analytics 4 (10 tools)
| Tool | Description |
|---|---|
ga4_compare_periods | Compare two periods with percentage delta on key metrics. |
ga4_conversion_paths | User paths: acquisition source → landing page with sessions and users. |
ga4_events | Top GA4 events with count and number of users. |
ga4_landing_pages | Entry pages (landing pages) with sessions, users and bounce rate. |
ga4_overview | Site overview: users, sessions, pageviews, bounce rate, average session duration. |
ga4_page_performance | Detailed performance of a single page with device and source breakdown. |
ga4_realtime | Realtime report: pages currently being viewed and active users. |
ga4_top_pages | Top pages by traffic with full metrics (pageviews, users, duration, bounce rate). |
ga4_traffic_sources | Traffic breakdown by source/medium (e.g. google/organic, direct/none). |
ga4_user_demographics | User demographics breakdown: country, device, browser, language. |
Bing Webmaster Tools (22 tools)
| Tool | Description |
|---|---|
bing_crawl_issues | URLs with crawl problems (4xx/5xx errors, redirects, etc.). |
bing_crawl_stats | Bing crawl statistics: crawled pages, errors, redirects, etc. |
bing_keyword | Bing impression volume for an exact query (impressions + broad). |
bing_keyword_stats | Historical statistics for a keyword on Bing: impressions and trend. |
bing_link_counts | Pages with the highest number of backlinks according to Bing. |
bing_pages_for_query | Pages that rank for a specific query on Bing. |
bing_queries_for_page | Search queries that drive traffic to a specific page. |
bing_query_page_detail | Detailed statistics for a specific query + page combination. |
bing_query_traffic | Daily traffic trend for a specific query on Bing. |
bing_related_keywords | Keywords related to a search term on Bing, with impression data. |
bing_sitemaps | List all sitemaps/feeds submitted to Bing. |
bing_sites | List all sites verified in the Bing Webmaster Tools account. |
bing_submission_quota | Check the URL submission quota for Bing. |
bing_submit_sitemap | Submit a new sitemap/feed to Bing. |
bing_submit_url | Submit a URL to Bing for indexing. |
bing_submit_urls_batch | Submit a batch of URLs to Bing for indexing (max 500). |
bing_top_pages | Top pages on Bing with clicks, impressions and average position. |
bing_top_queries | Top Bing search queries with clicks, impressions and average position. |
bing_traffic_stats | Daily Bing traffic statistics: clicks and impressions over time. |
bing_url_info | Indexing status of a specific URL on Bing. |
bing_url_links | Inbound backlinks to a specific URL according to Bing. |
bing_url_traffic | Traffic data for a specific URL on Bing. |
Microsoft Clarity (10 tools)
| Tool | Description |
|---|---|
clarity_breakdown | Free-form raw breakdown (1-3 dimensions). Power-user — costs 1 quota unit if not already cached. |
clarity_dead_clicks | Top URLs with dead clicks (clicks on non-interactive elements — a UX problem signal). |
clarity_engagement | Engagement Time + Scroll Depth per URL (or another dimension). |
clarity_excessive_scroll | Top URLs with excessive scrolling (users hunting for info they can't easily find). |
clarity_popular_pages | Top URLs by visits over the last days (Popular Pages metric, dimension=URL). |
clarity_quickback_clicks | Top URLs with quickback clicks (user goes back immediately — page not relevant). |
clarity_quota_status | Daily quota status (local counter, does not call the API). |
clarity_rage_clicks | Top URLs with rage clicks (fast repeated clicks — user frustration). |
clarity_script_errors | Top URLs with JS errors + error clicks (technical problems on the page). |
clarity_traffic | Traffic breakdown from Microsoft Clarity (sessions, bot %, pages per session). |
Why not the official GA4 server or mcp-gsc?
Both are good and this project doesn't pretend otherwise. Google's official analytics-mcp covers GA4 only; mcp-gsc covers GSC only. If you live in one data source, use them. This project is for people who work across the whole free SEO stack and want the cross-source workflow (GSC + GA4 + Bing + Clarity) plus opinionated analysis tools in one place.
License
MIT.
Built and maintained by Raffaele Nocera — freelance web & SEO. Available for consulting.
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
80.0K
Stars
7
Installs
6.5
Security
No ratings yet
Local
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
137
Stars
547
Installs
8.0
Security
4.8
Local
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
-
Stars
84
Installs
10.0
Security
4.6
Local