# How to connect the Browserless MCP server

To connect the official Browserless MCP server, add https://mcp.browserless.io/mcp to your MCP client as a Streamable HTTP server, then sign in with OAuth when your client prompts you. If your client can't use OAuth, use your API token. Browserless documents setup for Claude Code, Claude, Cursor, VS Code, Windsurf, Codex and ChatGPT.

- Endpoint: https://mcp.browserless.io/mcp
- Transport: Streamable HTTP
- Registry: io.browserless/mcp 1.44.0
- Publisher documentation reviewed: 2026-11-05 (not a tested connection)
- Guide page: https://apitracker.io/mcp-guides/browserless-mcp

## Before you start

- A Browserless account, used for OAuth sign-in or to copy an API token from the account dashboard.
- Each tool call consumes Browserless units based on session time, plus proxy traffic and CAPTCHA solving if used.
- The hosted server uses the US West (San Francisco) Browserless region by default. London and Amsterdam endpoints are selected with the x-browserless-api-url header.
- On Claude Team and Enterprise plans an Owner adds the connector for the organization. ChatGPT custom MCP servers are limited to Business and Enterprise or Edu workspaces, and on Business only admins and owners can add them.

## Steps

1. **Open Browserless's MCP setup instructions for your client** <https://docs.browserless.io/mcp/browserless-mcp-server/setup>
2. **Add the Browserless MCP server to your client** Add https://mcp.browserless.io/mcp as a remote MCP server that uses the Streamable HTTP transport. The hosted server does not support the legacy SSE transport. Cursor users can install the Browserless plugin from the Cursor Marketplace instead.
3. **Sign in with your Browserless account**
4. **If your client can't use OAuth, use your API token** Copy your API token from the Browserless account dashboard and send it in the Authorization header as a bearer token. For clients that only accept a URL, Browserless also accepts the token in a token query parameter; avoid this where a header is possible, because URLs are easily shared or logged.
5. **Only for the token alternative: Authorization**
6. **Optional: regional Browserless endpoint**
7. **List the server's tools**

## Questions

### What is the Browserless MCP server URL?

The official Browserless MCP server is at https://mcp.browserless.io/mcp and uses the Streamable HTTP transport.

### How do I authenticate with the Browserless MCP server?

Sign in with OAuth when your client prompts you. If your client can't use OAuth, use your API token: Copy your API token from the Browserless account dashboard and send it in the Authorization header as a bearer token. For clients that only accept a URL, Browserless also accepts the token in a token query parameter; avoid this where a header is possible, because URLs are easily shared or logged.

### Which AI clients can use the Browserless MCP server?

Browserless's documentation covers Claude Code, Claude, Cursor, VS Code, Windsurf, Codex and ChatGPT. Other clients that support remote Streamable HTTP MCP servers may also work.

### What do I need before connecting Browserless MCP?

A Browserless account, used for OAuth sign-in or to copy an API token from the account dashboard. Each tool call consumes Browserless units based on session time, plus proxy traffic and CAPTCHA solving if used. The hosted server uses the US West (San Francisco) Browserless region by default. London and Amsterdam endpoints are selected with the x-browserless-api-url header. On Claude Team and Enterprise plans an Owner adds the connector for the organization. ChatGPT custom MCP servers are limited to Business and Enterprise or Edu workspaces, and on Business only admins and owners can add them.

### Has this Browserless MCP guide been tested?

Browserless's documentation was reviewed on 2026-11-05. It is not a tested connection; your account and permissions decide which tools work.

## Sources

- https://docs.browserless.io/mcp/browserless-mcp-server/setup (checked 2026-11-05)
- https://docs.browserless.io/mcp/clients/claude (checked 2026-11-05)
- https://docs.browserless.io/mcp/clients/cursor (checked 2026-11-05)
- https://registry.modelcontextprotocol.io/v0.1/servers/io.browserless%2Fmcp/versions/1.44.0 (checked 2026-11-05)
- https://modelcontextprotocol.io/specification/2026-07-28/basic/authorization (checked 2026-11-05)

Guide JSON: https://github.com/apideck-libraries/mcp-connect/blob/626f6a146170ded34891b30dca3af26f09e07466/proposals/connection-guide/0.1/reviewed/guides/browserless-mcp.json