browserbase · Kylejeong2 · Oct 16, 2025 · Oct 12, 2025 · Oct 12, 2025 · Oct 12, 2025
diff --git a/.github/workflows/publish-mcp.yml b/.github/workflows/publish-mcp.yml
@@ -0,0 +1,50 @@
+name: Publish to MCP Registry
+
+on:
+  push:
+    tags: ["v*"]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write # Required for OIDC authentication
+      contents: read
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v5
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v3
+        with:
+          version: 10.12.4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v5
+        with:
+          node-version: "lts/*"
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Run tests
+        run: pnpm test --if-present
+
+      - name: Build package
+        run: pnpm build --if-present
+
+      - name: Publish to npm
+        run: pnpm publish
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+      - name: Install MCP Publisher
+        run: |
+          curl -L "https://github.com/modelcontextprotocol/registry/releases/download/latest/mcp-publisher_$(uname -s | tr '[:upper:]' '[:lower:]')_$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/').tar.gz" | tar xz mcp-publisher
+
+      - name: Login to MCP Registry
+        run: ./mcp-publisher login github-oidc
+
+      - name: Publish to MCP Registry
+        run: ./mcp-publisher publish
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,11 @@
 # @browserbasehq/mcp-server-browserbase
 
+## 2.2.0
+
+### Minor Changes
+
+- Remove multisession tools, remove prompts sampling, simplify tool descriptions for better context, add support if google apikey set, latest version of stagehand, remove custom availmodelschema to use stagehand model type instead.
+
 ## 2.1.3
 
 ### Patch Changes

