browser-automationwebdriver-bidizen-browserwebsocketform-filling
MCP server for automating Zen Browser via WebDriver BiDi over WebSocket without Selenium or Playwright.
Quick Install
Automated & IDE SetupCopy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.
One-click editor setup isn’t available for this listing yet — we don’t have a confirmed install command, and we’d rather show nothing than point your editor at the wrong package or host. Follow the project’s own setup instructions, linked above.
Manual Client & Custom JSON ConfigExpand JSON ▾
No confirmed setup config for this listing yet. We only publish a config block when the install details come from the project itself — its README, its docs, or a verified owner. We haven’t found those for sh6drack/zen-mcp, and we’d rather show nothing than a guess you’d paste into your client. Follow the project’s own setup instructions for the current steps.
Overview
Use cases
Navigate to URLs and manage browser tabs
Fill forms and interact with page elements
Capture screenshots and extract page content
Run JavaScript code in the page context
Automate keyboard input and page scrolling
Key features
20 browser automation tools including navigation, form filling, and screenshots
Direct WebDriver BiDi protocol communication over WebSocket
Supports React, Vue, and Angular apps with native event dispatch
Auto-reconnect and session recovery for reliability
Tab management: open, close, switch tabs
JavaScript evaluation and keyboard input support
Capabilities & Tool Schemas
Inspect callable tools, capabilities, and parameters exposed to AI agents by Zen MCP.
Extracted Tool Capabilities
20 browser automation tools including navigation, form filling, and screenshots
Direct WebDriver BiDi protocol communication over WebSocket
Supports React, Vue, and Angular apps with native event dispatch
Auto-reconnect and session recovery for reliability
Tab management: open, close, switch tabs
JavaScript evaluation and keyboard input support
Documentation Overview
zen-mcp
The first MCP server for Zen Browser. Automate Zen from Claude Code, Cursor, or any MCP client.
No Selenium. No Playwright. No browser drivers. Just WebSocket.
Setup (2 minutes)
1. Start Zen with remote debugging
Pro tip: Add
alias zen='open /Applications/Zen.app --args --remote-debugging-port 9222'to your shell config. Then just runzen.
2. Add to Claude Code
Add to ~/.claude/mcp_servers.json:
If you cloned instead of npm install, use
"command": "node", "args": ["/absolute/path/to/zen-mcp/server.mjs"]
Add to ~/.claude/settings.json:
That's it. Start a new Claude Code session and the zen_* tools are available.
20 Tools
Browse
| Tool | What it does |
|---|---|
zen_navigate | Go to a URL |
zen_list_pages | List all open tabs |
zen_select_page | Switch to a tab |
zen_new_tab | Open a new tab |
zen_close_tab | Close a tab |
See
| Tool | What it does |
|---|---|
zen_snapshot | Page structure with selectors (filter: all/interactive/form) |
zen_screenshot | Capture a screenshot |
zen_get_page_text | Get page title, URL, and text |
zen_get_form_fields | List all form fields with labels and values |
Interact
| Tool | What it does |
|---|---|
zen_click | Click an element |
zen_fill | Type into an input or textarea |
zen_select_option | Pick a dropdown option |
zen_check | Toggle a checkbox or radio |
zen_press_key | Keyboard input (Enter, Tab, Ctrl+A, etc.) |
zen_fill_form | Fill multiple fields at once |
zen_scroll | Scroll the page or to an element |
Utility
| Tool | What it does |
|---|---|
zen_evaluate | Run JavaScript in the page |
zen_wait | Wait N milliseconds |
zen_wait_for | Wait for text or element to appear |
zen_reconnect | Force reconnect to Zen |
How It Works
zen-mcp speaks WebDriver BiDi (W3C standard) directly over WebSocket. Form filling uses native value setters with input/change event dispatch so React, Vue, and Angular apps work correctly.
What Works Well
- Navigation, clicking, form filling — rock solid, handles React/Vue/Angular
- Screenshots and page reads — reliable content extraction
- Tab management — open, close, switch between tabs
- JavaScript evaluation — run any code in the page context
- Keyboard input — shortcuts, Enter, Tab, modifier combos
Known Limitations
- Zen inherits Firefox's WebDriver BiDi implementation, which is still maturing. Some advanced BiDi commands that work in Chrome may not be available yet.
- Zombie sessions can only be cleared by restarting Zen (BiDi session.end is connection-scoped). zen-mcp detects this and tells you what to do.
- No file upload or drag-and-drop support (BiDi spec limitation).
Built-in Reliability
- Auto-reconnect with exponential backoff if WebSocket drops
- Zombie session recovery when a previous client crashed
- Connection retry (3 attempts with backoff)
- Clean shutdown on SIGINT/SIGTERM to prevent orphaned sessions
Troubleshooting
| Problem | Fix |
|---|---|
| "Cannot connect to Zen Browser" | Start Zen with --remote-debugging-port 9222 |
| "Maximum number of active sessions" | Restart Zen: killall zen && zen |
| Connection keeps dropping | Use zen_reconnect to force a fresh connection |
Config
| Env Variable | Default | Description |
|---|---|---|
ZEN_DEBUG_PORT | 9222 | Zen's remote debugging port |
Requirements
- Zen Browser
- Node.js 20+
Test
License
MIT
Related MCP Servers
Adoption & maintenance
Factual signals from GitHub, npm, and our automated checks — not a rating.
GitHub stars
18
Stargazers on the source repository.
Last commit
3mo ago
Most recent push to the default branch.
Directory activity
2 views
Config copies, upvotes, and views on AllMCPs.
Reviews
No reviews yet — be the first to share how this listing worked for you.
Frequently Asked Questions about Zen MCP
AllMCPs Directory Badge
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
Badge Style:
Live Dynamic SVG Preview
Markdown (GitHub README)
[](https://allmcps.com/mcp/sh6drack-zen-mcp)HTML Embed
<a href="https://allmcps.com/mcp/sh6drack-zen-mcp"><img src="https://allmcps.com/api/badge/sh6drack-zen-mcp?style=directory" alt="Zen MCP on AllMCPs" /></a>Technical Specs & Signals
CategoryBrowser Automation
PricingFree
43Quality signal: Fair · 43/100How this signal is calculated ▾
Server availabilityNot measured
Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.
Verified ownership10/20
Documentation & tools19/30
Adoption & activity3/15
Community engagement0/10
A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.
Own this project?
This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.
Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.
Claim & get free dofollowShare & Embed
Add our SVG badge (dark/light directory styles) or embeddable widget to your site.