{"_id":"@ashsec/mcp-server-browserbase-local","_rev":"3-500c8803f034c0e4f09d49f4a1230af3","name":"@ashsec/mcp-server-browserbase-local","dist-tags":{"latest":"1.2.0"},"versions":{"1.0.0":{"name":"@ashsec/mcp-server-browserbase-local","version":"1.0.0","author":{"url":"https://www.browserbase.com/","name":"Browserbase, Inc."},"license":"Apache-2.0","_id":"@ashsec/mcp-server-browserbase-local@1.0.0","maintainers":[{"name":"ashesh3","email":"demonetix@gmail.com"}],"homepage":"https://www.browserbase.com","bugs":{"url":"https://github.com/modelcontextprotocol/servers/issues"},"bin":{"mcp-server-browserbase-local":"cli.js"},"dist":{"shasum":"08fb5d6e0be22bb76885b70c5f009febaa4a779c","tarball":"https://registry.npmjs.org/@ashsec/mcp-server-browserbase-local/-/mcp-server-browserbase-local-1.0.0.tgz","fileCount":32,"integrity":"sha512-E9Xyt81ZgKIE9fXcTQCCDJjUtdVG8MpSAwz8dqa2qKyNBn4CIRjm4kdYGgI/kyzYB0o3OzfpOKSa4a4zoaVeUw==","signatures":[{"sig":"MEYCIQCeg/C/j0VY9J2WPFH4cguVBhQl34Krwn2Y1w+8DWVcEwIhAOkv2e4UCd1jqTQ21Ot6t93lfbrklR8+U5W8pgiNFN8i","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1502760},"main":"./cli.js","type":"module","module":"./src/index.ts","gitHead":"128f2b447d7437fad007db37c25e378f8e032ca4","mcpName":"io.github.browserbase/mcp-server-browserbase","scripts":{"lint":"eslint . --ext .ts","build":"tsc && shx chmod +x dist/*.js","clean":"rm -rf dist","evals":"tsx evals/run-evals.ts run --config evals/mcp-eval-basic.config.json && tsx evals/run-evals.ts run --config evals/mcp-eval-minimal.config.json && tsx evals/run-evals.ts run --config evals/mcp-eval.config.json","watch":"tsc --watch","format":"prettier --write .","prepare":"husky || true","release":"changeset publish","smithery":"npx @smithery/cli dev src/index.ts","changeset":"changeset","inspector":"npx @modelcontextprotocol/inspector build/index.js","pre-commit":"pnpm lint-staged","prepublishOnly":"npm run clean && npm run build","version:packages":"changeset version"},"_npmUser":{"name":"ashesh3","email":"demonetix@gmail.com"},"_npmVersion":"11.5.1","description":"MCP server for AI web browser automation with LOCAL mode support (Edge/Chrome auto-detection, persistent profiles)","directories":{},"lint-staged":{"*.{js,jsx,ts,tsx,json,css,scss,md}":["prettier --write .","eslint --fix"]},"_nodeVersion":"24.5.0","dependencies":{"zod":"^3.25.67","sharp":"^0.33.0","dotenv":"^16.4.6","commander":"^14.0.0","@mcp-ui/server":"^5.10.0","@browserbasehq/sdk":"^2.6.0","@browserbasehq/stagehand":"^3.0.8","@modelcontextprotocol/sdk":"^1.13.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"pnpm@10.12.4+sha512.5ea8b0deed94ed68691c9bad4c955492705c5eeb8a87ef86bc62c74a26b037b08ff9570f108b2e4dbd1dd1a9186fea925e527f141c648e85af45631074680184","devDependencies":{"shx":"^0.3.4","tsx":"^4.20.3","chalk":"^5.3.0","husky":"^9.1.7","eslint":"^9.29.0","globals":"^16.2.0","mcpvals":"^0.4.0","prettier":"^3.6.1","@eslint/js":"^9.29.0","typescript":"^5.6.2","@types/node":"^24.10.1","lint-staged":"^16.1.2","@smithery/cli":"^1.2.15","@changesets/cli":"^2.29.6","typescript-eslint":"^8.35.0","eslint-plugin-react":"^7.37.5"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server-browserbase-local_1.0.0_1773122408663_0.9119774642442442","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"@ashsec/mcp-server-browserbase-local","version":"1.1.0","author":{"url":"https://www.browserbase.com/","name":"Browserbase, Inc."},"license":"Apache-2.0","_id":"@ashsec/mcp-server-browserbase-local@1.1.0","maintainers":[{"name":"ashesh3","email":"demonetix@gmail.com"}],"homepage":"https://www.browserbase.com","bugs":{"url":"https://github.com/modelcontextprotocol/servers/issues"},"bin":{"mcp-server-browserbase-local":"cli.js"},"dist":{"shasum":"18fec603b1ee6d16991733510accee85c8fabeb0","tarball":"https://registry.npmjs.org/@ashsec/mcp-server-browserbase-local/-/mcp-server-browserbase-local-1.1.0.tgz","fileCount":32,"integrity":"sha512-Ka74SMOL1ce1qtFrsGfWnP6Fr8qNS9s/GaQL1C7nZ/wAPVC/ve+WDDNizkizIAhQxGg/1RdfNEbZOIY31yAKUw==","signatures":[{"sig":"MEQCIAKbOZdFSWdMGMZSlqBhBsfIqthRpC32sr3fT97SwG32AiAsiA+dp7x6AZEnO0LRGqao0ZZlRiTxyM5oFrEZx7OYSw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1502760},"main":"./cli.js","type":"module","module":"./src/index.ts","gitHead":"63941a2cbe6b5fad84f011d8c3a59c6a349e1117","mcpName":"io.github.browserbase/mcp-server-browserbase","scripts":{"lint":"eslint . --ext .ts","build":"tsc && shx chmod +x dist/*.js","clean":"rm -rf dist","evals":"tsx evals/run-evals.ts run --config evals/mcp-eval-basic.config.json && tsx evals/run-evals.ts run --config evals/mcp-eval-minimal.config.json && tsx evals/run-evals.ts run --config evals/mcp-eval.config.json","watch":"tsc --watch","format":"prettier --write .","prepare":"husky || true","release":"changeset publish","smithery":"npx @smithery/cli dev src/index.ts","changeset":"changeset","inspector":"npx @modelcontextprotocol/inspector build/index.js","pre-commit":"pnpm lint-staged","prepublishOnly":"npm run clean && npm run build","version:packages":"changeset version"},"_npmUser":{"name":"ashesh3","email":"demonetix@gmail.com"},"_npmVersion":"11.5.1","description":"MCP server for AI web browser automation with LOCAL mode support (Edge/Chrome auto-detection, persistent profiles)","directories":{},"lint-staged":{"*.{js,jsx,ts,tsx,json,css,scss,md}":["prettier --write .","eslint --fix"]},"_nodeVersion":"24.5.0","dependencies":{"zod":"^3.25.67","sharp":"^0.33.0","dotenv":"^16.4.6","commander":"^14.0.0","@mcp-ui/server":"^5.10.0","@browserbasehq/sdk":"^2.6.0","@browserbasehq/stagehand":"^3.0.8","@modelcontextprotocol/sdk":"^1.13.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"pnpm@10.12.4+sha512.5ea8b0deed94ed68691c9bad4c955492705c5eeb8a87ef86bc62c74a26b037b08ff9570f108b2e4dbd1dd1a9186fea925e527f141c648e85af45631074680184","devDependencies":{"shx":"^0.3.4","tsx":"^4.20.3","chalk":"^5.3.0","husky":"^9.1.7","eslint":"^9.29.0","globals":"^16.2.0","mcpvals":"^0.4.0","prettier":"^3.6.1","@eslint/js":"^9.29.0","typescript":"^5.6.2","@types/node":"^24.10.1","lint-staged":"^16.1.2","@smithery/cli":"^1.2.15","@changesets/cli":"^2.29.6","typescript-eslint":"^8.35.0","eslint-plugin-react":"^7.37.5"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server-browserbase-local_1.1.0_1773123630493_0.792164978615908","host":"s3://npm-registry-packages-npm-production"}},"1.2.0":{"name":"@ashsec/mcp-server-browserbase-local","version":"1.2.0","description":"MCP server for AI web browser automation with LOCAL mode support (Edge/Chrome auto-detection, persistent profiles)","mcpName":"io.github.browserbase/mcp-server-browserbase","license":"Apache-2.0","author":{"name":"Browserbase, Inc.","url":"https://www.browserbase.com/"},"homepage":"https://www.browserbase.com","bugs":{"url":"https://github.com/modelcontextprotocol/servers/issues"},"type":"module","main":"./cli.js","module":"./src/index.ts","bin":{"mcp-server-browserbase-local":"cli.js"},"scripts":{"build":"tsc && shx chmod +x dist/*.js","prepare":"husky || true","watch":"tsc --watch","smithery":"npx @smithery/cli dev src/index.ts","inspector":"npx @modelcontextprotocol/inspector build/index.js","evals":"tsx evals/run-evals.ts run --config evals/mcp-eval-basic.config.json && tsx evals/run-evals.ts run --config evals/mcp-eval-minimal.config.json && tsx evals/run-evals.ts run --config evals/mcp-eval.config.json","lint":"eslint . --ext .ts","format":"prettier --write .","clean":"rm -rf dist","prepublishOnly":"npm run clean && npm run build","pre-commit":"pnpm lint-staged","changeset":"changeset","version:packages":"changeset version","release":"changeset publish"},"lint-staged":{"*.{js,jsx,ts,tsx,json,css,scss,md}":["prettier --write .","eslint --fix"]},"dependencies":{"@browserbasehq/sdk":"^2.6.0","@browserbasehq/stagehand":"^3.0.8","@mcp-ui/server":"^5.10.0","@modelcontextprotocol/sdk":"^1.13.1","commander":"^14.0.0","dotenv":"^16.4.6","sharp":"^0.33.0","zod":"^3.25.67"},"devDependencies":{"@changesets/cli":"^2.29.6","@eslint/js":"^9.29.0","@smithery/cli":"^1.2.15","@types/node":"^24.10.1","chalk":"^5.3.0","eslint":"^9.29.0","eslint-plugin-react":"^7.37.5","globals":"^16.2.0","husky":"^9.1.7","lint-staged":"^16.1.2","mcpvals":"^0.4.0","prettier":"^3.6.1","shx":"^0.3.4","tsx":"^4.20.3","typescript":"^5.6.2","typescript-eslint":"^8.35.0"},"publishConfig":{"access":"public"},"packageManager":"pnpm@10.12.4+sha512.5ea8b0deed94ed68691c9bad4c955492705c5eeb8a87ef86bc62c74a26b037b08ff9570f108b2e4dbd1dd1a9186fea925e527f141c648e85af45631074680184","_id":"@ashsec/mcp-server-browserbase-local@1.2.0","gitHead":"e28470ddf1615b2fc6961096167ff7e5bd92223d","_nodeVersion":"24.5.0","_npmVersion":"11.5.1","dist":{"integrity":"sha512-CS+EbVBQ5ihdKR7uCNHMN1eoN9vFN6U5sKjQULam0GGopmeu+ogYUOjCZBRjoD2CrvW1kdpXAh7QAr+Is4IcWg==","shasum":"1edecf84995007f488c5b5834e85f8c8fa7c6d74","tarball":"https://registry.npmjs.org/@ashsec/mcp-server-browserbase-local/-/mcp-server-browserbase-local-1.2.0.tgz","fileCount":32,"unpackedSize":1503420,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCdxxsNZYMeI3CaPu1FoWmFvIEdxjTt7Zgrrdvb9xdEfQIhAMB08tRvg0OMvAu+unJ6sN6cT0bvoBHRVADdFe9gXGnL"}]},"_npmUser":{"name":"ashesh3","email":"demonetix@gmail.com"},"directories":{},"maintainers":[{"name":"ashesh3","email":"demonetix@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-server-browserbase-local_1.2.0_1773946311648_0.2906362117344605"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-10T06:00:08.579Z","modified":"2026-03-19T18:51:52.018Z","1.0.0":"2026-03-10T06:00:08.919Z","1.1.0":"2026-03-10T06:20:30.747Z","1.2.0":"2026-03-19T18:51:51.898Z"},"bugs":{"url":"https://github.com/modelcontextprotocol/servers/issues"},"author":{"name":"Browserbase, Inc.","url":"https://www.browserbase.com/"},"license":"Apache-2.0","homepage":"https://www.browserbase.com","description":"MCP server for AI web browser automation with LOCAL mode support (Edge/Chrome auto-detection, persistent profiles)","maintainers":[{"name":"ashesh3","email":"demonetix@gmail.com"}],"readme":"# Browserbase MCP Server\r\n\r\n[![smithery badge](https://smithery.ai/badge/@browserbasehq/mcp-browserbase)](https://smithery.ai/server/@browserbasehq/mcp-browserbase)\r\n\r\n![cover](assets/cover.png)\r\n\r\n[The Model Context Protocol (MCP)](https://modelcontextprotocol.io/introduction) is an open protocol that enables seamless integration between LLM applications and external data sources and tools. Whether you're building an AI-powered IDE, enhancing a chat interface, or creating custom AI workflows, MCP provides a standardized way to connect LLMs with the context they need.\r\n\r\nThis server provides cloud browser automation capabilities using [Browserbase](https://www.browserbase.com/) and [Stagehand](https://github.com/browserbase/stagehand). It enables LLMs to interact with web pages, take screenshots, extract information, and perform automated actions with atomic precision.\r\n\r\n## What's New in Stagehand v3\r\n\r\nPowered by [Stagehand v3.0](https://github.com/browserbase/stagehand), this MCP server now includes:\r\n\r\n- **20-40% Faster Performance**: Speed improvements across all core operations (`act`, `extract`, `observe`) through automatic caching\r\n- **Enhanced Extraction**: Targeted extraction and observation across iframes and shadow roots\r\n- **Improved Schemas**: Streamlined extract schemas for more intuitive data extraction\r\n- **Advanced Selector Support**: CSS selector support with improved element targeting\r\n- **Multi-Browser Support**: Compatible with Playwright, Puppeteer, and Patchright\r\n- **New Primitives**: Built-in `page`, `locator`, `frameLocator`, and `deepLocator` for simplified automation\r\n- **Experimental Features**: Enable cutting-edge capabilities with the `--experimental` flag\r\n\r\nFor more details, visit the [Stagehand v3 documentation](https://docs.stagehand.dev/).\r\n\r\n## Features\r\n\r\n| Feature            | Description                                                 |\r\n| ------------------ | ----------------------------------------------------------- |\r\n| Browser Automation | Control and orchestrate cloud browsers via Browserbase      |\r\n| Data Extraction    | Extract structured data from any webpage                    |\r\n| Web Interaction    | Navigate, click, and fill forms with ease                   |\r\n| Screenshots        | Capture full-page and element screenshots                   |\r\n| Model Flexibility  | Supports multiple models (OpenAI, Claude, Gemini, and more) |\r\n| Vision Support     | Use annotated screenshots for complex DOMs                  |\r\n| Session Management | Create, manage, and close browser sessions                  |\r\n| High Performance   | 20-40% faster operations with automatic caching (v3)        |\r\n| Advanced Selectors | Enhanced CSS selector support for precise element targeting |\r\n\r\n## How to Setup\r\n\r\n### Quickstarts:\r\n\r\n#### Add to Cursor\r\n\r\nCopy and Paste this link in your Browser:\r\n\r\n```text\r\ncursor://anysphere.cursor-deeplink/mcp/install?name=browserbase&config=eyJjb21tYW5kIjoibnB4IEBicm93c2VyYmFzZWhxL21jcCIsImVudiI6eyJCUk9XU0VSQkFTRV9BUElfS0VZIjoiIiwiQlJPV1NFUkJBU0VfUFJPSkVDVF9JRCI6IiIsIkdFTUlOSV9BUElfS0VZIjoiIn19\r\n```\r\n\r\nWe currently support 2 transports for our MCP server, STDIO and SHTTP. We recommend you use SHTTP with our remote hosted url to take advantage of the server at full capacity.\r\n\r\n## SHTTP:\r\n\r\nTo use the Browserbase MCP Server through our remote hosted URL, add the following to your configuration.\r\n\r\nGo to [smithery.ai](https://smithery.ai/server/@browserbasehq/mcp-browserbase) and enter your API keys and configuration to get a remote hosted URL.\r\nWhen using our remote hosted server, we provide the LLM costs for Gemini, the [best performing model](https://www.stagehand.dev/evals) in [Stagehand](https://www.stagehand.dev).\r\n\r\n![Smithery Image](assets/smithery.jpg)\r\n\r\nIf your client supports SHTTP:\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"browserbase\": {\r\n      \"type\": \"http\",\r\n      \"url\": \"your-smithery-url.com\"\r\n    }\r\n  }\r\n}\r\n```\r\n\r\nIf your client doesn't support SHTTP:\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"browserbase\": {\r\n      \"command\": \"npx\",\r\n      \"args\": [\"mcp-remote\", \"your-smithery-url.com\"]\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n## STDIO:\r\n\r\nYou can either use our Server hosted on NPM or run it completely locally by cloning this repo.\r\n\r\n> **❗️ Important:** If you want to use a different model you have to add --modelName to the args and provide that respective key as an arg. More info below.\r\n\r\n### To run on NPM (Recommended)\r\n\r\nGo into your MCP Config JSON and add the Browserbase Server:\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"browserbase\": {\r\n      \"command\": \"npx\",\r\n      \"args\": [\"@browserbasehq/mcp-server-browserbase\"],\r\n      \"env\": {\r\n        \"BROWSERBASE_API_KEY\": \"\",\r\n        \"BROWSERBASE_PROJECT_ID\": \"\",\r\n        \"GEMINI_API_KEY\": \"\"\r\n      }\r\n    }\r\n  }\r\n}\r\n```\r\n\r\nThat's it! Reload your MCP client and Claude will be able to use Browserbase.\r\n\r\n### To run 100% local:\r\n\r\n#### Option 1: Direct installation\r\n\r\n```bash\r\n# Clone the Repo\r\ngit clone https://github.com/browserbase/mcp-server-browserbase.git\r\ncd mcp-server-browserbase\r\n\r\n# Install the dependencies and build the project\r\nnpm install && npm run build\r\n```\r\n\r\n#### Option 2: Docker\r\n\r\n```bash\r\n# Clone the Repo\r\ngit clone https://github.com/browserbase/mcp-server-browserbase.git\r\ncd mcp-server-browserbase\r\n\r\n# Build the Docker image\r\ndocker build -t mcp-browserbase .\r\n```\r\n\r\nThen in your MCP Config JSON run the server. To run locally we can use STDIO or self-host SHTTP.\r\n\r\n### STDIO:\r\n\r\n#### Using Direct Installation\r\n\r\nTo your MCP Config JSON file add the following:\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"browserbase\": {\r\n      \"command\": \"node\",\r\n      \"args\": [\"/path/to/mcp-server-browserbase/cli.js\"],\r\n      \"env\": {\r\n        \"BROWSERBASE_API_KEY\": \"\",\r\n        \"BROWSERBASE_PROJECT_ID\": \"\",\r\n        \"GEMINI_API_KEY\": \"\"\r\n      }\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n#### Using Docker\r\n\r\nTo your MCP Config JSON file add the following:\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"browserbase\": {\r\n      \"command\": \"docker\",\r\n      \"args\": [\r\n        \"run\",\r\n        \"--rm\",\r\n        \"-i\",\r\n        \"-e\",\r\n        \"BROWSERBASE_API_KEY\",\r\n        \"-e\",\r\n        \"BROWSERBASE_PROJECT_ID\",\r\n        \"-e\",\r\n        \"GEMINI_API_KEY\",\r\n        \"mcp-browserbase\"\r\n      ],\r\n      \"env\": {\r\n        \"BROWSERBASE_API_KEY\": \"\",\r\n        \"BROWSERBASE_PROJECT_ID\": \"\",\r\n        \"GEMINI_API_KEY\": \"\"\r\n      }\r\n    }\r\n  }\r\n}\r\n```\r\n\r\nThen reload your MCP client and you should be good to go!\r\n\r\n## Configuration\r\n\r\nThe Browserbase MCP server accepts the following command-line flags:\r\n\r\n| Flag                       | Description                                                                 |\r\n| -------------------------- | --------------------------------------------------------------------------- |\r\n| `--proxies`                | Enable Browserbase proxies for the session                                  |\r\n| `--advancedStealth`        | Enable Browserbase Advanced Stealth (Only for Scale Plan Users)             |\r\n| `--keepAlive`              | Enable Browserbase Keep Alive Session                                       |\r\n| `--contextId <contextId>`  | Specify a Browserbase Context ID to use                                     |\r\n| `--persist`                | Whether to persist the Browserbase context (default: true)                  |\r\n| `--port <port>`            | Port to listen on for HTTP/SHTTP transport                                  |\r\n| `--host <host>`            | Host to bind server to (default: localhost, use 0.0.0.0 for all interfaces) |\r\n| `--browserWidth <width>`   | Browser viewport width (default: 1024)                                      |\r\n| `--browserHeight <height>` | Browser viewport height (default: 768)                                      |\r\n| `--modelName <model>`      | The model to use for Stagehand (default: gemini-2.0-flash)                  |\r\n| `--modelApiKey <key>`      | API key for the custom model provider (required when using custom models)   |\r\n| `--experimental`           | Enable experimental features (default: false)                               |\r\n\r\nThese flags can be passed directly to the CLI or configured in your MCP configuration file.\r\n\r\n### NOTE:\r\n\r\nCurrently, these flags can only be used with the local server (npx @browserbasehq/mcp-server-browserbase or Docker).\r\n\r\n### Using Configuration Flags with Docker\r\n\r\nWhen using Docker, you can pass configuration flags as additional arguments after the image name. Here's an example with the `--proxies` flag:\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"browserbase\": {\r\n      \"command\": \"docker\",\r\n      \"args\": [\r\n        \"run\",\r\n        \"--rm\",\r\n        \"-i\",\r\n        \"-e\",\r\n        \"BROWSERBASE_API_KEY\",\r\n        \"-e\",\r\n        \"BROWSERBASE_PROJECT_ID\",\r\n        \"-e\",\r\n        \"GEMINI_API_KEY\",\r\n        \"mcp-browserbase\",\r\n        \"--proxies\"\r\n      ],\r\n      \"env\": {\r\n        \"BROWSERBASE_API_KEY\": \"\",\r\n        \"BROWSERBASE_PROJECT_ID\": \"\",\r\n        \"GEMINI_API_KEY\": \"\"\r\n      }\r\n    }\r\n  }\r\n}\r\n```\r\n\r\nYou can also run the Docker container directly from the command line:\r\n\r\n```bash\r\ndocker run --rm -i \\\r\n  -e BROWSERBASE_API_KEY=your_api_key \\\r\n  -e BROWSERBASE_PROJECT_ID=your_project_id \\\r\n  -e GEMINI_API_KEY=your_gemini_key \\\r\n  mcp-browserbase --proxies\r\n```\r\n\r\n## Configuration Examples\r\n\r\n### Proxies\r\n\r\nHere are our docs on [Proxies](https://docs.browserbase.com/features/proxies).\r\n\r\nTo use proxies, set the --proxies flag in your MCP Config:\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"browserbase\": {\r\n      \"command\": \"npx\",\r\n      \"args\": [\"@browserbasehq/mcp-server-browserbase\", \"--proxies\"],\r\n      \"env\": {\r\n        \"BROWSERBASE_API_KEY\": \"\",\r\n        \"BROWSERBASE_PROJECT_ID\": \"\",\r\n        \"GEMINI_API_KEY\": \"\"\r\n      }\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n### Advanced Stealth\r\n\r\nHere are our docs on [Advanced Stealth](https://docs.browserbase.com/features/stealth-mode#advanced-stealth-mode).\r\n\r\nTo use advanced stealth, set the --advancedStealth flag in your MCP Config:\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"browserbase\": {\r\n      \"command\": \"npx\",\r\n      \"args\": [\"@browserbasehq/mcp-server-browserbase\", \"--advancedStealth\"],\r\n      \"env\": {\r\n        \"BROWSERBASE_API_KEY\": \"\",\r\n        \"BROWSERBASE_PROJECT_ID\": \"\",\r\n        \"GEMINI_API_KEY\": \"\"\r\n      }\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n### Contexts\r\n\r\nHere are our docs on [Contexts](https://docs.browserbase.com/features/contexts)\r\n\r\nTo use contexts, set the --contextId flag in your MCP Config:\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"browserbase\": {\r\n      \"command\": \"npx\",\r\n      \"args\": [\r\n        \"@browserbasehq/mcp-server-browserbase\",\r\n        \"--contextId\",\r\n        \"<YOUR_CONTEXT_ID>\"\r\n      ],\r\n      \"env\": {\r\n        \"BROWSERBASE_API_KEY\": \"\",\r\n        \"BROWSERBASE_PROJECT_ID\": \"\",\r\n        \"GEMINI_API_KEY\": \"\"\r\n      }\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n### Browser Viewport Sizing\r\n\r\nThe default viewport sizing for a browser session is 1024 x 768. You can adjust the Browser viewport sizing with browserWidth and browserHeight flags.\r\n\r\nHere's how to use it for custom browser sizing. We recommend to stick with 16:9 aspect ratios (ie: 1920 x 1080, 1280 x 720, 1024 x 768)\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"browserbase\": {\r\n      \"command\": \"npx\",\r\n      \"args\": [\r\n        \"@browserbasehq/mcp-server-browserbase\",\r\n        \"--browserHeight 1080\",\r\n        \"--browserWidth 1920\"\r\n      ],\r\n      \"env\": {\r\n        \"BROWSERBASE_API_KEY\": \"\",\r\n        \"BROWSERBASE_PROJECT_ID\": \"\",\r\n        \"GEMINI_API_KEY\": \"\"\r\n      }\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n### Experimental Features\r\n\r\nStagehand v3 includes experimental features that can be enabled with the `--experimental` flag. These features provide cutting-edge capabilities that are actively being developed and refined.\r\n\r\nTo enable experimental features:\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"browserbase\": {\r\n      \"command\": \"npx\",\r\n      \"args\": [\"@browserbasehq/mcp-server-browserbase\", \"--experimental\"],\r\n      \"env\": {\r\n        \"BROWSERBASE_API_KEY\": \"\",\r\n        \"BROWSERBASE_PROJECT_ID\": \"\",\r\n        \"GEMINI_API_KEY\": \"\"\r\n      }\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n_Note: Experimental features may change or be removed in future releases. Use them at your own discretion._\r\n\r\n### Model Configuration\r\n\r\nStagehand defaults to using Google's Gemini 2.0 Flash model, but you can configure it to use other models like GPT-4o, Claude, or other providers.\r\n\r\n**Important**: When using any custom model (non-default), you must provide your own API key for that model provider using the `--modelApiKey` flag.\r\n\r\nHere's how to configure different models:\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"browserbase\": {\r\n      \"command\": \"npx\",\r\n      \"args\": [\r\n        \"@browserbasehq/mcp-server-browserbase\",\r\n        \"--modelName\",\r\n        \"anthropic/claude-sonnet-4.5\",\r\n        \"--modelApiKey\",\r\n        \"your-anthropic-api-key\"\r\n      ],\r\n      \"env\": {\r\n        \"BROWSERBASE_API_KEY\": \"\",\r\n        \"BROWSERBASE_PROJECT_ID\": \"\"\r\n      }\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n_Note: The model must be supported in Stagehand. Check out the docs [here](https://docs.stagehand.dev/examples/custom_llms#supported-llms). When using any custom model, you must provide your own API key for that provider._\r\n\r\n### Resources\r\n\r\nThe server provides access to screenshot resources:\r\n\r\n1. **Screenshots** (`screenshot://<screenshot-name>`)\r\n   - PNG images of captured screenshots\r\n\r\n## Key Features\r\n\r\n- **AI-Powered Automation**: Natural language commands for web interactions\r\n- **Multi-Model Support**: Works with OpenAI, Claude, Gemini, and more\r\n- **Screenshot Capture**: Full-page and element-specific screenshots\r\n- **Data Extraction**: Intelligent content extraction from web pages\r\n- **Proxy Support**: Enterprise-grade proxy capabilities\r\n- **Stealth Mode**: Advanced anti-detection features\r\n- **Context Persistence**: Maintain authentication and state across sessions\r\n\r\nFor more information about the Model Context Protocol, visit:\r\n\r\n- [MCP Documentation](https://modelcontextprotocol.io/docs)\r\n- [MCP Specification](https://spec.modelcontextprotocol.io/)\r\n\r\nFor the official MCP Docs:\r\n\r\n- [Browserbase MCP](https://docs.browserbase.com/integrations/mcp/introduction)\r\n\r\n## License\r\n\r\nLicensed under the Apache 2.0 License.\r\n\r\nCopyright 2025 Browserbase, Inc.\r\n","readmeFilename":"README.md"}