invisible-playwright-mcp

A stealth Firefox browser, exposed as an MCP server, so any AI agent can browse and act on real websites without being blocked by anti-bot systems.

It wraps invisible-playwright (a real Firefox patched at the C++ source for stealth) and hands your MCP client the usual browser tools: navigate, click, type, read, screenshot. The browser is always launched by the stealth engine, so the fingerprint is set inside the engine, not bolted on.

Install (Claude Code)

One line:

claude mcp add stealth --env STEALTHFOX_PROXY=http://user:pass@host:port -- uvx invisible-playwright-mcp

Or add it to any MCP client via a config block (Claude Code, Cursor, Claude Desktop):

{
  "mcpServers": {
    "stealth": {
      "command": "uvx",
      "args": ["invisible-playwright-mcp"],
      "env": { "STEALTHFOX_PROXY": "http://user:pass@host:port" }
    }
  }
}

uvx downloads and runs it in one step; no manual install. The stealth Firefox engine is fetched automatically on first use.

Configuration (environment variables)

Variable	Meaning
`STEALTHFOX_PROXY`	Your proxy URL (`http://…`, `https://…` or `socks5://…`). Bring your own. With it set, the session's timezone, locale and egress are derived from the proxy automatically.
`STEALTHFOX_SEED`	Integer seed for a deterministic fingerprint (same seed, same identity).
`STEALTHFOX_PROFILE_DIR`	A directory for a persistent profile, so logins survive across runs.
`STEALTHFOX_BINARY`	Path to a specific engine binary (otherwise fetched automatically).
`STEALTHFOX_HEADLESS`	`0` to run headed; headless by default.
`STEALTHFOX_CAPTURE_DIR`	Record every page continuously as JPEG frames into this directory, with a `frames.jsonl` beside them carrying the url and timestamp of each. Defaults to `mcp_captures/` under the working directory.
`STEALTHFOX_CAPTURE_INTERVAL_MS`	Milliseconds between frames (default `200`, floor `100`).
`STEALTHFOX_CAPTURE_QUALITY`	JPEG quality 1-100 (default `55`).

Tools

session_new_page, session_list_pages, session_select_page, session_close_page, browser_navigate, browser_read_text, browser_snapshot, browser_click, browser_click_at, browser_type, browser_press_key, browser_evaluate, browser_wait_for, browser_take_screenshot.

browser_click_at takes viewport coordinates instead of a selector, moves the pointer there rather than teleporting, optionally holds before releasing, and returns a screenshot of what happened - for a slider, a canvas-drawn challenge, or a press-and-hold.

browser_snapshot returns the title, the url and the visible interactive elements rather than the accessibility tree: one country <select> on a real sign-up page contributes about two hundred <option> nodes, which fill the character budget before the form does.

Tool names mirror the Microsoft Playwright MCP, so prompts written for it work here too.

Notes

Bring your own proxy. The engine does the stealth; a residential proxy gives you the matching IP and geography. Without one it still runs, but the exit is your own address.
This is a browser, not a captcha solver. It does not solve or bypass challenges for you; it makes an ordinary Firefox session look like a real one.

License

See the engine project, invisible-playwright.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

invisible_playwright_mcp-0.2.0.tar.gz (15.6 kB view details)

Uploaded Aug 31, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

invisible_playwright_mcp-0.2.0-py3-none-any.whl (12.6 kB view details)

Uploaded Aug 31, 2026 Python 3

File details

Details for the file invisible_playwright_mcp-0.2.0.tar.gz.

File metadata

Download URL: invisible_playwright_mcp-0.2.0.tar.gz
Upload date: Aug 31, 2026
Size: 15.6 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for invisible_playwright_mcp-0.2.0.tar.gz
Algorithm	Hash digest
SHA256	`06c25b8f7cb9bce873dca05ceb4fe9b48c372cae45c3f6da41a24ef3fbf18b70`
MD5	`34917cc33b64ef4d027ddd9e1c37f23f`
BLAKE2b-256	`846b261dad1acfe6ece1474299a5d67a3c299a59e8ebd94cb7842a4e533639f5`

See more details on using hashes here.

Provenance

The following attestation bundles were made for invisible_playwright_mcp-0.2.0.tar.gz:

Publisher: publish.yml on feder-cr/invisible-playwright-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: invisible_playwright_mcp-0.2.0.tar.gz
- Subject digest: 06c25b8f7cb9bce873dca05ceb4fe9b48c372cae45c3f6da41a24ef3fbf18b70
- Sigstore transparency entry: 2663884050
- Sigstore integration time: Aug 31, 2026
Source repository:
- Permalink: feder-cr/invisible-playwright-mcp@0faa5811e6cbdc44fcd53e25813f5902f55a9e01
- Branch / Tag: refs/tags/v0.2.0
- Owner: https://github.com/feder-cr
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@0faa5811e6cbdc44fcd53e25813f5902f55a9e01
- Trigger Event: push