SEO Performance MCP
One verdict per blog post (refresh, expand, merge, kill) from Search Console, GA4 and more
- 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-mcpAdd 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

Agent-Native Analytics
MCP serverOpen-source analytics app where an AI agent builds charts and dashboards from your data
- Remote
- Open source
- 7.7K GitHub stars
- Analytics and data

Google Ads + Meta Ads + SEO/GEO MCP
MCP serverHosted 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

Tapetide - Indian Stock Market MCP
MCP serverIndian NSE and BSE stock market data for AI assistants through 48 MCP tools
- 17 tools
- Remote
- Freemium
- 150 GitHub stars
- Finance and payments

World Monitor
MCP serverLive geopolitical intelligence dashboard with an API and MCP server for agents
- Remote
- Freemium
- Analytics and data

Calven
MCP serverProduct marketing context from Calven delivered into Claude, ChatGPT and other AI tools
Not checked yet- Remote
- Free trial
- 3 GitHub stars
- Marketing and SEO

CompanyData
MCP serverSearch and enrich company records from official registers via the CompanyData API
- 3 tools
- Remote
- Paid
- 3 GitHub stars
- Analytics and data