browserlol
Browser.lol MCP server
A real cloud browser for your AI agent. Connect Claude, ChatGPT, Cursor or any other MCP client to Browser.lol, and your agent opens pages, clicks, types and reads them in an isolated session on our servers. You watch live and take over whenever you want.
This repository holds no code. The server is hosted by Browser.lol: you add one address to your client and sign in.
What your agent gets
A real browser in the cloud. Each session runs in its own container. Nothing to install, no browser driver on your machine.
Input like a person. Every click, keystroke and scroll is real mouse and keyboard input with human timing.
A live view link. Your agent shares a link to the session. Open it to watch, take over at any time and hand control back. For a login or a captcha, your agent asks you to step in.
Apps. Your agent installs what a session needs: Anonymous Mail for sign-ups and verification codes, Files for uploads and downloads, Agent DevTools for web development and debugging.
Sessions in other countries. Start a session with an exit location in another country, a residential address or your own proxy, and with its own language and keyboard layout.
Saved profiles. Continue a saved profile with its logins and settings, or keep a session as a new one.
Available browser images and exit locations depend on your account.
Related MCP server: Cloudflare Playwright MCP
Quick start
Endpoint |
|
Transport | Streamable HTTP |
Authentication | OAuth sign-in in your browser, or an API key in a header |
OAuth discovery |
|
Plan | Premium (plans) |
Add
https://api.browser.lol/mcpto your client (see below).Sign in on the Browser.lol page that opens and allow access.
Give your agent a task, for example: Open example.com in a Browser.lol session and tell me what the page says.
Clients without sign-in and your own code use an API key instead: Authorization: Bearer YOUR_ACCESS_KEY or x-api-key: YOUR_ACCESS_KEY. Create one on the AI agents page under Advanced. Keys in the URL are not accepted.
Setup per client
Guides for more clients (Gemini CLI, GitHub Copilot CLI, Zed, Kiro, LM Studio, n8n and others) are in the MCP docs.
Open Customize › Connectors › + Add › Add custom connector. Enter the name browserlol and this URL, then click Continue and sign in on the Browser.lol page that opens.
https://api.browser.lol/mcpOn Team and Enterprise plans, an owner first adds the connector under Organization settings › Connectors.
claude mcp add --scope user --transport http browserlol https://api.browser.lol/mcpThen type /mcp in Claude Code, choose browserlol and sign in.
Turn on Developer mode under Settings › Security and login. Then add an app with + under Plugins: name it browserlol, paste this URL and choose OAuth.
https://api.browser.lol/mcpcodex mcp add browserlol --url https://api.browser.lol/mcp
codex mcp login browserlolAdd this to ~/.cursor/mcp.json, then click Connect next to browserlol under Settings › Tools & MCP.
{
"mcpServers": {
"browserlol": {
"url": "https://api.browser.lol/mcp"
}
}
}Run MCP: Open User Configuration in the Command Palette and add this. VS Code asks you to trust the server and then to sign in.
{
"servers": {
"browserlol": {
"type": "http",
"url": "https://api.browser.lol/mcp"
}
}
}devin mcp add --scope user browserlol https://api.browser.lol/mcp
devin mcp login browserlolIn the Cline panel, open MCP Servers › Configure › Configure MCP Servers and add this. Then start the OAuth sign-in for browserlol from the server list.
{
"mcpServers": {
"browserlol": {
"type": "streamableHttp",
"url": "https://api.browser.lol/mcp"
}
}
}Open Settings › Tools › AI Assistant › Model Context Protocol (MCP) › Add and paste this.
{
"mcpServers": {
"browserlol": {
"url": "https://api.browser.lol/mcp",
"headers": {
"Authorization": "Bearer YOUR_ACCESS_KEY"
}
}
}
}{
"mcpServers": {
"browserlol": {
"type": "http",
"url": "https://api.browser.lol/mcp",
"headers": {
"Authorization": "Bearer YOUR_ACCESS_KEY"
}
}
}
}Tools
27 tools. The developer tools work once the session has the Agent DevTools app, which your agent installs itself with browser_apps.
Tool | What it does |
| Open a site through the address bar, search, go back or forward, or reload. Starts a session when none runs. |
| List, open, switch to or close tabs. |
| Read the page as a tree of elements with references, dialogs first. |
| Find elements by their text without reading the whole page. |
| See the whole screen as the live view shows it, toolbar included. |
| Wait until text appears or is gone, the URL matches, or a time has passed. |
| Click an element or a screen point. The pointer moves there like a hand. |
| Type into a field like a person. |
| Fill several fields one after another. |
| Choose an option in a dropdown. |
| Press a key or shortcut, or answer a JavaScript dialog. |
| Turn the mouse wheel over the page or until an element is in view. |
| Move the pointer over an element to open menus and tooltips. |
| Drag and drop: lists, sliders, canvas. |
| Attach files through a file input. |
| List the session's downloads with a link to fetch each file. |
| Hand the browser to the person watching for a login or a captcha. |
| Start a session with a browser image, exit location, screen size, language or keyboard layout. |
| List your sessions with quota and recent usage, also those you started yourself. |
| Rename a session or change its exit location. |
| List, install and uninstall a session's apps. |
| Close a session when the work is done. |
| Read your plan features, browser images, saved profiles, quota and usage. |
| Your temporary mail inbox for sign-ups: address, incoming mail, links and codes. |
| Read what DevTools shows: DOM, styles, network, cookies, storage, console. For web development and debugging. |
| Run JavaScript in the page like the DevTools console. For web development and debugging. |
| Send Chrome DevTools Protocol commands and read their events. For web development and debugging. |
Plans
The MCP server is included with Browser.lol Premium. See the plans for pricing.
How sessions work
A page tool starts a session when none is running. With several sessions, your agent names the one to use.
Your agent can use the sessions you start yourself, and you can watch and manage the ones it starts.
Sessions end after their plan's idle or maximum runtime. Your agent closes its session when the work is done.
While you are in control, your agent pauses. It continues once you hand control back.
Security and privacy
A connected agent or API key acts on your account like a password. Disconnect an agent or revoke a key on the AI agents page as soon as you no longer use it.
Give each client or machine its own API key, so you can revoke access separately.
Pages load in isolated browser containers on our servers. Your agent's model stays with its client.
Privacy policy · Terms · Acceptable use · Subprocessors · Imprint
Support
Docs: browser.lol/en/docs/mcp. Questions and problems: support@browser.lol.
License
The documentation in this repository is licensed under the MIT License. The Browser.lol service is subject to its terms.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Give AI agents a real cloud Chrome: open sessions, navigate, read pages, click, type and screenshot.
Cloud browsers for AI agents: saved logins, residential IPs, live human takeover, 57 browser tools.
Cloud browser, web extraction, screenshots, and remote CDP tools for AI agents.
Let your AI agent operate any website through a real, logged-in browser session.
Related MCP Servers
- AlicenseAqualityCmaintenanceEnables AI agents to fully control a browser for web automation, including navigation, clicking, typing, scrolling, screenshots, and DOM inspection, with session persistence and anti-bot bypass.4036 npmMIT
- AlicenseNot gradedqualityNot gradedmaintenanceEnables AI assistants to control a browser through tools for navigation, typing, clicking, and taking screenshots to perform web automation tasks.Apache 2.0
- AlicenseAqualityBmaintenanceEnables AI agents to open, read, and act on live web pages through verified browser actions, including filling forms, extracting data, debugging pages, and handling bot walls.112MIT
- AlicenseNot gradedqualityCmaintenanceGives ChatGPT, Claude and other AI assistants a real Chrome browser running in the cloud, so they can navigate, read page content, click, type, run scripts and take screenshots, with saved sessions, live viewing or takeover via remote desktop, and CAPTCHA detection.MIT