[STG-1576] Sync MCP docs into Stagehand docs (browserbase#1818)

# why
Sync the Stagehand MCP docs with the Browserbase MCP docs for STG-1576.

# what changed
Copied the refreshed Browserbase MCP introduction and setup pages into
`packages/docs/v3/integrations/mcp`.

# test plan
`pnpm exec prettier --check packages/docs/docs.json
packages/docs/v3/integrations/mcp/introduction.mdx
packages/docs/v3/integrations/mcp/setup.mdx`; `pnpm --dir packages/docs
exec mint broken-links` (unrelated existing failures only); `pnpm lint`
fails in `packages/core` on an existing ESLint rule config issue.

---------

Co-authored-by: ci-test <ci-test@example.com>

Author: monadoid

packages/docs/v2/first-steps/quickstart.mdx

@@ -3,7 +3,7 @@ title: Quickstart
 description: 'Stagehand allows you to build web automations with natural language and code.'
 ---
 
-If this is your **first time using Stagehand**, you should try [Director](https://director.ai) first. It's an agent that allows you to build Stagehand workflows using natural language. You can also try Stagehand using our [MCP server](/integrations/mcp/introduction) .   
+If this is your **first time using Stagehand**, you should try [Director](https://director.ai) first. It's an agent that allows you to build Stagehand workflows using natural language. You can also try Stagehand using our [MCP server](/v2/integrations/mcp/introduction).
 
 Otherwise, the quickest way to start with Stagehand is with our CLI. It scaffolds a ready‑to‑run Stagehand app with sensible defaults, and an example script.
 
@@ -122,4 +122,3 @@ Learn about the Stagehand primitives: act, extract, observe, and agent.
     Autonomous multi-step browser workflows
   </Card>
 </CardGroup>
-

packages/docs/v2/integrations/mcp/configuration.mdx

@@ -43,7 +43,7 @@ Your Browserbase project ID
 | `--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: gemini-2.0-flash) |
+| `--modelName <model>` | The model to use for Stagehand (default: google/gemini-2.5-flash-lite) |
 | `--modelApiKey <key>` | API key for the custom model provider (required when using custom models) |
 | `--experimental` | Enable experimental features (default: false) |
 
@@ -270,7 +270,7 @@ Cookies must be in [Playwright Cookie format](https://playwright.dev/docs/api/cl
 
 ## Model Configuration
 
-Configure AI models for enhanced browser automation. Stagehand defaults to Google's Gemini 2.0 Flash but supports multiple providers.
+Configure AI models for enhanced browser automation. Stagehand defaults to Google's Gemini 2.5 Flash Lite but supports multiple providers.
 
 <Warning>
 When using any custom model (non-default), you must provide your own API key for that model provider using the `--modelApiKey` flag.
@@ -279,7 +279,7 @@ When using any custom model (non-default), you must provide your own API key for
 <Tabs>
 <Tab title="Available Models">
 **Google Gemini** (Default)
-- `google/gemini-2.0-flash` (default)
+- `google/gemini-2.5-flash-lite` (default)
 - `google/gemini-1.5-pro`
 - `google/gemini-1.5-flash`
 
@@ -433,4 +433,4 @@ AI-powered browser automation
 <Card title="Support" icon="headset" href="mailto:support@browserbase.com">
 Get help from our team
 </Card>
-</CardGroup>
+</CardGroup>

packages/docs/v2/integrations/mcp/introduction.mdx

@@ -6,20 +6,16 @@ description: "AI-powered browser automation through Model Context Protocol integ
 
 ## Overview
 
-The Browserbase MCP Server brings powerful browser automation capabilities to Claude through the Model Context Protocol (MCP). Built on top of [Stagehand](https://docs.stagehand.dev/), this integration provides AI-powered web automation using natural language commands.
+The Browserbase MCP Server brings powerful browser automation capabilities to MCP clients through the Model Context Protocol (MCP). Built on top of [Stagehand](https://docs.stagehand.dev/), this integration provides AI-powered web automation using natural language commands.
 
 <Info>
-This server enables Claude to control browsers, navigate websites, interact with web elements, and extract data—all through simple conversational commands.
+  The hosted [Streamable HTTP](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#streamable-http)
+  endpoint is served on Browserbase infrastructure.
+  You can also run the MCP server locally with STDIO, but we recommend the
+  hosted [Streamable HTTP](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#streamable-http)
+  endpoint for most users.
 </Info>
 
-<Note>
-**Two Ways to Use MCP:**
-1. **Browserbase MCP Server**: Provides browser automation tools to Claude Desktop and other MCP clients
-2. **MCP Integrations in Stagehand**: Add external tools (like Exa search, Supabase) to Stagehand agents
-
-This documentation covers the Browserbase MCP Server. For using MCP integrations within Stagehand agents, see [MCP Integrations](/best-practices/mcp-integrations).
-</Note>
-
 ## Key Features
 
 <CardGroup cols={2}>
@@ -28,25 +24,17 @@ Control browsers using plain English commands like "click the login button" or "
 </Card>
 
 <Card title="Web Interaction" icon="browser">
-Navigate, click, and fill forms with ease
+  Navigate, click, and fill forms with ease
 </Card>
 
 <Card title="Data Extraction" icon="download">
-Extract structured data from any website automatically
-
-</Card>
-
-<Card title="Multi-Session Management" icon="window-restore">
-Run multiple browser sessions simultaneously for complex workflows
+  Extract structured data from any website automatically
 </Card>
 
-<Card title="Screenshot Capture" icon="camera">
-Capture and analyze webpage screenshots programmatically
+<Card title="Session Lifecycle" icon="route">
+  Create, reuse, and close browser sessions with explicit MCP tools
 </Card>
 
-<Card title="Cookie Management" icon="cookie-bite">
-Handle authentication and session persistence across interactions
-</Card>
 </CardGroup>
 
 ## Core Benefits
@@ -59,7 +47,7 @@ No need to learn complex selectors or automation syntax. Simply describe what yo
 </Card>
 
 <Card title="Quick Setup" icon="rocket">
-Get started in minutes with our NPM package or our remote hosted URL.
+  Get started in minutes with either hosted [Streamable HTTP](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#streamable-http) or local STDIO.
 </Card>
 
 <Card title="Smart Automation" icon="brain">
@@ -75,31 +63,27 @@ Navigate, click, type, scroll, and interact with any web element.
 </Card>
 
 <Card title="Data Intelligence" icon="chart-line">
-Extract structured information from complex web pages automatically.
+  Extract structured information from complex web pages automatically.
 </Card>
 
 <Card title="Session Persistence" icon="cookie-bite">
 Maintain authentication states and cookies across multiple interactions.
 </Card>
-
-<Card title="Multi-Session Support" icon="window-restore">
-Run parallel browser instances for complex workflows.
-</Card>
 </CardGroup>
 </Tab>
 
 <Tab title="Enterprise Ready">
 <CardGroup cols={2}>
 <Card title="Reliable Infrastructure" icon="server">
-Built on Browserbase's cloud browser platform for consistent performance.
+Hosted [Streamable HTTP](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#streamable-http) runs on Browserbase infrastructure for consistent performance.
 </Card>
 
 <Card title="Scalable Architecture" icon="arrows-up-to-line">
-Handle multiple concurrent sessions and high-volume automation tasks.
+  Handle multiple concurrent sessions and high-volume automation tasks.
 </Card>
 
 <Card title="Security Features" icon="shield-check">
-Stealth mode, proxy support, and advanced anti-detection capabilities.
+  Stealth mode, proxy support, and advanced anti-detection capabilities.
 </Card>
 
 <Card title="Comprehensive Logging" icon="file-lines">
@@ -119,11 +103,11 @@ Track product prices, availability, and competitor information
 </Card>
 
 <Card title="Market Research" icon="chart-bar">
-Gather data from multiple sources for analysis and reporting
+  Gather data from multiple sources for analysis and reporting
 </Card>
 
 <Card title="Content Aggregation" icon="newspaper">
-Collect articles, posts, and media from various websites
+  Collect articles, posts, and media from various websites
 </Card>
 
 <Card title="Lead Generation" icon="users">
@@ -139,11 +123,11 @@ Create comprehensive test suites for web applications
 </Card>
 
 <Card title="Cross-Browser Validation" icon="browsers">
-Test functionality across different browser environments
+  Test functionality across different browser environments
 </Card>
 
 <Card title="User Journey Testing" icon="route">
-Simulate real user interactions and workflows
+  Simulate real user interactions and workflows
 </Card>
 
 <Card title="Performance Monitoring" icon="gauge">
@@ -159,11 +143,11 @@ Automatically fill and submit complex web forms
 </Card>
 
 <Card title="Report Generation" icon="chart-line">
-Extract data and generate automated reports
+  Extract data and generate automated reports
 </Card>
 
 <Card title="Social Media Management" icon="share-nodes">
-Schedule posts and monitor engagement across platforms
+  Schedule posts and monitor engagement across platforms
 </Card>
 
 <Card title="Administrative Tasks" icon="clipboard-check">
@@ -173,63 +157,39 @@ Automate repetitive web-based business processes
 </Tab>
 </Tabs>
 
-## Session Management
-
-<Info>
-The Browserbase MCP Server supports both single and multi-session architectures to accommodate different automation needs.
-</Info>
-
-<Tabs>
-<Tab title="Single Session Mode">
-**Traditional Approach**
-- One active browser session at a time
-- Simpler for basic automation tasks  
-- Automatic session lifecycle management
-- Ideal for sequential workflows
-</Tab>
-
-<Tab title="Multi-Session Mode">
-**Advanced Parallel Processing**
-- Multiple independent browser sessions
-- Each session maintains separate state
-- Parallel execution capabilities
-- Perfect for complex workflows
-</Tab>
-</Tabs>
-
 ## Getting Started
 
 <Steps>
 <Step title="Install the MCP Server">
-Choose from NPM installation, remote hosted URL, or local development based on your needs.
+Choose hosted [Streamable HTTP](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#streamable-http) (recommended) or local STDIO based on your needs.
 </Step>
 
 <Step title="Configure Authentication">
-Set up your Browserbase API credentials in the MCP configuration. 
-Get your API keys from the [Browserbase Dashboard](https://www.browserbase.com/overview).
+  Set up your Browserbase API credentials in MCP configuration. Get API keys
+  from the [Browserbase Dashboard](https://www.browserbase.com/overview).
 </Step>
 
 <Step title="Start Automating">
-Begin using natural language commands to control browsers through Claude.
+Begin using natural language commands to control browsers through your MCP client.
 </Step>
 </Steps>
 
 <Tip>
-Ready to get started? Check out our [Setup Guide](/integrations/mcp/setup) for detailed installation instructions.
+  Ready to get started? Check out the [Setup Guide](/v2/integrations/mcp/setup).
 </Tip>
 
 ## Further Reading
 
 <CardGroup cols={3}>
-<Card title="Setup Guide" icon="rocket" href="/integrations/mcp/setup">
+<Card title="Setup Guide" icon="rocket" href="/v2/integrations/mcp/setup">
 Get started with installation and configuration
 </Card>
 
-<Card title="Available Tools" icon="wrench" href="/integrations/mcp/tools">
-Explore all available automation tools
+<Card title="MCP Docs" icon="book" href="https://modelcontextprotocol.io/introduction">
+Learn more about the MCP protocol
 </Card>
 
-<Card title="Configuration Options" icon="gear" href="/integrations/mcp/configuration">
-Customize your browser automation setup
+<Card title="Browserbase Docs" icon="globe" href="https://docs.browserbase.com">
+Explore Browserbase features and capabilities
 </Card>
-</CardGroup>
+</CardGroup>