<div align="center">

<img src="media/UndetectedStealthBrowser.png" alt="Reaper MCP" width="200"/>

💀 Reaper MCP

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

</div>

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

<div align="center">

Core Features	Statistics	Community

</div>

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

Feature	Reaper MCP	Playwright MCP
Cloudflare/Queue-It	✅ Consistently works	❌ Commonly blocked
Banking/Gov portals	✅ Works	❌ Frequently blocked
Social sites	✅ Full automation	❌ Captchas/bans
UI cloning	✅ CDP-accurate	⚠️ Limited
Network debugging	✅AI agent sees all requests/responses	⚠️ Basic
API reverse engineering	✅Full payload inspection via chat	❌ Manual tools only
Dynamic Hook System	✅AI writes Python functions for real-time processing	❌ Not available
Modular Architecture	✅11 sections, 22-90 tools	⚠️ Fixed ~20 tools
Tooling	✅ 90 (customizable)	⚠️ ~20

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

---

💀 Toolbox

<details> <summary><strong>Browser Management (11 tools)</strong></summary>

Tool	Description
mcp_Reaper_MCP_spawn_browser()	Create undetectable browser instance
mcp_Reaper_MCP_navigate()	Navigate to URLs
mcp_Reaper_MCP_close_instance()	Clean shutdown of browser
mcp_Reaper_MCP_list_instances()	Manage multiple sessions
mcp_Reaper_MCP_get_instance_state()	Full browser state information
mcp_Reaper_MCP_go_back()	Navigate back in history
mcp_Reaper_MCP_go_forward()	Navigate forward in history
mcp_Reaper_MCP_reload_page()	Reload current page
mcp_Reaper_MCP_hot_reload()	Reload modules without restart
mcp_Reaper_MCP_reload_status()	Check module reload status
mcp_Reaper_MCP_validate_browser_environment_tool()	Diagnose platform issues

</details>

<details> <summary><strong>Element Interaction (11 tools)</strong></summary>

Tool	Description
mcp_Reaper_MCP_query_elements()	Find elements by CSS/XPath
mcp_Reaper_MCP_click_element()	Natural clicking
mcp_Reaper_MCP_type_text()	Human-like typing with newline support
mcp_Reaper_MCP_paste_text()	Instant text pasting via CDP
mcp_Reaper_MCP_scroll_page()	Natural scrolling
mcp_Reaper_MCP_wait_for_element()	Smart waiting
mcp_Reaper_MCP_execute_script()	Run JavaScript
mcp_Reaper_MCP_select_option()	Dropdown selection
mcp_Reaper_MCP_get_element_state()	Element properties
mcp_Reaper_MCP_take_screenshot()	Capture screenshots
mcp_Reaper_MCP_get_page_content()	HTML and metadata

</details>

<details> <summary><strong>Element Extraction - CDP Accurate (9 tools)</strong></summary>

Tool	Description
mcp_Reaper_MCP_extract_complete_element_cdp()	Complete CDP-based element clone
mcp_Reaper_MCP_clone_element_complete()	Complete element cloning
mcp_Reaper_MCP_extract_complete_element_to_file()	Save complete extraction to file
mcp_Reaper_MCP_extract_element_styles()	300+ CSS properties via CDP
mcp_Reaper_MCP_extract_element_styles_cdp()	Pure CDP styles extraction
mcp_Reaper_MCP_extract_element_structure()	Full DOM tree
mcp_Reaper_MCP_extract_element_events()	React/Vue/framework listeners
mcp_Reaper_MCP_extract_element_animations()	CSS animations/transitions
mcp_Reaper_MCP_extract_element_assets()	Images, fonts, videos
mcp_Reaper_MCP_extract_related_files()	Related CSS/JS files

</details>

<details> <summary><strong>File-Based Extraction (9 tools)</strong></summary>

Tool	Description
mcp_Reaper_MCP_extract_element_styles_to_file()	Save styles to file
mcp_Reaper_MCP_extract_element_structure_to_file()	Save structure to file
mcp_Reaper_MCP_extract_element_events_to_file()	Save events to file
mcp_Reaper_MCP_extract_element_animations_to_file()	Save animations to file
mcp_Reaper_MCP_extract_element_assets_to_file()	Save assets to file
mcp_Reaper_MCP_clone_element_to_file()	Save complete clone to file
mcp_Reaper_MCP_list_clone_files()	List saved clone files
mcp_Reaper_MCP_cleanup_clone_files()	Clean up old clone files

</details>

<details> <summary><strong>Network Debugging & Interception (15 tools)</strong></summary>

🕵️ 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

