Chrome for AI

MCP server: AI agents drive real Google Chrome — click, type, tabs, cookies — with Patchright under official Microsoft Playwright MCP so the CDP handshake is less obvious to bot detection.

Not a fork of microsoft/playwright-mcp. Same official tools (~63 browser_*). Extra stealth/captcha helpers on top.

Docs: documentation map · architecture · connection recipes (Grok, Antigravity, Codex, Claude, Cursor, VS Code, Gemini, …)

Capabilities

An agent connected to this MCP can:

• Open pages, click, type, fill forms, hover, drag & drop, upload files, handle dialogs, navigate back, and manage tabs

• Read accessibility snapshots (vision model not required)

• Manage cookies / localStorage, take screenshots, export PDFs, execute JS, and inspect network traffic

• Persist logins across sessions (persistent Chrome profile)

• Audit browser fingerprint (stealth_audit), open bot.sannysoft.com (stealth_check)

• Detect CAPTCHAs / Cloudflare IUAM; automatically wait for passive JS challenges to resolve

• Support proxies, attach to an existing running Chrome instance (CDP), headed mode by default

• Use compact viewport snapshots with @e1 refs and obstruction-aware ref click/fill

• Read Markdown/llms.txt, capture Set-of-Marks screenshots, and replay in-memory flows

Not supported / Out of scope: Solving interactive reCAPTCHA/hCaptcha, token farming, 100% anti-detect guarantee, IP spoofing (requires proxy).

Grok mcp doctor handshake verified, 77 tools (63 official + 14 extra).

Install

git clone https://github.com/Pelag-Michael/Chrome-for-AI.git
cd Chrome-for-AI
npm install
npm test
npm run smoke
npm run live-smoke
node scripts/doctor.mjs

Then point any MCP client at node /ABS/PATH/Chrome-for-AI/src/index.mjs. Full recipes: docs/setup/CONNECT.md.

Grok shortcut:

node scripts/install-grok.mjs
grok mcp doctor chrome-for-ai   # or grok-browser if you used the older name

Stack

Do not add a fake User-Agent or a heavy fingerprint init-script. Patchright’s own rule: real Chrome, no injection.

Interactive captchas still need a human in the headed window. This MCP detects them; it does not solve them.

Extra tools

Stealth/challenge: stealth_status · stealth_audit · stealth_check · captcha_detect · challenge_wait · human_wait · human_scroll

Token-efficient control: browser_snapshot_refs · browser_click_ref · browser_fill_ref · browser_smart_read · browser_annotated_screenshot · browser_record_step · browser_replay_flow

Refs are temporary and viewport-scoped: call browser_snapshot_refs again after navigation or major DOM changes. Recorded flows live only in the current MCP session and are never written to disk.

License

Apache-2.0. Playwright MCP is Microsoft (Apache-2.0). Patchright is Apache-2.0. This repo only wraps them.