To connect Browser Use to OpenCode, configure Browser Use’s local stdio server as a local MCP server, then check it with opencode mcp list. For OpenCode v2, the server belongs under mcp.servers; the command is uvx --from 'browser-use[cli]' browser-use --mcp. Use the configuration schema for your installed OpenCode release, because older documentation shows a different layout.
What Browser Use MCP does in OpenCode
Browser Use is the browser-use project, whose documentation provides a local MCP server command. It is distinct from other products and packages with similar “Browser MCP” names. OpenCode can launch a local MCP server as a command over standard input and output (stdio); once connected, its tools can be made available to the agent. OpenCode’s v2 MCP documentation describes its server configuration, and Browser Use’s integration guide documents its MCP options.
| # | Preview | Product | Price | |
|---|---|---|---|---|
| 1 |
|
Code Debug Repeat Programmer Developer Laptop Stainless Steel Insulated Water Bottle | $28.99 | Buy on Amazon |
This setup lets you ask OpenCode to use Browser Use’s browser automation tools as part of a task. It is different from simply taking a static screenshot: Browser Use is intended for browser tasks, while a screenshot API is for returning an image or PDF of a page.
Check your OpenCode configuration format
First confirm which OpenCode release and configuration schema you are using. The v2 documentation places named servers under mcp.servers. Older OpenCode guides show a flatter mcp structure, so do not combine the v2 example below with an older schema. Consult the documentation for the version installed in your environment if its configuration differs. OpenCode v2 MCP server documentation
Quick wins for a faster PC:
Clear out junk files and repair common Windows errorsFree Scan →Scan for outdated or missing drivers - takes under a minuteDriver Scan →#1 Best Overall
- Dual-wall insulated stainless steel construction keeps beverages hot or cold, dishwasher safe and BPA free
- Leak-proof flip lid includes BPA free plastic drinking straw
The example below is JSON-compatible configuration for OpenCode v2. It combines the local-server schema documented by OpenCode with Browser Use’s documented launch command; it is not presented as a single vendor-published recipe.
Configure the local Browser Use MCP server
-
Make sure the OpenCode process can find
uvx. Browser Use’s repository manifest listsbrowser-usefrom PyPI and indicatesuvxas its runtime hint. The invocation uses an unpinned package specification, so it can select a changing package release over time. Browser Use server manifest -
Add a named local server to the OpenCode v2 configuration used by your installation:
{ "$schema": "https://opencode.ai/config.json", "mcp": { "servers": { "browser-use": { "type": "local", "command": [ "uvx", "--from", "browser-use[cli]", "browser-use", "--mcp" ] } } } }The array elements are the executable and its arguments. The command corresponds to Browser Use’s documented local invocation,
uvx --from 'browser-use[cli]' browser-use --mcp; the quotes around the package name in the shell form keep the brackets together. OpenCode’s local server configuration uses a command array. OpenCode MCP server schema · Browser Use local MCP commandSpecial offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy. -
Save the configuration and start or refresh OpenCode as appropriate for your installation. The exact config-file location and reload behavior depend on the OpenCode release and setup; use that release’s documentation rather than copying a path from a different version.
-
In a terminal where the OpenCode command is available, run:
opencode mcp listLook for
browser-useand confirm that its status is connected. OpenCode documents this command for checking configured MCP server status. OpenCode MCP server documentation
Try a low-risk browser task
After the server reports connected, give OpenCode a simple request that does not require logging in or changing anything on a site. For example:
Use Browser Use to open https://example.com and tell me the page title and the main visible heading. Do not submit forms or click links.
This is a suggested verification task, not a claim that a particular environment was tested. It is useful because it asks for a small, observable result without requesting an account action or other state change. Browser Use documents browser automation tasks, and OpenCode says connected MCP tools become available to the agent. Browser Use integrations · OpenCode MCP servers
If OpenCode does not use the browser tool, ask it explicitly to use the Browser Use MCP tools and check whether opencode mcp list still reports the server connected. A connected status establishes that the MCP server is available to OpenCode; it does not by itself prove that a specific website task will succeed.
Choose local or cloud Browser Use MCP
Browser Use also documents a cloud MCP endpoint at https://api.browser-use.com/mcp. Its integration guide describes authentication using an x-browser-use-api-key header and lists tools including browser_task, execute_skill, and task monitoring. The local and cloud routes differ in where the MCP service runs and how the documented connection is authenticated. Browser Use MCP integration guide
Recommended Free Tools
| Decision point | Local command | Cloud endpoint |
|---|---|---|
| Where it runs | A local process launched by OpenCode over stdio, using Browser Use’s uvx command. OpenCode docs · Browser Use guide |
At the documented Browser Use endpoint https://api.browser-use.com/mcp. Browser Use guide |
| Connection and credentials | OpenCode runs the configured command; the documented local invocation does not specify a cloud API-key header. OpenCode docs · Browser Use guide | The guide documents the x-browser-use-api-key header. Current account requirements are not stated in the cited integration guide. Browser Use guide |
| Runtime details | The documented command uses uvx and the browser-use[cli] package. Browser Use guide |
Not stated in the cited integration guide. Browser Use guide |
| Browser profile and data handling | Not stated in the cited setup material. Browser Use guide | Not stated in the cited setup material. Browser Use guide |
| Current price | Not stated in the cited setup material. Browser Use guide | Not stated in the cited setup material. Browser Use guide |
| Documented tool examples | Browser automation tools are documented; the integration guide should be checked for the current tool surface. Browser Use guide | The guide lists browser_task, execute_skill, and task-monitoring tools. Browser Use guide |
The available setup documentation does not establish a complete current cost, privacy, profile, or account comparison. Check Browser Use’s current service terms and integration instructions before choosing the cloud route, especially if the page content or credentials are sensitive. Choose local when you want OpenCode to launch the documented local command; consider cloud when you specifically need the hosted endpoint and its documented task tools.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Troubleshoot a server that will not connect
-
browser-useis missing from the status list: Confirm that the configuration was saved in the location read by the running OpenCode installation and that it uses that release’s schema. For v2, the documented nesting ismcp.servers. Then rerunopencode mcp list. OpenCode MCP documentation -
OpenCode cannot start the command: Check whether
uvxis installed and available on the PATH inherited by the OpenCode process, not only in a separate interactive terminal. Verify that your Python/uv tooling is installed and functioning. These are troubleshooting checks inferred from the documented command, not a report of a reproduced error. Browser Use local command -
The package or command fails to resolve: Compare the configured argument array with Browser Use’s current invocation:
uvx --from 'browser-use[cli]' browser-use --mcp. The package specification is unpinned, so consult the current integration guide and package release information if the command’s behavior has changed. Browser Use integration guide · Browser Use manifestSpecial offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy. -
It connects but does not respond to a browser request: First retry with a public page and an instruction to use the Browser Use MCP tools. Separate connection status from task outcome: the list command checks the server connection, while the task also depends on the requested page and operation.
-
An older guide’s JSON does not work: Do not transplant its flatter MCP object into the v2 example. Follow the official documentation matching your installed OpenCode version. OpenCode v2 documentation
-
You see
--cli-mcpin an example: Do not substitute it for--mcpby assumption. Browser Use’s CLI source distinguishes the two modes; use the intended interface and tool surface for your installed version. Browser Use CLI source
Or skip the browser setup
If your goal is a clean static screenshot or PDF rather than interactive browser automation, ScreenshotNeo is a separate option: a website screenshot API and MCP server for developers. Its one-call API is not a Browser Use MCP configuration and does not replace a browser task. ScreenshotNeo says it accepts cookie/consent banners as a visitor and removes 60+ known consent platforms, newsletter popups, and chat widgets before capture; each cleanup step can be turned off. It also reports page verdict and billing status in response headers: bot checks/CAPTCHAs, blank pages, timeouts, failed loads, and cache hits cost nothing. Its MCP server provides take_screenshot, get_page_info, and capture_pdf.
The Tool Desk
Outbyte Driver Updater FREEScan for outdated or missing drivers - takes under a minuteDriver Scan →Outbyte PC Repair FREEClear out junk files and repair common Windows errorsFree Scan →For a one-request screenshot, create an API key and replace YOUR_API_KEY with it. This cURL example requests a WebP capture of Stripe:
curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://stripe.com -o shot.webp
See the ScreenshotNeo API documentation for request options. It also supports PNG or JPEG, PDF output, full-page or selector captures, viewport/device settings, custom CSS and JavaScript, waits, request blocking, caching, signed links, async jobs, bulk capture, and other capture controls.
Cookie banners, popups, and chat widgets are removed before the shot; bot checks, blank pages, and failed loads are never billed; an MCP server lets AI agents take screenshots; and 1,000 screenshots per month are free with no card, with paid plans starting at $5 for 3,000. Learn about ScreenshotNeo or sign up for 1,000 free screenshots a month with no card.
Keep the configuration version-aware
OpenCode and Browser Use documentation and package details can change. The Browser Use manifest has displayed version 0.13.5, but that manifest value is not a guarantee of the latest release; the local command here intentionally follows the unpinned invocation in the integration guide. Check the linked OpenCode schema and Browser Use instructions again when upgrading either tool or debugging a setup that previously worked. Browser Use manifest · Browser Use integrations
Free tools Windows power users keep installed
One-click scans. No signup required.
Frequently Asked Questions
Will opencode mcp list tell me whether a particular website task succeeded?
No. It checks the configured MCP server connection; a site-specific task has its own outcome.
Can I treat the cloud endpoint’s listed tools as identical to the local tool surface?
The cited integration guide lists cloud tools, but does not establish that the local and cloud tool surfaces are identical. Check the current guide for the route you choose.
Quick Recap
Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

