# RankCLI

> RankCLI is a freemium MCP server for marketing and seo. Free local SEO and AI-search audits from your coding agent; nothing leaves your machine. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, API, Web
- **Website:** https://rankcli.dev
- **Repository:** https://github.com/integrallis/rankcli/tree/HEAD/packages/mcp-server
- **MCP Registry name:** io.github.integrallis/rankcli-mcp-server
- **Categories:** marketing and SEO, developer tools
- **Listing updated:** 2026-11-14

## About

The package gives Claude Code, Cursor and other MCP hosts a toolbox of 15 SEO and GEO checks that run on HTML and robots.txt your host supplies, so nothing round-trips through RankCLI. GEO here means whether AI answers can cite your site: crawler access, robots rules for GPTBot, ClaudeBot and PerplexityBot, and llms.txt.

Checks include Core Web Vitals estimates, structured data validation, security header grading, image and internal-link analysis, mobile readiness, and generators for robots.txt, JSON-LD and security headers. A free hosted endpoint serves the same tools for clients like ChatGPT. rankcli_connect is the only tool that contacts RankCLI, linking an account for auto-fix pull requests and monitoring.

Paid plans add more sites, daily audits, alerts and unlimited fix PRs.

## Features

- **Local analysis:** Runs inside your MCP host.
- **GEO checks:** Tests AI crawler access and citation readiness.
- **Generators:** Creates robots.txt, JSON-LD and security header configs.
- **Web vitals estimate:** Estimates LCP, CLS, INP and TTFB from HTML.
- **Hosted option:** Free hosted endpoint for clients without local runs.
- **Optional account:** Links to GitHub auto-fix PRs and monitoring.

## Good for

- Audit a page before deploying
- Check whether AI crawlers are blocked
- Generate Schema.org markup for a page type
- Grade security headers

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "rankcli-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@rankcli/mcp-server"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `seo_analyze`: Full SEO analysis.
- `seo_geo_check`: AI search visibility check.
- `seo_robots_ai`: Which AI crawlers robots.txt allows.
- `seo_generate_robots`: Generate an AI-friendly robots.txt.
- `seo_core_web_vitals`: Estimate Core Web Vitals from HTML.
- `seo_structured_data`: Validate JSON-LD markup.
- `seo_generate_schema`: Generate a JSON-LD template.
- `seo_security_headers`: Grade security headers.
- `seo_generate_security_headers`: Generate security header config.
- `seo_images`: Check image alt, size and formats.
- `seo_internal_links`: Check anchor text and orphan pages.
- `seo_mobile`: Check mobile and PWA readiness.
- `seo_ai_crawlers`: List known AI crawler user agents.
- `rankcli_connect`: Link to a RankCLI account.
- `rankcli_disconnect`: Unlink from the account locally.

## FAQ

### Does it need signup?

No. The local server needs no account or key.

### What is the only tool that contacts RankCLI?

rankcli_connect, which is opt-in.

### How do I run it?

npx @rankcli/mcp-server, or use the hosted free endpoint.

### Does paid pricing exist?

Yes; the CLI, MCP server and GitHub Action are free, with paid plans for more sites and PRs.

### Is RankCLI free?

RankCLI has a free plan, with paid plans for more usage or features.

### How do I add RankCLI to Claude Code?

Run this command in your terminal: claude mcp add rankcli-mcp-server -- npx -y @rankcli/mcp-server

### What are the best alternatives to RankCLI?

The closest alternatives to RankCLI are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.

---
Source: https://ai-powered.com/mcp/rankcli
