💀 Reaper MCP

🚀 The ULTIMATE browser automation - Harvest data, bypass protections, and automate the impossible

Unleash the power of Reaper MCP - an AI-powered browser automation system designed for maximum stealth and efficiency. No CAPTCHAs. No blocks. Pure automation dominance.

⚡ 30-second setup • 🛡️ Undetectable by design • 🏆 98.7% success rate on protected sites • 🕵️ Full network debugging via AI chat

Give your AI agent real browser superpowers: access Cloudflare sites, extract any UI, and intercept network traffic — from inside your chat.

🔗 Quick Links

• ▶️ Quickstart

• 🛒 Marketplace - Premium tools & services

• 📢 Updates Channel - Telegram notifications

• 💬 Community Chat - Telegram public group

• 🏆 Hall of Fame - Impossible automations made possible

• 🥊 Reaper vs Others - Why we dominate the competition

• 🔥 Viral Examples - Copy & paste prompts that blow minds

• 🧰 90 Tools - Complete arsenal of browser automation

• 🎥 Live Demos - See it bypass what others can't

🆚 Reaper vs Playwright MCP

Sites users care about: LinkedIn • Instagram • Twitter/X • Amazon • Banking • Government portals • Cloudflare APIs • Nike SNKRS • Ticketmaster • Supreme

💀 Toolbox

🕵️ Turn your AI agent into a network detective! No more Postman, no more browser dev tools — just ask your agent what APIs are being called.

Basic Network Monitoring

Dynamic Network Hook System

🎯 AI writes custom Python functions to intercept and modify requests/responses in real-time!

AI Hook Learning System

💡 Example: "Create a hook that blocks social media trackers, redirects API endpoints, and adds auth headers"

Quickstart (60 seconds)

✅ Recommended Setup (Tested Method)

# 1. Clone the repository
git clone https://github.com/DoomsdayxProductions/Reaper-MCP.git
cd Reaper-MCP

# 2. Create virtual environment
python -m venv venv

# 3. Activate virtual environment
# Windows:
venv\Scripts\activate
# Mac/Linux:
source venv/bin/activate

# 4. Install dependencies
pip install -r requirements.txt

# 5. Add to Claude Code using CLI

Windows (Full Installation):

claude mcp add-json reaper-mcp "{\"type\":\"stdio\",\"command\":\"C:\\path\\to\\reaper-browser-mcp\\venv\\Scripts\\python.exe\",\"args\":[\"C:\\path\\to\\reaper-browser-mcp\\src\\server.py\"]}"

Windows (Minimal - Core Tools Only):

claude mcp add-json reaper-mcp "{\"type\":\"stdio\",\"command\":\"C:\\path\\to\\reaper-browser-mcp\\venv\\Scripts\\python.exe\",\"args\":[\"C:\\path\\to\\reaper-browser-mcp\\src\\server.py\",\"--minimal\"]}"

Mac/Linux (Full Installation):

claude mcp add-json reaper-mcp '{
  "type": "stdio",
  "command": "/path/to/reaper-browser-mcp/venv/bin/python",
  "args": [
    "/path/to/reaper-browser-mcp/src/server.py"
  ]
}'

Mac/Linux (Custom - Disable Advanced Features):

claude mcp add-json reaper-mcp '{
  "type": "stdio",
  "command": "/path/to/reaper-browser-mcp/venv/bin/python",
  "args": [
    "/path/to/reaper-browser-mcp/src/server.py",
    "--disable-cdp-functions",
    "--disable-dynamic-hooks"
  ]
}'

💡 Replace /path/to/reaper-browser-mcp/ with your actual project path

Alternative: Manual Configuration (If Claude CLI not available)

If you don't have Claude Code CLI, manually add to your MCP client configuration:

Claude Desktop - Windows (%APPDATA%\Claude\claude_desktop_config.json)

{
  "mcpServers": {
    "reaper-mcp-full": {
      "command": "C:\\path\\to\\reaper-browser-mcp\\venv\\Scripts\\python.exe",
      "args": ["C:\\path\\to\\reaper-browser-mcp\\src\\server.py"],
      "env": {}
    },
    "reaper-mcp-minimal": {
      "command": "C:\\path\\to\\reaper-browser-mcp\\venv\\Scripts\\python.exe",
      "args": ["C:\\path\\to\\reaper-browser-mcp\\src\\server.py", "--minimal"],
      "env": {}
    }
  }
}

