home / mcp / browserbase mcp server

Browserbase MCP Server

Provides Browserbase data access and actions to MCP clients via HTTP/SSE or STDIO transports.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "ampcome-mcps-browserbase-mcp": {
      "url": "http://localhost:8931/sse"
    }
  }
}

This MCP server enables you to connect an LLM workflow to the Browserbase data and actions, letting you search and interact with Browserbase within your AI applications. It provides both a local, self-hosted option and a remote, hosted server to suit your deployment needs.

How to use

You integrate the Browserbase MCP server into your client by configuring your MCP setup to include the browserbase server as a provider. Once active, your LLM-powered applications can issue queries and actions that leverage Browserbase context, cookies, and persistence to enhance search and browsing tasks. You can run the server locally for development or point to a hosted MCP server for production workloads. Key capabilities include Contexts for persistence, Cookie Management, and Browser session tools that expose Browserbase functionality to your LLM.

To use the server in your workflow, add the Browserbase MCP server to your MCP configuration as either a local, stdio-based server or a remote HTTP/SSE endpoint. Then reload your MCP client so your application can start issuing Browserbase-enabled actions.

How to install

Prerequisites: ensure you have Node.js installed on your system. You will also need a Browserbase API key and project ID if you are using the hosted options.

Choose one of the following installation methods depending on whether you want a quick, hosted setup or a fully local environment.

Option A: Run via NPM (recommended for quick start) create or edit your MCP config to include the Browserbase server using npx

{
  "mcpServers": {
    "browserbase": {
      "command": "npx",
      "args" : ["@browserbasehq/mcp"],
      "env": {
        "BROWSERBASE_API_KEY": "",
        "BROWSERBASE_PROJECT_ID": ""
      }
    }
  }
}

Option B: Run 100% locally

Clone the Browserbase MCP server repository, install dependencies, and build the project. Then configure and run the server either via STDIO or via SSE.

# Clone the Repo 
git clone https://github.com/browserbase/mcp-server-browserbase.git

# Install dependencies and build
cd browserbase
npm install && npm run build

Available tools

browserbase_context_create

Creates a new Browserbase context, optionally with a friendly name.

browserbase_session_create

Creates a new session and optionally associates it with a context, with options to persist changes back to the context.

browserbase_context_delete

Deletes a Browserbase context when it is no longer needed.

browserbase_cookies_add

Adds cookies to the current browser session with full control over properties.

browserbase_cookies_get

Retrieves all cookies in the current session, with optional URL filtering.

browserbase_cookies_delete

Deletes specific cookies or clears all cookies from the session.