MCP Servers

Reaper MCP

Provides AI-powered undetectable browser automation for data harvesting, bypassing protections like Cloudflare, and intercepting network traffic, with 90 tools for element interaction, extraction, and network debugging.

README

💀 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

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.

🆚 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>

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

Recommended Servers

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official

Featured

TypeScript

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official

Featured

Local

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official

Featured

TypeScript

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official

Featured

Python

E2B

Using MCP to run code via e2b.

Official

Featured

Neon Database

MCP server for interacting with Neon Management API and databases

Official

Featured

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official

Featured

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official

Featured

Reaper MCP

README

💀 Reaper MCP

🔗 Quick Links

🆚 Reaper vs Playwright MCP

💀 Toolbox

Basic Network Monitoring

Dynamic Network Hook System

AI Hook Learning System

Quickstart (60 seconds)

✅ Recommended Setup (Tested Method)

Alternative: Manual Configuration (If Claude CLI not available)

🎛️ Customize Your Installation

Quick Test

🚨 Having Installation Issues?

✨ Why developers choose Reaper

🎯 Advanced Text Input

⚡ Instant Text Pasting

📝 Smart Newline Handling

🔧 Why This Matters

🛡️ Cross-Platform Compatibility & Root Support

⚙️ Smart Environment Detection

🔧 Flexible Args Handling

📊 Built-in Diagnostics

🎯 Why This Matters

🎛️ Modular Architecture

⚙️ Installation Modes

📦 Tool Sections

🧪 Real-world examples

🌐 Community & Support

🛒 Reaper Marketplace

📢 Telegram Updates Channel

💬 Telegram Community Chat

📚 Additional Resources

Recommended Servers