# turbo-browser-mcp [Health: Active]

**Category:** 📂 Browser Automation  
**Repository:** https://github.com/Tthanh2k6/turbo-browser-mcp  
**GitHub Stars:** 127  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/turbo-browser-mcp

## Description
Playwright MCP server built to cut agent turns and tokens: one-call form filling, delta snapshots, batched steps, and a submit guard on by default

## Tools
Capabilities this server exposes over MCP:

- **tabs_batch** — Tab operations in one call: list, open/open_many, navigate, activate, resize, emulate, reload, back/forward, close.
- **inspect_compact** — List interactive elements (with refs), forms or readable sections across frames and open Shadow DOM, capped at maxChars.
- **smart_fill_form** — Fill several fields at once: inputs, editors, comboboxes, selects, checkboxes, Shadow DOM/iframe fields, file uploads. Stops before Submit by default.
- **act_fast** — One action on a ref, selector, text or x/y. Supports returnSnapshot; blocks submit/publish/send unless allowSubmit=true.
- **batch_actions** — Run actions or smart_fill_form steps in order, including navigate/extract for multi-page reading. Stops on Submit guard blocks; optional post-batch snapshot.
- **extract_clean_text** — Extract readable text or markdown from the main content and iframes, capped at maxChars.
- **evaluate_js** — Evaluate JavaScript in a frame or element (ref/selector/text passes el and arg); returns JSON.
- **page_diagnostics** — Read buffered console logs, network requests, downloads and dialogs for a tab.
- **capture_page** — Screenshot (png/jpeg) or PDF of the page or an element, saved under cwd or TURBO_BROWSER_SAVE_ROOT; optional inline image.
- **network_session** — Manage browser cookies, localStorage/sessionStorage, Playwright storageState files, quick blocking presets (turbo, no-images, no-media, clean), and custom resource/URL blocking.
- **wait_for_human** — Let a human do a step (login, bot check, 2FA) in the visible browser; wait until a condition holds, then continue in the same session. Only waits.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "turbo-browser-mcp": {
    "command": "npx",
    "args": ["-y","turbo-browser-mcp"]
  }
}
```

## Documentation

## What turbo-browser-mcp does

turbo-browser-mcp exposes browser automation through the Model Context Protocol and Playwright. Its 11 tools cover browser and tab lifecycle, compact page inspection, form completion, direct page actions, batched workflows, text extraction, JavaScript evaluation, diagnostics, screenshots and PDFs, network or storage state, and human-assisted steps.

The server is aimed at workflows where one MCP call can replace several individual browser actions. `smart_fill_form` handles complete forms, including React inputs, selects, comboboxes, rich-text editors, checkboxes, and file uploads. `batch_actions` can combine clicks, key presses, form operations, page navigation, and extraction. `inspect_compact` can limit output to elements that changed after an earlier snapshot.

## How it works

The default `auto` mode first checks for a Chrome-compatible browser listening on `http://127.0.0.1:9222`. If none is available, it launches Chromium. Other modes attach to an existing browser through CDP, reuse a persistent profile, or launch a clean session. Supported browser sources include Playwright's cache and installed Chrome, Edge, Brave, or Chromium binaries.

Tabs can use separate cookie and storage contexts through `isolatedContext`. Multiple URLs can be opened concurrently, with a maximum concurrency of 10. Navigation in batch workflows uses GET in the same tab and waits for `domcontentloaded`.

Submit-like controls such as Submit, Send, Publish, Pay, and Confirm are blocked by default, including equivalents in several Asian languages. A call can opt in with `allowSubmit: true`, or the server can start with `--allow-submit`. `wait_for_human` pauses for a person to complete a step and then resumes in the same session.

## Setup and configuration

Node.js 20 or newer and a Chromium-based browser are required. Install the package with `npx -y turbo-browser-mcp`, or clone the repository, run `npm install`, and start `node src/index.mjs`.

Claude Code can register the server with `claude mcp add turbo-browser -- npx -y turbo-browser-mcp`. Clients using an `mcpServers` JSON configuration can launch the same command with `npx` and the package name. Run `npx -y turbo-browser-mcp --doctor` to check the setup; `npx playwright-core install chromium` installs Playwright's Chromium when needed.

`TURBO_BROWSER_SAVE_ROOT` restricts where screenshots, PDFs, and storage files may be written or read. If omitted, the working directory is used. Set `TURBO_BROWSER_TOOLS=core`, or pass `--tools core`, to expose only the six core tools: `tabs_batch`, `inspect_compact`, `smart_fill_form`, `act_fast`, `batch_actions`, and `extract_clean_text`.

## Tools and capabilities

- `tabs_batch` manages tabs, browser lifecycle, navigation, resizing, emulation, and isolated contexts.
- `inspect_compact` returns capped snapshots of interactive elements, forms, article text, or all supported content.
- `smart_fill_form` fills fields, editors, selects, checkboxes, and file inputs in one call.
- `act_fast` performs a single page action, while `batch_actions` runs ordered steps and can verify expected URLs, text, selectors, or new text.
- `extract_clean_text` returns page text or compact Markdown; `evaluate_js` runs an expression or element function.
- `page_diagnostics`, `capture_page`, `network_session`, and `wait_for_human` cover diagnostics, screenshots or PDFs, resource and storage controls, and human intervention.

The server returns short initialization instructions recommending batched form fields, batched action steps, changed-only snapshots after the first inspection, and references from the latest snapshot.

## Limitations and notes

The automation intentionally does not use stealth patches, fingerprint changes, or CAPTCHA solving. Sites with bot checks may require a person to take over through `wait_for_human`. Submit protection can be overridden per call or globally, so workflows that enable it should include their own confirmation or duplicate-submission checks. File and storage access is constrained by `TURBO_BROWSER_SAVE_ROOT`.

_Full upstream README: https://allmcps.com/mcp/turbo-browser-mcp/readme_