Claude Desktop - Mac/Linux (~/Library/Application Support/Claude/claude_desktop_config.json)

{
  "mcpServers": {
    "reaper-mcp-full": {
      "command": "/path/to/reaper-browser-mcp/venv/bin/python",
      "args": ["/path/to/reaper-browser-mcp/src/server.py"],
      "env": {}
    },
    "reaper-mcp-custom": {
      "command": "/path/to/reaper-browser-mcp/venv/bin/python",
      "args": [
        "/path/to/reaper-browser-mcp/src/server.py",
        "--disable-cdp-functions",
        "--disable-dynamic-hooks"
      ],
      "env": {}
    }
  }
}

Cursor IDE (C:\Users\YOUR_USER\.cursor\mcp.json or ~/.cursor/mcp.json)

{
  "mcpServers": {
    "Reaper MCP": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "fastmcp",
        "--with-requirements",
        "C:\\path\\to\\reaper-browser-mcp\\requirements.txt",
        "fastmcp",
        "run",
        "C:\\path\\to\\reaper-browser-mcp\\src\\server.py"
      ],
      "env": {},
      "transport": "stdio"
    }
  }
}

🎛️ Customize Your Installation

Reaper MCP supports modular tool loading! Disable sections you don't need:

# Minimal installation (only core browser + element interaction)
python src/server.py --minimal

# Custom installation - disable specific sections
python src/server.py --disable-cdp-functions --disable-dynamic-hooks

# List all 11 available tool sections
python src/server.py --list-sections

Available sections:

• browser-management (11 tools) - Core browser operations

• element-interaction (11 tools) - Page interaction and manipulation

• element-extraction (9 tools) - Element cloning and extraction

• file-extraction (9 tools) - File-based extraction tools

• network-debugging (5 tools) - Network monitoring and interception

• cdp-functions (13 tools) - Chrome DevTools Protocol execution

• progressive-cloning (10 tools) - Advanced element cloning

• cookies-storage (3 tools) - Cookie and storage management

• tabs (5 tools) - Tab management

• debugging (6 tools) - Debug and system tools (includes environment validator)

• dynamic-hooks (10 tools) - AI-powered network hooks

💡 Pro Tip: Use --minimal for lightweight deployments or --disable-* flags to exclude functionality you don't need!

Quick Test

Restart your MCP client and ask your agent:

"Use Reaper MCP to navigate to https://example.com and extract the pricing table."

🚨 Having Installation Issues?

Check out our comprehensive Installation Issues Guide for solutions to common problems:

• Package installation errors

• Module not found errors

• Browser/Chrome issues

• Root user/container issues

• Path and configuration errors

✨ Why developers choose Reaper

• 💀 Harvest protected data that blocks traditional automation

• 🎯 Pixel-accurate element cloning via Chrome DevTools Protocol

• 🕵️ Full network debugging through AI chat — see every request, response, header, and payload

• 🧠 Your AI agent becomes a network detective — no more guessing what APIs are being called

• 🎛️ Modular architecture — disable unused sections, run minimal installs

• ⚡ Lightweight deployments — from 22 core tools to full 90-tool arsenal

• 🔌 Clean MCP integration — no custom brokers or wrappers needed

• 🛠️ 90 focused tools organized into 11 logical sections

Built on nodriver + Chrome DevTools Protocol + FastMCP

🎯 Advanced Text Input

Revolutionary text input capabilities that solve common automation challenges:

⚡ Instant Text Pasting

# paste_text() - Lightning-fast text input via CDP
await mcp_Reaper_MCP_paste_text(instance_id, "textarea", large_markdown_content, clear_first=True)

• 10x faster than character-by-character typing

• Uses Chrome DevTools Protocol insert_text for maximum compatibility

• Perfect for large content (README files, code blocks, forms)

📝 Smart Newline Handling

# type_text() with newline parsing
await mcp_Reaper_MCP_type_text(instance_id, "textarea", "Line 1\nLine 2\nLine 3", parse_newlines=True, delay_ms=10)

• parse_newlines=True: Converts \n to actual Enter key presses

• Essential for multi-line forms, chat apps, and text editors

• Maintains human-like typing with customizable speed

🔧 Why This Matters

• Form Automation: Handle complex multi-line inputs correctly

• Content Management: Paste large documents instantly without timeouts

• Chat Applications: Send multi-line messages with proper line breaks

