mcp

<div align="center">
  <img src="https://www.robot-speed.com/logo.png" alt="Robot Speed" width="120" />
  <h1>Robot Speed MCP Server</h1>
  <p><strong>Audit any website's SEO. Generate client reports. Manage content at scale.<br/>From any AI assistant — no dashboard needed.</strong></p>

  <p>
    <a href="https://github.com/robot-speed/mcp/stargazers"><img src="https://img.shields.io/github/stars/robot-speed/mcp?style=flat&color=22c55e" alt="Stars" /></a>
    <a href="#available-tools-27"><img src="https://img.shields.io/badge/tools-27-blue" alt="27 Tools" /></a>
    <a href="#free-seo-tools-no-account-needed"><img src="https://img.shields.io/badge/free_tools-12-orange" alt="12 Free Tools" /></a>
    <a href="#works-with"><img src="https://img.shields.io/badge/works_with-Claude_%7C_Cursor_%7C_Windsurf_%7C_VS_Code_%7C_ChatGPT-8A2BE2" alt="Cross-platform" /></a>
    <a href="https://discord.gg/X3qTR66sm2"><img src="https://img.shields.io/discord/1234567890?label=Discord&color=5865F2" alt="Discord" /></a>
    <a href="#license"><img src="https://img.shields.io/badge/license-Proprietary-lightgrey" alt="License" /></a>
  </p>

  <p>
    <a href="https://www.robot-speed.com">Website</a> &bull;
    <a href="https://www.robot-speed.com/dashboard">Dashboard</a> &bull;
    <a href="https://discord.gg/X3qTR66sm2">Discord</a> &bull;
    <a href="#quick-start-30-seconds">Quick Start</a>
  </p>

  <sub>Langue / Language: <strong>English</strong> &bull; <a href="#french">Fran&ccedil;ais</a></sub>

  <br/><br/>
</div>

---

**12 free SEO tools. No account needed. Just add the URL to your AI assistant.**
**27 pro tools for content management, GSC traffic, and white-label reports.**

> **What's MCP?** Model Context Protocol lets your AI assistant (Claude, Cursor, Copilot) use external tools. Add one URL to your config, and your AI can audit websites, generate keywords, and manage SEO — all through conversation.

```
You:    "Audit the SEO of https://example.com"
Claude: Running seo_audit... 8 categories analyzed.

        Score: 72/100
        Top issues:
        - Missing FAQ schema (GEO/AEO impact)
        - 3 images without alt text
        - Meta description too short (89 chars, target 150-160)
        - No hreflang tags detected

        Top strengths:
        - HTTPS ✓, valid sitemap, clean robots.txt
        - H1 matches target keyword
        - Page loads in 1.2s (LCP < 2.5s)

You:    "Now generate the full monthly report and send me the link"
Claude: Done. Here's your shareable report:
        https://www.robot-speed.com/report/a8f2k...
        Branded "Acme Corp". Expires in 30 days. No login needed.
```

---

## Table of Contents

