mcp-server-seoradar

MCP server for SEO Radar — run SEO audits and manage URL monitoring from any MCP-compatible AI client.

Prerequisites

Node.js ≥ 20
An sr_live_ API key from seoradar.cz

Quick install

Add to your MCP client config:

{
  "mcpServers": {
    "seoradar": {
      "command": "npx",
      "args": ["-y", "mcp-server-seoradar"],
      "env": { "SEORADAR_API_KEY": "sr_live_your_key_here" }
    }
  }
}

Setup

Claude Code

claude mcp add seoradar -e SEORADAR_API_KEY=sr_live_your_key -- npx -y mcp-server-seoradar

Claude Desktop

Config file: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "seoradar": {
      "command": "npx",
      "args": ["-y", "mcp-server-seoradar"],
      "env": { "SEORADAR_API_KEY": "sr_live_your_key_here" }
    }
  }
}

Cursor

Config file: ~/.cursor/mcp.json

{
  "mcpServers": {
    "seoradar": {
      "command": "npx",
      "args": ["-y", "mcp-server-seoradar"],
      "env": { "SEORADAR_API_KEY": "sr_live_your_key_here" }
    }
  }
}

VS Code

Config file: ~/.vscode/mcp.json (or workspace .vscode/mcp.json)

{
  "servers": {
    "seoradar": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-server-seoradar"],
      "env": { "SEORADAR_API_KEY": "sr_live_your_key_here" }
    }
  }
}

Available tools

| Tool | Input | Purpose | | --- | --- | --- | | seo_audit | { url } | Run an audit, return score + summary | | get_audit_results | { hash } | Full per-check report | | check_api_usage | — | Quota: tier/limit/used/remaining | | list_monitored_urls | — | List watched URLs + status | | add_monitored_url | { url, label?, cadence? } | Add a URL to monitoring | | get_monitoring_status | { id } | One URL's latest status | | remove_monitored_url | { id } | Stop watching a URL |

Usage examples

Run an SEO audit on https://example.com
What are the detailed results for audit hash abc123?
How many audits do I have left today?
Show me all my monitored URLs
Add https://example.com to monitoring with label "Homepage" checked daily
What's the latest status of monitored URL 42?
Remove monitored URL 42

Development

npm install       # install dependencies
npm run build     # compile TypeScript → dist/
npm test          # run vitest tests
npm run lint      # eslint src/

Configuration

| Variable | Required | Default | Description | | --- | --- | --- | --- | | SEORADAR_API_KEY | Yes | — | Your sr_live_ API key from seoradar.cz | | SEORADAR_API_URL | No | https://seoradar.cz/api/v1 | API base URL (override for staging) |

Error handling

All tools return structured error messages. Common cases:

401 — invalid or missing API key
404 — audit hash or monitored URL ID not found
422 — invalid URL format or unsupported cadence value
429 — rate limit or daily quota exceeded
5xx — SEO Radar API temporarily unavailable

Polling tools (seo_audit) retry automatically for up to ~90 s before returning a timeout error.

Security

The API key is passed via environment variable and never logged or included in responses. Store your key in your OS keychain or a secrets manager — never commit it to source control.

License

MIT — see LICENSE.

seoradar-mcp