Tool	Description
mcp_Reaper_MCP_list_network_requests()	Ask AI: "What API calls happened?"
mcp_Reaper_MCP_get_request_details()	Ask AI: "Show me the headers and payload"
mcp_Reaper_MCP_get_response_details()	Ask AI: "What did the server return?"
mcp_Reaper_MCP_get_response_content()	Ask AI: "Show me the response body"
mcp_Reaper_MCP_modify_headers()	Ask AI: "Add custom headers"

Dynamic Network Hook System

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

Tool	Description
mcp_Reaper_MCP_create_dynamic_hook()	Create hook with custom Python code
mcp_Reaper_MCP_create_simple_dynamic_hook()	Quick hook creation with templates
mcp_Reaper_MCP_list_dynamic_hooks()	Show all active hooks with stats
mcp_Reaper_MCP_get_dynamic_hook_details()	View hook Python code
mcp_Reaper_MCP_remove_dynamic_hook()	Remove active hook

AI Hook Learning System

Tool	Description
mcp_Reaper_MCP_get_hook_documentation()	AI learns request structure
mcp_Reaper_MCP_get_hook_examples()	10 detailed hook examples
mcp_Reaper_MCP_get_hook_requirements_documentation()	Pattern matching guide
mcp_Reaper_MCP_get_hook_common_patterns()	Common hook patterns
mcp_Reaper_MCP_validate_hook_function()	Validate hook code

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

</details>

<details> <summary><strong>CDP Function Execution (13 tools)</strong></summary>

Tool	Description
mcp_Reaper_MCP_execute_cdp_command()	Direct CDP commands (use snake_case)
mcp_Reaper_MCP_discover_global_functions()	Find JavaScript functions
mcp_Reaper_MCP_discover_object_methods()	Discover object methods (93+ methods)
mcp_Reaper_MCP_call_javascript_function()	Execute any function
mcp_Reaper_MCP_inject_and_execute_script()	Run custom JS code
mcp_Reaper_MCP_inspect_function_signature()	Inspect function details
mcp_Reaper_MCP_create_persistent_function()	Functions that survive reloads
mcp_Reaper_MCP_execute_function_sequence()	Execute function sequences
mcp_Reaper_MCP_create_python_binding()	Create Python-JS bindings
mcp_Reaper_MCP_execute_python_in_browser()	Execute Python code via py2js
mcp_Reaper_MCP_get_execution_contexts()	Get JS execution contexts
mcp_Reaper_MCP_list_cdp_commands()	List available CDP commands
mcp_Reaper_MCP_get_function_executor_info()	Get executor state info

</details>

<details> <summary><strong>Progressive Element Cloning (10 tools)</strong></summary>

Tool	Description
mcp_Reaper_MCP_clone_element_progressive()	Initial lightweight structure
mcp_Reaper_MCP_expand_styles()	On-demand styles expansion
mcp_Reaper_MCP_expand_events()	On-demand events expansion
mcp_Reaper_MCP_expand_children()	Progressive children expansion
mcp_Reaper_MCP_expand_css_rules()	Expand CSS rules data
mcp_Reaper_MCP_expand_pseudo_elements()	Expand pseudo-elements
mcp_Reaper_MCP_expand_animations()	Expand animations data
mcp_Reaper_MCP_list_stored_elements()	List stored elements
mcp_Reaper_MCP_clear_stored_element()	Clear specific element
mcp_Reaper_MCP_clear_all_elements()	Clear all stored elements

</details>

<details> <summary><strong>Cookie & Storage (3 tools)</strong></summary>

Tool	Description
mcp_Reaper_MCP_get_cookies()	Read cookies
mcp_Reaper_MCP_set_cookie()	Set cookies
mcp_Reaper_MCP_clear_cookies()	Clear cookies

</details>

<details> <summary><strong>Tab Management (5 tools)</strong></summary>

Tool	Description
mcp_Reaper_MCP_list_tabs()	List open tabs
mcp_Reaper_MCP_new_tab()	Create new tab
mcp_Reaper_MCP_switch_tab()	Change active tab
mcp_Reaper_MCP_close_tab()	Close tab
mcp_Reaper_MCP_get_active_tab()	Get current tab

</details>

<details> <summary><strong>Debugging & Diagnostics (6 tools)</strong></summary>

Tool	Description
mcp_Reaper_MCP_get_debug_view()	Debug info with pagination
mcp_Reaper_MCP_clear_debug_view()	Clear debug logs
mcp_Reaper_MCP_export_debug_logs()	Export logs (JSON/pickle/gzip)
mcp_Reaper_MCP_get_debug_lock_status()	Debug lock status

</details>

---

Quickstart (60 seconds)

<div align="center">

</div>

✅ 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

Mode	Tools	Use Case
Full	90 tools	Complete browser automation & debugging
Minimal (--minimal)	22 tools	Core browser automation only
Custom	Your choice	Disable specific sections you don't need

📦 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 💀