Skip to main content
https://api.browser-use.com/v3/mcp
Get your API key at cloud.browser-use.com/settings.

​
Claude Code

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

​
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

ToolDescription
run_sessionCreate a session and run a task. Supports keep_alive, model (bu-mini, bu-max), output_schema, and profile_id.
get_sessionPoll session status and output. Returns status, step count, cost breakdown, and live URL.
send_taskSend a follow-up task to an idle keep-alive session.
stop_sessionStop a session. strategy: "task" stops only the task, "session" destroys the sandbox.
get_session_messagesGet the agent’s messages — browser actions, reasoning, and results.
list_sessionsList recent sessions with status and cost.
list_browser_profilesList browser profiles for authenticated tasks.