mcp server

rankcli-mcp-server

Free, local MCP server for RankCLI SEO + GEO analysis — no signup, no API key

integrallis/rankcli-mcp-servercommunitylistedunreviewed

Use tool

Set up

Runs on your computer. Pick your agent and operating system.

Before you start

Node.js 20 or newer

~/Library/Application Support/Claude/claude_desktop_config.json

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

same format Cursor, GitHub Copilot CLI, Junie, JetBrains AI Assistant, Augment (Auggie CLI), Factory Droid, Kiro, Devin CLI +12

Values in angle brackets are placeholders. Restart Claude Desktop after editing its config.Claude Desktop docs

README

synced Oct 17, 2026

@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.

Install

Claude Desktop — download the latest .mcpb from Releases and double-click it. No config file, no terminal.

Claude Code — one line, no config file:

claude mcp add rankcli -- npx -y @rankcli/mcp-server

Anything else (Claude Desktop, Codex, Windsurf) — the standard config block:

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

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

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

Agent skills and Claude Code plugin

The same checks as skills your coding agent loads on demand. Two skills ship in this repo: seo-audit (run the audit, read the JSON, fix the highest-impact issues in the codebase) and seo-ci-gate (fail the build on SEO regressions in GitHub Actions or any CI).

Any agent (Claude Code, Cursor, Codex, Copilot, Windsurf and others), via the skills CLI:

npx skills add integrallis/rankcli-mcp-server

Claude Code plugin (the two skills plus the MCP server, one install):

/plugin install rankcli --marketplace integrallis/rankcli-mcp-server

or from a shell: claude plugin marketplace add integrallis/rankcli-mcp-server then claude plugin install rankcli@rankcli. The skills are then /rankcli:seo-audit and /rankcli:seo-ci-gate.

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

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://rankcli-audit-worker.fly.dev/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

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