SEOReport

npx add-mcp 'https://seoreport.dev/mcp'

SEOReport MCP Server

Run full technical SEO audits of any website from your AI agent and get structured, prioritised findings back.

SEOReport audits a website across indexability, canonicalization, crawlability, AI-search readiness, structured data, security headers and performance, and returns a scored report with a prioritised fix plan, per-page detail and an executive summary. This MCP server lets an agent start a report for a URL, read the findings as structured data and download the PDF.

This repository holds the connection details for the hosted server. The server itself runs at SEOReport; there is nothing to install.

Endpoint	https://seoreport.dev/mcp
Transport	Streamable HTTP
Auth	Authorization: Bearer <api-key>
Official MCP Registry	dev.seoreport/seoreport
Smithery	seoreport/seoreport
Docs	seoreport.dev/agents

Get an API key

SEOReport is a paid product. With an active plan, create a key at seoreport.dev/dashboard/api-keys. Keep it in your client's secret settings, not in chat or in a committed file.

Connect

Claude Code

claude mcp add --transport http seoreport https://seoreport.dev/mcp \
  --header "Authorization: Bearer $SEOREPORT_API_KEY"

Claude Desktop, Cursor, Windsurf and other JSON-configured clients

{
  "mcpServers": {
    "seoreport": {
      "url": "https://seoreport.dev/mcp",
      "headers": { "Authorization": "Bearer <your-api-key>" }
    }
  }
}

VS Code

{
  "servers": {
    "seoreport": {
      "type": "http",
      "url": "https://seoreport.dev/mcp",
      "headers": { "Authorization": "Bearer ${input:seoreport-api-key}" }
    }
  },
  "inputs": [
    { "id": "seoreport-api-key", "type": "promptString", "description": "SEOReport API key", "password": true }
  ]
}

Clients that only speak stdio

{
  "mcpServers": {
    "seoreport": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://seoreport.dev/mcp", "--header", "Authorization: Bearer ${SEOREPORT_API_KEY}"],
      "env": { "SEOREPORT_API_KEY": "<your-api-key>" }
    }
  }
}

What an agent can do

• Start an audit for a URL and wait for it to finish
• Read the findings as structured data, filtered to what matters
• Download the report as PDF, Markdown, text or JSON
• Check the account's plan and remaining credits
• List plans and start checkout when credits run out
• Send feedback to the SEOReport team

The live tool list, with input and output schemas, is published at /.well-known/mcp/server-card.json.

Example prompts

• "Audit example.com with SEOReport and list the five fixes with the most impact."
• "Run SEOReport on our staging site and tell me which pages are blocked from indexing."
• "Download the SEOReport PDF for the last audit so I can send it to the client."

Support

support@seoreport.dev