- [Quick Start (30 seconds)](#quick-start-30-seconds)
- [Works With](#works-with)
- [Free SEO Tools (No Account Needed)](#free-seo-tools-no-account-needed)
- [Pro Tools (27)](#available-tools-27)
- [Workflows](#workflows)
- [Example Conversations](#example-conversations)
- [White-Label Reports](#white-label-reports)
- [Authentication](#authentication)
- [FAQ](#faq)
- [What's New](#whats-new)

---

## Quick Start (30 seconds)

Add this to your Claude Desktop config — **no account needed** for free tools:

```json
{
  "mcpServers": {
    "robot-speed": {
      "url": "https://www.robot-speed.com/api/mcp"
    }
  }
}
```

That's it. 12 free SEO tools are immediately available. Say *"audit the SEO of https://mysite.com"* and get a full report.

**Want pro features?** (content management, GSC traffic, AI bot tracking, client reports) Create an account at [robot-speed.com](https://www.robot-speed.com) and add your API key:

### Option B: API Key (for pro tools)

```json
{
  "mcpServers": {
    "robot-speed": {
      "url": "https://www.robot-speed.com/api/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}
```

Get your key: [Dashboard > Settings > API Keys](https://www.robot-speed.com/dashboard)

---

## Works With

Add the config above to your AI tool of choice:

| Platform | Config file | Auth |
|----------|-------------|------|
| **Claude Desktop** | `claude_desktop_config.json` | OAuth or API Key |
| **Claude Code** | `claude_desktop_config.json` | OAuth or API Key |
| **Cursor** | Settings > MCP Servers > Add | API Key |
| **Windsurf** | MCP config (`serverUrl` field) | API Key |
| **VS Code (Copilot)** | `.vscode/mcp.json` | API Key |
| **ChatGPT** | MCP bridge/plugin | API Key |

<details>
<summary><strong>Platform-specific configs</strong></summary>

#### Cursor

Settings > MCP Servers > Add:
- **Name:** `robot-speed`
- **Type:** `sse`
- **URL:** `https://www.robot-speed.com/api/mcp`
- **Headers:** `X-API-Key: YOUR_API_KEY`

#### Windsurf

```json
{
  "mcpServers": {
    "robot-speed": {
      "serverUrl": "https://www.robot-speed.com/api/mcp",
      "headers": { "X-API-Key": "YOUR_API_KEY" }
    }
  }
}
```

#### VS Code (GitHub Copilot)

`.vscode/mcp.json`:
```json
{
  "servers": {
    "robot-speed": {
      "url": "https://www.robot-speed.com/api/mcp",
      "headers": { "X-API-Key": "YOUR_API_KEY" }
    }
  }
}
```

</details>

---

## Free SEO Tools (No Account Needed)

These tools work on any URL without signing up. No account needed. Try them now via MCP or on the web at [robot-speed.com/free-tools](https://www.robot-speed.com/free-tools).

Robot Speed powers **90+ free SEO tools**. The best ones are available via MCP:

| Tool | What it does | Status |
|------|-------------|--------|
| `seo_plan` | **Start here** — Full audit + prioritized action plan with effort/impact estimates | ✅ Live |
| `seo_audit` | Full 8-category audit: Foundation, Crawl & Index, Content SEO, Metadata, Performance, Media & UX, Architecture, GEO/AEO | ✅ Live |
| `seo_score` | SEO score (0-100) for any URL | ✅ Live |
| `meta_tag_analyzer` | Title, description, OG tags, Twitter cards analysis | ✅ Live |
| `page_speed_check` | Performance audit: blocking scripts, page weight, Core Web Vitals | ✅ Live |
| `broken_link_check` | Find broken links on any page | ✅ Live |
| `ai_visibility_score` | How well AI bots can crawl your site (ChatGPT, Perplexity, Claude) | ✅ Live |
| `readability_check` | Readability score and content quality analysis | ✅ Live |
| `schema_validator` | JSON-LD and schema markup validation | ✅ Live |
| `keyword_generator` | Keyword suggestions for any topic | ✅ Live |
| `noindex_checker` | Verify a page is indexable (no noindex tag) | ✅ Live |

**Why free?** Because great SEO starts with knowing what's broken. Audit first, then let Robot Speed fix it.

---

## Available Tools (27)

These require a Robot Speed account and a connected site.

### Discovery

| Tool | Description |
|------|-------------|
| `discover` | Tool index and recommended workflows — **call this first** |
| `list_sites` | List all sites accessible with your API key |

### Content Management

| Tool | Description |
|------|-------------|
| `list_articles` | Articles with title, status, SEO score, word count |
| `get_article` | Full article with HTML content and quality metrics |
| `search_articles` | Search by keyword in title or target keyword |
| `list_content_calendar` | Editorial pipeline: ideas → planned → in progress → completed |
| `list_content_ideas` | Idea backlog with cluster, intent, search volume, difficulty |
| `get_topical_clusters` | Cluster/pillar content view with coverage analysis |

### Reporting & Analytics

| Tool | Description |
|------|-------------|
| `get_performance_report` | Monthly report: articles published, SEO scores, GSC traffic |
| `get_traffic_report` | Google Search Console: clicks, impressions, CTR, avg position |
| `get_ai_visibility_report` | AI bot crawls — which AI agents visit your content |

### Site Health

| Tool | Description |
|------|-------------|
| `get_site_stats` | Article counts, avg SEO score, avg word count |
| `get_site_audit` | Health snapshot: GSC, CMS, last publish, freshness |
| `get_credits` | Remaining content credits and plan tier |

### Backlinks

| Tool | Description |
|------|-------------|
| `list_backlinks` | Backlink exchanges: anchor text, status, verification |
| `get_backlink_stats` | Aggregate stats: total, by status, inbound vs outbound |
| `list_outreach_prospects` | Outreach pipeline with DR and contact info (beta) |

### Keywords

| Tool | Description |
|------|-------------|
| `list_keywords` | Tracked keyword opportunities with volume and difficulty |
| `get_keyword_gaps` | Content ideas with no matching article — gaps to fill |

### Content Refresh

| Tool | Description |
|------|-------------|
| `list_refresh_candidates` | Articles needing update, sorted by priority score |

### Settings

| Tool | Description |
|------|-------------|
| `get_settings` | Auto-publish, content mode, language, connected platforms |
| `update_settings` | Change auto-publish or content quality mode |

### Actions

| Tool | Description |
|------|-------------|
| `approve_article` | Move draft → approved, or approved → published |
| `publish_to_cms` | Push to WordPress, Shopify, Kleap, Prestashop, Wix |
| `regenerate_article` | Re-generate with fresh content (1st free, then 1 credit) |
| `get_article_history` | View generation pipeline: 26+ steps, durations, status |

### Sharing

| Tool | Description |
|------|-------------|
| `generate_shareable_report` | Public report URL for your client — white-label, no login needed |

---

## Workflows

### Monthly Client Report

> *"Generate the monthly report for example.com and send me the link."*

```
You:    Generate a monthly report for my client Acme Corp.

Claude: Running site audit... ✓
        Fetching performance data (30 days)... ✓
        Pulling GSC traffic... ✓
        Generating shareable report...

        Here's your report:
        https://www.robot-speed.com/report/a8f2k3...

        Branded "Acme Corp" — no Robot Speed logo.
        Valid 30 days. No login required for Acme Corp to view it.

        Summary:
        - 12 articles published this month
        - Avg SEO score: 87/