diff --git a/README.md b/README.md
@@ -2,7 +2,7 @@
 
 [![smithery badge](https://smithery.ai/badge/@browserbasehq/mcp-browserbase)](https://smithery.ai/server/@browserbasehq/mcp-browserbase)
 
-![cover](assets/cover-mcp.png)
+![cover](assets/cover.png)
 
 [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.
 
@@ -19,7 +19,6 @@ This server provides cloud browser automation capabilities using [Browserbase](h
 | Model Flexibility  | Supports multiple models (OpenAI, Claude, Gemini, and more) |
 | Vision Support     | Use annotated screenshots for complex DOMs                  |
 | Session Management | Create, manage, and close browser sessions                  |
-| Multi-Session      | Run multiple browser sessions in parallel                   |
 
 ## How to Setup
 
@@ -194,7 +193,7 @@ The Browserbase MCP server accepts the following command-line flags:
 | `--cookies [json]`         | JSON array of cookies to inject into the browser                            |
 | `--browserWidth <width>`   | Browser viewport width (default: 1024)                                      |
 | `--browserHeight <height>` | Browser viewport height (default: 768)                                      |
-| `--modelName <model>`      | The model to use for Stagehand (default: google/gemini-2.0-flash)           |
+| `--modelName <model>`      | The model to use for Stagehand (default: gemini-2.0-flash)                  |
 | `--modelApiKey <key>`      | API key for the custom model provider (required when using custom models)   |
 | `--experimental`           | Enable experimental features (default: false)                               |
 
@@ -386,13 +385,11 @@ The server provides access to screenshot resources:
 
 - **AI-Powered Automation**: Natural language commands for web interactions
 - **Multi-Model Support**: Works with OpenAI, Claude, Gemini, and more
-- **Advanced Session Management**: Single and multi-session support for parallel browser automation
 - **Screenshot Capture**: Full-page and element-specific screenshots
 - **Data Extraction**: Intelligent content extraction from web pages
 - **Proxy Support**: Enterprise-grade proxy capabilities
 - **Stealth Mode**: Advanced anti-detection features
 - **Context Persistence**: Maintain authentication and state across sessions
-- **Parallel Workflows**: Run multiple browser sessions simultaneously for complex automation tasks
 
 For more information about the Model Context Protocol, visit:
 

diff --git a/assets/browserbase-demo.png b/assets/browserbase-demo.png
diff --git a/assets/cover-mcp.png b/assets/cover-mcp.png
diff --git a/assets/session.png b/assets/session.png
diff --git a/config.d.ts b/config.d.ts
@@ -1,5 +1,5 @@
 import type { Cookie } from "playwright-core";
-import type { AvailableModelSchema } from "./src/types/models.js";
+import type { AvailableModelSchema } from "@browserbasehq/stagehand";
-import type { AvailableModelSchema } from "@browserbasehq/stagehand";
+import type { Cookie } from "playwright-core";
+import { AvailableModelSchema } from "@browserbasehq/stagehand";
+import type { z } from "zod";
-import type { AvailableModelSchema } from "@browserbasehq/stagehand";
+import type { Cookie } from "playwright-core";
+import { AvailableModelSchema } from "@browserbasehq/stagehand";
+import type { z } from "zod";
 
 export type Config = {
   /**
@@ -96,12 +96,12 @@ export type Config = {
    * The Model that Stagehand uses
    * Available models: OpenAI, Claude, Gemini, Cerebras, Groq, and other providers
    *
-   * @default "google/gemini-2.0-flash"
+   * @default "gemini-2.0-flash"
    */
-  modelName?: AvailableModelSchema;
+  modelName?: z.infer<typeof AvailableModelSchema>;
   /**
    * API key for the custom model provider
-   * Required when using a model other than the default google/gemini-2.0-flash
+   * Required when using a model other than the default gemini-2.0-flash
    */
   modelApiKey?: string;
   /**

diff --git a/evals/mcp-eval-basic.config.json b/evals/mcp-eval-basic.config.json
@@ -76,22 +76,6 @@
         "browserbase_session_close"
       ]
     },
-    {
-      "name": "multi-session-test",
-      "description": "Test multi-session browser management",
-      "steps": [
-        {
-          "user": "Create a multi-session browser named 'test-session', list all sessions, navigate to https://example.com in that session, and close the session",
-          "expectedState": "closed"
-        }
-      ],
-      "expectTools": [
-        "multi_browserbase_stagehand_session_create",
-        "multi_browserbase_stagehand_session_list",
-        "multi_browserbase_stagehand_navigate_session",
-        "multi_browserbase_stagehand_session_close"
-      ]
-    },
     {
       "name": "form-interaction-test",
       "description": "Test form filling and submission capabilities",

diff --git a/evals/mcp-eval-minimal.config.json b/evals/mcp-eval-minimal.config.json
@@ -52,29 +52,6 @@
         "browserbase_session_close"
       ]
     },
-    {
-      "name": "smoke-test-multi-session",
-      "description": "Quick test to verify multi-session functionality",
-      "steps": [
-        {
-          "user": "Create a browser session named 'test-session'",
-          "expectedState": "session created"
-        },
-        {
-          "user": "List active sessions",
-          "expectedState": "test-session"
-        },
-        {
-          "user": "Close the test session",
-          "expectedState": "closed session"
-        }
-      ],
-      "expectTools": [
-        "multi_browserbase_stagehand_session_create",
-        "multi_browserbase_stagehand_session_list",
-        "multi_browserbase_stagehand_session_close"
-      ]
-    },
     {
       "name": "smoke-test-url-tools",
       "description": "Quick test to verify URL retrieval tools work",

diff --git a/evals/mcp-eval.config.json b/evals/mcp-eval.config.json
@@ -76,22 +76,6 @@
         "browserbase_session_close"
       ]
     },
-    {
-      "name": "multi-session-test",
-      "description": "Test multi-session browser management",
-      "steps": [
-        {
-          "user": "Create a multi-session browser named 'test-session', list all sessions, navigate to https://example.com in that session, and close the session",
-          "expectedState": "closed"
-        }
-      ],
-      "expectTools": [
-        "multi_browserbase_stagehand_session_create",
-        "multi_browserbase_stagehand_session_list",
-        "multi_browserbase_stagehand_navigate_session",
-        "multi_browserbase_stagehand_session_close"
-      ]
-    },
     {
       "name": "form-interaction-test",
       "description": "Test form filling and submission capabilities",
@@ -121,22 +105,6 @@
         "browserbase_session_create",
         "browserbase_stagehand_navigate"
       ]
-    },
-    {
-      "name": "url-retrieval-test",
-      "description": "Test URL retrieval functionality",
-      "steps": [
-        {
-          "user": "Create a browser session, navigate to https://example.com, get the current URL to verify navigation, and close the session",
-          "expectedState": "https://example.com"
-        }
-      ],
-      "expectTools": [
-        "browserbase_session_create",
-        "browserbase_stagehand_navigate",
-        "browserbase_stagehand_get_url",
-        "browserbase_session_close"
-      ]
     }
   ]
 }
diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@browserbasehq/mcp-server-browserbase",
-  "version": "2.1.3",
+  "version": "2.2.0",
   "description": "MCP server for AI web browser automation using Browserbase and Stagehand",
   "mcpName": "io.github.browserbase/mcp-server-browserbase",
   "license": "Apache-2.0",
@@ -24,7 +24,7 @@
   ],
   "scripts": {
     "build": "tsc && shx chmod +x dist/*.js",
-    "prepare": "husky && npm run build",
+    "prepare": "husky && pnpm build",
     "watch": "tsc --watch",
     "smithery": "npx @smithery/cli dev src/index.ts",
     "inspector": "npx @modelcontextprotocol/inspector build/index.js",
@@ -46,7 +46,7 @@
   },
   "dependencies": {
     "@browserbasehq/sdk": "^2.6.0",
-    "@browserbasehq/stagehand": "^2.5.0",
+    "@browserbasehq/stagehand": "^2.5.2",
     "@mcp-ui/server": "^5.10.0",
     "@modelcontextprotocol/sdk": "^1.13.1",
     "commander": "^14.0.0",

diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
diff --git a/server.json b/server.json
@@ -7,13 +7,13 @@
     "url": "https://github.com/browserbase/mcp-server-browserbase",
     "source": "github"
   },
-  "version": "2.1.3",
+  "version": "2.2.0",
   "packages": [
     {
       "registry_type": "npm",
       "registry_base_url": "https://registry.npmjs.org",
       "identifier": "@browserbasehq/mcp-server-browserbase",
-      "version": "2.1.1",
+      "version": "2.2.0",
       "transport": {
         "type": "stdio"
       },
@@ -44,7 +44,7 @@
     {
       "registry_type": "oci",
       "identifier": "browserbasehq/mcp-server-browserbase",
-      "version": "2.1.3",
+      "version": "2.2.0",
       "runtime_hint": "docker",
       "environment_variables": [
         {

diff --git a/src/config.ts b/src/config.ts
@@ -1,6 +1,7 @@
 import type { Cookie } from "playwright-core";
 import type { Config } from "../config.d.ts";
-import type { AvailableModel } from "./types/models.js";
+import { z } from "zod";
+import { AvailableModelSchema } from "@browserbasehq/stagehand";
 
 export type ToolCapability = "core" | string;
 
@@ -15,7 +16,7 @@ export type CLIOptions = {
   cookies?: Cookie[];
   browserWidth?: number;
   browserHeight?: number;
-  modelName?: typeof AvailableModel;
+  modelName?: z.infer<typeof AvailableModelSchema>;
   modelApiKey?: string;
   keepAlive?: boolean;
   experimental?: boolean;
@@ -35,7 +36,7 @@ const defaultConfig: Config = {
     browserHeight: 768,
   },
   cookies: undefined,
-  modelName: "google/gemini-2.0-flash", // Default Model
+  modelName: "gemini-2.0-flash", // Default Model
 };
 
 // Resolve final configuration by merging defaults, file config, and CLI options
@@ -46,7 +47,8 @@ export async function resolveConfig(cliOptions: CLIOptions): Promise<Config> {
 
   // --- Add Browserbase Env Vars ---
   if (!mergedConfig.modelApiKey) {
-    mergedConfig.modelApiKey = process.env.GEMINI_API_KEY;
+    mergedConfig.modelApiKey =
+      process.env.GEMINI_API_KEY || process.env.GOOGLE_API_KEY;
   }
 
   // --------------------------------