SEO Score API — Model Context Protocol Server

Give Claude Desktop, Claude Code, Cursor, Windsurf, or any MCP-aware AI tool direct access to the SEO Score API: full audits, backlink data, monitoring, and history.

Quick start

npx -y seoscoreapi-mcp

Set your API key once and forget it:

export SEO_SCORE_API_KEY="ssa_your_key_here"

(Get a free key at https://seoscoreapi.com — no card required.)

Tools exposed

| Tool | What it does | Plan | |---|---|---| | audit | Full SEO audit on a URL — score, grade, 82 checks, AI readability, prioritized fixes | Free | | batch_audit | Audit up to 25 URLs at once | Starter ($5/mo) | | usage | Current plan + monthly usage + remaining quota | Free | | report_url | Public shareable HTML report for a domain | Free | | add_monitor | Add a URL to scheduled re-audit + alerts | Starter | | list_monitors | List monitored URLs | Starter | | history | Time-series of past scores for a URL | Starter | | history_domains | Every domain audited by this key with 30-day trend | Starter | | backlinks | Observed backlinks for a domain (audit-fed graph; honest data caveat in every response) | Basic ($15/mo) |

Configuration

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (Mac) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "seoscoreapi": {
      "command": "npx",
      "args": ["-y", "seoscoreapi-mcp"],
      "env": {
        "SEO_SCORE_API_KEY": "ssa_your_key_here"
      }
    }
  }
}

Restart Claude Desktop. You'll see the SEO Score tools in the tool picker.

Claude Code

claude mcp add seoscoreapi -e SEO_SCORE_API_KEY=ssa_your_key_here -- npx -y seoscoreapi-mcp

Cursor

Open Cursor Settings → MCP Servers → Add a new server with the same JSON shape as Claude Desktop above.

Windsurf

Settings → Cascade → MCP Servers → paste the same configuration.

Any other MCP client

Run npx -y seoscoreapi-mcp as a stdio transport. The server speaks standard MCP and exposes all tools in the table above.

Example prompts

Once installed, talk to your AI assistant naturally:

"Audit https://stripe.com and tell me the top 3 things to fix."

"Run a batch audit on stripe.com, square.com, and adyen.com, then compare their AI readability scores."

"What backlinks have we seen pointing at my-startup.com?"

"Check the score history for our marketing site over the last 30 days."

The tool the AI picks is shown in your client; you can always ask "what tools did you use?" to see the trace.

Why MCP?

MCP lets the AI reach data it wouldn't have — your actual site SEO scores, the backlink graph, your monitoring history — without any custom plumbing. Every prompt that says "audit this URL" goes from idea to result in one round-trip. Same source of truth as the REST API; no copying scores between tools.

Honest framing

The backlinks tool returns an audit-fed sample, not a comprehensive backlink index. Every response includes a data_caveat explaining exactly what the dataset is. We are not Ahrefs and don't pretend to be — we expose the unique, growing graph our customers' audits build for free.

Source

The MCP server is open source: https://github.com/avansledright/seoscoreapi.com/tree/main/sdks/mcp

License

MIT