How do I install Seo Stack?

Seo Stack is a local plugin. Install it using PyPI package: seo-stack-mcp and add the generated configuration snippet to your AI app's MCP config file. Then restart your AI app.

Is Seo Stack safe to use?

Seo Stack was flagged by MCP Marketplace's security scan, scoring 4.2/10 (high risk). It has 5 high or critical findings to review. Review the security report on this page carefully before installing it.

What credentials does Seo Stack need?

Seo Stack requires the following credentials or 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. You can find setup instructions on the server detail page.

What AI apps work with Seo Stack?

Seo Stack uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Seo Stack MCP Server

by Raffaele86

Developer ToolsUse Caution4.2MCP RegistryLocal

Free

Server data from the Official MCP Registry

The complete open-source SEO data stack for AI agents: 7 sources, 86 tools, one MCP server

About

The complete open-source SEO data stack for AI agents: 7 sources, 86 tools, one MCP server

Security Report

4.2

Use Caution4.2High Risk

This SEO data stack MCP server is a well-intentioned developer tool with proper architecture and reasonable security practices overall. However, there are several moderate-risk findings around credential handling, lack of input validation on some operations, and overly broad exception handling that could mask errors. The server's permissions are appropriate for its purpose (aggregating multiple SEO APIs), but the security implementation could be strengthened. Supply chain analysis found 5 known vulnerabilities in dependencies (0 critical, 5 high severity). Package verification found 1 issue.

3 files analyzed · 15 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

env_vars

Check that this permission is expected for this type of plugin.

HTTP Network Access

Connects to external APIs or services over the internet.

File System Read

Reads files on your machine. Normal for tools that analyze or process local data.

File System Write

Writes or modifies files on your machine. Check that this is expected for the tool.

What You'll Need

Set these up before or after installing:

Path to a Google service-account JSON key (enables GSC + GA4)Optional

Environment variable: GOOGLE_APPLICATION_CREDENTIALS

Path to a Google OAuth desktop client secrets JSON (alternative to service account)Optional

Environment variable: SEO_STACK_OAUTH_CLIENT

Default GA4 property IDOptional

Environment variable: GA4_PROPERTY_ID

Default Search Console property (e.g. sc-domain:example.com)Optional

Environment variable: GSC_SITE_URL

AdSense account (accounts/pub-XXXX...) — enables AdSense tools on top of the Google credentialsOptional

Environment variable: ADSENSE_ACCOUNT_ID

Reporting currency for AdSense tools (default USD)Optional

Environment variable: ADSENSE_CURRENCY

Bing Webmaster Tools API key (enables Bing tools)Required

Environment variable: BING_WEBMASTER_API_KEY

Default Bing site URLOptional

Environment variable: BING_SITE_URL

Microsoft Clarity Data Export API token (enables Clarity tools)Required

Environment variable: CLARITY_API_TOKEN

Google Ads developer token (enables Keyword Planner tools; needs the google-ads extra)Required

Environment variable: GOOGLE_ADS_DEVELOPER_TOKEN

Google Ads OAuth client idOptional

Environment variable: GOOGLE_ADS_CLIENT_ID

Google Ads OAuth client secretRequired

Environment variable: GOOGLE_ADS_CLIENT_SECRET

Google Ads OAuth refresh token (adwords scope)Required

Environment variable: GOOGLE_ADS_REFRESH_TOKEN

Google Ads customer id (10 digits)Optional

Environment variable: GOOGLE_ADS_CUSTOMER_ID

Manager account id, if the customer is under an MCCOptional

Environment variable: GOOGLE_ADS_LOGIN_CUSTOMER_ID

Open PageRank API key (enables the pagerank_score tool)Required

Environment variable: OPENPAGERANK_API_KEY

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",
        "ADSENSE_CURRENCY": "your-adsense-currency-here",
        "CLARITY_API_TOKEN": "your-clarity-api-token-here",
        "ADSENSE_ACCOUNT_ID": "your-adsense-account-id-here",
        "GOOGLE_ADS_CLIENT_ID": "your-google-ads-client-id-here",
        "OPENPAGERANK_API_KEY": "your-openpagerank-api-key-here",
        "BING_WEBMASTER_API_KEY": "your-bing-webmaster-api-key-here",
        "GOOGLE_ADS_CUSTOMER_ID": "your-google-ads-customer-id-here",
        "SEO_STACK_OAUTH_CLIENT": "your-seo-stack-oauth-client-here",
        "GOOGLE_ADS_CLIENT_SECRET": "your-google-ads-client-secret-here",
        "GOOGLE_ADS_REFRESH_TOKEN": "your-google-ads-refresh-token-here",
        "GOOGLE_ADS_DEVELOPER_TOKEN": "your-google-ads-developer-token-here",
        "GOOGLE_ADS_LOGIN_CUSTOMER_ID": "your-google-ads-login-customer-id-here",
        "GOOGLE_APPLICATION_CREDENTIALS": "your-google-application-credentials-here"
      },
      "args": [
        "seo-stack-mcp"
      ],
      "command": "uvx"
    }
  }
}

Documentation

View on GitHub

From 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, 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.
`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).

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.

Reviews

No reviews yet

Be the first to review this server!

More Developer Tools MCP Servers

Git

Free

by Modelcontextprotocol · Developer Tools

Read, search, and manipulate Git repositories programmatically

Fetch

Free

by Modelcontextprotocol · Developer Tools

Web content fetching and conversion for efficient LLM usage

Toleno

Free

by Toleno · Developer Tools

Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.

mcp-creator-python

Free

by mcp-marketplace · Developer Tools

Create, build, and publish Python MCP servers to PyPI — conversationally.

MCP Marketplace

Free

by mcp-marketplace · Developer Tools

Search and install MCP servers from inside your AI client.

MarkItDown

Free

by Microsoft · Content & Media

Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption

Seo Stack MCP Server

About

Security Report

Findings (15)Action required

Permissions Required

What You'll Need

How to Install

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

Reviews

No reviews yet

More Developer Tools MCP Servers

Git

Fetch

Toleno

mcp-creator-python

MCP Marketplace

MarkItDown