Stealth Browser MCP

🚀 The ONLY browser automation that bypasses Cloudflare, antibots, and social media blocks

Supercharge any MCP-compatible AI agent with undetectable, real-browser automation. No CAPTCHAs. No blocks. Just results.

⚡ 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
🏆 Hall of Fame - Impossible automations made possible
🥊 Stealth vs Others - Why we dominate the competition
🔥 Viral Examples - Copy & paste prompts that blow minds
🧰 105 Tools - Complete arsenal of browser automation
🎥 Live Demos - See it bypass what others can't
🤝 Contributing & 💬 Discord

Quickstart (60 seconds)

Option 1: FastMCP CLI (Recommended)

# Install FastMCP CLI
pip install fastmcp

# Clone and setup
git clone https://github.com/vibheksoni/stealth-browser-mcp.git
cd stealth-browser-mcp

# Auto-install with dependencies into Claude Desktop/Code/Cursor
fastmcp install claude-desktop src/server.py --with-requirements requirements.txt
# OR
fastmcp install claude-code src/server.py --with-requirements requirements.txt
# OR
fastmcp install cursor src/server.py --with-requirements requirements.txt

Option 2: Manual Installation

git clone https://github.com/vibheksoni/stealth-browser-mcp.git
cd stealth-browser-mcp
python -m venv venv

# Windows
venv\Scripts\activate
pip install -r requirements.txt

# Mac/Linux
source venv/bin/activate
pip install -r requirements.txt

Add to your MCP client configuration:

Windows

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

Mac/Linux

{
  "mcpServers": {
    "stealth-browser": {
      "command": "/path/to/venv/bin/python",
      "args": ["/path/to/src/server.py"],
      "env": {}
    }
  }
}

Quick Test

Restart your MCP client and ask your agent:

"Use stealth-browser to navigate to https://example.com and extract the pricing table."

✨ Why developers star this

Works on protected sites that block 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
Clean MCP integration — no custom brokers or wrappers needed
105 focused tools designed for real-world workflows

Built on nodriver + Chrome DevTools Protocol + FastMCP

🆚 Stealth vs Playwright MCP

Feature	Stealth Browser 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 request processing	Not available
Tooling	105	~20

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

Toolbox

Tool	Description
`spawn_browser()`	Create undetectable browser instance
`navigate()`	Navigate to URLs
`close_instance()`	Clean shutdown of browser
`list_instances()`	Manage multiple sessions
`get_instance_state()`	Full browser state information
`go_back()`	Navigate back in history
`go_forward()`	Navigate forward in history
`reload_page()`	Reload current page
`hot_reload()`	Reload modules without restart
`reload_status()`	Check module reload status

Tool	Description
`query_elements()`	Find elements by CSS/XPath
`click_element()`	Natural clicking
`type_text()`	Human-like typing
`scroll_page()`	Natural scrolling
`wait_for_element()`	Smart waiting
`execute_script()`	Run JavaScript
`select_option()`	Dropdown selection
`get_element_state()`	Element properties

Tool	Description
`extract_complete_element_cdp()`	Complete CDP-based element clone
`clone_element_complete()`	Complete element cloning
`extract_complete_element_to_file()`	Save complete extraction to file
`extract_element_styles()`	300+ CSS properties via CDP
`extract_element_styles_cdp()`	Pure CDP styles extraction
`extract_element_structure()`	Full DOM tree
`extract_element_events()`	React/Vue/framework listeners
`extract_element_animations()`	CSS animations/transitions
`extract_element_assets()`	Images, fonts, videos
`extract_related_files()`	Related CSS/JS files

Tool	Description
`extract_element_styles_to_file()`	Save styles to file
`extract_element_structure_to_file()`	Save structure to file
`extract_element_events_to_file()`	Save events to file
`extract_element_animations_to_file()`	Save animations to file
`extract_element_assets_to_file()`	Save assets to file
`clone_element_to_file()`	Save complete clone to file
`list_clone_files()`	List saved clone files
`cleanup_clone_files()`	Clean up old clone files

🕵️ 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
`list_network_requests()`	Ask AI: "What API calls happened in the last 30 seconds?"
`get_request_details()`	Ask AI: "Show me the headers and payload for that login request"
`get_response_content()`	Ask AI: "What data did the server return from that API call?"
`modify_headers()`	Ask AI: "Add custom authentication headers to all requests"
`spawn_browser(block_resources=[...])`	Ask AI: "Block all tracking scripts and ads"

Dynamic Network Hook System (NEW!)

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

Tool	Description
`create_dynamic_hook()`	Ask AI: "Create a hook that blocks ads and logs API calls"
`create_simple_dynamic_hook()`	Ask AI: "Block all requests to .ads.com"*
`list_dynamic_hooks()`	Ask AI: "Show me all active hooks with statistics"
`get_dynamic_hook_details()`	Ask AI: "Show me the Python code for hook ID abc123"
`remove_dynamic_hook()`	Ask AI: "Remove the ad blocking hook"

AI Hook Learning System

Tool	Description
`get_hook_documentation()`	AI learns request object structure and HookAction types
`get_hook_examples()`	10 detailed examples: blockers, redirects, API proxies, custom responses
`get_hook_requirements_documentation()`	Pattern matching, conditions, best practices
`get_hook_common_patterns()`	Ad blocking, API proxying, auth injection patterns
`validate_hook_function()`	Validate hook Python code before deployment

