PlugWiki
stealth-browser-mcp logo

Stealth Browser MCP Server: Setup for Claude, Cursor and Other Apps

CommunityLocal
GetPyPIbrowserstealthmcpvibheksoni/stealth-browser-mcpDocs

Lets your assistant drive a real Chrome built to avoid bot detection, read pages, watch network traffic and copy page elements.

This community server starts a real Chrome, Chromium or Edge window on your computer and gives the assistant more than a hundred controls for it. It is built to avoid bot-detection checks, so sites are less likely to flag it as automated.

It has no read-only mode. The assistant can click, type, run JavaScript, read cookies and change network traffic, so treat it like handing over a browser.

Good for

  • Developers debugging how a site loads and what its API returns
  • Researchers who need pages that block ordinary scrapers
  • Front-end developers who want to copy an element's HTML, CSS and events
  • Testers who need to intercept and change browser traffic

Works in

12 should work

Tap an app to see how to set it up and any known problems.

Install stealth-browser MCP

Claude Code

  1. 1

    Copy this prompt.

    Add the stealth-browser MCP server to Claude Code. Run this command:
    
    claude mcp add --transport stdio stealth-browser -- uvx browserstealthmcp
    
    Then check that it loaded and tell me if I need to sign in or restart.
  2. 2

    Paste it into Claude Code. It shows the change and asks before running it.

Requires Python 3.10 or newer, Chrome, Chromium or Edge.

Read-only mode: There is no read-only mode. Start with --minimal for 21 core tools, or switch off sections such as --disable-cdp-functions and --disable-dynamic-hooks.

Needs Python 3.10 or newer and Chrome, Chromium or Microsoft Edge on your computer. The PyPI package is called browserstealthmcp, because the name stealth-browser-mcp on PyPI belongs to a different project. The README also installs it with pipx and runs the stealth-browser-mcp command. Add --minimal to the arguments to load only 21 core tools, which keeps the assistant's tool list short.

Built from the package data we hold. Not yet tested by us.

Tools

  • Opens a stealth Chrome window

    Starts a new Chrome, Chromium or Edge window that is set up to look like a normal person's browser, and returns its ID.

    Try: “Open a stealth browser.”

    Write · spawn_browser

  • Lists your open browser windows

    Shows every browser session this server has started.

    Try: “Which browsers are open?”

    Read · list_instances

  • Closes a browser window

    Shuts a browser session down cleanly.

    Try: “Close the browser.”

    Write · close_instance

  • Shows the state of a browser

    Returns details about one browser session, such as its tabs and settings.

    Try: “What is the state of this browser?”

    Read · get_instance_state

  • Goes to a web address

    Loads a URL in the current tab.

    Try: “Open https://example.com.”

    Network · navigate

  • Goes back one page

    Moves the tab back in its history.

    Try: “Go back.”

    Network · go_back

  • Goes forward one page

    Moves the tab forward in its history.

    Try: “Go forward.”

    Network · go_forward

  • Reloads the page

    Refreshes the current page.

    Try: “Reload the page.”

    Network · reload_page

  • Finds elements on the page

    Looks up elements by CSS selector or XPath and returns what it finds.

    Try: “Find all the buttons on this page.”

    Network · query_elements

  • Clicks something on the page

    Clicks the element you point to, which can submit forms or trigger actions.

    Try: “Click the login button.”

    Write · click_element

  • Types text like a person

    Types into a field with human-like timing and supports new lines.

    Try: “Type my search term into the box.”

    Write · type_text

  • Pastes text instantly

    Puts text into a field at once instead of typing it.

    Try: “Paste this address into the field.”

    Write · paste_text

Read from the source code

Permissions

high risk · 4 things to watch

High risk

It can click, type, read cookies and storage, run JavaScript and change network traffic in a real browser. Use it only with accounts and sites you are comfortable letting the assistant control, and start with the minimal mode.

What it can do

  • Read your data
  • Create and change things
  • Delete things
  • Read-only mode

Watch out for

  • It can run code and change traffic in a live browser

    Tools run JavaScript, send raw browser protocol commands and install Python hooks that rewrite requests. Use the --minimal mode or switch off those sections. github.com

  • It can read cookies and saved sessions

    Cookie and storage tools return whatever the browser holds, such as login sessions. Do not sign in to sensitive accounts in the browser it controls. github.com

  • Can upload files from allowed folders

    The upload tool reads files from folders listed in BROWSER_FILE_UPLOAD_ALLOWED_DIRS, which default to the repo or data folder. Keep that list narrow. github.com

  • HTTP mode needs a token

    HTTP mode binds to 127.0.0.1 by default. The README says to set a token before exposing it beyond localhost. github.com

Security advisories

No published security advisories as of Nov 1, 2026.

Technical details
Talks toAny website you ask it to open
Sign-in and keysNo credentials of its own. Cookies and storage in the browser it starts can be read by the tools.
Scopes
  • Whatever the browser it starts can reach, including logged-in sessions you open

Questions

Is the Stealth Browser MCP server official?

No. It is a community project by vibheksoni and is not from Google, Chrome or any site it visits.

Why is the PyPI package called browserstealthmcp?

Because stealth-browser-mcp on PyPI belongs to a different, unrelated project. Installing that name gives the wrong program.

What do I need to run it?

Python 3.10 or newer, uv or pipx, and Chrome, Chromium or Edge.

Can I load fewer tools?

Yes. Add --minimal for 21 core tools, or switch off sections such as --disable-cdp-functions.

Can I make it read-only?

No. The README describes no read-only mode, and many tools click, type and change traffic.

Does it bypass Cloudflare and bot checks?

The README says it is built to handle such checks with a real browser. Results depend on the site, and you remain responsible for following each site's terms.

Does it run locally?

Yes. The browser runs on your computer. An HTTP mode also exists and listens on 127.0.0.1 by default.

Information

updated Nov 2, 2026

Publisher
Community
Package
browserstealthmcp
Registry
PyPI
Transport
stdio
Auth
None
Version
0.3.3
License
MIT
Last commit
Oct 26, 2026
Open issues
0

DocsGitHubPyPIChangelogIssues

Sources

Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.

Show all 3
  1. server.py · github.com
  2. README.md · github.com
  3. https://pypi.org/project/browserstealthmcp/ · pypi.org

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 2, 2026.