How do I install Seo Stack?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Seo Stack need an API key?

The publisher lists these environment variables: GOOGLE_APPLICATION_CREDENTIALS, SEO_STACK_OAUTH_CLIENT, GA4_PROPERTY_ID, GSC_SITE_URL, ADSENSE_ACCOUNT_ID, ADSENSE_CURRENCY, BING_WEBMASTER_API_KEY, BING_SITE_URL, CLARITY_API_TOKEN, GOOGLE_ADS_DEVELOPER_TOKEN, GOOGLE_ADS_CLIENT_ID, GOOGLE_ADS_CLIENT_SECRET, GOOGLE_ADS_REFRESH_TOKEN, GOOGLE_ADS_CUSTOMER_ID, GOOGLE_ADS_LOGIN_CUSTOMER_ID, OPENPAGERANK_API_KEY.

What transport does Seo Stack use?

Seo Stack runs locally over stdio.

When was Seo Stack last checked?

Last checked 2026-11-09. The complete open-source SEO data stack for AI agents: 7 sources, 86 tools, one MCP server

Seo Stack MCP server

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

uvx seo-stack-mcp==0.2.0

Credentials from the publisher

GOOGLE_APPLICATION_CREDENTIALS — Path to a Google service-account JSON key (enables GSC + GA4)
SEO_STACK_OAUTH_CLIENT — Path to a Google OAuth desktop client secrets JSON (alternative to service account)
GA4_PROPERTY_ID — Default GA4 property ID
GSC_SITE_URL — Default Search Console property (e.g. sc-domain:example.com)
ADSENSE_ACCOUNT_ID — AdSense account (accounts/pub-XXXX...) — enables AdSense tools on top of the Google credentials
ADSENSE_CURRENCY — Reporting currency for AdSense tools (default USD)
BING_WEBMASTER_API_KEY — Bing Webmaster Tools API key (enables Bing tools)
BING_SITE_URL — Default Bing site URL
CLARITY_API_TOKEN — Microsoft Clarity Data Export API token (enables Clarity tools)
GOOGLE_ADS_DEVELOPER_TOKEN — Google Ads developer token (enables Keyword Planner tools; needs the google-ads extra)
GOOGLE_ADS_CLIENT_ID — Google Ads OAuth client id
GOOGLE_ADS_CLIENT_SECRET — Google Ads OAuth client secret
GOOGLE_ADS_REFRESH_TOKEN — Google Ads OAuth refresh token (adwords scope)
GOOGLE_ADS_CUSTOMER_ID — Google Ads customer id (10 digits)
GOOGLE_ADS_LOGIN_CUSTOMER_ID — Manager account id, if the customer is under an MCC
OPENPAGERANK_API_KEY — Open PageRank API key (enables the pagerank_score tool)

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1GOOGLE_APPLICATION_CREDENTIALS=<value> SEO_STACK_OAUTH_CLIENT=<value> GA4_PROPERTY_ID=<value> GSC_SITE_URL=<value> ADSENSE_ACCOUNT_ID=<value> ADSENSE_CURRENCY=<value> BING_WEBMASTER_API_KEY=<secret> BING_SITE_URL=<value> CLARITY_API_TOKEN=<secret> GOOGLE_ADS_DEVELOPER_TOKEN=<secret> GOOGLE_ADS_CLIENT_ID=<value> GOOGLE_ADS_CLIENT_SECRET=<secret> GOOGLE_ADS_REFRESH_TOKEN=<secret> GOOGLE_ADS_CUSTOMER_ID=<value> GOOGLE_ADS_LOGIN_CUSTOMER_ID=<value> OPENPAGERANK_API_KEY=<secret> claude mcp add io.github.raffaele86-seo-stack-mcp -- uvx seo-stack-mcp==0.2.0

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.raffaele86-seo-stack-mcp": {4      "command": "uvx",5      "args": [6        "seo-stack-mcp==0.2.0"7      ],8      "env": {9        "GOOGLE_APPLICATION_CREDENTIALS": "<value>",10        "SEO_STACK_OAUTH_CLIENT": "<value>",11        "GA4_PROPERTY_ID": "<value>",12        "GSC_SITE_URL": "<value>",13        "ADSENSE_ACCOUNT_ID": "<value>",14        "ADSENSE_CURRENCY": "<value>",15        "BING_WEBMASTER_API_KEY": "<secret>",16        "BING_SITE_URL": "<value>",17        "CLARITY_API_TOKEN": "<secret>",18        "GOOGLE_ADS_DEVELOPER_TOKEN": "<secret>",19        "GOOGLE_ADS_CLIENT_ID": "<value>",20        "GOOGLE_ADS_CLIENT_SECRET": "<secret>",21        "GOOGLE_ADS_REFRESH_TOKEN": "<secret>",22        "GOOGLE_ADS_CUSTOMER_ID": "<value>",23        "GOOGLE_ADS_LOGIN_CUSTOMER_ID": "<value>",24        "OPENPAGERANK_API_KEY": "<secret>"25      }26    }27  }28}

