exe-browser MCP Server

This package exposes the CLI that bridges Model Context Protocol (MCP) clients to a live browser tab. It works together with the exe-browser MCP browser extension (Chrome/Firefox) so IDEs and agents can automate the tab you explicitly connect.

• Transparent & local-first – the CLI and extension only communicate on localhost; no browsing data is sent elsewhere.
• Feature-rich tooling – 47 MCP tools: DOM snapshots, diffs, humanized input, social media workflows, scheduling, campaign management, and more.
• Cross-client – compatible with Claude Code, OpenCode, Cursor, Windsurf, MCP Inspector, or any other MCP-aware client.
• Persistent state – SQLite-backed schedules, campaigns, and error tracking survive server restarts.
• Daemon mode – automated scheduling with agent spawning for hands-off engagement.

Installation

npm install -g exe-browser-mcp-pro
# or run without installing
npx exe-browser-mcp --ws-port 9010

Usage

1. Install and load the exe-browser MCP browser extension.
2. Start the server:

   exe-browser-mcp --ws-port 9010

3. Connect the tab via the extension popup and configure your MCP client to call the CLI.

The CLI communicates over stdio, so any MCP client can spawn it and exchange requests/responses.

Daemon Mode

For automated, hands-off scheduling, use daemon mode. The server checks for due schedule entries every minute and spawns agent sessions to execute them.

# Start with daemon mode (uses Claude CLI by default)
exe-browser-mcp --ws-port 9010 --daemon

# Use OpenCode as the agent
exe-browser-mcp --ws-port 9010 --daemon --agent-cmd opencode

# Specify a custom state DB path
exe-browser-mcp --ws-port 9010 --daemon --state-db /path/to/state.db

State is persisted to ~/.exe-browser/state-{port}.db by default in daemon mode.

CLI Flags

| Flag | Description | Default | |---|---|---| | --ws-port <port> | WebSocket port for browser extension | 9010 | | --http-port <port> | Optional Streamable HTTP endpoint | (disabled) | | --daemon | Enable daemon mode (auto-execute scheduled entries) | (disabled) | | --agent-cmd <cmd> | Agent CLI for daemon mode | claude | | --state-db <path> | SQLite database path for persistent state | ~/.exe-browser/state-{port}.db (daemon) or in-memory | | --context-db <path> | Alias for --state-db | | | --audit-log <path> | JSON-lines audit log path | stderr | | --compress-threshold <bytes> | Auto-compression threshold | 5120 | | --no-compress | Disable response compression | |

Tools (47 total)

Browser Control

browser_snapshot, browser_snapshot_diff, browser_navigate, browser_go_back, browser_go_forward, browser_wait, browser_wait_for, browser_press_key, browser_click, browser_hover, browser_drag, browser_type, browser_fill_form, browser_select_option, browser_screenshot, browser_get_console_logs, browser_page_state, browser_evaluate, browser_handle_dialog, browser_connection_info, browser_list_tabs, browser_switch_tab, browser_new_tab

Humanization

browser_mouse_move, browser_scroll, browser_wait_random, browser_type_human, browser_rate_limit_config, browser_rate_limit_check

Social Media Workflows

social_workflow, social_list_workflows, social_content_variation, social_session_check

Context Compression

browser_search_context, browser_context_stats

Orchestration & Scheduling

orchestrator_schedule, orchestrator_schedule_recurring, orchestrator_schedule_list, orchestrator_schedule_update, orchestrator_campaign_create, orchestrator_campaign_status, orchestrator_campaign_update, orchestrator_campaign_next_target, orchestrator_campaign_mark_engaged, orchestrator_error_record, orchestrator_error_list, orchestrator_error_resolve

Development

This package is part of the exe-browser MCP monorepo. Clone the repo for contribution instructions, publishing steps, and privacy policy.