# browser-use — MCP server card for AI agents

Browser agents and stealth cloud browsers for AI: run web tasks, fill forms, extract data.

Registry name: `com.browser-use/browser-use` · category: Browser and web scraping · version 0.13.11 · updated 2026-10-21

## Connect
- PyPI (stdio): `uvx browser-use`
- Remote (Claude Code): `claude mcp add --transport http browser-use https://api.browser-use.com/v3/mcp`

## Facts
- Repository: https://github.com/browser-use/browser-use (121,364 stars)
- Website: https://browser-use.com
- Configured in 3 public repos set up for AI coding agents (AgentGid scan)

Before you connect a server: read its repository, and give it only the permissions and keys it needs.

## Links
- AgentGid page: https://agentgid.com/mcp/servers/com-browser-use-browser-use/


## Browser Use: your AI assistant works in a real browser

Browser Use lets an AI assistant such as Claude Code or Cursor open web pages, click, type and read them in a real browser. You can run it free on your own computer, where it can use your own Chrome with your logins. Or you can pay for Browser Use's cloud, which runs whole web tasks and returns the result.

### Where to use it
- Hand off a whole web task: Tell your assistant to send a task like "find the cheapest flight on these dates" to a cloud browser. It checks back for the result and the cost.
- Pull data into a fixed shape: Ask for prices, opening hours or a list of products from a site and get them back as a table your app can store.
- Fill in a long web form: Let the assistant type your answers into a form on a site, page by page. You check the last page before anything is sent.
- Work in sites you are signed in to: On your own computer it can drive the Chrome you already use, so it reaches your dashboards without a new login.
- Check your own site after a change: After a new release, have the assistant open your sign-up page, fill it with test data and send you a screenshot of each step. (idea, not from the official pages)
- Compare offers across a few shops: Ask it to open three shops, find the same product and write down price and delivery time side by side. (idea, not from the official pages)

### How to start
- Get a Browser Use API key in the cloud dashboard (cloud server only).
- Add the cloud server to Claude Code with your key in the header.

```
claude mcp add -t http -H "Authorization: Bearer YOUR_API_KEY" browser-use https://api.browser-use.com/v3/mcp
```

- Or run it free on your computer with uv; it starts its own Chromium.

```
claude mcp add browser-use -- uvx --from 'browser-use[cli]' browser-use --mcp
```


### License
The code is free under the MIT license, also for paid products. The cloud browsers and the hosted agent are a paid service with its own terms.

### Good to know
- The local browser_exec tool runs any Python your assistant writes, as your user. It can read the server's files and settings, so treat it like a terminal.
- With --cli-mcp it drives your own Chrome with all your logins. Anything you can do on a site, it can do too.
- Version 1.0 removed the old tools such as browser_navigate and browser_click. The docs page for the local server still lists them.
- Cloud browsers cost $0.02 per hour, and traffic through home internet addresses costs $5 per gigabyte. New sign-ups get $1 once.
- Cloud browsers solve website puzzle checks (CAPTCHAs) on their own by default. Respect each site's rules, and switch the solver off where it should not run.

Checked 2026-11-10 against: https://github.com/browser-use/browser-use/blob/070be98109c03f04a95f704533e8f6e9868d0525/README.md, https://github.com/browser-use/browser-use/blob/070be98109c03f04a95f704533e8f6e9868d0525/server.json, https://github.com/browser-use/browser-use/blob/070be98109c03f04a95f704533e8f6e9868d0525/CLOUD.md, https://github.com/browser-use/browser-use/blob/070be98109c03f04a95f704533e8f6e9868d0525/MIGRATING.md, https://github.com/browser-use/browser-use/blob/070be98109c03f04a95f704533e8f6e9868d0525/LICENSE, https://github.com/browser-use/browser-use/blob/070be98109c03f04a95f704533e8f6e9868d0525/pyproject.toml, https://github.com/browser-use/browser-use/blob/070be98109c03f04a95f704533e8f6e9868d0525/browser_use/mcp/cli_mcp.py, https://github.com/browser-use/browser-use/blob/070be98109c03f04a95f704533e8f6e9868d0525/browser_use/mcp/__main__.py, https://github.com/browser-use/browser-use/blob/070be98109c03f04a95f704533e8f6e9868d0525/browser_use/telemetry/service.py, https://docs.browser-use.com/cloud/guides/mcp-server.md, https://docs.browser-use.com/open-source/customize/integrations/mcp-server.md, https://docs.browser-use.com/llms.txt, https://browser-use.com/pricing, https://pypi.org/pypi/browser-use/json, https://api.browser-use.com/v3/mcp

### Mistakes to avoid
- Don't: Call browser_navigate, browser_click or browser_get_state (the 0.x tools the local docs page still lists) → Do: Use browser_exec with helpers like new_tab(url) and page_info(), and browser_screenshot (browser-use 1.0 removed the old tools; they now return an error.)
- Don't: pip install browser-use (or browser-use>=1.0) with no exact pin → Do: pip install 'browser-use==1.0.0', and upgrade on purpose after reading the release notes (The project says releases move fast and can break things.)
- Don't: Paste the API key into the MCP config that you commit to git → Do: Keep the key in an environment variable or a local config file outside the repository (The key pays for browsers and models.)
- Don't: Use --cli-mcp on a shared machine or for an untrusted task → Do: Use --mcp (its own Chromium on a temp profile) in a container, or a cloud browser (--cli-mcp drives your own Chrome with your logins, and site limits are a guard, not a sandbox.)
- Don't: Expect a cloud browser started from the local server to keep running after the session → Do: Pass timeout=<minutes> (up to 240) to start_remote_daemon if a task needs longer than 30 minutes (The server starts cloud browsers with a 30-minute life and stops them when it exits.)

### Questions
- Is it free? The code and the local server are free under MIT. The cloud browsers, the hosted agent and model calls are paid by use.
- Can I stop it from visiting certain sites? The library has allowed and blocked site lists, but the docs call them a guard, not a sandbox. Run untrusted tasks in a container.
- What does the cloud server do differently from the local one? The cloud server runs whole tasks on Browser Use's machines and reports back. The local one gives your assistant direct control of a browser on your computer.
- Does the local server send anything to Browser Use? It sends anonymous usage events, one per tool call, without task text or page content. ANONYMIZED_TELEMETRY=false turns this off.

---
AgentGid's catalog is curated: every entry was checked against the maker's official pages (registry, repository, license and pricing pages) on the date shown; a license value shows the quote it stands on wherever AgentGid has one. Usage numbers come from AgentGid's own scan of public repositories set up for AI coding agents. Claims by makers are reported, not tested by AgentGid.
