Quickstart
Install the server, connect your client, and ask your agent to use a browser.
Install uv
The commands below launch BrowserControl with uv, which downloads it on first use. Check that uv is on your PATH:
uv --versionIf you would rather install with pip, see Installation.
Add BrowserControl to your client
›/plugin marketplace add adityasasidhar/browsercontrol›/plugin install browsercontrol@browsercontrolInstalls the MCP server and the agent skill together.
For Claude Code, the plugin is the quickest route: it adds the MCP server and the agent skill together. Restart Claude Code or run /reload-plugins afterwards. For every other client, see Connect a client.
Ask for something
Reload your client, then try:
Open Hacker News with BrowserControl and tell me the top story.
The first launch can take a minute: BrowserControl reuses a Chromium or Chrome it finds, and otherwise downloads Chromium once.
What just happened
- The agent called
navigate_to("https://news.ycombinator.com"). - BrowserControl loaded the page, waited for it to settle, and returned a screenshot with every link and button numbered, plus the same numbers as text.
- The agent read the top story from the screenshot or the text, and, if it needed more, called something like
click(12)orget_page_content().
The browser opens a visible window by default. To hide it, set BROWSER_HEADLESS=true in your client's MCP config. See Configuration.
Not working?
If your client doesn't list BrowserControl's tools, check its MCP logs, then see Troubleshooting.
