seo-mcp — Claude Code MCP server: what it does, how to install
Runs 91 search optimization and AI-readability checks on web pages directly from your AI development assistant.
claude mcp add --transport http seo-mcp https://mcp.metricspot.com/mcpWhat seo-mcp does
This server connects AI agents to MetricSpot audit infrastructure through six dedicated tools. The primary run_audit action performs full page evaluations with PageSpeed Insights metrics grouped into 11 modules. After completing an evaluation, agents can inspect detailed findings via get_audit, generate a signed PDF download link, or pull a 28-day traffic snapshot from linked Google Analytics 4 and Search Console accounts.
You can connect via a hosted streamable HTTP endpoint or run it locally through stdio using npx. If you run without an MCP_API_KEY, the server limits you strictly to run_audit_anonymous. That unauthenticated mode restricts usage to one execution per IP every 24 hours and strips out Core Web Vitals metrics entirely.
What it helps with
- audit web page readability for search engines and AI scrapers
- generate signed links for downloadable PDF audit reports
- retrieve a 28-day organic traffic summary from GA4 and Search Console
- evaluate page markup and structure across 91 separate checks
Example prompts for the agent
- Run an anonymous audit on my staging site
- Execute a full audit with run_audit and review the findings
- Fetch the 28-day organic traffic metrics for the verified property
How to install seo-mcp
1Platform CLI: remote server
claude mcp add --transport http seo-mcp https://mcp.metricspot.com/mcp2Platform CLI
claude mcp add --env MCP_API_KEY=<MCP_API_KEY> --transport stdio seo-mcp -- npx -y @metricspot/mcp-serverReplace <…> with your own values
1Platform CLI: remote server
codex mcp add seo-mcp --url https://mcp.metricspot.com/mcp2Platform CLI
codex mcp add seo-mcp --env MCP_API_KEY=<MCP_API_KEY> -- npx -y @metricspot/mcp-serverReplace <…> with your own values
Config file
{
"mcpServers": {
"seo-mcp": {
"url": "https://mcp.metricspot.com/mcp"
}
}
}{
"mcpServers": {
"seo-mcp": {
"command": "npx",
"args": [
"-y",
"@metricspot/mcp-server"
],
"env": {
"MCP_API_KEY": "<MCP_API_KEY>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"seo-mcp": {
"type": "http",
"url": "https://mcp.metricspot.com/mcp"
}
}
}{
"servers": {
"seo-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@metricspot/mcp-server"
],
"env": {
"MCP_API_KEY": "<MCP_API_KEY>"
}
}
}
}Replace <…> with your own values
1Platform CLI: remote server
gemini mcp add -t http seo-mcp https://mcp.metricspot.com/mcp2Platform CLI
gemini mcp add -e MCP_API_KEY=<MCP_API_KEY> seo-mcp npx -y @metricspot/mcp-serverReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about seo-mcp
How to install seo-mcp in Claude Code?
Run claude mcp add --transport http seo-mcp https://mcp.metricspot.com/mcp in your terminal.
What does seo-mcp do?
It inspects websites against 91 technical SEO and machine-readability checks. The server returns structured issues, score breakdowns across 11 modules, and traffic summaries to your assistant.
How does the anonymous audit differ from a full audit?
The run_audit_anonymous tool needs no API key but is capped at one run per IP every 24 hours without Core Web Vitals. Running run_audit provides full PageSpeed metrics but requires an MCP_API_KEY.
