com.metricspot/seo-mcp (MCP) Server

This Model Context Protocol (MCP) server for MetricSpot exposes six SEO and AI-readability audit tools to AI agents. It provides 91 checks across 11 score modules via a hosted Streamable HTTP endpoint and a local stdio binary, supporting common agent runtimes.

🛠️ Key Features

Six tools for SEO and AI-readability audits
91 checks and 11 score modules
Hosted Streamable HTTP endpoint: https://mcp.metricspot.com/mcp
Local stdio binary available via npx @metricspot/mcp-server

🚀 Use Cases

Running one-shot SEO/AI-readability audits through AI agents
Performing full audits with an issued audit_id
Using MetricSpot audits with agents such as Claude, ChatGPT, Gemini, and others listed in the readmeExcerpt

⚡ Developer Benefits

Tool-based integration: run_audit_anonymous and run_audit
run_audit_anonymous: no auth, one-shot audit (1/IP/24h), and no Core Web Vitals
run_audit: Bearer key required, includes PSI, returns audit_id
Agent guide: https://metricspot.com/AGENTS.md

⚠️ Limitations

Anonymous audits are rate-limited (1/IP/24h)
Anonymous audits do not include Core Web Vitals

@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):

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.

Omit MCP_API_KEY to only use run_audit_anonymous.

Env vars

Var

Default

Purpose

PORT

3000

HTTP listen port

APP_API_BASE_URL

https://app.metricspot.com

MetricSpot app API base (the dev/dev:stdio scripts override it to http://localhost:3000)

APP_PUBLIC_BASE_URL

falls back to APP_API_BASE_URL

Used to build report_url

MCP_INTERNAL_TOKEN

—

Service-to-service secret forwarded as X-MCP-Internal-Token

MCP_API_KEY

—

(stdio only) User API key, sent as Authorization: Bearer to the HTTP layer

Install

Tools (6)

run_audit_anonymousrun_auditget_auditlist_auditsget_audit_pdfget_organic_traffic

Configuration

Environment variables

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

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "seo-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@metricspot/mcp-server@0.1.1"
      ],
      "env": {
        "MCP_API_KEY": "<YOUR_MCP_API_KEY>"
      }
    }
  }
}

com.metricspot/seo-mcp