BROWSER USE

- Browser Use Agents: give Browser Use a task and receive completed work. API V4 is current for new integrations.
- Browser Infrastructure: connect your agent or automation to managed browsers through SDK, REST, or CDP. Starts at $0.02/browser-hour.
- Developer tools: Open Source, Browser Harness, SDK, and MCP support the two products above.

[Developer Index](https://browser-use.com/index.md)
[Product Map](https://browser-use.com/llms.txt)
[Full Product Context](https://browser-use.com/llms-full.txt)
[Pricing](https://browser-use.com/pricing.md)
[Cloud Docs](https://docs.browser-use.com/cloud/quickstart)
[Open Source Docs](https://docs.browser-use.com/open-source/introduction)

---

# MCP server for browser automation

> Add Browser Use to Claude Code, Claude Desktop, Cursor or Windsurf as an MCP server. The hosted server runs browser agents on stealth cloud browsers; a local stdio server exposes the Browser Harness helpers for your own Chrome.

[HTML page](https://browser-use.com/mcp) · [Docs](https://docs.browser-use.com/cloud/guides/mcp-server) · [Coding agents](https://browser-use.com/coding-agents.md)

## Hosted server

URL: `https://api.browser-use.com/v3/mcp`, header `x-browser-use-api-key`. Get a key at cloud.browser-use.com under Settings, API keys.

Claude Code:

```bash
claude mcp add -t http -H "x-browser-use-api-key: YOUR_API_KEY" browser-use https://api.browser-use.com/v3/mcp
```

Cursor (`.cursor/mcp.json`) and Claude Desktop (`claude_desktop_config.json`):

```json
{ "mcpServers": { "browser-use": { "url": "https://api.browser-use.com/v3/mcp", "headers": { "x-browser-use-api-key": "YOUR_API_KEY" } } } }
```

Windsurf uses `serverUrl` instead of `url` in `~/.codeium/windsurf/mcp_config.json`.

## Tools

| Tool | What it does |
|---|---|
| run_session | Create a session and run a task. Supports keep_alive, model, output_schema, profile_id. |
| get_session | Poll status, step count, cost breakdown and live URL. |
| send_task | Send a follow-up task to an idle keep-alive session. |
| stop_session | Stop the task only, or destroy the session. |
| get_session_messages | Browser actions, reasoning and results. |
| list_sessions | Recent sessions with status and cost. |

## Local server

`browser-harness-mcp` exposes the local browser helpers as MCP tools over stdio for Claude Code, Devin, Cursor and other stdio clients, driving your own Chrome. See github.com/browser-use/browser-harness/blob/main/docs/MCP.md.