• Code Input: Paste code snippets with preserved formatting

• Markdown Editors: Handle content with proper line separations

Real-world impact: What used to take 30+ seconds of character-by-character typing now happens instantly, with proper newline handling for complex forms.

🛡️ Cross-Platform Compatibility & Root Support

Automatic platform detection and privilege handling that eliminates common browser spawning issues:

⚙️ Smart Environment Detection

# Automatic privilege detection and sandbox handling
mcp_Reaper_MCP_validate_browser_environment_tool()  # Diagnose your environment

• Root/Administrator Detection: Auto-adds --no-sandbox when running as root

• Container Detection: Detects Docker/Kubernetes and adds container-specific args

• Platform-Aware: Handles Windows, Linux, macOS differences automatically

• Chrome Discovery: Automatically finds Chrome/Chromium installation

🔧 Flexible Args Handling

// All these formats now work:
{"args": ["--disable-web-security"]}                    // JSON array
{"args": "[\"--disable-web-security\"]"}              // JSON string  
{"args": "--disable-web-security"}                     // Single string

• Multiple Format Support: Accepts JSON arrays, JSON strings, or single strings

• Smart Parsing: Tries JSON first, falls back gracefully

• Backward Compatible: Existing configurations continue to work

📊 Built-in Diagnostics

# Environment validation tool
mcp_Reaper_MCP_validate_browser_environment_tool()
# Returns: platform info, Chrome path, issues, warnings, recommendations

• Pre-flight Checks: Validates environment before browser launch

• Issue Detection: Identifies common problems and provides solutions

• Platform Insights: Detailed system information for debugging

🎯 Why This Matters

• Root User Support: No more "Failed to connect to browser" on Linux servers

• Container Compatibility: Works in Docker, Kubernetes, and serverless environments

• Windows Administrator: Handles UAC and privilege escalation scenarios

• Error Prevention: Catches issues before they cause failures

• Better Debugging: Clear diagnostics for troubleshooting

Real-world impact: Browser spawning now works reliably across all environments - from local development to production containers to CI/CD pipelines.

🎛️ Modular Architecture

Reaper MCP supports modular tool loading! Choose exactly what functionality you need:

⚙️ Installation Modes

📦 Tool Sections

# List all sections with tool counts
python src/server.py --list-sections

# Examples:
python src/server.py --minimal                    # Only browser + element interaction
python src/server.py --disable-cdp-functions      # Disable Chrome DevTools functions  
python src/server.py --disable-dynamic-hooks      # Disable AI network hooks
python src/server.py --disable-debugging          # Disable debug tools

Benefits:

• 🚀 Faster startup - Only load tools you need

• 💾 Smaller memory footprint - Reduce resource usage

• 🏗️ Cleaner interface - Less tool clutter in AI chat

• ⚙️ Environment-specific - Different configs for dev/prod

🧪 Real-world examples

• Market research: Extract pricing/features from 5 competitors and output a comparison

• UI/UX cloning: Recreate a pricing section with exact fonts, styles, and interactions

• Inventory monitoring: Watch a product page and alert when in stock

• Reverse engineering: Intercept requests, map endpoints, and understand data flow

• Credential testing: Systematically test login credentials across multiple accounts

• Data harvesting: Extract structured data from protected websites

You can drive all of the above from a single AI agent chat.

🌐 Community & Support

🛒 Reaper Marketplace

Your one-stop shop for premium Reaper MCP tools, scripts, and services:

• Premium Automation Scripts - Ready-to-use templates for common tasks

• Custom Development Services - Tailored browser automation solutions

• Advanced Tools & Plugins - Extend Reaper MCP's capabilities

• Expert Consultation - Get help from automation professionals

📢 Telegram Updates Channel

Stay informed about the latest developments:

• New feature announcements

• Critical updates and patches

• Performance improvements

• Security advisories

• Best practices and tips

💬 Telegram Community Chat

Join our active community:

• Get help from other users

• Share your automation success stories

• Discuss use cases and strategies

• Request features and improvements

• Network with automation professionals

📚 Additional Resources

• Complete Documentation - All 90 tools with examples

• Quick Reference Cheat Sheet - One-page command reference

• HiDrive Automation Guide - Complete login automation example

• Network Hooks Guide - Advanced network interception patterns

• Installation Issues Guide - Common problems and solutions

Reaper MCP - Harvest the web with AI-powered automation dominance 💀