SEOFix

MCP server

Give your agent an SEO audit tool.

The SEOFix MCP server lets Claude Code, Codex and Cursor run audits, read issues grouped by template and fetch fix prompts. One HTTPS endpoint, authenticated with your API key.

https://mcp.seofix.ai/mcpStreamable HTTP · Bearer auth

  1. 1. Create an API key

    Keys start with sk_ and belong to your team. Find them in Settings.

    Sign up to get a key

  2. 2. Add the server

    Paste the snippet for your agent below and replace sk_... with your key.

  3. 3. Ask in plain English

    Your agent picks the right tools: start an audit, poll it, read the report and apply the fixes.

Setup

Claude Code

Run in your project's terminal.

Add --scope user to use it in every project.

Run in your project's terminal
claude mcp add --transport http seofix https://mcp.seofix.ai/mcp \
  --header "Authorization: Bearer sk_..."

Codex

Add to ~/.codex/config.toml.

Prefer not to store the key in the file? Use bearer_token_env_var = "SEOFIX_API_KEY" instead of http_headers.

Add to ~/.codex/config.toml
[mcp_servers.seofix]
url = "https://mcp.seofix.ai/mcp"
http_headers = { "Authorization" = "Bearer sk_..." }

Cursor

Add to .cursor/mcp.json.

Add to .cursor/mcp.json
{
  "mcpServers": {
    "seofix": {
      "url": "https://mcp.seofix.ai/mcp",
      "headers": {
        "Authorization": "Bearer sk_..."
      }
    }
  }
}

33 tools

Every tool maps to the same /v1 REST API.

Audits

  • start_audit

    Start an SEO audit crawl of any URL; returns a crawl_id and its credit cost.

  • get_audit_status

    Status, pages crawled, pages/min, crawl speed and failure reason of an audit.

  • cancel_audit

    Cancel a running audit crawl.

  • start_site_audit

    Re-audit a registered site with its saved settings, diffed against the last run.

Reports

  • get_report

    Health score, totals, crawl stats, firewall coverage and the top issues.

  • get_templates

    Issues grouped by URL template, so one template fix clears thousands of pages.

  • get_fix_prompt

    A ready-to-follow markdown prompt with the top issues, affected URLs and fixes.

  • list_issues

    Paginated issues, filterable by check code, severity or template.

  • get_pages

    Paginated crawled pages by status code, incl. firewall blocks and fetch errors.

  • get_diff

    New and fixed issues and health delta since the previous audit: your regression check.

Fixes

  • get_fix_tasks

    Fix tasks ranked by impact (severity × pages × Search Console traffic), or the diversified Top 3.

  • get_fix_task

    One fix task in full: why, the fix, every affected URL and the acceptance condition.

  • verify_fix

    Recheck just the task's URLs after you deploy; the task is marked fixed when all pass.

  • get_recheck

    Progress and per-URL results of a Verify fix recheck.

  • get_fix_impact

    Search Console clicks before and 7, 14 and 28 days after each verified fix.

Sites

  • list_sites

    Sites in your team with verification, monitoring schedule and limits.

  • create_site

    Register a site for repeat audits and monitoring; returns verification instructions.

  • get_site

    One site's settings, verification status, latest crawl and health trend.

  • list_site_audits

    A site's audit history (manual, scheduled, CI) with health scores, newest first.

  • verify_site

    Check ownership via Search Console, DNS TXT, meta tag or file (unlocks monitoring, faster and larger audits).

  • get_verification

    The site's verification status and the exact instructions for each method.

  • set_monitoring

    Turn recurring audits off, weekly or daily, with email alerts on new errors.

Google & IndexNow

  • get_indexing_summary

    Indexed vs not indexed, clicks and impressions from Search Console.

  • list_not_indexed

    Pages Google doesn't index, grouped with Google's own coverage reasons.

  • get_index_triage

    Why pages aren't indexed: worth indexing, low value, duplicate or excluded on purpose.

  • get_url_status

    One URL's Google index status, canonical, last crawl and SEOFix issues.

  • inspect_urls

    Run Google URL Inspection on specific URLs within the daily budget.

  • get_opportunities

    Quick wins: pages with impressions but low clicks, near page one.

  • submit_indexnow

    Submit changed URLs to IndexNow (Bing, Yandex and others; not Google).

  • get_indexnow_status

    The site's IndexNow key, verification, auto-submit setting and detection result.

  • set_indexnow_key

    Use an IndexNow key you already serve, checked right away.

  • detect_indexnow_key

    Look for an IndexNow key already on the site (team keys, crawl, platform).

Account

  • get_account

    Your credit balance and crawl usage.

Try asking your agent

  • “Audit example.com with SEOFix and fix the top template issue in this repo.”
  • “Get the SEOFix fix prompt for my last audit and work through it.”
  • “Re-audit my site and tell me what changed since last week.”

Fix prompts contain URLs and text copied from the crawled site. SEOFix marks them as untrusted data so your agent follows only the fix guidance.