@rankcli/mcp-server

Free, local SEO + GEO (AI-search-citation) analysis as an MCP tool. No signup, no API key, nothing sent to RankCLI's servers — it runs entirely inside your MCP host (Claude Code, Claude Desktop, Cursor, etc.) against HTML you already have or that your host fetches for you. The one exception is rankcli_connect, an explicit opt-in tool that links this server to a RankCLI account.

npx @rankcli/mcp-server

Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "rankcli": {
      "command": "npx",
      "args": ["@rankcli/mcp-server"]
    }
  }
}

Prefer not to run anything locally? The same tools are available at a free hosted HTTP endpoint, no npx and no signup:

{
  "mcpServers": {
    "rankcli": {
      "url": "https://mcp.rankcli.dev/mcp/free"
    }
  }
}

Available Tools

| Tool | Description | |------|-------------| | seo_analyze | Full SEO analysis: GEO, Core Web Vitals, structured data, security headers, mobile, images, internal linking | | seo_geo_check | AI search visibility (GEO) — crawler access, LLM content signals, citation readiness | | seo_robots_ai | Which AI crawlers (GPTBot, ClaudeBot, PerplexityBot, etc.) your robots.txt allows or blocks | | seo_generate_robots | Generate an AI-crawler-friendly robots.txt | | seo_core_web_vitals | Estimate LCP, CLS, INP, TTFB from HTML | | seo_structured_data | Validate JSON-LD / Schema.org markup | | seo_generate_schema | Generate a JSON-LD template for a page type | | seo_security_headers | Grade HTTPS, HSTS, CSP, and related headers | | seo_generate_security_headers | Generate recommended security header config | | seo_images | Alt text, dimensions, formats, lazy loading | | seo_internal_links | Anchor text quality, orphan-page risk | | seo_mobile | Viewport, touch targets, PWA readiness | | seo_ai_crawlers | Reference list of known AI crawler user agents | | rankcli_connect | Link this server to a RankCLI account for GitHub auto-fix PRs, scheduled monitoring, and a dashboard with audit history. Opens a browser tab to approve; the only tool here that contacts rankcli.dev | | rankcli_disconnect | Unlink this server from your RankCLI account (local only — doesn't touch the account itself) |

Connecting your account

Ask Claude to "connect my RankCLI account," or call rankcli_connect directly. It opens rankcli.dev in your browser to approve (or asks for permission first, on MCP hosts that support that inline) - once approved, this server and the rankcli CLI on the same machine both use the connection, with nothing further to configure. It works the same on the free plan: connect a BYOK AI provider key at rankcli.dev/account?tab=ai-provider and auto-fix PRs run on your own key at no cost, including several providers with genuinely free tiers.

Example

Just ask Claude:

"Run an SEO audit on https://example.com"

Your MCP host fetches the page and Claude calls these tools directly — nothing round-trips through RankCLI.

Want more?

This local server works from HTML/robots.txt you or your MCP host supply. For URL-only tools that fetch and crawl for you (seo_audit, seo_geo_check, seo_robots_check, seo_compare), plus the newer Cloudflare AI-crawler-gating compliance check, CI/CD scheduling, and auto-fix PRs, see the hosted endpoint and paid tiers:

{
  "mcpServers": {
    "rankcli-hosted": {
      "url": "https://mcp.rankcli.dev/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Get a free API key at rankcli.dev/dashboard.

Links

• Main package: @rankcli/cli
• Docs: rankcli.dev/docs
• Dashboard: rankcli.dev/dashboard