Seo Mcp

metricspot/mcp-server

Wraps MetricSpot's SEO and AI-readability engine in six MCP tools. The anonymous endpoint gives you a quick one-shot audit with no key, rate-limited to one per IP per day. Authenticated tools let you run full audits with Core Web Vitals via PageSpeed Insights, fetch results by ID, grab a branded PDF, list your audit history, and pull a 28-day organic traffic snapshot from GA4 and Search Console if you've linked Google. Ships as both a local stdio binary via npx and a hosted Streamable HTTP endpoint. Useful when you're building AI workflows that need to check on-page SEO, readability scores, or lighthouse metrics without leaving the chat context.

tools: 6
auth: Secret needed
transport: STDIO, HTTP
env var: 1
last updated: May 14, 2026

View on GitHub

Install

From registry metadata

$ npx add-mcp https://mcp.metricspot.com/mcp --name seo-mcp --header 'Authorization: Bearer ${API_TOKEN}'

Run in your terminal. add-mcp asks which agents to add it to, then asks for each value it needs. Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add --transport http seo-mcp https://mcp.metricspot.com/mcp --header 'Authorization: YOUR_AUTHORIZATION'

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 6 tools

Verified live against the running server on Nov 6, 2026.

run_audit_anonymousRun a one-shot SEO + AI-readability audit on any public URL. Returns scores across 11 modules and ~90 checks, plus actionable findings with rule docs. Limited to 1 audit per IP per 24 hours — for higher volume, get an API key at https://app.metricspot.com/settings/api-keys and...1 params

Run a one-shot SEO + AI-readability audit on any public URL. Returns scores across 11 modules and ~90 checks, plus actionable findings with rule docs. Limited to 1 audit per IP per 24 hours — for higher volume, get an API key at https://app.metricspot.com/settings/api-keys and...

Parameters* required

url*string

run_auditQueue a full SEO + AI-readability audit (includes Core Web Vitals from Google PSI and organic traffic if Google is linked). Returns the audit envelope immediately with `status: queued` and an `audit_id`. Poll `get_audit` with the returned `audit_id` until `status` becomes `com...1 params

Queue a full SEO + AI-readability audit (includes Core Web Vitals from Google PSI and organic traffic if Google is linked). Returns the audit envelope immediately with `status: queued` and an `audit_id`. Poll `get_audit` with the returned `audit_id` until `status` becomes `com...

Parameters* required

url*string

get_auditFetch a previously-run audit by id. Returns module scores (0-100), total score, all findings with severity, recommendation text, and links to the HTML report. Use this to poll a queued `run_audit` until `status: complete`. Requires an API key.1 params

Fetch a previously-run audit by id. Returns module scores (0-100), total score, all findings with severity, recommendation text, and links to the HTML report. Use this to poll a queued `run_audit` until `status: complete`. Requires an API key.

Parameters* required

audit_id*string

list_auditsList the user's audits (most recent first, deduplicated by URL). Returns `audit_id`, `url`, `status`, `total_score`, `created_at`. Default limit 24, max 100. Use the returned `audit_id` with `get_audit` for full findings. Requires an API key.1 params

List the user's audits (most recent first, deduplicated by URL). Returns `audit_id`, `url`, `status`, `total_score`, `created_at`. Default limit 24, max 100. Use the returned `audit_id` with `get_audit` for full findings. Requires an API key.

Parameters* required

limitinteger

get_audit_pdfReturn a signed download URL for the branded PDF report for a given audit id. If no PDF has been rendered yet, queues a render and returns `status: queued` — poll the same tool again, or fetch the URL directly once ready. Requires an API key.1 params

Return a signed download URL for the branded PDF report for a given audit id. If no PDF has been rendered yet, queues a render and returns `status: queued` — poll the same tool again, or fetch the URL directly once ready. Requires an API key.

Parameters* required

audit_id*string

get_organic_trafficIf the user has linked GA4 + Google Search Console, return the 28-day organic traffic snapshot for an audit: session count, daily trend, top landing pages, top queries, and indexing health. Returns `connected: false` if Google is not linked. Cached 24h server-side. Requires an...1 params

If the user has linked GA4 + Google Search Console, return the 28-day organic traffic snapshot for an audit: session count, daily trend, top landing pages, top queries, and indexing health. Returns `connected: false` if Google is not linked. Cached 24h server-side. Requires an...

Parameters* required

audit_id*string

Configuration

MCP_API_KEYsecret

Your MetricSpot API key (ms_live_...) from app.metricspot.com/settings/api-keys. Required for 5 of the 6 tools; omit to use only run_audit_anonymous (1 audit per IP per 24 hours, no auth).

Readme

@metricspot/mcp-server

Model Context Protocol server for MetricSpot. Exposes 6 SEO + AI-readability audit tools to AI agents (Claude, ChatGPT, Gemini, Perplexity, Cursor, Zed, OpenClaw, custom bots).

Hosted Streamable HTTP endpoint: https://mcp.metricspot.com/mcp
Local stdio binary: npx @metricspot/mcp-server
Agent guide: https://metricspot.com/AGENTS.md

Tools

Tool	Auth	Description
`run_audit_anonymous`	none	One-shot audit, 1/IP/24h, no Core Web Vitals
`run_audit`	Bearer key	Full audit with PSI, returns `audit_id`
`get_audit`	Bearer key	Fetch audit + findings by id
`list_audits`	Bearer key	List the user's recent audits (max 100)
`get_audit_pdf`	Bearer key	Signed URL for the branded PDF report
`get_organic_traffic`	Bearer key	28-day GA4 + GSC snapshot (if Google linked)

Local install (stdio)

Claude Code (~/.claude/mcp.json):

{
  "mcpServers": {
    "metricspot": {
      "command": "npx",
      "args": ["-y", "@metricspot/mcp-server"],
      "env": {
        "MCP_API_KEY": "ms_live_xxx"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json) and Zed use the same shape.

View the full README on GitHub

Details

Repository: github.com/metricspot/mcp-server
Website: metricspot.com/features/seo-mcp
Category: Sales & Marketing
Package: @metricspot/mcp-server
Transport: STDIO, HTTP
Auth: Required
Registry: MCP registry, active
Tools verified: Nov 6, 2026

Related Sales & Marketing MCP servers

View all

Linkedin Outreach Mcpcsoai-org/linkedin-outreach-mcpLinkedin Outreach MCP Server by MEOK AI Labs0stars

Mcp Data Pipeline Connectordbsectrainer/mcp-data-pipeline-connectorUniversal data connector for CSV, Postgres, and REST APIs via DuckDB0stars

Apollo Intelligence Networkbnmbnmai/mcp-proxy54 AI agent tools: OSINT, intel feeds, DeFi, crypto, weather, DNS, proxies. x402 micropayments.0stars

SEO Page Analyzerbr0ski777/seo-analyzer-x402SEO audit any URL: meta tags, headings, links, images, Schema.org, score 0-100. x402.0stars

Technology Stack Detection APIbr0ski777/tech-enrichment-x402Detect 50+ technologies on any website: CMS, frameworks, analytics, CDN. x402.0stars

HubSpot Integrations MCPcentrify-internal/hubspot-mcp-serverMCP server for the HubSpot Integrations Center HubDB: search and retrieve integration data.0stars