Browserbase MCP Server

Official

Cloud browsers for AI agents — automation sessions that run in Browserbase's fleet, not on your machine.

Local + remotestdiostreamable-httpTypeScriptApache-2.0 2.9k

What is the Browserbase MCP server?

Browserbase answers the question every local browser automation setup eventually raises: where should these browsers actually run? Its MCP server hands your assistant a browser session hosted in Browserbase's cloud fleet — with stealth options, proxies, and session recordings — while your own machine does nothing but relay commands.

The practical wins are real. Local browser automation ties up your laptop, breaks in CI without a display stack, and gets blocked by sites that fingerprint obvious headless Chromium. Cloud sessions sidestep all three: they scale horizontally, come with residential proxy options for sites that geo-gate or rate-limit, and every session leaves a replay you can watch to debug what the agent actually did.

Under the hood the server pairs with Stagehand, Browserbase's AI-native automation layer, so the model can act on pages using natural-language instructions ("click the pricing toggle") rather than brittle selectors. For extraction work you describe the data you want and get structured output back.

It's a paid service with a free tier, and that's the honest trade-off versus the Playwright server: you're exchanging money for reliability at scale, anti-bot resilience and zero local setup. For an occasional scrape, run Playwright locally. For an agent that browses hundreds of pages a day as part of a product, cloud sessions are usually the difference between a demo and something you can ship.

Cost and session hygiene

  • Sessions bill for wall-clock time, so close them explicitly with browserbase_session_close rather than waiting for the idle timeout. An agent that forgets is an agent that runs a browser all night.
  • Reuse a single session across a multi-page task instead of creating one per URL — cookies, auth state and warm connections all carry across navigations.
  • Reach for browserbase_act when the page is unfamiliar and plain selectors when it isn't; each natural-language action costs an extra model round trip through Stagehand.
  • Stealth mode and proxies are per-session settings, not account-wide, so enable them for the scrapes that need them and leave them off for internal dashboards where they only add latency.

What you can do with it

Agent browsing at scale

Products whose agents visit many pages per day, where local browsers would be a bottleneck or a liability.

Scraping bot-protected sites

Stealth mode and proxy support get through defences that instantly flag vanilla headless Chromium.

Auditable automation

Every session is recorded, so you can replay exactly what the agent clicked when something goes wrong.

Available tools

ToolWhat it does
browserbase_session_createStart a fresh cloud browser session
browserbase_navigateNavigate the session to a URL
browserbase_actPerform an action described in natural language ('click Sign in')
browserbase_extractExtract structured data from the current page
browserbase_screenshotCapture a screenshot of the cloud session
browserbase_session_closeEnd the session and stop billing for it

How to install the Browserbase MCP server

{
  "mcpServers": {
    "browserbase": {
      "command": "npx",
      "args": ["-y", "@browserbasehq/mcp"],
      "env": {
        "BROWSERBASE_API_KEY": "your-api-key",
        "BROWSERBASE_PROJECT_ID": "your-project-id"
      }
    }
  }
}

Configuration

A Browserbase account (free tier available). Node.js 18+ for the local connector.

VariableDescriptionRequired
BROWSERBASE_API_KEYAPI key from the Browserbase dashboarde.g. bb_live_...Yes
BROWSERBASE_PROJECT_IDProject ID the sessions bill againstYes

Example prompts to try

  • Start a cloud browser session, open competitor.com/pricing, and extract their plan names and prices as a table.
  • Browse to this listing page, paginate through all results, and collect every product name and price.
  • Open the session replay-friendly checkout flow on staging and tell me where it breaks.

Frequently asked questions

The browser runs in Browserbase's cloud instead of on your machine — you get scale, session recordings, stealth fingerprinting and proxies, at the cost of a paid subscription. Local Playwright is free and fine for light use; Browserbase is built for production agent workloads.