# Browser Use

Cloud browsers with stealth and proxies you control over CDP, plus an agent API and an open-source Python library.

- Provider: Browser Use (https://browser-use.com)
- Category: Drive a browser
- Type: Hosted browser
- Pricing model: Pay as you go, prepaid credits [2]
- Free tier: $1 one-time signup credit [1]
- Authentication: API key in `X-Browser-Use-API-Key` header; Bearer key for the MCP server [4]
- Connect via: REST API (v4), CDP URL for Playwright/Puppeteer/Selenium, remote MCP server, Python and TypeScript SDKs, open-source library [4]
- Read from the provider's pages on 2026-11-04
- Page: https://supermarket.dev/tools/drive-a-browser/browser-use

## Pricing

### Billing
- Pricing model: Pay as you go, prepaid credits; no subscription [1]
- Free tier: $1 one-time credit per person, for eligible Google, GitHub or Microsoft signups [1]
- Card required for free tier: No [1]
- Minimum spend: $5 minimum top-up, whole dollars [2]
- Billing period: None; credits are charged as used and do not expire. Browser time is billed per minute, rounded up [1]

### Prices
Cloud browser rate is $0.02 per browser-hour, which is $0.02 per hour as published (no conversion). Residential proxy and network traffic are billed separately per GB.
- Browser time (per browser-hour): $0.02 [1]
- Residential proxy (on by default): $5 per GB [1]
- Your own proxy: $0.20 per GB [1]
- Browser time (create-session page): $0.02 per hour [18]

### Other charges
- Web agent runs: Model price per 1M tokens includes a 20% fee; browser time and traffic are billed on top [1]
- Open-source library: Free; MIT licence [16]

## Tools

### MCP server
- Official MCP server: Yes, remote [5]
- Address or package: `https://api.browser-use.com/v3/mcp` [5]

### MCP tools
Documented tools of the v3 server. The docs do not state read-only hints.
| Tool | What it does | Read-only |
|---|---|---|
| `run_session` | Create a V3 session and run a task | Not stated |
| `get_session` | Poll session status and output, with step count, cost and live URL | Not stated |
| `send_task` | Send a follow-up task to an idle keep-alive session | Not stated |
| `stop_session` | Stop the task or destroy the sandbox | Not stated |
| `get_session_messages` | Get the agent's browser actions, reasoning and results | Not stated |
| `list_sessions` | List recent sessions with status and cost | Not stated |
| `list_browser_profiles` | List browser profiles for authenticated tasks | Not stated |
Source [5]

### API
API v4, base `https://api.browser-use.com/api/v4`.
| Endpoint | What it does |
|---|---|
| `POST /browsers` | Create a cloud browser; returns `id` and `cdpUrl` |
| `PATCH /browsers/{id}` | Stop a browser with `{"action":"stop"}` |
| `GET /browsers/{id}` | Get a browser session, including `recordingUrl` |
| `POST /runs` | Create an agent run |
| `GET /runs/{RUN_ID}/status` | Poll run status |
| `GET /runs/{RUN_ID}` | Fetch the full run once finished |
| `POST /sessions/{SESSION_ID}/queue` | Send a follow-up message to a session |
| `POST /profiles` | Create a browser profile |
Source [17]

### Features
- Where the browser runs: Browser Use cloud (US; separate Frankfurt deployment for EU) [11]
- Browsers: Hardened Chromium fork, stealth on by default [6]
- Max session length: 240 minutes (default 60) for a standalone browser; agent browsers have a four-hour hard timeout [18]
- Concurrent sessions: 10 on a new project; 50 after a $100 one-time top-up [12]
- Proxies: US residential proxy on by default; country selectable; custom proxies allowed on all accounts [8]
- CAPTCHA solving: Automatic, on by default; can be turned off with `solveCaptchas: false` [7]
- Session recording: Off by default; MP4 via `enableRecording: true`; live preview on `live.browser-use.com` [9]
- Persistent logins: Yes, via profiles holding cookies and local storage [13]
- Open-source library: Python library installed with `uv add browser-use`; MIT licence [16]

## Authentication

### Methods
| Method | Used for | How |
|---|---|---|
| API key header | REST API v4 and browser sessions | `X-Browser-Use-API-Key: <key>`, no Bearer prefix |
| Bearer token | Remote MCP server | `Authorization: Bearer YOUR_API_KEY` |
| x402 wallet payment | Pay per request with no account or API key | See the x402 guide |
Source [5]

### Getting access
- Who creates the account: A person; agent self-signup is off [12]
- Where to get a key: Cloud dashboard (API keys settings); keys belong to a project [12]
- Other requirements: Sign-in with Google, GitHub or Microsoft for the free credit; no card for the free credit; auto recharge needs a saved payment method [1]

## Setup

### Addresses
- REST API: `https://api.browser-use.com/api/v4` (EU: `https://api.eu.browser-use.com/api/v4`) [17]
- MCP server: `https://api.browser-use.com/v3/mcp` [5]
- OpenAPI spec: `https://docs.browser-use.com/cloud/openapi/v4.json` [19]
- Docs for agents: `https://docs.browser-use.com/llms.txt` [19]
- Status page: `https://status.browser-use.com` [20]

### Install
| What | Command |
|---|---|
| MCP server for Claude Code | `claude mcp add -t http -H "Authorization: Bearer YOUR_API_KEY" browser-use https://api.browser-use.com/v3/mcp` |
| Python SDK | `pip install --upgrade browser-use-sdk playwright` |
| TypeScript SDK (Playwright) | `npm install browser-use-sdk@latest playwright` |
| TypeScript SDK (Puppeteer) | `npm install browser-use-sdk@latest puppeteer-core` |
| Open-source library | `uv add browser-use` |
Source [4]

## Limits

### Rate limits
- Per-project request budget: Default max(25, 2 x concurrency) requests per second, capped at 100 for creates, lists, updates, deletes, event reads and full run reads [3]
- Edge limit per IP: 1,000 requests per second per public source IP for general traffic, over a 300-second window [3]

### Other limits
- Concurrency before any payment: 10 concurrent sessions [3]
- Browser idle time after a run: About 2 minutes after the last run activity [3]
- Agent browser hard timeout: 4 hours [3]
- File size limits: Not published

## Privacy

### Your data
- Data location: US by default; separate EU deployment in Frankfurt, Germany [11]
- Retention: Not stated for general use; with Zero Data Retention, save results and files within 15 minutes after completion [10]
- Used for training: The privacy policy says inputs are used to train models; ZDR page does not address training [14]
- Zero data retention: Yes, per-project setting in the US Cloud dashboard [10]

### Compliance
- Certifications: Not published
- HIPAA: Not published

## Sources

1. Pricing: https://browser-use.com/pricing
2. Billing and credits: https://docs.browser-use.com/cloud/guides/billing.md
3. Concurrency and limits: https://docs.browser-use.com/cloud/guides/concurrency.md
4. Browser Infrastructure quickstart: https://docs.browser-use.com/cloud/browser/quickstart.md
5. MCP Server: https://docs.browser-use.com/cloud/guides/mcp-server.md
6. Stealth: https://docs.browser-use.com/cloud/browser/stealth.md
7. CAPTCHA handling: https://docs.browser-use.com/cloud/browser/captcha-handling.md
8. Proxies: https://docs.browser-use.com/cloud/browser/proxies.md
9. Live preview & recording: https://docs.browser-use.com/cloud/browser/live-preview.md
10. Zero Data Retention: https://docs.browser-use.com/cloud/zero-data-retention.md
11. EU deployment: https://docs.browser-use.com/cloud/eu-deployment.md
12. Get a Browser Use API Key: https://docs.browser-use.com/cloud/agent-signup.md
13. Sync local and cloud cookies: https://docs.browser-use.com/cloud/guides/profile-sync.md
14. Privacy policy: https://browser-use.com/privacy
15. FAQ: https://docs.browser-use.com/cloud/faq.md
16. GitHub: browser-use/browser-use: https://github.com/browser-use/browser-use
17. API v4 reference: https://docs.browser-use.com/cloud/api-v4-overview.md
18. Create Browser Session: https://docs.browser-use.com/cloud/api-v4/browsers/create-browser-session.md
19. llms.txt: https://docs.browser-use.com/llms.txt
20. Status page: https://status.browser-use.com
21. Checked by supermarket.dev