browser_click
Click an element by selector.
LABSCO SUMMARY
Sessions are first-class, so one agent can hold several pages open and act on the right one.
The tool set is Playwright-shaped — selectors, element states, generated locators — with the session made explicit in every signature rather than kept as hidden server state, which is what lets a run keep a signed-in tab and a scratch tab side by side. browser_evaluate runs arbitrary JavaScript in the page context, so a session is exactly as trusted as the page it is pointed at, and browser_screenshot is available but browser_snapshot is the cheaper way to answer most questions about page state.
What it is
A browser automation server built around numbered sessions, 26 tools spanning session lifecycle, navigation, element interaction, keyboard and mouse input, and page inspection.
What you get
- Concurrent sessions as the organising idea: start_session names one and chooses a provider, get_sessions lists what is open, close_session takes a numeric session ID and close_all_sessions ends them all
- Selector-driven interaction — browser_click, browser_fill, browser_fill_form for several fields in one call, browser_select_option, browser_hover, browser_drag and browser_upload_file
- Three ways to read a page: browser_snapshot returns a structured snapshot bounded by maxDepth and maxChildren, browser_get_page_structure a readable summary, browser_dom_query an element's presence, count and state without waiting
- Coordinate-level input for what selectors cannot reach: browser_mouse_move, browser_mouse_click_xy, browser_mouse_drag, browser_keyboard_press for key chords and browser_keyboard_type with a per-character delay
- browser_generate_locator, which suggests locators for an element — the piece that makes a broken selector fixable inside the same session
- Explicit waiting rather than sleeps scattered through a script: browser_wait_for_selector waits for a state, browser_wait_for_timeout waits a set number of milliseconds
Requirements
The browser provider that start_session opens against, and the numeric session ID it returns — every other tool takes it as sessionId. Apache-2.0 licensed.
Setup effort
One command — npx parallel-browser-mcp@latest
USE CASES
01
Filling a long form in one pass
Open the page in a session, set every text field in a single call instead of one per input, choose the dropdown values, then submit.
02
Repairing a selector that stopped matching
Ask whether the element is present, how many match and what state it is in without waiting, get locator suggestions for it, then wait for the corrected selector to reach the state you need.
03
Comparing two accounts side by side
Open a named session per account, keep both signed in at once, read each page as a structured snapshot rather than an image, and close them together at the end.
04
Reproducing a bug that only appears after interaction
Drive the page with real input — keys, chords and coordinate clicks where selectors do not reach — run a snippet in the page to read internal state, and capture the screen once it has settled.
26 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
browser_dom_query
Query element presence, count, and state without waiting.
browser_drag
Drag from one element to another.
browser_evaluate
Run JavaScript in the page context.
browser_fill
Fill a field with text.
browser_fill_form
Fill multiple form fields.
browser_generate_locator
Generate locator suggestions for an element.
browser_get_page_structure
Return a readable page structure summary.
browser_go_back
Go back in browser history.
browser_hover
Hover over an element by selector.
browser_keyboard_press
Press a keyboard key or key chord.
browser_keyboard_type
Type text into the active page.
browser_mouse_click_xy
Click at viewport coordinates.
browser_mouse_drag
Drag the mouse from one point to another.
browser_mouse_move
Move the mouse to viewport coordinates.
browser_navigate
Navigate the session page to a URL.
browser_screenshot
Capture a screenshot of the current page.
browser_select_option
Select options in a select element.
browser_snapshot
Return a structured page snapshot.
browser_upload_file
Upload files to a file input.
browser_wait_for_selector
Wait for a selector to reach a state.
browser_wait_for_timeout
Wait a fixed number of milliseconds.
close_all_sessions
Close all active browser sessions.
close_session
Close a browser session by numeric session ID.
get_sessions
List all active browser sessions.
start_session
Start a browser session using the configured provider.
BEFORE YOU INSTALL
What to know first
Tools you get
26 tools when we connected. browser_dom_query is available but undocumented. All tools are present whichever browser provider you configure; the provider only decides whether a session can start.
Requires
npx on PATH
CONTEXT COST
Light Standing cost
Rated by the size of the 26 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
TERMINAL
npx parallel-browser-mcp@latestMCP Clients
Claude Code
CLAUDE CODE · TERMINAL
claude mcp add parallel-browser-mcp npx parallel-browser-mcp@latestClaude Desktop, Cursor
JSON
{
"mcpServers": {
"parallel-browser-mcp": {
"command": "npx",
"args": [
"parallel-browser-mcp@latest"
],
"env": {
"BROWSER_MCP_CONFIG": "{\"defaultProvider\":\"playwright\",\"providers\":{\"playwright\":{\"launchOptions\":{\"headless\":true}}}}",
"BROWSERBASE_API_KEY": "<YOUR_BROWSERBASE_API_KEY>",
"ANCHOR_API_KEY": "<YOUR_ANCHOR_API_KEY>"
}
}
}
}Codex
CODEX · TOML
[mcp_servers.parallel-browser-mcp]
command = "npx"
args = ["parallel-browser-mcp@latest"]GitHub Copilot
GITHUB COPILOT · JSON
{
"mcpServers": {
"parallel-browser-mcp": {
"type": "local",
"command": "npx",
"tools": [
"*"
],
"args": [
"parallel-browser-mcp@latest"
],
"env": {
"BROWSER_MCP_CONFIG": "{\"defaultProvider\":\"playwright\",\"providers\":{\"playwright\":{\"launchOptions\":{\"headless\":true}}}}",
"BROWSERBASE_API_KEY": "<YOUR_BROWSERBASE_API_KEY>",
"ANCHOR_API_KEY": "<YOUR_ANCHOR_API_KEY>"
}
}
}
}
