{"_id":"@autom8y/mcp-stagehand","_rev":"3-f6b21c6dcd6369a2ab112a5936eb850c","name":"@autom8y/mcp-stagehand","dist-tags":{"latest":"1.0.2"},"versions":{"1.0.0":{"name":"@autom8y/mcp-stagehand","version":"1.0.0","author":{"url":"forked from Browserbase, Inc.","name":"autom8y"},"license":"Apache-2.0","_id":"@autom8y/mcp-stagehand@1.0.0","maintainers":[{"name":"tomtenuta","email":"tom@tenuta.io"}],"homepage":"https://github.com/autom8y/mcp-stagehand","bugs":{"url":"https://github.com/autom8y/mcp-stagehand/issues"},"bin":{"knossos-mcp-stagehand":"cli.js"},"dist":{"shasum":"07a45ee1603301ece70eea27db6a580c18a5b98b","tarball":"https://registry.npmjs.org/@autom8y/mcp-stagehand/-/mcp-stagehand-1.0.0.tgz","fileCount":30,"integrity":"sha512-aqNtBALVSi+8sdQoeVXnQtH5dPkE1ua0TNP/r3q98Ap/H+GaWB206v6Bwsv1ZahB3eojKqVqfESjM7xQ7F1tIw==","signatures":[{"sig":"MEUCIQDETxSAiSg9DIKkrK6lMwmYYAMX1sVQfjBz/KkHzfUrogIgA2tKYY0E0LHFKBP3SeErEuEU0YeWJfP3yogm4+/KwJQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1492972},"main":"./cli.js","type":"module","module":"./src/index.ts","gitHead":"a64b429c48052858a0d1d7a6483cce3e30864323","mcpName":"io.github.autom8y/mcp-stagehand","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 && pnpm build","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":"pnpm clean && pnpm build","version:packages":"changeset version"},"_npmUser":{"name":"tomtenuta","email":"tom@tenuta.io"},"_npmVersion":"10.9.4","description":"MCP server for AI browser automation via Stagehand — LOCAL mode + Anthropic CUA support. Fork of @browserbasehq/mcp-server-browserbase.","directories":{},"lint-staged":{"*.{js,jsx,ts,tsx,json,css,scss,md}":["prettier --write .","eslint --fix"]},"_nodeVersion":"22.22.1","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.1.0","@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-stagehand_1.0.0_1773749545315_0.3427958685549397","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@autom8y/mcp-stagehand","version":"1.0.1","author":{"url":"forked from Browserbase, Inc.","name":"autom8y"},"license":"Apache-2.0","_id":"@autom8y/mcp-stagehand@1.0.1","maintainers":[{"name":"tomtenuta","email":"tom@tenuta.io"}],"homepage":"https://github.com/autom8y/mcp-stagehand","bugs":{"url":"https://github.com/autom8y/mcp-stagehand/issues"},"bin":{"knossos-mcp-stagehand":"cli.js"},"dist":{"shasum":"291112c8589740c26caab467d9c68ea05cfeb345","tarball":"https://registry.npmjs.org/@autom8y/mcp-stagehand/-/mcp-stagehand-1.0.1.tgz","fileCount":30,"integrity":"sha512-wjWdXCwhCgNGe/ien9phOM6E7tVJcgtibTVBwpDPUzrq92eYZL7cuZOUJ3SZtaqrEwyxQJxeGJTn/21mJUcNrQ==","signatures":[{"sig":"MEUCIG5SModSM8VYhzmFVbrcTabULizMW29anC6zlFRtGd/HAiEAmAl0aKtwmWWNI66YAhdHQaxeUrnWUCMY180/oae5RwA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1493153},"main":"./cli.js","type":"module","module":"./src/index.ts","gitHead":"a64b429c48052858a0d1d7a6483cce3e30864323","mcpName":"io.github.autom8y/mcp-stagehand","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 && pnpm build","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":"pnpm clean && pnpm build","version:packages":"changeset version"},"_npmUser":{"name":"tomtenuta","email":"tom@tenuta.io"},"_npmVersion":"10.9.4","description":"MCP server for AI browser automation via Stagehand — LOCAL mode + Anthropic CUA support. Fork of @browserbasehq/mcp-server-browserbase.","directories":{},"lint-staged":{"*.{js,jsx,ts,tsx,json,css,scss,md}":["prettier --write .","eslint --fix"]},"_nodeVersion":"22.22.1","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.1.0","@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-stagehand_1.0.1_1773750185286_0.0727048203862124","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@autom8y/mcp-stagehand","version":"1.0.2","description":"MCP server for AI browser automation via Stagehand — LOCAL mode + Anthropic CUA support. Fork of @browserbasehq/mcp-server-browserbase.","mcpName":"io.github.autom8y/mcp-stagehand","license":"Apache-2.0","author":{"name":"autom8y","url":"forked from Browserbase, Inc."},"homepage":"https://github.com/autom8y/mcp-stagehand","bugs":{"url":"https://github.com/autom8y/mcp-stagehand/issues"},"type":"module","main":"./cli.js","module":"./src/index.ts","bin":{"knossos-mcp-stagehand":"cli.js"},"scripts":{"build":"tsc && shx chmod +x dist/*.js","prepare":"husky && pnpm build","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":"pnpm clean && pnpm 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.1.0","@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":"@autom8y/mcp-stagehand@1.0.2","gitHead":"a64b429c48052858a0d1d7a6483cce3e30864323","_nodeVersion":"22.22.1","_npmVersion":"10.9.4","dist":{"integrity":"sha512-RfSLW8Mg6APYsnp3fRF6nvffSofJAvTH06zYqdrqmYZK0vIyaHtcMpBkifdqGQoWAB6bN2O0Kdu+YJE92caIXQ==","shasum":"a2f4993438586c17a3b937e8b070ca4cc4124577","tarball":"https://registry.npmjs.org/@autom8y/mcp-stagehand/-/mcp-stagehand-1.0.2.tgz","fileCount":30,"unpackedSize":1493222,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIHwYpqnoxZP+R89ps70ZAPh/cZ0KTsxywJPvWHVDHDiEAiBk/r2eaX9Sop8BTw8E/mJyctT9oGsCUxTjAduqJxAxhw=="}]},"_npmUser":{"name":"tomtenuta","email":"tom@tenuta.io"},"directories":{},"maintainers":[{"name":"tomtenuta","email":"tom@tenuta.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-stagehand_1.0.2_1773765261618_0.007059091341276691"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-17T12:12:25.223Z","modified":"2026-03-17T16:34:21.958Z","1.0.0":"2026-03-17T12:12:25.487Z","1.0.1":"2026-03-17T12:23:05.473Z","1.0.2":"2026-03-17T16:34:21.834Z"},"bugs":{"url":"https://github.com/autom8y/mcp-stagehand/issues"},"author":{"name":"autom8y","url":"forked from Browserbase, Inc."},"license":"Apache-2.0","homepage":"https://github.com/autom8y/mcp-stagehand","description":"MCP server for AI browser automation via Stagehand — LOCAL mode + Anthropic CUA support. Fork of @browserbasehq/mcp-server-browserbase.","maintainers":[{"name":"tomtenuta","email":"tom@tenuta.io"}],"readme":"# Browserbase MCP Server\n\n[![smithery badge](https://smithery.ai/badge/@browserbasehq/mcp-browserbase)](https://smithery.ai/server/@browserbasehq/mcp-browserbase)\n\n![cover](assets/cover.png)\n\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.\n\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.\n\n## What's New in Stagehand v3\n\nPowered by [Stagehand v3.0](https://github.com/browserbase/stagehand), this MCP server now includes:\n\n- **20-40% Faster Performance**: Speed improvements across all core operations (`act`, `extract`, `observe`) through automatic caching\n- **Enhanced Extraction**: Targeted extraction and observation across iframes and shadow roots\n- **Improved Schemas**: Streamlined extract schemas for more intuitive data extraction\n- **Advanced Selector Support**: CSS selector support with improved element targeting\n- **Multi-Browser Support**: Compatible with Playwright, Puppeteer, and Patchright\n- **New Primitives**: Built-in `page`, `locator`, `frameLocator`, and `deepLocator` for simplified automation\n- **Experimental Features**: Enable cutting-edge capabilities with the `--experimental` flag\n\nFor more details, visit the [Stagehand v3 documentation](https://docs.stagehand.dev/).\n\n## Features\n\n| Feature            | Description                                                 |\n| ------------------ | ----------------------------------------------------------- |\n| Browser Automation | Control and orchestrate cloud browsers via Browserbase      |\n| Data Extraction    | Extract structured data from any webpage                    |\n| Web Interaction    | Navigate, click, and fill forms with ease                   |\n| Screenshots        | Capture full-page and element screenshots                   |\n| Model Flexibility  | Supports multiple models (OpenAI, Claude, Gemini, and more) |\n| Vision Support     | Use annotated screenshots for complex DOMs                  |\n| Session Management | Create, manage, and close browser sessions                  |\n| High Performance   | 20-40% faster operations with automatic caching (v3)        |\n| Advanced Selectors | Enhanced CSS selector support for precise element targeting |\n\n## How to Setup\n\n### Quickstarts:\n\n#### Add to Cursor\n\nCopy and Paste this link in your Browser:\n\n```text\ncursor://anysphere.cursor-deeplink/mcp/install?name=browserbase&config=eyJjb21tYW5kIjoibnB4IEBicm93c2VyYmFzZWhxL21jcCIsImVudiI6eyJCUk9XU0VSQkFTRV9BUElfS0VZIjoiIiwiQlJPV1NFUkJBU0VfUFJPSkVDVF9JRCI6IiIsIkdFTUlOSV9BUElfS0VZIjoiIn19\n```\n\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.\n\n## SHTTP:\n\nTo use the Browserbase MCP Server through our remote hosted URL, add the following to your configuration.\n\nGo to [smithery.ai](https://smithery.ai/server/@browserbasehq/mcp-browserbase) and enter your API keys and configuration to get a remote hosted URL.\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).\n\n![Smithery Image](assets/smithery.jpg)\n\nIf your client supports SHTTP:\n\n```json\n{\n  \"mcpServers\": {\n    \"browserbase\": {\n      \"type\": \"http\",\n      \"url\": \"your-smithery-url.com\"\n    }\n  }\n}\n```\n\nIf your client doesn't support SHTTP:\n\n```json\n{\n  \"mcpServers\": {\n    \"browserbase\": {\n      \"command\": \"npx\",\n      \"args\": [\"mcp-remote\", \"your-smithery-url.com\"]\n    }\n  }\n}\n```\n\n## STDIO:\n\nYou can either use our Server hosted on NPM or run it completely locally by cloning this repo.\n\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.\n\n### To run on NPM (Recommended)\n\nGo into your MCP Config JSON and add the Browserbase Server:\n\n```json\n{\n  \"mcpServers\": {\n    \"browserbase\": {\n      \"command\": \"npx\",\n      \"args\": [\"@browserbasehq/mcp-server-browserbase\"],\n      \"env\": {\n        \"BROWSERBASE_API_KEY\": \"\",\n        \"BROWSERBASE_PROJECT_ID\": \"\",\n        \"GEMINI_API_KEY\": \"\"\n      }\n    }\n  }\n}\n```\n\nThat's it! Reload your MCP client and Claude will be able to use Browserbase.\n\n### To run 100% local:\n\n#### Option 1: Direct installation\n\n```bash\n# Clone the Repo\ngit clone https://github.com/browserbase/mcp-server-browserbase.git\ncd mcp-server-browserbase\n\n# Install the dependencies and build the project\nnpm install && npm run build\n```\n\n#### Option 2: Docker\n\n```bash\n# Clone the Repo\ngit clone https://github.com/browserbase/mcp-server-browserbase.git\ncd mcp-server-browserbase\n\n# Build the Docker image\ndocker build -t mcp-browserbase .\n```\n\nThen in your MCP Config JSON run the server. To run locally we can use STDIO or self-host SHTTP.\n\n### STDIO:\n\n#### Using Direct Installation\n\nTo your MCP Config JSON file add the following:\n\n```json\n{\n  \"mcpServers\": {\n    \"browserbase\": {\n      \"command\": \"node\",\n      \"args\": [\"/path/to/mcp-server-browserbase/cli.js\"],\n      \"env\": {\n        \"BROWSERBASE_API_KEY\": \"\",\n        \"BROWSERBASE_PROJECT_ID\": \"\",\n        \"GEMINI_API_KEY\": \"\"\n      }\n    }\n  }\n}\n```\n\n#### Using Docker\n\nTo your MCP Config JSON file add the following:\n\n```json\n{\n  \"mcpServers\": {\n    \"browserbase\": {\n      \"command\": \"docker\",\n      \"args\": [\n        \"run\",\n        \"--rm\",\n        \"-i\",\n        \"-e\",\n        \"BROWSERBASE_API_KEY\",\n        \"-e\",\n        \"BROWSERBASE_PROJECT_ID\",\n        \"-e\",\n        \"GEMINI_API_KEY\",\n        \"mcp-browserbase\"\n      ],\n      \"env\": {\n        \"BROWSERBASE_API_KEY\": \"\",\n        \"BROWSERBASE_PROJECT_ID\": \"\",\n        \"GEMINI_API_KEY\": \"\"\n      }\n    }\n  }\n}\n```\n\nThen reload your MCP client and you should be good to go!\n\n## Configuration\n\nThe Browserbase MCP server accepts the following command-line flags:\n\n| Flag                       | Description                                                                 |\n| -------------------------- | --------------------------------------------------------------------------- |\n| `--proxies`                | Enable Browserbase proxies for the session                                  |\n| `--advancedStealth`        | Enable Browserbase Advanced Stealth (Only for Scale Plan Users)             |\n| `--keepAlive`              | Enable Browserbase Keep Alive Session                                       |\n| `--contextId <contextId>`  | Specify a Browserbase Context ID to use                                     |\n| `--persist`                | Whether to persist the Browserbase context (default: true)                  |\n| `--port <port>`            | Port to listen on for HTTP/SHTTP transport                                  |\n| `--host <host>`            | Host to bind server to (default: localhost, use 0.0.0.0 for all interfaces) |\n| `--browserWidth <width>`   | Browser viewport width (default: 1024)                                      |\n| `--browserHeight <height>` | Browser viewport height (default: 768)                                      |\n| `--modelName <model>`      | The model to use for Stagehand (default: gemini-2.0-flash)                  |\n| `--modelApiKey <key>`      | API key for the custom model provider (required when using custom models)   |\n| `--experimental`           | Enable experimental features (default: false)                               |\n\nThese flags can be passed directly to the CLI or configured in your MCP configuration file.\n\n### NOTE:\n\nCurrently, these flags can only be used with the local server (npx @browserbasehq/mcp-server-browserbase or Docker).\n\n### Using Configuration Flags with Docker\n\nWhen using Docker, you can pass configuration flags as additional arguments after the image name. Here's an example with the `--proxies` flag:\n\n```json\n{\n  \"mcpServers\": {\n    \"browserbase\": {\n      \"command\": \"docker\",\n      \"args\": [\n        \"run\",\n        \"--rm\",\n        \"-i\",\n        \"-e\",\n        \"BROWSERBASE_API_KEY\",\n        \"-e\",\n        \"BROWSERBASE_PROJECT_ID\",\n        \"-e\",\n        \"GEMINI_API_KEY\",\n        \"mcp-browserbase\",\n        \"--proxies\"\n      ],\n      \"env\": {\n        \"BROWSERBASE_API_KEY\": \"\",\n        \"BROWSERBASE_PROJECT_ID\": \"\",\n        \"GEMINI_API_KEY\": \"\"\n      }\n    }\n  }\n}\n```\n\nYou can also run the Docker container directly from the command line:\n\n```bash\ndocker run --rm -i \\\n  -e BROWSERBASE_API_KEY=your_api_key \\\n  -e BROWSERBASE_PROJECT_ID=your_project_id \\\n  -e GEMINI_API_KEY=your_gemini_key \\\n  mcp-browserbase --proxies\n```\n\n## Configuration Examples\n\n### Proxies\n\nHere are our docs on [Proxies](https://docs.browserbase.com/features/proxies).\n\nTo use proxies, set the --proxies flag in your MCP Config:\n\n```json\n{\n  \"mcpServers\": {\n    \"browserbase\": {\n      \"command\": \"npx\",\n      \"args\": [\"@browserbasehq/mcp-server-browserbase\", \"--proxies\"],\n      \"env\": {\n        \"BROWSERBASE_API_KEY\": \"\",\n        \"BROWSERBASE_PROJECT_ID\": \"\",\n        \"GEMINI_API_KEY\": \"\"\n      }\n    }\n  }\n}\n```\n\n### Advanced Stealth\n\nHere are our docs on [Advanced Stealth](https://docs.browserbase.com/features/stealth-mode#advanced-stealth-mode).\n\nTo use advanced stealth, set the --advancedStealth flag in your MCP Config:\n\n```json\n{\n  \"mcpServers\": {\n    \"browserbase\": {\n      \"command\": \"npx\",\n      \"args\": [\"@browserbasehq/mcp-server-browserbase\", \"--advancedStealth\"],\n      \"env\": {\n        \"BROWSERBASE_API_KEY\": \"\",\n        \"BROWSERBASE_PROJECT_ID\": \"\",\n        \"GEMINI_API_KEY\": \"\"\n      }\n    }\n  }\n}\n```\n\n### Contexts\n\nHere are our docs on [Contexts](https://docs.browserbase.com/features/contexts)\n\nTo use contexts, set the --contextId flag in your MCP Config:\n\n```json\n{\n  \"mcpServers\": {\n    \"browserbase\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"@browserbasehq/mcp-server-browserbase\",\n        \"--contextId\",\n        \"<YOUR_CONTEXT_ID>\"\n      ],\n      \"env\": {\n        \"BROWSERBASE_API_KEY\": \"\",\n        \"BROWSERBASE_PROJECT_ID\": \"\",\n        \"GEMINI_API_KEY\": \"\"\n      }\n    }\n  }\n}\n```\n\n### Browser Viewport Sizing\n\nThe default viewport sizing for a browser session is 1024 x 768. You can adjust the Browser viewport sizing with browserWidth and browserHeight flags.\n\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)\n\n```json\n{\n  \"mcpServers\": {\n    \"browserbase\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"@browserbasehq/mcp-server-browserbase\",\n        \"--browserHeight 1080\",\n        \"--browserWidth 1920\"\n      ],\n      \"env\": {\n        \"BROWSERBASE_API_KEY\": \"\",\n        \"BROWSERBASE_PROJECT_ID\": \"\",\n        \"GEMINI_API_KEY\": \"\"\n      }\n    }\n  }\n}\n```\n\n### Experimental Features\n\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.\n\nTo enable experimental features:\n\n```json\n{\n  \"mcpServers\": {\n    \"browserbase\": {\n      \"command\": \"npx\",\n      \"args\": [\"@browserbasehq/mcp-server-browserbase\", \"--experimental\"],\n      \"env\": {\n        \"BROWSERBASE_API_KEY\": \"\",\n        \"BROWSERBASE_PROJECT_ID\": \"\",\n        \"GEMINI_API_KEY\": \"\"\n      }\n    }\n  }\n}\n```\n\n_Note: Experimental features may change or be removed in future releases. Use them at your own discretion._\n\n### Model Configuration\n\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.\n\n**Important**: When using any custom model (non-default), you must provide your own API key for that model provider using the `--modelApiKey` flag.\n\nHere's how to configure different models:\n\n```json\n{\n  \"mcpServers\": {\n    \"browserbase\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"@browserbasehq/mcp-server-browserbase\",\n        \"--modelName\",\n        \"anthropic/claude-sonnet-4.5\",\n        \"--modelApiKey\",\n        \"your-anthropic-api-key\"\n      ],\n      \"env\": {\n        \"BROWSERBASE_API_KEY\": \"\",\n        \"BROWSERBASE_PROJECT_ID\": \"\"\n      }\n    }\n  }\n}\n```\n\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._\n\n### Resources\n\nThe server provides access to screenshot resources:\n\n1. **Screenshots** (`screenshot://<screenshot-name>`)\n   - PNG images of captured screenshots\n\n## Key Features\n\n- **AI-Powered Automation**: Natural language commands for web interactions\n- **Multi-Model Support**: Works with OpenAI, Claude, Gemini, and more\n- **Screenshot Capture**: Full-page and element-specific screenshots\n- **Data Extraction**: Intelligent content extraction from web pages\n- **Proxy Support**: Enterprise-grade proxy capabilities\n- **Stealth Mode**: Advanced anti-detection features\n- **Context Persistence**: Maintain authentication and state across sessions\n\nFor more information about the Model Context Protocol, visit:\n\n- [MCP Documentation](https://modelcontextprotocol.io/docs)\n- [MCP Specification](https://spec.modelcontextprotocol.io/)\n\nFor the official MCP Docs:\n\n- [Browserbase MCP](https://docs.browserbase.com/integrations/mcp/introduction)\n\n## License\n\nLicensed under the Apache 2.0 License.\n\nCopyright 2025 Browserbase, Inc.\n","readmeFilename":"README.md"}