# seo-mcp

Runs 91 search optimization and AI-readability checks on web pages directly from your AI development assistant.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: MetricSpot
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/MetricSpot/mcp-server
- Updated: 2026-05-22
- HTML: https://affpapa.org/en/nevibecode/mcp/seo-mcp

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.metricspot.com/mcp`
- Environment variables: `MCP_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http seo-mcp https://mcp.metricspot.com/mcp
```

2. **Platform CLI**
```bash
claude mcp add --env MCP_API_KEY=<MCP_API_KEY> --transport stdio seo-mcp -- npx -y @metricspot/mcp-server
```
Replace <…> with your own values

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add seo-mcp --url https://mcp.metricspot.com/mcp
```

2. **Platform CLI**
```bash
codex mcp add seo-mcp --env MCP_API_KEY=<MCP_API_KEY> -- npx -y @metricspot/mcp-server
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "seo-mcp": {
            "url": "https://mcp.metricspot.com/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "seo-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@metricspot/mcp-server"
            ],
            "env": {
                "MCP_API_KEY": "<MCP_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "seo-mcp": {
            "type": "http",
            "url": "https://mcp.metricspot.com/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "seo-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@metricspot/mcp-server"
            ],
            "env": {
                "MCP_API_KEY": "<MCP_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http seo-mcp https://mcp.metricspot.com/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e MCP_API_KEY=<MCP_API_KEY> seo-mcp npx -y @metricspot/mcp-server
```
Replace <…> with your own values

## When to use it
- 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
- 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

## Similar
- [seo-fundamentals](https://affpapa.org/en/nevibecode/skills/sickn33-seo-fundamentals.md) — skill · 1100 installs
- [Frase SEO](https://affpapa.org/en/nevibecode/mcp/frase-seo.md) — MCP server
- [That SEO Agent](https://affpapa.org/en/nevibecode/mcp/that-seo-agent.md) — MCP server
- [seo-coach](https://affpapa.org/en/nevibecode/skills/seo-coach.md) — skill · 6700 installs
- [seo-audit](https://affpapa.org/en/nevibecode/skills/coreyhaines31-seo-audit.md) — skill · 238500 installs
- [seo](https://affpapa.org/en/nevibecode/skills/agricidaniel-seo.md) — skill · 9200 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md