by Tthanh2k6
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
# Add to your Claude Code skills
git clone https://github.com/Tthanh2k6/turbo-browser-mcpGuides for using ai agents skills like turbo-browser-mcp.
See how turbo-browser-mcp compares with popular alternatives.
turbo-browser-mcp is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by Tthanh2k6. 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. It has 123 GitHub stars.
turbo-browser-mcp's catalog security scan is still queued. You can run an instant dependency and prompt-injection check now with the "Scan for vulnerabilities" button above.
Clone the repository with "git clone https://github.com/Tthanh2k6/turbo-browser-mcp" and add it to your Claude Code skills directory (see the Installation section above).
turbo-browser-mcp is primarily written in JavaScript. It is open-source under Tthanh2k6 on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh turbo-browser-mcp against similar tools.
No comments yet. Be the first to share your thoughts!
Available after the catalog security scan passes.
⚠️ Third-Party Software Notice
This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM is an informational directory and does not control or maintain the underlying repository.
Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.
Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.
The deep catalog scan for this skill is still queued. Run an instant dependency check now instead.
An MCP server for browser automation, built on Playwright. It has 11 tools, and each one does more per call than the usual one-action-per-call design:
smart_fill_form fills a whole form in one call, including React inputs, selects, comboboxes, rich-text editors and file uploads read from disk.inspect_compact can return only the elements that changed since the last snapshot.batch_actions runs a list of clicks, key presses, form steps and page reads as one call.Fewer calls means fewer model turns and less page text replayed in the conversation. The numbers, and their limits, are under Benchmarks.
Buttons that look like a final commit (Submit, Send, Publish, Pay, Confirm, and their Korean, Japanese, Chinese and Vietnamese equivalents) are blocked by default, so an agent can prefill a form and leave the last click to a person. Pass allowSubmit: true per call or start with --allow-submit to turn this off.
The server does not hide that the browser is automated: no stealth patches, no fingerprint changes, no CAPTCHA solving. For sites with a bot check it can hand the tab to a person and continue afterwards (wait_for_human).
Needs Node 20 or newer and a Chromium-based browser (Chrome, Edge, Brave, or Playwright's Chromium).
Claude Code:
claude mcp add turbo-browser -- npx -y turbo-browser-mcp
Clients that read an mcpServers JSON config (Cursor, Claude Desktop, Antigravity and others):
{
"mcpServers": {
"turbo-browser": {
"command": "npx",
"args": ["-y", "turbo-browser-mcp"],
"env": { "TURBO_BROWSER_SAVE_ROOT": "/absolute/path/to/workspace" }
}
}
}
TURBO_BROWSER_SAVE_ROOT is the only folder the server may write screenshots, PDFs and storage files to, or read storage files from. Leave it out and the current working directory is used.
Check the setup, and install Chromium if no browser is found:
npx -y turbo-browser-mcp --doctor
npx playwright-core install chromium
By default the server first tries a Chrome that is already listening on http://127.0.0.1:9222, so the agent can use a browser you are signed in to, and otherwise launches its own headless Chromium. --mode, --headed and the other options are listed under CLI options.
From source:
git clone https://github.com/Tthanh2k6/turbo-browser-mcp.git
cd turbo-browser-mcp
npm install
node src/index.mjs --doctor
| Tool | Purpose | Key parameters |
|---|---|---|
tabs_batch |
Tab and browser lifecycle | operations[] (list, open, open_many, navigate, activate, resize, emulate, reload, back, forward, close, close_browser), isolatedContext, concurrency (1-10) |
inspect_compact |
Size-capped snapshot of elements, forms or article text | mode (interactive, forms, article, all), onlyChanged, query, boxes, maxChars, includeFrames, savePath |
smart_fill_form |
Fill a form, editors and file inputs in one call | fields[] (ref, selector, value, option, values, check, not, keys, file, files, frameIdx, all), gmail, overwrite, stopBeforeSubmit, returnSnapshot |
act_fast |
One action on the page | action (16 actions), ref/selector/text/label/(x, y), modifiers, dropData, allowSubmit, observeAftermath, returnSnapshot |
batch_actions |
Ordered actions, form steps, and multi-page navigate/extract | steps[] (including navigate with url, extract with format, selector, maxChars), continueOnError, allowSubmit, expect, submissionKey, allowDuplicate, observeAftermath, returnSnapshot, snapshotMaxChars |
extract_clean_text |
Page text or compact Markdown | format (text, markdown), selector, includeFrames, maxChars, savePath |
evaluate_js |
JS expression, or a function called with (el, arg) |
expression, arg, frameIdx, ref/selector/text, savePath |
page_diagnostics |
Console, network, downloads and dialogs | level (errors, all), statusFilter (errors, all), includeStatic, urlFilter, reqId, part, dialogPolicy, clear, savePath |
capture_page |
PNG/JPEG screenshot or PDF | mode (screenshot, pdf), type, quality, fullPage, scale (css, device), ref/selector/text, returnImage, savePath |
network_session |
Resource blocking, cookies and storage | preset (turbo, no-images, no-media, clean), blockResources, blockUrls, cookieAction, storageAction, loadStorageStatePath, saveStorageStatePath |
wait_for_human |
Hand a step to a person, resume in the same session | message, urlMatches, selector, textMatches, textGone, timeoutMs, pollMs |
The server also sends short instructions in the MCP initialize result: batch fields with smart_fill_form, chain steps with batch_actions, use onlyChanged after the first snapshot, and use refs from the latest snapshot.
With --tools core (or TURBO_BROWSER_TOOLS=core) only tabs_batch, inspect_compact, smart_fill_form, act_fast, batch_actions and extract_clean_text are listed, and calls to the other tools are refused. The default lists all 11.
{
"name": "smart_fill_form",
"arguments": {
"fields": [
{ "selector": "#full_name", "value": "Alex Nguyen" },
{ "selector": "#email", "value": "alex@example.com" },
{ "selector": "#country", "option": "United States" },
{ "selector": "#skills", "values": ["TypeScript", "Playwright"] },
{ "selector": "#agree_terms", "check": true },
{ "selector": "#resume_pdf", "file": "./assets/resume.pdf" }
],
"stopBeforeSubmit": true,
"returnSnapshot": true
}
}
{
"name": "inspect_compact",
"arguments": {
"mode": "interactive",
"onlyChanged": true,
"maxChars": 3000
}
}
{
"name": "tabs_batch",
"arguments": {
"operations": [
{ "action": "open", "url": "https://example.com/app", "isolatedContext": "acct-a" },
{ "action": "open_many", "urls": ["https://example.com/docs", "https://example.com/pricing"], "concurrency": 4 }
]
}
}
{
"name": "batch_actions",
"arguments": {
"steps": [
{ "action": "smart_fill_form", "fields": [{ "selector": "#name", "value": "홍길동" }] },
{ "action": "click", "text": "다음" },
{ "action": "click", "text": "확인" }
],
"allowSubmit": true,
"expect": { "textMatches": "접수번호\\s*R-\\d+", "timeoutMs": 8000 },
"submissionKey": "photo-contest:2026-11-15:entry-1"
}
}
{
"name": "batch_actions",
"arguments": {
"steps": [
{ "action": "navigate", "url": "https://example.com/catalog?page=2" },
{ "action": "extract", "format": "text", "selector": "main", "maxChars": 3000 },
{ "action": "navigate", "url": "https://example.com/catalog?page=3" },
{ "action": "extract", "format": "markdown", "selector": "main", "maxChars": 3000 }
]
}
}
Navigation uses GET in the same tab and waits for domcontentloaded. Each extract step returns the same output as extract_clean_text in its step result.
--mode auto (default) probes --cdp http://127.0.0.1:9222 and falls back to launching Chromium. cdp attaches to a running browser, persistent reuses a --user-data-dir profile, launch starts a clean session (headless unless --headed). The browser is found in the Playwright cache, in system installs of Chrome, Edge, Brave and Chromium, or at --executable <path>.isolatedContext gives a tab its own cookies and storage. open_many opens up to 10 URLs at once. emulate sets colorScheme, media, reducedMotion, contrast, forcedColors or a userAgent.inspect_compact reads the main frame, child iframes (includeFrames, frameIdx) and open Shadow DOM. With onlyChanged: true a * before a line marks a ref that is new since the last snapshot, and a Removed: line lists refs that went away. An unchanged Submit-like button is still listed so the model knows it exists, and the submit guard still blocks it. query filters by regex or substring, boxes: true adds [box=x,y,w,h], maxChars caps the output, and savePath writes the full output to disk.smart_fill_form handles text-like inputs, <input type="range">, checkboxes, radio groups, <select> and <select multiple>, ARIA comboboxes and switches, contenteditable editors, and Gmail compose (gmail: { to, subject, body }). Set all: true to fill matching controls across frames. file and files paths go straight to Playwright's setInputFiles, so file contents never enter the model's context.act_fast takes click, dblclick, hover, focus, clear, fill, type, select, check, uncheck, drag, drop, press, scroll, wait and upload. A target is a ref from the latest snapshot, a CSS selector, visible text, a label, or (x, y) coordinates.returnSnapshot or