mcp server browserbase

Local 2025-08-31 23:17:18 0

Browser Automation @browserbase/mcp-server-browserbase

This server provides cloud browser automation capabilities using Browserbase, Puppeteer, and Stagehand. This server enables LLMs to interact with web pages, take screenshots, and execute JavaScript in a cloud browser environment.

cover

Get Started

Run npm install to install the necessary dependencies, then run npm run build to get dist/index.js.
Set up your Claude Desktop configuration to use the server.

{
  "mcpServers": {
    "browserbase": {
      "command": "node",
      "args": ["path/to/mcp-server-browserbase/browserbase/dist/index.js"],
      "env": {
        "BROWSERBASE_API_KEY": "<YOUR_BROWSERBASE_API_KEY>",
        "BROWSERBASE_PROJECT_ID": "<YOUR_BROWSERBASE_PROJECT_ID>"
      }
    }
  }
}

Restart your Claude Desktop app and you should see the tools available clicking the ? icon.
Start using the tools! Below is an image of Claude closing a browser session.

demo

Tools

Browserbase API

browserbase_create_session
Create a new cloud browser session using Browserbase
No required inputs
browserbase_navigate
Navigate to any URL in the browser
Input: url (string)
browserbase_screenshot
Capture screenshots of the entire page or specific elements
Inputs:
- name (string, required): Name for the screenshot
- selector (string, optional): CSS selector for element to screenshot
- width (number, optional, default: 800): Screenshot width
- height (number, optional, default: 600): Screenshot height
browserbase_click
Click elements on the page
Input: selector (string): CSS selector for element to click
browserbase_fill
Fill out input fields
Inputs:
- selector (string): CSS selector for input field
- value (string): Value to fill
browserbase_evaluate
Execute JavaScript in the browser console
Input: script (string): JavaScript code to execute
browserbase_get_content
Extract all content from the current page
Input: selector (string, optional): CSS selector to get content from specific elements
browserbase_parallel_sessions
Create multiple browser sessions and navigate to different URLs
Input: sessions (array): Array of objects containing:
- url (string): URL to navigate to
- id (string): Session identifier

Resources

The server provides access to two types of resources:

Console Logs (console://logs)
Browser console output in text format
Includes all console messages from the browser
Screenshots (screenshot://<name>)
PNG images of captured screenshots
Accessible via the screenshot name specified during capture

Key Features

Cloud browser automation
Web data extraction
Console log monitoring
Screenshot capabilities
JavaScript execution
Basic web interaction (navigation, clicking, form filling)

License

This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.

[
  {
    "description": "Create a new cloud browser session using Browserbase",
    "inputSchema": {
      "properties": {},
      "required": [],
      "type": "object"
    },
    "name": "browserbase_create_session"
  },
  {
    "description": "Close a browser session on Browserbase",
    "inputSchema": {
      "properties": {
        "sessionId": {
          "type": "string"
        }
      },
      "required": [
        "sessionId"
      ],
      "type": "object"
    },
    "name": "browserbase_close_session"
  },
  {
    "description": "Navigate to a URL",
    "inputSchema": {
      "properties": {
        "url": {
          "type": "string"
        }
      },
      "required": [
        "url"
      ],
      "type": "object"
    },
    "name": "browserbase_navigate"
  },
  {
    "description": "Take a screenshot of the current page or a specific element",
    "inputSchema": {
      "properties": {
        "height": {
          "description": "Height in pixels (default: 600)",
          "type": "number"
        },
        "name": {
          "description": "Name for the screenshot",
          "type": "string"
        },
        "selector": {
          "description": "CSS selector for element to screenshot",
          "type": "string"
        },
        "width": {
          "description": "Width in pixels (default: 800)",
          "type": "number"
        }
      },
      "required": [
        "name"
      ],
      "type": "object"
    },
    "name": "browserbase_screenshot"
  },
  {
    "description": "Click an element on the page",
    "inputSchema": {
      "properties": {
        "selector": {
          "description": "CSS selector for element to click",
          "type": "string"
        }
      },
      "required": [
        "selector"
      ],
      "type": "object"
    },
    "name": "browserbase_click"
  },
  {
    "description": "Fill out an input field",
    "inputSchema": {
      "properties": {
        "selector": {
          "description": "CSS selector for input field",
          "type": "string"
        },
        "value": {
          "description": "Value to fill",
          "type": "string"
        }
      },
      "required": [
        "selector",
        "value"
      ],
      "type": "object"
    },
    "name": "browserbase_fill"
  },
  {
    "description": "Execute JavaScript in the browser console",
    "inputSchema": {
      "properties": {
        "script": {
          "description": "JavaScript code to execute",
          "type": "string"
        }
      },
      "required": [
        "script"
      ],
      "type": "object"
    },
    "name": "browserbase_evaluate"
  },
  {
    "description": "Extract all content from the current page",
    "inputSchema": {
      "properties": {
        "selector": {
          "description": "Optional CSS selector to get content from specific elements (default: returns whole page)",
          "type": "string"
        }
      },
      "required": [],
      "type": "object"
    },
    "name": "browserbase_get_content"
  }
]