Vercel AI SDK

The Vercel AI SDK integration connects an AI SDK tool loop to the Stagehand facade MCP server over MCP/stdio. One server process owns the browser, so page state survives across run, snapshot, and screenshot calls.

Building with Eve? Use the native Eve integration to run the same tool contract in-process.

Stagehand ships this experimental integration from its repository and does not publish it as a standalone adapter.

Prerequisites

Node.js 24 or newer
pnpm 11.10.0
An OpenAI API key for the example agent
A current Google Chrome installation for local browser mode

Quickstart

Clone and build Stagehand

git clone https://github.com/browserbase/stagehand.git
cd stagehand
corepack pnpm@11.10.0 install --frozen-lockfile
corepack pnpm@11.10.0 exec turbo run build \
  --filter @browserbasehq/stagehand-integrations

Configure the AI SDK agent

export OPENAI_API_KEY="your-openai-api-key"

Set AI_SDK_STAGEHAND_MODEL to select another model supported by the example.

Choose the browser

The example uses local Chrome by default. To use Browserbase instead:

export STAGEHAND_BROWSER="browserbase"
export BROWSERBASE_API_KEY="your-browserbase-api-key"

Run a browser task

corepack pnpm@11.10.0 --dir packages/integrations/vercel-ai start -- \
  "Open https://example.com and report the page title."

Configuration

Variable	Purpose
`AI_SDK_STAGEHAND_MODEL`	AI SDK agent model.
`OPENAI_API_KEY`	Credential for the example agent. The AI SDK process does not forward it to the MCP child.
`STAGEHAND_BROWSER`	Select `local` or `browserbase`.
`BROWSERBASE_API_KEY`	Required for Browserbase.
`BROWSERBASE_PROJECT_ID`	Optional Browserbase project ID.
`STAGEHAND_MODEL_NAME`	Optional model for Stagehand AI methods called inside `run`.
`STAGEHAND_MODEL_API_KEY`	Required with `STAGEHAND_MODEL_NAME`; the MCP child does not receive agent-provider credentials.

Keep the browser session alive

The example connects once with createMCPClient, loads the three tools, and closes the client only after the model loop finishes. Keep that lifetime when adapting the example; reconnecting for each call starts another browser and loses previous state. The MCP child receives only Stagehand and Browserbase configuration plus the process values required to launch Node. The host’s model credential remains in the AI SDK process.

run executes model-authored JavaScript in the browser. Use Browserbase for untrusted tasks and review the integration security boundary.

Vercel AI SDK integration source

Read the MCP client setup, agent loop, and contract tests.

First steps

The basics

Configuration

Integrations

Best practices

Migration guide

SDK reference

Prerequisites

Quickstart

Configuration

Keep the browser session alive

Vercel AI SDK integration source

​Prerequisites

​Quickstart

​Configuration

​Keep the browser session alive

Vercel AI SDK integration source

Prerequisites

Quickstart

Configuration

Keep the browser session alive