[STG-1681] Align tools with hosted MCP server (#161)

* feat!: align tools with hosted MCP server at mcp.browserbase.com

BREAKING CHANGE: Tool names, schemas, and default model updated to match
the hosted Browserbase MCP server. Removed screenshot, get_url, and agent
tools. Removed all Smithery references and dependencies.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* test: add unit tests, smoke test, and update eval configs

- Add vitest with 11 unit tests verifying tool names, schemas, and capabilities
- Add STDIO smoke test that spawns server and verifies tools/list response
- Update all 3 eval configs to use new tool names (start, end, navigate, act, observe, extract)
- Remove eval workflows referencing deleted tools (screenshot, url, agent)
- Add pnpm test step to CI pipeline (runs before evals, needs no secrets)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* fix: update eval expectedState to match new response format

The end tool now returns {"success": true} instead of
"closed successfully via Stagehand", so expectedState checks
need to use "success" instead.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* ci: add changesets release workflow for automated npm publishing

On push to main, changesets/action will either create a "Version Packages"
PR (when changesets exist) or publish to npm (when the version PR merges).
The existing publish-mcp.yml fires on v* tags to handle MCP registry.

Also removed stale hip-vans-battle.md changeset for the removed screenshot tool.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* ci: enable provenance for trusted publishing

Adds NPM_CONFIG_PROVENANCE=true so changeset publish uses OIDC-based
trusted publishing with provenance attestation, no NPM_TOKEN needed.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: shrey150

.changeset/align-with-hosted-mcp.md

@@ -0,0 +1,20 @@
+---
+"@browserbasehq/mcp-server-browserbase": major
+---
+
+Align tool names and schemas with the hosted Browserbase MCP server at mcp.browserbase.com.
+
+**Breaking changes:**
+
+- Tool `browserbase_session_create` renamed to `start`
+- Tool `browserbase_session_close` renamed to `end`
+- Tool `browserbase_stagehand_navigate` renamed to `navigate`
+- Tool `browserbase_stagehand_act` renamed to `act`
+- Tool `browserbase_stagehand_observe` renamed to `observe`
+- Tool `browserbase_stagehand_extract` renamed to `extract`
+- Tools `browserbase_screenshot`, `browserbase_stagehand_get_url`, and `browserbase_stagehand_agent` removed
+- `act` tool no longer accepts `variables` parameter
+- `start` tool no longer accepts `sessionId` parameter
+- `extract` tool `instruction` is now optional (matches hosted)
+- Default model changed from `gemini-2.0-flash` to `google/gemini-2.5-flash-lite`
+- Removed Smithery references and dependencies

.github/workflows/ci.yml

@@ -36,6 +36,9 @@ jobs:
       - name: Build project
         run: pnpm build
 
+      - name: Run unit and smoke tests
+        run: pnpm test
+
       - name: Run evaluation tests
         env:
           BROWSERBASE_API_KEY: ${{ secrets.BROWSERBASE_API_KEY }}

.github/workflows/release.yml

@@ -0,0 +1,45 @@
+name: Release
+
+on:
+  push:
+    branches:
+      - main
+
+permissions:
+  contents: write
+  pull-requests: write
+  id-token: write
+
+concurrency: ${{ github.workflow }}-${{ github.ref }}
+
+jobs:
+  release:
+    name: Release
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Repo
+        uses: actions/checkout@v4
+
+      - name: Install pnpm
+        uses: pnpm/action-setup@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "22"
+          cache: "pnpm"
+          registry-url: "https://registry.npmjs.org"
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Build
+        run: pnpm build
+
+      - name: Create Release Pull Request or Publish to npm
+        uses: changesets/action@v1
+        with:
+          publish: pnpm release
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NPM_CONFIG_PROVENANCE: true

.gitignore

@@ -292,9 +292,6 @@ cython_debug/
 
 .DS_Store
 
-# Smithery
-/.smithery
-
 # MCP Registry https://github.com/modelcontextprotocol/registry
 .mcpregistry_github_token
 .mcpregistry_registry_token