WebRun Browser Automation MCP server
ai.webrun · Updated
Run multi-step tasks in a real Chrome browser: persistent environments, live view, human takeover.
At a glance
WebRun Browser Automation is an MCP server in the Web & Search category. It is hosted remotely and connects over HTTP, and needs Authorization. It exposes 21 tools, including browser_task, create_session and send_task. It scores C (40/100) on the MCP Skills Hub health score as of Oct 28, 2026.
One-click install
Opens your editor and pre-fills the config. Your editor will ask before adding it.
How to install WebRun Browser Automation in your AI client
Setup for Claude Code, Claude Desktop, Cursor, Codex, Windsurf, Cline and VS Code — copy-paste ready.
How to install WebRun Browser Automation in Claude CodeAnthropic's agentic CLI
Add the server
bashclaude mcp add --transport http webrun https://api.webrun.ai/mcp --header 'Authorization: Bearer <YOUR_TOKEN>'Fill in your credentials
Replace Bearer <YOUR_TOKEN> with your real value. Keep secrets out of any config file you commit.
Verify it's connected
bashclaude mcp listSharing it with your team?
Add `--scope project` to write it to .mcp.json in the repository root, which you can commit (with the secrets left as environment variables).
Use it in a session
Ask Claude to use the tools this server exposes (e.g. browser_task, create_session, send_task). It discovers them automatically.
How to install WebRun Browser Automation in Claude DesktopDesktop app (MCP config)
Open your MCP config
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json
Add this server
json{ "mcpServers": { "webrun": { "command": "npx", "args": [ "-y", "mcp-remote", "https://api.webrun.ai/mcp", "--header", "Authorization:${AUTH_HEADER}" ], "env": { "AUTH_HEADER": "Bearer <YOUR_TOKEN>" } } } }Fill in your credentials
Replace Bearer <YOUR_TOKEN> with your real value. Keep secrets out of any config file you commit.
Why the wrapper?
This is a remote (HTTP) server and Claude Desktop only launches local processes, so mcp-remote proxies the connection. It will open a browser window if the server needs OAuth.
Restart Claude Desktop
The tools appear under the 🔌 menu once the app reloads.
How to install WebRun Browser Automation in CursorAI-first code editor
Create / edit .cursor/mcp.json in your project
json{ "mcpServers": { "webrun": { "url": "https://api.webrun.ai/mcp", "headers": { "Authorization": "Bearer <YOUR_TOKEN>" } } } }Fill in your credentials
Replace Bearer <YOUR_TOKEN> with your real value. Keep secrets out of any config file you commit.
Enable it
Cursor Settings → MCP → toggle the server on. Tools become available to the Composer/Agent.
How to install WebRun Browser Automation in Codex CLIOpenAI coding agent
Add to ~/.codex/config.toml
toml[mcp_servers.webrun] command = "npx" args = ["-y", "mcp-remote", "https://api.webrun.ai/mcp", "--header", "Authorization:${AUTH_HEADER}"] env = { AUTH_HEADER = "Bearer <YOUR_TOKEN>" }Fill in your credentials
Replace Bearer <YOUR_TOKEN> with your real value. Keep secrets out of any config file you commit.
Why the wrapper?
Codex runs MCP servers as local processes, so mcp-remote bridges this HTTP endpoint to stdio.
Run Codex
Codex loads MCP servers from config.toml on startup and exposes their tools to the agent.
How to install WebRun Browser Automation in WindsurfCodeium's agentic IDE
Edit ~/.codeium/windsurf/mcp_config.json
json{ "mcpServers": { "webrun": { "serverUrl": "https://api.webrun.ai/mcp", "headers": { "Authorization": "Bearer <YOUR_TOKEN>" } } } }Fill in your credentials
Replace Bearer <YOUR_TOKEN> with your real value. Keep secrets out of any config file you commit.
Reload
Windsurf → Cascade → refresh MCP servers. Cascade can now call the tools.
How to install WebRun Browser Automation in ClineVS Code autonomous agent
Open Cline → MCP Servers → Configure
Adds to cline_mcp_settings.json.
Add the server
json{ "mcpServers": { "webrun": { "type": "streamableHttp", "url": "https://api.webrun.ai/mcp", "headers": { "Authorization": "Bearer <YOUR_TOKEN>" } } } }Fill in your credentials
Replace Bearer <YOUR_TOKEN> with your real value. Keep secrets out of any config file you commit.
How to install WebRun Browser Automation in VS CodeCopilot / MCP support
Create .vscode/mcp.json
json{ "servers": { "webrun": { "type": "http", "url": "https://api.webrun.ai/mcp", "headers": { "Authorization": "Bearer <YOUR_TOKEN>" } } } }Fill in your credentials
Replace Bearer <YOUR_TOKEN> with your real value. Keep secrets out of any config file you commit.
Start it
VS Code shows a ▶ Start action above the server entry. Agent mode (Copilot Chat) can then use the tools.
What does WebRun Browser Automation need from you?
Bearer token — WebRun API key as a bearer token.
AuthorizationrequiredsecretHTTP headerWebRun API key as a bearer token.
What tools does WebRun Browser Automation expose? (21)
Read from the live server. Click any tool for its input schema.
- browser_taskExecute a browser automation task in a real Chrome browser running in a WebRun cloud environment (docs.webrun.ai). Creates a session, runs the task, and auto-terminates. Best for simple one-off tasks that no saved workflow covers. May navigate, fill forms, and submit data on third-party websites as the task requires. Do NOT use this to run or test a saved workflow — use trigger_workflow instead: o
- create_sessionCreate a persistent session in a real Chrome browser running in a WebRun cloud environment (docs.webrun.ai), for multi-step interactive work. Returns a sessionId for subsequent commands. With an initial task the browser may act on third-party websites immediately. Do NOT use this to run or test a saved workflow — use trigger_workflow instead: only a workflow run carries the workflow's own rules, t
- send_taskSend a new task to an existing browser session (from create_session). The real Chrome browser may navigate, fill forms, and submit data on third-party websites as the task requires.
- pause_session_taskPause the task currently running in a browser session. Resume it later with resume_session_task.
- resume_session_taskResume a previously paused task in a browser session.
- stop_session_taskCancel the task currently running in a browser session, keeping the session alive for new tasks.
- terminate_sessionEnd a browser session and free its resources. The session and any running task cannot be resumed afterwards.
- guardrail_responseRespond to a guardrail trigger when the browser agent needs human input (credentials, clarification, approval). The response is handed to the live agent, which continues acting on it.
- get_task_statusCheck the status of a task previously started in a browser session. Use to poll for completion or detect guardrails. Read-only: reports on the task without affecting it.
- screenshotCapture a screenshot of the current browser page in an active session. Returns the screenshot as an inline image. Read-only.
- list_sessionsList all active browser sessions for this account. Read-only.
- list_environmentsList available browser environments (persistent profiles) for this account. Returns environment IDs needed for persistent sessions in browser_task or create_session. Read-only. NOTE: workflows and agents use the connection's environment automatically — you rarely need this tool for those, and should not ask the user to choose an environment.
- list_workflowsList the user's saved workflows (prompt-templated browser automations, docs.webrun.ai). Shows each workflow's title, schedule, {{variables}}, and run stats. Scoped to the bound environment when this connection has one; pass scope "all" for every environment. Read-only.
- get_workflowFull detail of one workflow: prompt template, {{variables}} and their defaults, trigger + schedule, run settings (starting URL, timezone, model, proxy, output contract, files), memory state, and any pending logins. Identify by workflowId or exact title. Read-only; proxy credentials are masked.
- create_workflowCreate a new saved workflow. READINESS BAR: if you could not execute the prompt yourself as a human in a browser — which site, which records, which fields, delivered where, matched to each recipient how — it is not ready; first collect the missing business facts from the user (see the TASK INTERVIEW in the server instructions), then create. Requires title and promptTemplate — write the prompt as a
- update_workflowUpdate an existing workflow. Supply workflowId plus only the fields to change: prompt, trigger, schedule, run settings, variables, presentation. Object and array fields are replaced whole; pass null to clear an optional field. Renaming via title keeps the slug stable. The stored schedule stays a saved setting — scheduled agents already deployed from this workflow keep their own timing. promptTempl
- trigger_workflowRun a workflow now in its deployed environment. This is the ONLY correct way to run or TEST a saved workflow — a run started here carries the workflow's rules, tracking and memory; browser_task/create_session runs do not. When the user says "run it", "run it once", "test it" or "try it" about a workflow, this is the tool they mean. Drives a real Chrome browser: the run may navigate, fill forms, an
- create_agentCreate a scheduled agent — a recurring or one-time automation that runs on a timer in a real Chrome browser. Two modes. WORKFLOW MODE: pass workflowId plus a schedule — the platform copies everything else (prompt, starting URL, output contract, model, proxy, policy, files) from the workflow and bakes your variables into the prompt; results and memory stay centralised on the workflow. STANDALONE MO
- list_agentsList the account's scheduled agents (cron deployments): schedule, status, next/last run, and whether each is standalone or deployed from a workflow. Scoped to the bound environment when this connection has one; pass scope "all" for every environment. Read-only.
- pause_agentPause an active scheduled agent — it stops firing until resumed. Get agentId from list_agents.
- resume_agentResume a paused scheduled agent — recomputes its next run and reactivates it. A completed work-list agent restarts with a fresh full pass. Refuses if the agent's expiry has passed (extend it on the dashboard first).
What the code can do
This is a remote server — nothing is installed or run on your machine, so there is no local code to analyze. What it can reach is described above: your requests go to the provider's host.
Before you install
Signals gathered from the source repo and package registry — not a safety verdict.
What it can reach
- Third-party hosted service — Your requests and any data in them are sent to api.webrun.ai.
- No local execution — Nothing is installed or run on your machine.
- No source repository — This registry entry does not link to a public repo, so its code cannot be reviewed before you install it.
Client compatibility
Health score
C · 40Maintenance, adoption, transparency and packaging — not a safety audit. How this is calculated
- Maintenance30%not measurable
No commit history available.
- Adoption20%not measurable
No usage data available.
- Transparency20%25%
1/4: ✗ public source repo, ✗ declared license, ✗ documentation, ✓ discoverable tool list.
- Provenance15%0%
No source repository to trace the code back to.
- Packaging15%100%
Remote endpoint with documented authentication.
Alternatives to WebRun Browser Automation
- Pagerunner — The Browser Layer That LearnsA · 84Real Chrome profiles with site intelligence — already logged in, PII anonymization, sessions persist
- ainative-browser-mcpA · 86AI-powered browser automation MCP — 6 tools for web interaction, extraction, and validation.
- agbrowserD · 33Browser sessions for agents: navigate, interact, read and screenshot. Pay in stablecoins.
- Yab, Yet Another BrowserA · 87Your own signed-in Mac browser for any agent: open, read and act in tabs. Local and free.
Maintain WebRun Browser Automation? Add a badge to your README
Shows its health grade, and links readers to install steps for every client.
[](https://mcp-skills-hub.vercel.app/mcps/ai-webrun-webrun)Catalog data refreshed . Something wrong? Report it.