# seo-mcp MCP server

Six tools for SEO and AI-readability audits. 91 checks, 11 score modules.

## Links
- Registry page: https://www.getdrio.com/mcp/com-metricspot-seo-mcp
- Repository: https://github.com/MetricSpot/mcp-server
- Website: https://metricspot.com/features/seo-mcp/

## Install
- Command: `npx -y @metricspot/mcp-server`
- Endpoint: https://mcp.metricspot.com/mcp
- Auth: Auth required by registry metadata

## Setup notes
- Remote header: Authorization (secret)
- Package: Npm @metricspot/mcp-server v0.1.1
- Environment variable: MCP_API_KEY (secret)
- The upstream registry signals required auth or secrets.
- Remote endpoint: https://mcp.metricspot.com/mcp
- Header: Authorization

## Tools
- run_audit_anonymous - 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 use `run_audit`. Synchronous: blocks until the audit completes. Does NOT include Core Web Vitals (use `run_audit` for full PSI scoring). No auth required. Endpoint: https://mcp.metricspot.com/mcp
- run_audit - 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 `complete` (typical 10-30s). Counts against the user's plan allowance. Requires an API key as a Bearer token. Quota and per-domain cooldowns mirror the dashboard. Endpoint: https://mcp.metricspot.com/mcp
- get_audit - 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. Endpoint: https://mcp.metricspot.com/mcp
- list_audits - 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. Endpoint: https://mcp.metricspot.com/mcp
- get_audit_pdf - 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. Endpoint: https://mcp.metricspot.com/mcp
- get_organic_traffic - 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 API key. Endpoint: https://mcp.metricspot.com/mcp

## Resources
Not captured

## Prompts
Not captured

## Metadata
- Owner: com.metricspot
- Version: 0.1.1
- Runtime: Npm
- Transports: STDIO, HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: May 14, 2026
- Source: https://registry.modelcontextprotocol.io