Skip to main content

MCP Integration

Integrate RapidRabbit as an MCP server for AI assistants like Claude. Configure automated website auditing workflows.

MCP Setup

Configure RapidRabbit as an MCP server for AI assistant integration. The MCP server is enabled by default and uses token-based authentication.

Starting the MCP Server

rapidrabbit --mcp

The server communicates via JSON-RPC 2.0 over stdin/stdout and supports 36 tools for website intelligence.

One-Click Setup with Claude Desktop

RapidRabbit includes a one-click configuration wizard for Claude Desktop:

  1. Open RapidRabbit and navigate to the MCP tab
  2. Click Check Config - this detects your Claude Desktop installation and automatically generates a secure authentication token if one does not already exist
  3. Click Add to Claude Desktop - this writes the RapidRabbit MCP server configuration directly into your Claude Desktop claude_desktop_config.json file, including the authentication token
  4. Restart Claude Desktop to pick up the new configuration

That is all that is needed. Claude can now use all 36 RapidRabbit tools for website analysis.

Authentication & Tokens

RapidRabbit requires token-based authentication for MCP connections by default. This prevents unauthorized access to your crawl data and local database.

How Tokens Work

  • Tokens are 64-character hex strings generated from 32 cryptographically random bytes
  • Each token has a name, creation date, expiration date, and active/default status
  • The default token is automatically included when writing the Claude Desktop configuration
  • Tokens are stored locally in the RapidRabbit SQLite database on your machine

Default Token

When you click Check Config and no default token exists, RapidRabbit automatically generates a token named "Default" with a 365-day expiration. This token is set as the default and is used for the RAPIDRABBIT_TOKEN environment variable in the Claude Desktop configuration.

Manual Token Management

You can create, regenerate, and manage tokens from the Authentication tab in the MCP panel:

  • Create Token - Generate a new token with a custom name and expiration (1-365 days, default 30)
  • Set Default - Choose which token is used for Claude Desktop configuration
  • Regenerate - Generate a new token value while preserving the token name and default status
  • Delete - Remove a token permanently

Disabling Authentication

If you prefer to run without authentication (not recommended), toggle off Require Authentication in the MCP Connection tab. The MCP server will accept connections without a token.

Available MCP Tools (36)

RapidRabbit exposes the following tools via MCP:

Session Management

  • create_session - Create a new crawl session for a website
  • get_sessions - Get all crawl sessions with pagination
  • get_session - Get details of a specific session
  • delete_session - Delete a crawl session and all associated data

Crawl Control

  • start_crawl - Start crawling a session (queues if another is running)
  • start_crawl_now - Start crawling immediately, pausing any running crawl
  • crawl_url - Create a session and immediately start crawling
  • pause_crawl - Pause a running crawl to resume later
  • resume_crawl - Resume a paused crawl from where it left off
  • stop_crawl - Stop a running crawl permanently
  • restart_crawl - Restart a crawl from the beginning
  • is_crawling - Check if a session is currently being crawled
  • get_crawl_queue - Get the current crawl queue status

Page & Content Retrieval

  • get_pages - Get pages from a session with pagination
  • get_page - Get full details of a specific page including markdown content
  • get_screenshot - Retrieve a page screenshot as a base64-encoded image
  • get_schema_data - Get Schema.org structured data from crawled pages

Detection & Analysis

  • detect_cms - Detect the CMS or framework used by a website
  • find_sitemaps - Find and parse sitemaps for a website
  • run_seo_analysis - Trigger SEO analysis for a completed session
  • get_seo_issues - Get SEO issues filtered by severity and category
  • get_seo_summary - Get SEO score (0-100) and issue summary
  • run_screenshots - Trigger screenshot capture for all pages

Site Structure

  • get_links - Get unique links with HTTP status codes
  • get_files - Get unique files found during crawl (deduplicated by hash)
  • get_components - Get UI components detected during crawl
  • get_forms - Get forms detected during crawl with field details

Occurrence Tracking

  • get_link_occurrences - Get pages where a specific link appears
  • get_file_occurrences - Get pages where a specific file appears
  • get_form_occurrences - Get pages where a specific form appears
  • get_component_occurrences - Get pages where a specific component appears

URL Import

  • parse_url_import - Preview URL list or CSV content before importing
  • create_session_from_urls - Create a session from a URL list
  • import_csv_urls - Parse CSV and create a session from a URL column
  • crawl_url_list - Create a session from URLs and start crawling immediately

Claude Desktop Configuration

If you prefer to configure Claude Desktop manually instead of using the one-click setup, add the following to your configuration file:

macOS

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

{
  "mcpServers": {
    "rapidrabbit": {
      "command": "/path/to/rapidrabbit",
      "args": ["--mcp"],
      "env": {
        "RAPIDRABBIT_TOKEN": "your-token-here"
      }
    }
  }
}

Windows

Edit %APPDATA%\Claude\claude_desktop_config.json with the same structure. Replace the command path with the full path to your RapidRabbit installation.

Linux

Edit ~/.config/Claude/claude_desktop_config.json with the same structure.

You can find your token value in the RapidRabbit app under MCP > Authentication, or copy the full configuration from MCP > Connection.

Custom Integrations

Any application that supports the Model Context Protocol can integrate with RapidRabbit.

Protocol

RapidRabbit uses JSON-RPC 2.0 over stdio. Start the server with rapidrabbit --mcp and communicate via stdin/stdout.

Example Request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "detect_cms",
    "arguments": {"url": "https://example.com"}
  },
  "id": 1
}

Environment Variables

The MCP server respects the following environment variables:

  • RAPIDRABBIT_TOKEN - Authentication token for securing the MCP connection. Required when authentication is enabled (default). The one-click setup handles this automatically.
  • RAPIDRABBIT_DB_PATH - Custom path for the SQLite database file. Defaults to the platform-specific application data directory.
  • RAPIDRABBIT_LOG_LEVEL - Set logging verbosity: debug, info, warn, or error.

Troubleshooting

  • Token expired: Regenerate the token from MCP > Authentication, then click "Add to Claude Desktop" again to update the configuration.
  • Connection refused: Verify that the RapidRabbit binary path in the config is correct and that no other process is using stdin/stdout.
  • Tools not appearing: Restart Claude Desktop after adding the configuration. Check Claude Desktop logs for MCP connection errors.
  • Permission denied: Ensure the RapidRabbit binary is executable (chmod +x on macOS/Linux).
Previous
Command Line Interface
Next
CMS Detection
MCP Integration - AI Assistant Setup | RapidRabbit