Stealth Agent Browser logo

Stealth Agent Browser

Stealth Chromium MCP server with AOM snapshots, visual refs, browser actions, content extraction, proxies, and CAPTCHA fallback.

Install Stealth Agent Browser

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "stealth-agent-browser": {
      "command": "npx",
      "args": [
        "-y",
        "playwright-core"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

We couldn’t confirm it starts correctly

The install command installed and started the server, which then stopped for configuration (such as an API key) that our sandbox does not have — expected for servers that connect to your account.

npx -y playwright-core

Process exited before answering initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 1d ago.

Overview

Stealth Agent Browser MCP server gives MCP-compatible hosts control of a Chromium session through accessibility snapshots, screenshots, and ref-based actions. It combines Playwright AOM YAML with optional Set-of-Mark annotations, while Readability converts page content into Markdown during scrolling. Use it for authorized browser automation, accessibility checks, QA, or sites where ordinary Playwright automation is detected. Configuration covers headless mode, stealth level, proxies, profiles, viewport, locale, time zone, and CAPTCHA providers.

Use cases

  • Automate authorized Chromium browser workflows
  • Inspect pages with compact accessibility snapshots
  • Extract readable web content as Markdown
  • Test sites with visual element grounding
  • Run QA through configurable proxy sessions

Key features

  • AOM YAML snapshots with ref-based actions
  • Set-of-Mark hybrid screenshots
  • Readability Markdown extraction
  • Runtime proxy and proxy-pool configuration
  • CAPTCHA provider fallback
  • Stealth Chromium sessions

Tools13

What Stealth Agent Browser lets your agent do. Expand a tool for its parameters.

Self-reported~238 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

7/7 checks healthy over the last 44d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 6d ago via OSV.dev · playwright-core (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars1Stargazers on the source repository.
npm downloads490MPackage downloads in the last 30 days.
Last commit6mo agoMost recent push to the default branch.
Install checkRunsOur sandbox started it; it then asked for an API key or config.
Tools exposed13Callable tools this server registers over MCP.
Directory activity1 viewsConfig copies, upvotes, and views on AllMCPs.

How Stealth Agent Browser works

What Stealth Agent Browser does

The Stealth Agent Browser MCP server exposes a Chromium browser through MCP tools for navigation, inspection, interaction, reading, tab management, JavaScript evaluation, proxy changes, CAPTCHA handling, and session restart. It is intended for use from an MCP host whose model drives the browser rather than from a bundled agent loop.

Pages can be inspected as an Accessibility-Object-Model snapshot in YAML, as a screenshot, or as a hybrid response containing both. Interactive elements in the AOM output receive refs such as [ref=eN]; click, type, and select operations use those refs instead of requiring CSS selectors. The server also provides a Readability-based path for extracting page content as Markdown.

Use this server only for authorized work, such as testing sites you own or have permission to assess, accessibility auditing, and automation against your own accounts.

How it works

The Stealth Agent Browser MCP server launches Chromium with rebrowser-playwright. Its browser-facing requests originate from Chromium rather than from Node HTTP clients. The snapshot pipeline can return compact AOM YAML, an unmodified screenshot, or a screenshot with numbered red markers whose identifiers correspond to the YAML refs.

browser_scroll_read runs Mozilla Readability through JSDOM and can return only content that changed since the previous read. Open shadow roots are supported by the reader. Human-like mouse movement, fingerprint profiles, proxy routing, and CAPTCHA adapters are configurable parts of the browser session.

The MCP entry point uses stdio: standard output is reserved for JSON-RPC, while logs are written to stderr.

Setup and configuration

Install the package globally, run it through npx, and install Chromium with Playwright when needed:

  • npm install -g stealth-agent-browser-mcp
  • npx playwright-core install chromium
  • Or run npx stealth-agent-browser-mcp without a global installation.

Add the command to the MCP host configuration and restart that host. The documented example sets SAB_HEADLESS=true and SAB_STEALTH_LEVEL=patched. Headless mode, stealth level, proxy server and credentials, proxy pools and rotation, sticky-session usernames, human mouse behavior, CAPTCHA provider and key, persistent profile directory, action timeout, annotation limit, viewport, locale, time zone, and log level are configurable through environment variables. Proxy changes take effect after browser_restart.

Tools and capabilities

  • Navigate to a URL and receive a snapshot.
  • Request AOM YAML, a raw screenshot, or hybrid YAML plus Set-of-Mark output.
  • Click, type, or select using refs from the latest AOM snapshot.
  • Scroll through readable page content and receive Markdown, optionally delta-only.
  • Wait for text or a ref to become visible.
  • List, create, close, and switch browser tabs.
  • Evaluate a JavaScript expression in the page's main world and receive JSON.
  • Set a single proxy or replace a residential proxy pool at runtime.
  • Detect Turnstile, hCaptcha, and reCAPTCHA and use the configured CapSolver or 2Captcha fallback.
  • Restart the active browser session with current configuration.

Limitations and notes

Action refs come from the most recent AOM snapshot, so a changed page may require a new snapshot before interaction. Proxy configuration changes are not active until the browser is restarted. CAPTCHA solving requires a supported provider and API key; the default provider is none.

The project documents benchmarks against public bot-detection pages and local fixture tests, but those results do not guarantee behavior on every website. Its TLS discussion applies to traffic leaving through Chromium; a proxy that terminates and re-initiates TLS can change what the origin observes. The server does not include its own agent loop, and use remains subject to website terms and applicable law.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Stealth Agent Browser

Stealth Agent Browser is an MCP server that connects an MCP-compatible host to a Chromium browser session and exposes navigation, AOM or visual snapshots, ref-based clicking and typing, readable-content extraction, tab control, JavaScript evaluation, proxy management, CAPTCHA fallback, and browser restart tools.

Install it with npm or run it through npx. Use `npm install -g stealth-agent-browser-mcp`, install Chromium with `npx playwright-core install chromium`, or run `npx stealth-agent-browser-mcp` directly. Then add the command to your MCP host configuration and restart the host.

Yes, Cursor is named as a supported quickstart host. Add the server command and its environment settings to Cursor's MCP configuration, then restart Cursor so the browser tools become available.

It identifies interactive elements with refs such as `[ref=eN]` in AOM snapshots. Use those refs with `browser_click`, `browser_type`, and `browser_select`; request a new snapshot when the page changes.

Set the proxy environment variables or call `browser_set_proxy` or `browser_set_proxy_pool`, then run `browser_restart`. Single proxies, credentialed residential pools, rotation modes, and sticky-session username templates are supported.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewStealth Agent Browser AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/stealth-agent-browser?style=directory)](https://allmcps.com/mcp/stealth-agent-browser)
HTML Embed
<a href="https://allmcps.com/mcp/stealth-agent-browser"><img src="https://allmcps.com/api/badge/stealth-agent-browser?style=directory" alt="Stealth Agent Browser on AllMCPs" /></a>