About this project

invisible_playwright_mcp is a self-hosted Python MCP server that lets an AI assistant drive a real browser. It is built on an anti-detect stealth Firefox engine, so the agent can browse pages that would otherwise block automated clients. Two ways to use it: 1. Over MCP from an assistant. Install uv, then add the plugin to Claude Code, Codex or Gemini CLI via the documented marketplace/extension commands. The package itself is the MCP server when run without a subcommand. 2. Standalone web UI. Run `uvx invisible-playwright-mcp ui --openrouter-key ...` and open http://127.0.0.1:8765. Chat sits on the left, a live view of the browser on the right. It requires an OpenRouter key and defaults to the z-ai/glm-5.3-flash model. The agent drives pages the way a person would: moving the pointer and pressing keys rather than only calling APIs. The README's example is a flight-search task where the agent must click calendar days one at a time and read fares without guessing. Configuration options include: - --openrouter-key or OPENROUTER_API_KEY - --model or INVISIBLE_MCP_MODEL - --proxy (http or socks5, with host and port required; timezone, locale and egress follow the proxy) - --binary for an existing engine build, which must match the pinned version - --seed for a reproducible browser identity - --profile-dir to persist logins and cookies - --headed to show the browser window - --host and --port (defaults 127.0.0.1:8765; changing the host exposes an unauthenticated interface) A .env file in the current directory can hold OPENROUTER_API_KEY and STEALTHFOX_BINARY. Precedence is flag, then environment, then .env, then default; only the current directory is read, and values are not printed at startup. Related projects in the same family: invisible_playwright (the engine as a Python library with a Playwright-style API) and invisible_core (seed to fingerprint, preferences, proxy and geolocation). Privacy notes from the README: the agent runs locally with no author-operated server. Visited sites see a normal Firefox; the model provider receives the conversation and page content; GitHub is contacted to download the engine, a GeoIP database when a proxy is set, and a one-line launch counter. Sessions, profiles and screenshots stay local under INVISIBLE_MCP_HOME or the system application-data directory. The project is MIT licensed, with pre-2 September 2026 releases remaining AGPL-3.0. The README also asks users to respect site terms and rate limits.