> ## Documentation Index
> Fetch the complete documentation index at: https://browseruse-0aece648-agency-x402-payment-cap.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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
```

Get your API key at [cloud.browser-use.com/settings](https://cloud.browser-use.com/settings?tab=api-keys\&new=1).

## Claude Code

```bash theme={null}
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`:

```json theme={null}
{
  "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`:

```json theme={null}
{
  "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`:

```json theme={null}
{
  "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. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.