Skip to content
MCP server

SEO Performance MCP

One verdict per blog post (refresh, expand, merge, kill) from Search Console, GA4 and more

Runs locallyStatus and history
Install
Pricing
Free
Platforms
CLI, self-hosted
Runs
Locally
Version
1.0.1
Listing updated
2 days ago

About SEO Performance MCP

SEO Performance MCP is a free MCP server for marketing and seo. It runs locally on your machine and is started by your AI client.

SEO Performance MCP looks at posts you have already published and ranks the ones worth an editor's time. For each URL it combines signals from Google Search Console, Matomo or GA4, Microsoft Clarity and AI-citation data, then a deterministic rule engine returns a verdict of refresh, expand, merge, kill, double down or hold, with reason codes and a 0-1 confidence score. The thresholds live in the repository's rules file, so decisions can be traced.

Every data source is optional: adapters without configuration are skipped and the server still starts. Posts are discovered from an XML sitemap, a JSON list or the Ghost Admin API. The server is read-only and never edits or publishes content.

It also lists quick wins, meaning queries at positions 5-15 with below-expected click-through, and can report which language models stopped citing a URL when a citation-intelligence endpoint is configured.

Install

Run in a terminal

claude mcp add seo-performance-mcp --env GSC_SERVICE_ACCOUNT_JSON='<GSC_SERVICE_ACCOUNT_JSON>' --env MATOMO_TOKEN='<MATOMO_TOKEN>' --env GA4_SERVICE_ACCOUNT_JSON='<GA4_SERVICE_ACCOUNT_JSON>' --env CLARITY_API_TOKEN='<CLARITY_API_TOKEN>' --env GHOST_ADMIN_API_KEY='<GHOST_ADMIN_API_KEY>' -- npx -y @automatelab/seo-performance-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "seo-performance-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@automatelab/seo-performance-mcp"
      ],
      "env": {
        "GSC_SERVICE_ACCOUNT_JSON": "<GSC_SERVICE_ACCOUNT_JSON>",
        "MATOMO_TOKEN": "<MATOMO_TOKEN>",
        "GA4_SERVICE_ACCOUNT_JSON": "<GA4_SERVICE_ACCOUNT_JSON>",
        "CLARITY_API_TOKEN": "<CLARITY_API_TOKEN>",
        "GHOST_ADMIN_API_KEY": "<GHOST_ADMIN_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "seo-performance-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@automatelab/seo-performance-mcp"
      ],
      "env": {
        "GSC_SERVICE_ACCOUNT_JSON": "<GSC_SERVICE_ACCOUNT_JSON>",
        "MATOMO_TOKEN": "<MATOMO_TOKEN>",
        "GA4_SERVICE_ACCOUNT_JSON": "<GA4_SERVICE_ACCOUNT_JSON>",
        "CLARITY_API_TOKEN": "<CLARITY_API_TOKEN>",
        "GHOST_ADMIN_API_KEY": "<GHOST_ADMIN_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "seo-performance-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@automatelab/seo-performance-mcp"
      ],
      "env": {
        "GSC_SERVICE_ACCOUNT_JSON": "<GSC_SERVICE_ACCOUNT_JSON>",
        "MATOMO_TOKEN": "<MATOMO_TOKEN>",
        "GA4_SERVICE_ACCOUNT_JSON": "<GA4_SERVICE_ACCOUNT_JSON>",
        "CLARITY_API_TOKEN": "<CLARITY_API_TOKEN>",
        "GHOST_ADMIN_API_KEY": "<GHOST_ADMIN_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "seo-performance-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@automatelab/seo-performance-mcp"
      ],
      "env": {
        "GSC_SERVICE_ACCOUNT_JSON": "<GSC_SERVICE_ACCOUNT_JSON>",
        "MATOMO_TOKEN": "<MATOMO_TOKEN>",
        "GA4_SERVICE_ACCOUNT_JSON": "<GA4_SERVICE_ACCOUNT_JSON>",
        "CLARITY_API_TOKEN": "<CLARITY_API_TOKEN>",
        "GHOST_ADMIN_API_KEY": "<GHOST_ADMIN_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "seo-performance-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@automatelab/seo-performance-mcp"
      ],
      "env": {
        "GSC_SERVICE_ACCOUNT_JSON": "<GSC_SERVICE_ACCOUNT_JSON>",
        "MATOMO_TOKEN": "<MATOMO_TOKEN>",
        "GA4_SERVICE_ACCOUNT_JSON": "<GA4_SERVICE_ACCOUNT_JSON>",
        "CLARITY_API_TOKEN": "<CLARITY_API_TOKEN>",
        "GHOST_ADMIN_API_KEY": "<GHOST_ADMIN_API_KEY>"
      }
    }
  }
}

