Skip to main content
Glama

@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

Add to Cursor Add to VS Code

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"]
    }
  }
}

Related MCP server: seo-audit-mcp

Agent skills and Claude Code plugin

The same checks as skills your coding agent loads on demand, named for the job you type:

Skill

For

check-site-before-deploy

the audit as a deploy gate: build directory or preview URL, a committed baseline, GitHub Actions or any CI

fix-seo-regressions

what changed, against a baseline or a previous report, fixed in the codebase by code

is-my-site-blocked-from-ai-search

whether ChatGPT, Claude, Perplexity and Google can read the site, by bot class, and the fix in robots.txt, at the CDN or in the framework

seo-audit

the full audit, read and triaged

seo-ci-gate

the short form of the deploy gate

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:check-site-before-deploy, /rankcli:fix-seo-regressions, /rankcli:is-my-site-blocked-from-ai-search, /rankcli:seo-audit and /rankcli:seo-ci-gate.

The server's source is packages/mcp-server in integrallis/rankcli (FSL-1.1-MIT); this repository is the install page, the skills and the plugin.

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. The free hosted endpoint https://mcp.rankcli.dev/mcp/free serves the same thirteen analysis tools with no key, for hosts that cannot run npx. 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.

Available Tools

13 tools
seo_ai_crawlersA

Get information about all known AI crawlers (GPTBot, ClaudeBot, PerplexityBot, Google-Extended, etc.) including their user agents and purposes.

Inputs: no named parameters.

seo_analyzeA

Run comprehensive SEO analysis on a webpage. Returns scores and issues for:

  • GEO (AI Search Optimization) - Is the site visible to ChatGPT, Perplexity, Claude?

  • Core Web Vitals (LCP, CLS, INP) - Performance estimates

  • Structured Data - Schema.org validation

  • Security Headers - HTTPS, HSTS, CSP

  • Mobile SEO - Responsive design, touch targets

  • Images - Alt text, formats, dimensions

  • Internal Linking - Anchor text, orphan detection

Use this for a complete SEO audit.

Inputs: url (required), html, robotsTxt.

seo_core_web_vitalsA

Estimate Core Web Vitals (LCP, CLS, INP, TTFB) from HTML analysis. Identifies issues like:

  • Render-blocking resources

  • Images without dimensions

  • Large JavaScript bundles

  • Missing preload hints

Inputs: url (required), html (required).

seo_generate_robotsB

Generate an AI-friendly robots.txt that allows all major AI crawlers (GPTBot, ClaudeBot, PerplexityBot, Google-Extended, etc.)

Inputs: siteUrl (required).

seo_generate_schemaB

Generate JSON-LD structured data template for a page type (article, product, faq, local-business, website).

Inputs: siteUrl (required), pageType (required), siteName (required), authorName, +1 more.

seo_generate_security_headersB

Generate recommended security headers configuration for a site.

Inputs: siteUrl (required).

seo_geo_checkA

Check if a website is optimized for AI search engines (GEO - Generative Engine Optimization).

Analyzes:

  • AI crawler access (GPTBot, ClaudeBot, PerplexityBot, etc.)

  • robots.txt rules for AI crawlers

  • JS rendering requirements (can AI crawlers see content?)

  • Content structure for LLM consumption

  • Citation readiness (trust signals)

  • FAQ/entity extraction capability

Critical for visibility in ChatGPT, Perplexity, Claude, and Gemini responses.

Inputs: url (required), html, robotsTxt.

seo_imagesA

Analyze images for SEO and performance. Checks alt text, dimensions, formats (WebP/AVIF), lazy loading, and responsive images.

Inputs: url (required), html (required).

seo_mobileB

Analyze mobile SEO. Checks viewport, touch targets, font sizes, content width, PWA readiness.

Inputs: url (required), html (required).

seo_robots_aiA

Analyze robots.txt for AI crawler permissions. Shows which AI crawlers (GPTBot, ClaudeBot, PerplexityBot, etc.) are allowed or blocked.

Inputs: robotsTxt (required).

seo_security_headersA

Analyze security headers (HTTPS, HSTS, CSP, X-Frame-Options, etc.). Returns a security grade A+ through F.

Inputs: url (required), headers (required).

seo_structured_dataA

Validate JSON-LD structured data (Schema.org). Checks for:

  • Required properties per schema type

  • Article, Product, FAQ, HowTo, LocalBusiness schemas

  • Rich result eligibility

  • Common mistakes

Inputs: url (required), html (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 13 tools

    Disambiguation4/5

    Tools are mostly distinct: seo_analyze is a comprehensive audit, while individual tools provide focused deep dives. Some overlap exists between seo_geo_check and seo_robots_ai (both touch AI crawler access), but descriptions clarify the broader scope of geo check.

    Naming Consistency4/5

    All tools share the seo_ prefix and use snake_case, with generation tools following a clear seo_generate_* pattern. However, analysis tools mix verbs (analyze, check) with bare noun phrases (seo_images, seo_internal_links), which is a minor inconsistency.

    Tool Count5/5

    13 tools is well-scoped for a technical SEO toolkit, covering analysis, generation, and informational tools without bloat. Each tool addresses a distinct SEO concern, and the count feels appropriate for the domain.

    Completeness4/5

    The toolset covers major technical SEO areas: AI search, Core Web Vitals, structured data, security headers, images, internal links, and mobile. Missing sitemap analysis and content/keyword features, but these are minor gaps for a focused technical audit tool.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      Lets any AI agent audit any website for SEO, GEO/AEO, and speed problems, reporting issues and recommendations without modifying the site.
      4
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI agents to perform instant SEO audits, check robots.txt, sitemaps, and AI crawler access for any URL without API keys.
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI assistants to run evidence-first technical SEO and GEO audits, inspect HTML, structured data, robots policies and sitemaps, and compare before/after reports to verify fixes.
      5
      1
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI assistants such as Claude, ChatGPT, Cursor, and Claude Code to run 25+ specialized SEO checks on any URL, generate XML sitemaps and robots.txt files, extract brand design elements, and audit technical SEO, content quality, mobile responsiveness, and security.
      MIT