io.github.avansaber/seo-monster MCP Server

Name: io.github.avansaber/seo-monster MCP Server
Author: io.github.avansaber

io.github.avansaber/seo-monster

Repository Registry

What is the io.github.avansaber/seo-monster MCP server?

SEO MCP over Search Console, GA4, PageSpeed Insights, Cloudflare, IndexNow, CrUX, technical-SEO.

How to install io.github.avansaber/seo-monster

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

SEO_MCP_GOOGLE_OAUTH_CLIENT
Path to your Desktop-app OAuth client-secrets JSON, downloaded from Google Cloud Console. Required for Search Console, Indexing, and GA4 tools.
SEO_MCP_GOOGLE_TOKEN
Writable path where the cached OAuth token is stored. On first use, a browser opens for one-time consent and the token is written here. Default: ${HOME}/.config/seo-monster/token.json
SEO_MCP_GSC_DEFAULT_SITE
Default Search Console property, e.g. 'sc-domain:example.com' or 'https://www.example.com/'.
SEO_MCP_GA4_PROPERTY_ID
Default GA4 property, e.g. 'properties/123456789' or bare '123456789'.
PSI_API_KEY
secret
Google API key shared by PageSpeed Insights and Chrome UX Report History tools. Optional; both work anonymously at a tighter rate limit when unset.
CF_API_TOKEN
secret
Cloudflare API token. Optional; needed only for the Cloudflare tools. Scopes: Zone:Read, DNS:Read, Account Analytics:Read, and (only when destructive mode is on) Cache Purge:Purge.
CF_ZONE
Default Cloudflare zone hostname, e.g. 'example.com'.
SEO_MCP_INDEXNOW_KEY
secret
IndexNow shared key (any 8-128 hex string you generate). Required only for the IndexNow tools. Host the key file at https://<your-host>/<key>.txt for engine verification.
SEO_MCP_INDEXNOW_KEY_LOCATION
Override the default IndexNow key-file URL (https://<host>/<key>.txt). Set only if you host the key file at a non-standard path.
SEO_MCP_ALLOW_DESTRUCTIVE
Set to 'true' to enable the Cloudflare cache-purge tools. Default false: all destructive tools refuse to run.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "seo-monster": {
      "command": "uvx",
      "args": [
        "seo-monster"
      ],
      "env": {
        "SEO_MCP_GOOGLE_OAUTH_CLIENT": "<YOUR_SEO_MCP_GOOGLE_OAUTH_CLIENT>",
        "SEO_MCP_GOOGLE_TOKEN": "<YOUR_SEO_MCP_GOOGLE_TOKEN>",
        "SEO_MCP_GSC_DEFAULT_SITE": "<YOUR_SEO_MCP_GSC_DEFAULT_SITE>",
        "SEO_MCP_GA4_PROPERTY_ID": "<YOUR_SEO_MCP_GA4_PROPERTY_ID>",
        "PSI_API_KEY": "<YOUR_PSI_API_KEY>",
        "CF_API_TOKEN": "<YOUR_CF_API_TOKEN>",
        "CF_ZONE": "<YOUR_CF_ZONE>",
        "SEO_MCP_INDEXNOW_KEY": "<YOUR_SEO_MCP_INDEXNOW_KEY>",
        "SEO_MCP_INDEXNOW_KEY_LOCATION": "<YOUR_SEO_MCP_INDEXNOW_KEY_LOCATION>",
        "SEO_MCP_ALLOW_DESTRUCTIVE": "<YOUR_SEO_MCP_ALLOW_DESTRUCTIVE>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "seo-monster": {
      "command": "uvx",
      "args": [
        "seo-monster"
      ],
      "env": {
        "SEO_MCP_GOOGLE_OAUTH_CLIENT": "<YOUR_SEO_MCP_GOOGLE_OAUTH_CLIENT>",
        "SEO_MCP_GOOGLE_TOKEN": "<YOUR_SEO_MCP_GOOGLE_TOKEN>",
        "SEO_MCP_GSC_DEFAULT_SITE": "<YOUR_SEO_MCP_GSC_DEFAULT_SITE>",
        "SEO_MCP_GA4_PROPERTY_ID": "<YOUR_SEO_MCP_GA4_PROPERTY_ID>",
        "PSI_API_KEY": "<YOUR_PSI_API_KEY>",
        "CF_API_TOKEN": "<YOUR_CF_API_TOKEN>",
        "CF_ZONE": "<YOUR_CF_ZONE>",
        "SEO_MCP_INDEXNOW_KEY": "<YOUR_SEO_MCP_INDEXNOW_KEY>",
        "SEO_MCP_INDEXNOW_KEY_LOCATION": "<YOUR_SEO_MCP_INDEXNOW_KEY_LOCATION>",
        "SEO_MCP_ALLOW_DESTRUCTIVE": "<YOUR_SEO_MCP_ALLOW_DESTRUCTIVE>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "seo-monster": {
      "command": "uvx",
      "args": [
        "seo-monster"
      ],
      "env": {
        "SEO_MCP_GOOGLE_OAUTH_CLIENT": "<YOUR_SEO_MCP_GOOGLE_OAUTH_CLIENT>",
        "SEO_MCP_GOOGLE_TOKEN": "<YOUR_SEO_MCP_GOOGLE_TOKEN>",
        "SEO_MCP_GSC_DEFAULT_SITE": "<YOUR_SEO_MCP_GSC_DEFAULT_SITE>",
        "SEO_MCP_GA4_PROPERTY_ID": "<YOUR_SEO_MCP_GA4_PROPERTY_ID>",
        "PSI_API_KEY": "<YOUR_PSI_API_KEY>",
        "CF_API_TOKEN": "<YOUR_CF_API_TOKEN>",
        "CF_ZONE": "<YOUR_CF_ZONE>",
        "SEO_MCP_INDEXNOW_KEY": "<YOUR_SEO_MCP_INDEXNOW_KEY>",
        "SEO_MCP_INDEXNOW_KEY_LOCATION": "<YOUR_SEO_MCP_INDEXNOW_KEY_LOCATION>",
        "SEO_MCP_ALLOW_DESTRUCTIVE": "<YOUR_SEO_MCP_ALLOW_DESTRUCTIVE>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "seo-monster": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "seo-monster"
      ],
      "env": {
        "SEO_MCP_GOOGLE_OAUTH_CLIENT": "<YOUR_SEO_MCP_GOOGLE_OAUTH_CLIENT>",
        "SEO_MCP_GOOGLE_TOKEN": "<YOUR_SEO_MCP_GOOGLE_TOKEN>",
        "SEO_MCP_GSC_DEFAULT_SITE": "<YOUR_SEO_MCP_GSC_DEFAULT_SITE>",
        "SEO_MCP_GA4_PROPERTY_ID": "<YOUR_SEO_MCP_GA4_PROPERTY_ID>",
        "PSI_API_KEY": "<YOUR_PSI_API_KEY>",
        "CF_API_TOKEN": "<YOUR_CF_API_TOKEN>",
        "CF_ZONE": "<YOUR_CF_ZONE>",
        "SEO_MCP_INDEXNOW_KEY": "<YOUR_SEO_MCP_INDEXNOW_KEY>",
        "SEO_MCP_INDEXNOW_KEY_LOCATION": "<YOUR_SEO_MCP_INDEXNOW_KEY_LOCATION>",
        "SEO_MCP_ALLOW_DESTRUCTIVE": "<YOUR_SEO_MCP_ALLOW_DESTRUCTIVE>"
      }
    }
  }
}

Claude Code

claude mcp add seo-monster --env SEO_MCP_GOOGLE_OAUTH_CLIENT=<YOUR_SEO_MCP_GOOGLE_OAUTH_CLIENT> --env SEO_MCP_GOOGLE_TOKEN=<YOUR_SEO_MCP_GOOGLE_TOKEN> --env SEO_MCP_GSC_DEFAULT_SITE=<YOUR_SEO_MCP_GSC_DEFAULT_SITE> --env SEO_MCP_GA4_PROPERTY_ID=<YOUR_SEO_MCP_GA4_PROPERTY_ID> --env PSI_API_KEY=<YOUR_PSI_API_KEY> --env CF_API_TOKEN=<YOUR_CF_API_TOKEN> --env CF_ZONE=<YOUR_CF_ZONE> --env SEO_MCP_INDEXNOW_KEY=<YOUR_SEO_MCP_INDEXNOW_KEY> --env SEO_MCP_INDEXNOW_KEY_LOCATION=<YOUR_SEO_MCP_INDEXNOW_KEY_LOCATION> --env SEO_MCP_ALLOW_DESTRUCTIVE=<YOUR_SEO_MCP_ALLOW_DESTRUCTIVE> -- uvx seo-monster