# SEOReport MCP Server Run full technical SEO audits of any website from your AI agent and get structured, prioritised findings back. [SEOReport](https://seoreport.dev) 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 ` | | Official MCP Registry | `dev.seoreport/seoreport` | | Smithery | [seoreport/seoreport](https://smithery.ai/servers/seoreport/seoreport) | | Docs | [seoreport.dev/agents](https://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](https://seoreport.dev/dashboard/api-keys). Keep it in your client's secret settings, not in chat or in a committed file. ## Connect ### Claude Code ```bash 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 ```json { "mcpServers": { "seoreport": { "url": "https://seoreport.dev/mcp", "headers": { "Authorization": "Bearer " } } } } ``` ### VS Code ```json { "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 ```json { "mcpServers": { "seoreport": { "command": "npx", "args": ["-y", "mcp-remote", "https://seoreport.dev/mcp", "--header", "Authorization: Bearer ${SEOREPORT_API_KEY}"], "env": { "SEOREPORT_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`](https://seoreport.dev/.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](mailto:support@seoreport.dev)