io.github.AutomateLab-tech/seo-performance-mcp — Model Context Protocol (MCP) Server

This MCP server provides per-URL SEO verdicts aggregated from Google Search Console (GSC), GA4, Matomo, Clarity, and AI citation inputs. Its described purpose is to refresh, expand, merge, or kill SEO elements based on those signals, using a Model Context Protocol interface.

🛠️ Key Features

Per-URL SEO verdicts
Inputs from GSC, GA4, Matomo, and Clarity
AI citations support
Refresh/expand/merge/kill workflow

🚀 Use Cases

Route SEO actions per specific URL based on analytics and search performance
Compare and reconcile findings across multiple tracking sources (GSC, GA4, Matomo, Clarity)
Manage SEO content decisions such as refresh, expand, merge, or removal

⚡ Developer Benefits

Standardized MCP integration via Model Context Protocol
Tooling aligned with TypeScript-oriented ecosystem and SEO tooling keywords
Explicit support for geo and citation-driven SEO decisions

⚠️ Limitations

Capabilities are limited to producing per-URL SEO verdicts using the listed source signals and citation inputs

Install

Configuration

Environment variables

GSC_SERVICE_ACCOUNT_JSONsecret

Base64-encoded Google service account JSON with Search Console read access.

GSC_SITE_URL

Search Console site URL (e.g. sc-domain:example.com or https://example.com/).

MATOMO_URL

Matomo instance URL (e.g. https://example.com/analytics).

MATOMO_TOKENsecret

Matomo auth token with view access.

MATOMO_SITE_ID

Matomo idSite for the site to query.

GA4_PROPERTY_ID

GA4 property ID (numeric, no G- prefix).

GA4_SERVICE_ACCOUNT_JSONsecret

Base64-encoded Google service account JSON with GA4 Data API access.

CLARITY_PROJECT_ID

Microsoft Clarity project ID.

CLARITY_API_TOKENsecret

Microsoft Clarity Data Export API token.

POSTS_SITEMAP_URL

XML sitemap URL used to enumerate posts. Primary platform-agnostic discovery path.

POSTS_LIST

Optional JSON array overriding sitemap discovery.

GHOST_ADMIN_API_URL

Optional. Ghost Admin API base URL. Pair with GHOST_ADMIN_API_KEY for richer metadata.

GHOST_ADMIN_API_KEYsecret

Optional. Ghost Admin API key in the form id:secret.

CITATION_INTELLIGENCE_URL

Optional URL of a citation-intelligence MCP server to delegate AI-citation queries to.

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "seo-performance-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@automatelab/seo-performance-mcp@1.0.0"
      ],
      "env": {
        "GSC_SERVICE_ACCOUNT_JSON": "<YOUR_GSC_SERVICE_ACCOUNT_JSON>",
        "GSC_SITE_URL": "<YOUR_GSC_SITE_URL>",
        "MATOMO_URL": "<YOUR_MATOMO_URL>",
        "MATOMO_TOKEN": "<YOUR_MATOMO_TOKEN>",
        "MATOMO_SITE_ID": "<YOUR_MATOMO_SITE_ID>",
        "GA4_PROPERTY_ID": "<YOUR_GA4_PROPERTY_ID>",
        "GA4_SERVICE_ACCOUNT_JSON": "<YOUR_GA4_SERVICE_ACCOUNT_JSON>",
        "CLARITY_PROJECT_ID": "<YOUR_CLARITY_PROJECT_ID>",
        "CLARITY_API_TOKEN": "<YOUR_CLARITY_API_TOKEN>",
        "POSTS_SITEMAP_URL": "<YOUR_POSTS_SITEMAP_URL>",
        "POSTS_LIST": "<YOUR_POSTS_LIST>",
        "GHOST_ADMIN_API_URL": "<YOUR_GHOST_ADMIN_API_URL>",
        "GHOST_ADMIN_API_KEY": "<YOUR_GHOST_ADMIN_API_KEY>",
        "CITATION_INTELLIGENCE_URL": "<YOUR_CITATION_INTELLIGENCE_URL>"
      }
    }
  }
}

SEO Performance MCP