From b5b173f2cb63825fccb6e8cc7d28e5026fca6e9a Mon Sep 17 00:00:00 2001
From: Shrey Pandya <shrey@browserbase.com>
Date: Tue, 7 Jul 2026 01:50:48 -0400
Subject: [PATCH] chore: point registry + Gemini extension at the hosted MCP
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Present the hosted server (https://mcp.browserbase.com/mcp) as the primary,
supported way to use the Browserbase MCP server. The npm/OCI package is an
open-source reference implementation; self-hosting is not officially pushed.

- server.json: bump version to 3.0.0 (match package.json); add a
  streamable-http `remotes` entry for the hosted URL; remove the npm + OCI
  `packages` entries so the registry surfaces the hosted remote as primary.
  Validated against the MCP 2025-07-09 server schema (packages is optional).
- gemini-extension.json: switch mcpServers to the hosted `httpUrl`; bump
  version to 3.0.0; add a description.
- README.md: make the top-of-file framing unambiguous — OSS reference
  implementation, use the hosted server, self-hosting not officially supported.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 README.md             |  2 +-
 gemini-extension.json |  6 ++--
 server.json           | 68 +++----------------------------------------
 3 files changed, 8 insertions(+), 68 deletions(-)

diff --git a/README.md b/README.md
index 90b7a10..d21c276 100644
--- a/README.md
+++ b/README.md
@@ -6,7 +6,7 @@
 
 This 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, extract information, and perform automated actions.
 
-This is a self-hostable version of the [Browserbase hosted MCP server](https://mcp.browserbase.com/mcp) with the same tools and functionality. **We recommend using the hosted version for the easiest setup.**
+> **Use the hosted server.** This repository is the open-source **reference implementation**. The recommended, fully supported way to use the Browserbase MCP server is the hosted endpoint at **[`https://mcp.browserbase.com/mcp`](https://mcp.browserbase.com/mcp)** — we run it for you and cover the LLM costs. **Self-hosting is not officially supported.** The setup instructions below are provided for reference only.
 
 ## Tools
 
diff --git a/gemini-extension.json b/gemini-extension.json
index 5013e62..9d97a09 100644
--- a/gemini-extension.json
+++ b/gemini-extension.json
@@ -1,10 +1,10 @@
 {
   "name": "mcp-server-browserbase",
-  "version": "2.4.1",
+  "version": "3.0.0",
+  "description": "AI web browser automation via the hosted Browserbase MCP server (Browserbase + Stagehand).",
   "mcpServers": {
     "mcp-server-browserbase": {
-      "command": "npx",
-      "args": ["@browserbasehq/mcp"]
+      "httpUrl": "https://mcp.browserbase.com/mcp"
     }
   }
 }
diff --git a/server.json b/server.json
index a292e34..0a821da 100644
--- a/server.json
+++ b/server.json
@@ -7,71 +7,11 @@
     "url": "https://github.com/browserbase/mcp-server-browserbase",
     "source": "github"
   },
-  "version": "2.2.0",
-  "packages": [
+  "version": "3.0.0",
+  "remotes": [
     {
-      "registry_type": "npm",
-      "registry_base_url": "https://registry.npmjs.org",
-      "identifier": "@browserbasehq/mcp",
-      "version": "2.2.0",
-      "transport": {
-        "type": "stdio"
-      },
-      "environment_variables": [
-        {
-          "description": "Your Browserbase API key",
-          "is_required": true,
-          "format": "string",
-          "is_secret": true,
-          "name": "BROWSERBASE_API_KEY"
-        },
-        {
-          "description": "Your Browserbase Project ID",
-          "is_required": true,
-          "format": "string",
-          "is_secret": false,
-          "name": "BROWSERBASE_PROJECT_ID"
-        },
-        {
-          "description": "Your Gemini API key (default model)",
-          "is_required": true,
-          "format": "string",
-          "is_secret": true,
-          "name": "GEMINI_API_KEY"
-        }
-      ]
-    },
-    {
-      "registry_type": "oci",
-      "identifier": "browserbasehq/mcp-server-browserbase",
-      "version": "2.2.0",
-      "runtime_hint": "docker",
-      "environment_variables": [
-        {
-          "description": "Your Browserbase API key",
-          "is_required": true,
-          "format": "string",
-          "is_secret": true,
-          "name": "BROWSERBASE_API_KEY"
-        },
-        {
-          "description": "Your Browserbase Project ID",
-          "is_required": true,
-          "format": "string",
-          "is_secret": false,
-          "name": "BROWSERBASE_PROJECT_ID"
-        },
-        {
-          "description": "Your Gemini API key (default model)",
-          "is_required": true,
-          "format": "string",
-          "is_secret": true,
-          "name": "GEMINI_API_KEY"
-        }
-      ],
-      "transport": {
-        "type": "stdio"
-      }
+      "type": "streamable-http",
+      "url": "https://mcp.browserbase.com/mcp"
     }
   ]
 }