# SEO Performance MCP

> SEO Performance MCP is a free MCP server for marketing and seo. One verdict per blog post (refresh, expand, merge, kill) from Search Console, GA4 and more. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI, self-hosted
- **Website:** https://automatelab.tech/products/mcp/seo-performance-mcp/
- **Repository:** https://github.com/automatelab-tech/seo-performance-mcp
- **MCP Registry name:** io.github.AutomateLab-tech/seo-performance-mcp
- **Categories:** marketing and SEO, analytics and data
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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>"
      }
    }
  }
}
```

## Tools

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

## 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

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [MCP](https://ai-powered.com/mcp/mcp-mwhffe53): MCP is a freemium MCP server for marketing and seo.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/seo-performance-mcp