claude_desktop_config.json

Local · pypiPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

seo-stack-mcp

The complete open-source SEO data stack for AI agents. Google Search Console, Google Analytics 4, Bing Webmaster Tools, Microsoft Clarity, Google AdSense, Google Keyword Planner and Open PageRank 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 7 different MCP servers with 7 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
AdSense	Google credentials above + `ADSENSE_ACCOUNT_ID` (`accounts/pub-XXXX...`)	AdSense → Account → Settings → Account information. Enable the AdSense Management API in Google Cloud. If you use OAuth and enable AdSense later, delete the cached token in `~/.config/seo-stack-mcp/` to re-consent with the new scope
Keyword Planner	`GOOGLE_ADS_DEVELOPER_TOKEN`, `GOOGLE_ADS_CLIENT_ID`, `GOOGLE_ADS_CLIENT_SECRET`, `GOOGLE_ADS_REFRESH_TOKEN`, `GOOGLE_ADS_CUSTOMER_ID` (+ `GOOGLE_ADS_LOGIN_CUSTOMER_ID` under an MCC)	Google Ads API Center → developer token (Basic access is enough; API calls are free). Also needs the `google-ads` extra: `uvx --with google-ads seo-stack-mcp` or `pip install seo-stack-mcp[ads]`
Open PageRank	`OPENPAGERANK_API_KEY`	Open PageRank — free API key, 10,000 calls/hour

Optional defaults: GSC_SITE_URL, BING_SITE_URL (so you don't repeat the site on every question), ADSENSE_CURRENCY (default USD), GOOGLE_ADS_LOCATION_ID / GOOGLE_ADS_LANGUAGE_ID (Keyword Planner geo/language defaults, default US / English).

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.

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.

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).

Google AdSense (10 tools)

Tool	Description
`adsense_alerts`	Active alerts on the AdSense account (severity, type, message).
`adsense_by_ad_unit`	Performance per ad unit: earnings, impressions, clicks, CTR, eCPM.
`adsense_by_country`	Revenue breakdown by country, sorted by earnings.
`adsense_by_platform`	Revenue breakdown by device platform (Desktop, Mobile, Tablet).
`adsense_compare_periods`	Compare two periods with percentage deltas on key metrics.
`adsense_earnings_by_date`	Daily earnings with total, average and trend.
`adsense_earnings_overview`	Earnings overview: estimated earnings, page views, impressions, clicks, RPM, CTR.
`adsense_payments`	Recent payments on the AdSense account.
`adsense_sites`	Sites linked to the AdSense account (domain, state, auto-ads).
`adsense_top_pages`	Top URL channels by revenue (requires URL channels configured in AdSense).

Google Keyword Planner (4 tools)

Tool	Description
`kp_historical_metrics`	Real historical Keyword Planner metrics for a list of known keywords.
`kp_keyword_ideas`	Keyword ideas with real metrics: volume, competition, top-of-page bids, 12-month volumes.
`kp_status`	Source status: library, credential completeness (masked) and live connection test.
`kp_suggest_geo_target`	Resolve a location name to its geo target constant ID.

Open PageRank (1 tool)

Tool	Description
`pagerank_score`	Domain authority score (0-10) for up to 100 domains per call, with a local 30-day cache.

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.

Seo Stack

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Seo Stack?

Does Seo Stack need an API key?

What transport does Seo Stack use?

When was Seo Stack last checked?

Documentation

seo-stack-mcp

Why this instead of N separate servers?

Quickstart (60 seconds)

Credentials

Tools

Google Search Console (29 tools)

Google Analytics 4 (10 tools)

Bing Webmaster Tools (22 tools)

Microsoft Clarity (10 tools)

Google AdSense (10 tools)

Google Keyword Planner (4 tools)

Open PageRank (1 tool)

Why not the official GA4 server or mcp-gsc?

See also

License