Configuration

  • GSC_SERVICE_ACCOUNT_JSONBase64-encoded Google service account JSON with Search Console read access.
  • GSC_SITE_URLSearch Console site URL (e.g. sc-domain:example.com or https://example.com/).
  • MATOMO_URLMatomo instance URL (e.g. https://example.com/analytics).
  • MATOMO_TOKENMatomo auth token with view access.
  • MATOMO_SITE_IDMatomo idSite for the site to query.
  • GA4_PROPERTY_IDGA4 property ID (numeric, no G- prefix).
  • GA4_SERVICE_ACCOUNT_JSONBase64-encoded Google service account JSON with GA4 Data API access.
  • CLARITY_PROJECT_IDMicrosoft Clarity project ID.
  • CLARITY_API_TOKENMicrosoft Clarity Data Export API token.
  • POSTS_SITEMAP_URLXML sitemap URL used to enumerate posts. Primary platform-agnostic discovery path.
  • POSTS_LISTOptional JSON array overriding sitemap discovery.
  • GHOST_ADMIN_API_URLOptional. Ghost Admin API base URL. Pair with GHOST_ADMIN_API_KEY for richer metadata.
  • GHOST_ADMIN_API_KEYOptional. Ghost Admin API key in the form id:secret.
  • CITATION_INTELLIGENCE_URLOptional URL of a citation-intelligence MCP server to delegate AI-citation queries to.

Tools this server provides (7)

Taken from the project documentation; the running server may differ.

posts_list
Discovers indexable posts from a sitemap, JSON list or Ghost.
posts_snapshot
30, 60 or 90-day snapshot across all configured sources.
posts_decay_curve
Weekly GSC trend classified as decay, plateau or growth.
posts_verdict
Runs the verdict engine on one post.
posts_refresh_brief
Produces a markdown brief for an editor or LLM.
posts_cite_loss
Lists LLMs that stopped citing a URL.
cohort_report
Ranks a cohort of posts by verdict priority.

What it does

Rule-based verdicts
Emits refresh, expand, merge, kill, double down or hold with reason codes.
Optional data sources
Search Console, Matomo, GA4, Clarity and citation data; missing ones are skipped.
Decay curves
Buckets weekly clicks, impressions and position to classify decay, plateau or growth.
Refresh briefs
Markdown hand-off briefs with numbers, top queries and suggested actions.
Cohort report
Ranks posts older than a given age by impact and confidence.
Citation loss
Lists models that no longer cite a URL, and the URL that replaced it if known.

Good for

  • Pick this week's three posts to update
  • Audit a blog before deciding what to merge or retire
  • Feed refresh briefs to a rewrite agent
  • Find queries stuck at positions 5-15 with weak click-through

Pricing

Free

Free; requires your own analytics access

Prices change. Check automatelab.tech before you buy.

SEO Performance MCP FAQ

Does it change my site?

No. It is read-only and never edits or publishes anything.

Which platforms work?

Any site with an XML sitemap; Ghost has optional extra metadata.

Are all the analytics sources required?

No. Every environment variable is optional.

What tools are exposed?

Eight tools in posts, cohort and gsc families, including posts_list, posts_snapshot, posts_verdict and cohort_report.

What does citation tracking need?

posts_cite_loss requires a citation-intelligence endpoint.

Is SEO Performance MCP free?

Yes. SEO Performance MCP is free to use.

How do I add SEO Performance MCP to Claude Code?

Run this command in your terminal: claude mcp add seo-performance-mcp --env GSC_SERVICE_ACCOUNT_JSON='<GSC_SERVICE_ACCOUNT_JSON>' --env MATOMO_TOKEN='<MATOMO_TOKEN>' --env GA4_SERVICE_ACCOUNT_JSON='<GA4_SERVICE_ACCOUNT_JSON>' --env CLARITY_API_TOKEN='<CLARITY_API_TOKEN>' --env GHOST_ADMIN_API_KEY='<GHOST_ADMIN_API_KEY>' -- npx -y @automatelab/seo-performance-mcp

What are the best alternatives to SEO Performance MCP?

The closest alternatives to SEO Performance MCP are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Tapetide - Indian Stock Market MCP, World Monitor and Calven.

Alternatives to SEO Performance MCP

  1. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  2. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  3. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  4. World Monitor

    MCP server

    Live geopolitical intelligence dashboard with an API and MCP server for agents

    • Remote
    • Freemium
    • Analytics and data
  5. Calven

    MCP server

    Product marketing context from Calven delivered into Claude, ChatGPT and other AI tools

    Not checked yet
    • Remote
    • Free trial
    • 3 GitHub stars
    • Marketing and SEO
  6. CompanyData

    MCP server

    Search and enrich company records from official registers via the CompanyData API

    • 3 tools
    • Remote
    • Paid
    • 3 GitHub stars
    • Analytics and data