# mcp-server-browserbase

**Author**: browserbase  
**Description**: MCP server that lets LLMs control cloud browsers through Browserbase & Stagehand (web automation, screenshots, data-extraction, multi-session).  
**Stars**: 2.3k  
**Forks**: 241  
**License**: Apache License 2.0  
**Category**: Specialized

[GitHub](https://github.com/browserbase/mcp-server-browserbase) [Website](https://stagehand.dev/) [NPM](https://www.npmjs.com/package/mcp-server-browserbase)

## Overview

# Supercharge Augment Code with Browser Automation

Transform Augment Code from a coding assistant into a full-stack development powerhouse by adding the Browserbase MCP server. Now your AI can actually **see and interact with live web applications**, automating everything from testing workflows to data extraction—all while you code.

## Beyond Code Generation: Live Web Interaction

With this MCP server, Augment Code can launch cloud browsers, navigate websites, fill forms, click buttons, and capture screenshots. Imagine asking Augment to "test my login flow on staging" and watching it actually navigate through your app, or having it extract competitor pricing data while you implement new features. This isn't just code assistance—it's having an AI teammate that can interact with the web like a human developer would.

The integration is seamless through Augment's MCP configuration. Simply add your Browserbase credentials, and suddenly Augment can orchestrate complex browser automation tasks using natural language. It can run multiple browser sessions in parallel, perfect for testing cross-browser compatibility or running simultaneous workflows. The AI can even analyze screenshots using vision capabilities to handle complex DOM interactions that would normally require precise selectors.

## Real Developer Superpowers

**End-to-End Testing**: Ask Augment to "test the checkout flow and screenshot any errors"—it will navigate your app, fill forms, and document issues automatically.  
**Data Extraction**: "Scrape the top 50 GitHub repos for this technology and create a comparison table" becomes a single request.  
**UI Debugging**: Upload a screenshot of a broken layout and ask Augment to navigate to that page and investigate the DOM structure.  
**Competitive Analysis**: Have Augment systematically analyze competitor features while you focus on implementation.

The setup takes minutes: add the server to your `settings.json`, provide your Browserbase API key, and you're ready to give Augment browser superpowers. It's the difference between an AI that can only read code and one that can actually interact with the web applications you're building.

## Installation

1. **Prerequisites**  
   • Node.js ≥ 18 (LTS recommended)  
   • A Browserbase cloud account (https://browserbase.com) – obtain your BROWSERBASE_API_KEY  
   • A Stagehand account (https://stagehand.dev) – obtain your STAGEHAND_API_KEY

2. **Clone the repository**  
   `git clone https://github.com/browserbase/mcp-server-browserbase.git`  
   `cd mcp-server-browserbase`

3. **Install dependencies**  
   ```  
   # Choose your package manager  
   npm install        # or  
   pnpm install       # or  
   yarn install       
   ```

4. **Configure environment variables (create .env in project root)**  
   ```  
   BROWSERBASE_API_KEY=YOUR_BROWSERBASE_KEY  
   STAGEHAND_API_KEY=YOUR_STAGEHAND_KEY  
   PORT=8080               # Optional: server port  
   ```

5. **Build (if you want a production bundle)**  
   `npm run build`  
   # transpiles TypeScript -> JS in ./dist

6. **Run the MCP server**  
   ```  
   # Development (auto-reload with ts-node-dev)  
   npm run dev  
   # Production  
   npm start               # uses compiled output  
   ```

7. **Optional Docker deployment**  
   ```  
   docker build -t mcp-browserbase .  
   docker run -e BROWSERBASE_API_KEY=... -e STAGEHAND_API_KEY=... -p 8080:8080 mcp-browserbase  
   ```  
   After start-up, the server exposes the Model Context Protocol (MCP) HTTP interface on /v1/tool-endpoint (default port 8080).

**License**: Apache License 2.0  
**Updated**: 7/30/2025

### Table of Contents