Seo Stack Mcp

io.github.Raffaele86/seo-stack-mcp · v0.2.0

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

Source code Set it up

Connect Runs on your machine

Terminal

claude mcp add seo-stack-mcp -e GOOGLE_APPLICATION_CREDENTIALS=<GOOGLE_APPLICATION_CREDENTIALS> -e SEO_STACK_OAUTH_CLIENT=<SEO_STACK_OAUTH_CLIENT> -e GA4_PROPERTY_ID=<GA4_PROPERTY_ID> -e GSC_SITE_URL=<GSC_SITE_URL> -e ADSENSE_ACCOUNT_ID=<ADSENSE_ACCOUNT_ID> -e ADSENSE_CURRENCY=<ADSENSE_CURRENCY> -e BING_WEBMASTER_API_KEY=<BING_WEBMASTER_API_KEY> -e BING_SITE_URL=<BING_SITE_URL> -e CLARITY_API_TOKEN=<CLARITY_API_TOKEN> -e GOOGLE_ADS_DEVELOPER_TOKEN=<GOOGLE_ADS_DEVELOPER_TOKEN> -e GOOGLE_ADS_CLIENT_ID=<GOOGLE_ADS_CLIENT_ID> -e GOOGLE_ADS_CLIENT_SECRET=<GOOGLE_ADS_CLIENT_SECRET> -e GOOGLE_ADS_REFRESH_TOKEN=<GOOGLE_ADS_REFRESH_TOKEN> -e GOOGLE_ADS_CUSTOMER_ID=<GOOGLE_ADS_CUSTOMER_ID> -e GOOGLE_ADS_LOGIN_CUSTOMER_ID=<GOOGLE_ADS_LOGIN_CUSTOMER_ID> -e OPENPAGERANK_API_KEY=<OPENPAGERANK_API_KEY> -- uvx seo-stack-mcp==0.2.0

claude_desktop_config.json

{
  "mcpServers": {
    "seo-stack-mcp": {
      "command": "uvx",
      "args": [
        "seo-stack-mcp==0.2.0"
      ],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "<GOOGLE_APPLICATION_CREDENTIALS>",
        "SEO_STACK_OAUTH_CLIENT": "<SEO_STACK_OAUTH_CLIENT>",
        "GA4_PROPERTY_ID": "<GA4_PROPERTY_ID>",
        "GSC_SITE_URL": "<GSC_SITE_URL>",
        "ADSENSE_ACCOUNT_ID": "<ADSENSE_ACCOUNT_ID>",
        "ADSENSE_CURRENCY": "<ADSENSE_CURRENCY>",
        "BING_WEBMASTER_API_KEY": "<BING_WEBMASTER_API_KEY>",
        "BING_SITE_URL": "<BING_SITE_URL>",
        "CLARITY_API_TOKEN": "<CLARITY_API_TOKEN>",
        "GOOGLE_ADS_DEVELOPER_TOKEN": "<GOOGLE_ADS_DEVELOPER_TOKEN>",
        "GOOGLE_ADS_CLIENT_ID": "<GOOGLE_ADS_CLIENT_ID>",
        "GOOGLE_ADS_CLIENT_SECRET": "<GOOGLE_ADS_CLIENT_SECRET>",
        "GOOGLE_ADS_REFRESH_TOKEN": "<GOOGLE_ADS_REFRESH_TOKEN>",
        "GOOGLE_ADS_CUSTOMER_ID": "<GOOGLE_ADS_CUSTOMER_ID>",
        "GOOGLE_ADS_LOGIN_CUSTOMER_ID": "<GOOGLE_ADS_LOGIN_CUSTOMER_ID>",
        "OPENPAGERANK_API_KEY": "<OPENPAGERANK_API_KEY>"
      }
    }
  }
}

~/.cursor/mcp.json

