MCP Server

Run browser automation tasks from your AI coding assistant. Connect to Claude, Cursor, Windsurf, or any MCP client.

https://api.browser-use.com/v3/mcp

The MCP server runs tasks on a cloud browser on Browser Use infrastructure — it does not control your local browser. Each task spins up a hosted stealth browser with proxies and CAPTCHA solving on by default. Authentication is an HTTP header (x-browser-use-api-key), not an environment variable.

Get your API key at cloud.browser-use.com/settings.

Claude Code

claude mcp add --transport http browser-use https://api.browser-use.com/v3/mcp --header "x-browser-use-api-key: YOUR_API_KEY"

Claude Desktop

Add to claude_desktop_config.json:

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

Cursor

Add to .cursor/mcp.json:

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

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

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

Available Tools

Tool	Description
run_session	Create a session and run a task. Supports keep_alive, model (claude-sonnet-4.6, claude-opus-4.6, gpt-5.4-mini), output_schema, and profile_id.
get_session	Poll session status and output. Returns status, step count, cost breakdown, and live URL.
send_task	Send a follow-up task to an idle keep-alive session.
stop_session	Stop a session. strategy: "task" stops only the task, "session" destroys the sandbox.
get_session_messages	Get the agent’s messages — browser actions, reasoning, and results.
list_sessions	List recent sessions with status and cost.
list_browser_profiles	List browser profiles for authenticated tasks.