💡 Example: "Create a hook that blocks social media trackers during work hours, redirects old API endpoints to new servers, and adds authentication headers to all API calls"

🔥 Hook Features:

Real-time processing (no pending state)
AI-generated Python functions with custom logic
Pattern matching with wildcards and conditions
Request/response stage processing with content modification
Full response body replacement and header injection
Automatic syntax validation and error handling
Base64 encoding for binary content support

Tool	Description
`execute_cdp_command()`	Direct CDP commands (use snake_case)
`discover_global_functions()`	Find JavaScript functions
`discover_object_methods()`	Discover object methods (93+ methods)
`call_javascript_function()`	Execute any function
`inject_and_execute_script()`	Run custom JS code
`inspect_function_signature()`	Inspect function details
`create_persistent_function()`	Functions that survive reloads
`execute_function_sequence()`	Execute function sequences
`create_python_binding()`	Create Python-JS bindings
`execute_python_in_browser()`	Execute Python code via py2js
`get_execution_contexts()`	Get JS execution contexts
`list_cdp_commands()`	List available CDP commands
`get_function_executor_info()`	Get executor state info

Tool	Description
`clone_element_progressive()`	Initial lightweight structure
`expand_styles()`	On-demand styles expansion
`expand_events()`	On-demand events expansion
`expand_children()`	Progressive children expansion
`expand_css_rules()`	Expand CSS rules data
`expand_pseudo_elements()`	Expand pseudo-elements
`expand_animations()`	Expand animations data
`list_stored_elements()`	List stored elements
`clear_stored_element()`	Clear specific element
`clear_all_elements()`	Clear all stored elements

Tool	Description
`get_cookies()`	Read cookies
`set_cookie()`	Set cookies
`clear_cookies()`	Clear cookies
`get_instance_state()`	localStorage & sessionStorage snapshot
`execute_script()`	Read/modify storage via JS

Tool	Description
`list_tabs()`	List open tabs
`new_tab()`	Create new tab
`switch_tab()`	Change active tab
`close_tab()`	Close tab
`get_active_tab()`	Get current tab

Tool	Description
`take_screenshot()`	Capture screenshots
`get_page_content()`	HTML and metadata
`get_debug_view()`	Debug info with pagination
`clear_debug_view()`	Clear debug logs
`export_debug_logs()`	Export logs (JSON/pickle/gzip)
`get_debug_lock_status()`	Debug lock status

🧪 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

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

🛣️ Roadmap

See the live plan in ROADMAP.md. Contributions welcome.

Contributing

We love first‑time contributions. Read CONTRIBUTING.md and open a PR.

If this project saves you time, consider starring the repo and sharing it with a friend.

💼 Need Website or App Development? Try DevHive Studios

DevHive Studios is a fair marketplace connecting businesses with skilled developers. Unlike other platforms, we put developers first while keeping costs affordable for clients.

🏆 Why DevHive?

For Developers: Keep 60% of what clients pay (+ bonuses for on-time delivery)
For Clients: Quality websites/apps starting at just $50
For Everyone: Transparent pricing, fast delivery, expert team

🛠️ Services Available

Web development • Mobile apps • Bots & automation • E-commerce • UI/UX design • Security • Custom software • And more

Ready to start your project? Hit up DevHive Studios today:

🌐 devhivestudios.com
💬 Contact on Discord

DevHive Studios — Fair marketplace. Quality results.

☕ Support This Project

If this browser automation MCP saved you time or made you money, consider supporting the development:

☕ Buy me a coffee: buymeacoffee.com/vibheksoni
₿ Bitcoin: 3QaS5hq2416Gd3386M6c9g5Dgc5RgvP3o2
Ł Litecoin: MM35KN1wUXREpwjj2RsmiKHM1ZWKDmeqDz
◎ Solana: 3LkBXDKLZXAgCRzAApa6dQG3ba7zRkUK82Bvmd9JWMdi

Every contribution helps maintain and improve this project! 🚀

📄 License

MIT — see LICENSE.

If you want your AI agent to access ANY website, star this repo. It helps more than you think.

⭐ Star History

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Enables AI agents to perform undetectable browser automation that bypasses Cloudflare, antibots, and social media blocks. Provides 105 tools for element extraction, network debugging, and real-world web scraping with a 98.7% success rate on protected sites.

Related MCP Servers

MCP Browser Use Server
JovaniPink
A
security
F
license
A
quality
Enables AI agents to interact with web browsers using natural language, featuring automated browsing, form filling, vision-based element detection, and structured JSON responses for systematic browser control.
Last updated -
1
50
Python
Deepseek R1 MCP Server
grapheneaffiliate
-
security
A
license
-
quality
Enables browser automation and real-time computer vision tasks through AI-driven commands, offering zero-cost digital navigation and interaction for enhanced web experiences.
Last updated -
0
1
JavaScript
MIT License
MCP Browser Use
janspoerer
-
security
A
license
-
quality
Empowers AI agents to perform web browsing, automation, and scraping tasks with minimal supervision using natural language instructions and Selenium.
Last updated -
4
Python
Apache 2.0
Browser Automation MCP Server
Raghu6798
-
security
F
license
-
quality
Enables intelligent web scraping through a browser automation tool that can search Google, navigate to webpages, and extract content from various websites including GitHub, Stack Overflow, and documentation sites.
Last updated -
1
Python

View all related MCP servers

Stealth Browser MCP