{
  "mcpServers": {
    "seo-stack-mcp": {
      "command": "uvx",
      "args": [
        "seo-stack-mcp==0.2.0"
      ],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "<GOOGLE_APPLICATION_CREDENTIALS>",
        "SEO_STACK_OAUTH_CLIENT": "<SEO_STACK_OAUTH_CLIENT>",
        "GA4_PROPERTY_ID": "<GA4_PROPERTY_ID>",
        "GSC_SITE_URL": "<GSC_SITE_URL>",
        "ADSENSE_ACCOUNT_ID": "<ADSENSE_ACCOUNT_ID>",
        "ADSENSE_CURRENCY": "<ADSENSE_CURRENCY>",
        "BING_WEBMASTER_API_KEY": "<BING_WEBMASTER_API_KEY>",
        "BING_SITE_URL": "<BING_SITE_URL>",
        "CLARITY_API_TOKEN": "<CLARITY_API_TOKEN>",
        "GOOGLE_ADS_DEVELOPER_TOKEN": "<GOOGLE_ADS_DEVELOPER_TOKEN>",
        "GOOGLE_ADS_CLIENT_ID": "<GOOGLE_ADS_CLIENT_ID>",
        "GOOGLE_ADS_CLIENT_SECRET": "<GOOGLE_ADS_CLIENT_SECRET>",
        "GOOGLE_ADS_REFRESH_TOKEN": "<GOOGLE_ADS_REFRESH_TOKEN>",
        "GOOGLE_ADS_CUSTOMER_ID": "<GOOGLE_ADS_CUSTOMER_ID>",
        "GOOGLE_ADS_LOGIN_CUSTOMER_ID": "<GOOGLE_ADS_LOGIN_CUSTOMER_ID>",
        "OPENPAGERANK_API_KEY": "<OPENPAGERANK_API_KEY>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "seo-stack-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "seo-stack-mcp==0.2.0"
      ],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "<GOOGLE_APPLICATION_CREDENTIALS>",
        "SEO_STACK_OAUTH_CLIENT": "<SEO_STACK_OAUTH_CLIENT>",
        "GA4_PROPERTY_ID": "<GA4_PROPERTY_ID>",
        "GSC_SITE_URL": "<GSC_SITE_URL>",
        "ADSENSE_ACCOUNT_ID": "<ADSENSE_ACCOUNT_ID>",
        "ADSENSE_CURRENCY": "<ADSENSE_CURRENCY>",
        "BING_WEBMASTER_API_KEY": "<BING_WEBMASTER_API_KEY>",
        "BING_SITE_URL": "<BING_SITE_URL>",
        "CLARITY_API_TOKEN": "<CLARITY_API_TOKEN>",
        "GOOGLE_ADS_DEVELOPER_TOKEN": "<GOOGLE_ADS_DEVELOPER_TOKEN>",
        "GOOGLE_ADS_CLIENT_ID": "<GOOGLE_ADS_CLIENT_ID>",
        "GOOGLE_ADS_CLIENT_SECRET": "<GOOGLE_ADS_CLIENT_SECRET>",
        "GOOGLE_ADS_REFRESH_TOKEN": "<GOOGLE_ADS_REFRESH_TOKEN>",
        "GOOGLE_ADS_CUSTOMER_ID": "<GOOGLE_ADS_CUSTOMER_ID>",
        "GOOGLE_ADS_LOGIN_CUSTOMER_ID": "<GOOGLE_ADS_LOGIN_CUSTOMER_ID>",
        "OPENPAGERANK_API_KEY": "<OPENPAGERANK_API_KEY>"
      }
    }
  }
}

Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.

Tools

This server runs locally, so its tools are listed by your MCP client once it starts.

Environment variables

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

Details

Package	`[email protected]` (PYPI, stdio)
First published	19 Jul 2026
Last updated	19 Jul 2026
Registry name	`io.github.Raffaele86/seo-stack-mcp`

More marketing and seo servers See all

Live status

Local install

Installed and run on your own machine, so there is no public endpoint to check.

Pair it with live search

Agents that use Seo Stack Mcp often also need current facts. NestDaddy MCP gives your AI today's internet: web search, real-time breaking news and full page reading in one connector.

See NestDaddy MCP

For maintainers

[![NestDaddy MCP](https://nestdaddy.com/mcp/servers/io-github-raffaele86-seo-stack-mcp/badge.svg)](https://nestdaddy.com/mcp/servers/io-github-raffaele86-seo-stack-mcp)

Add the badge to your README. It turns green while your server passes our daily check. Listing details come from the official MCP registry; update them there.

Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.