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
Browser ManagementTool | 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.