Skip to content

Commit 5e9bcab

Browse files
committed
update MCP tools & removed multisession, updated to newer models in docs
1 parent 2dbac99 commit 5e9bcab

File tree

4 files changed

+11
-177
lines changed

4 files changed

+11
-177
lines changed

docs/configuration/models.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -48,7 +48,7 @@ Stagehand supports major LLM providers with structured output capabilities:
4848
| Provider | Best Models | Strengths | Use Case |
4949
|----------|-------------|-----------|----------|
5050
| **OpenAI** | `gpt-4.1`, `gpt-4.1-mini` | High accuracy, reliable | Production, complex sites |
51-
| **Anthropic** | `claude-3-7-sonnet-latest` | Excellent reasoning | Complex automation tasks |
51+
| **Anthropic** | `claude-sonnet-4-5-20250929, claude-haiku-4-5-20251001` | Excellent reasoning | Complex automation tasks |
5252
| **Google** | `gemini-2.5-flash`, `gemini-2.5-pro` | Fast, cost-effective | High-volume automation |
5353

5454
### Additional Providers

docs/integrations/mcp/configuration.mdx

Lines changed: 4 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -284,17 +284,15 @@ When using any custom model (non-default), you must provide your own API key for
284284
- `google/gemini-1.5-flash`
285285

286286
**OpenAI**
287+
- `openai/gpt-4.1`
287288
- `openai/gpt-4o`
288289
- `openai/gpt-4o-mini`
289-
- `openai/o1-mini`
290-
- `openai/o1-preview`
291-
- `openai/o3-mini`
292290

293291
**Anthropic Claude**
294-
- `anthropic/claude-3-5-sonnet-latest`
295-
- `anthropic/claude-3-7-sonnet-latest`
292+
- `anthropic/claude-sonnet-4-5-20250929`
293+
- `anthropic/claude-haiku-4-5-20251001`
296294

297-
[View full list of supported models](https://docs.stagehand.dev/examples/custom_llms#supported-llms)
295+
[View full list of supported models](https://docs.stagehand.dev/configuration/models#supported-providers)
298296
</Tab>
299297

300298
<Tab title="Configuration Examples">

docs/integrations/mcp/introduction.mdx

Lines changed: 0 additions & 40 deletions
Original file line numberDiff line numberDiff line change
@@ -12,14 +12,6 @@ The Browserbase MCP Server brings powerful browser automation capabilities to Cl
1212
This server enables Claude to control browsers, navigate websites, interact with web elements, and extract data—all through simple conversational commands.
1313
</Info>
1414

15-
<Note>
16-
**Two Ways to Use MCP:**
17-
1. **Browserbase MCP Server**: Provides browser automation tools to Claude Desktop and other MCP clients
18-
2. **MCP Integrations in Stagehand**: Add external tools (like Exa search, Supabase) to Stagehand agents
19-
20-
This documentation covers the Browserbase MCP Server. For using MCP integrations within Stagehand agents, see [MCP Integrations](/best-practices/mcp-integrations).
21-
</Note>
22-
2315
## Key Features
2416

2517
<CardGroup cols={2}>
@@ -36,10 +28,6 @@ Extract structured data from any website automatically
3628

3729
</Card>
3830

39-
<Card title="Multi-Session Management" icon="window-restore">
40-
Run multiple browser sessions simultaneously for complex workflows
41-
</Card>
42-
4331
<Card title="Screenshot Capture" icon="camera">
4432
Capture and analyze webpage screenshots programmatically
4533
</Card>
@@ -81,10 +69,6 @@ Extract structured information from complex web pages automatically.
8169
<Card title="Session Persistence" icon="cookie-bite">
8270
Maintain authentication states and cookies across multiple interactions.
8371
</Card>
84-
85-
<Card title="Multi-Session Support" icon="window-restore">
86-
Run parallel browser instances for complex workflows.
87-
</Card>
8872
</CardGroup>
8973
</Tab>
9074

@@ -173,30 +157,6 @@ Automate repetitive web-based business processes
173157
</Tab>
174158
</Tabs>
175159

176-
## Session Management
177-
178-
<Info>
179-
The Browserbase MCP Server supports both single and multi-session architectures to accommodate different automation needs.
180-
</Info>
181-
182-
<Tabs>
183-
<Tab title="Single Session Mode">
184-
**Traditional Approach**
185-
- One active browser session at a time
186-
- Simpler for basic automation tasks
187-
- Automatic session lifecycle management
188-
- Ideal for sequential workflows
189-
</Tab>
190-
191-
<Tab title="Multi-Session Mode">
192-
**Advanced Parallel Processing**
193-
- Multiple independent browser sessions
194-
- Each session maintains separate state
195-
- Parallel execution capabilities
196-
- Perfect for complex workflows
197-
</Tab>
198-
</Tabs>
199-
200160
## Getting Started
201161

202162
<Steps>

docs/integrations/mcp/tools.mdx

Lines changed: 6 additions & 130 deletions
Original file line numberDiff line numberDiff line change
@@ -33,6 +33,10 @@ Perform an action on the web page using natural language
3333
Extract all text content from the current page (filters out CSS and JavaScript)
3434

3535
<Info>No input parameters required</Info>
36+
37+
<ParamField path="instruction" type="string">
38+
Extracted text content from the current page
39+
</ParamField>
3640
</Accordion>
3741

3842
<Accordion title="browserbase_stagehand_observe">
@@ -64,19 +68,9 @@ Get the current URL of the browser page
6468
</ResponseField>
6569
</Accordion>
6670

67-
<Accordion title="browserbase_stagehand_get_all_urls">
68-
Get current URLs of all active browser sessions
71+
## Session Management
6972

70-
<Info>No input parameters required</Info>
71-
72-
<ResponseField name="sessionUrls" type="object">
73-
Mapping of session IDs to their current URLs in JSON format
74-
</ResponseField>
75-
</Accordion>
76-
77-
## Single Session Management
78-
79-
Traditional approach with one active browser session. Simpler for basic automation tasks and automatically manages the active session.
73+
Manage your browser session lifecycle with create and close operations.
8074

8175
<Accordion title="browserbase_session_create">
8276
Create or reuse a cloud browser session using Browserbase with fully initialized Stagehand
@@ -94,124 +88,6 @@ Close the current Browserbase session, disconnect the browser, and cleanup Stage
9488

9589
</Accordion>
9690

97-
## Multi-Session Management
98-
99-
Advanced approach with multiple parallel browser sessions for complex automation workflows. Each session maintains independent state, cookies, and browser context.
100-
101-
### Session Lifecycle Management
102-
103-
<Accordion title="multi_browserbase_stagehand_session_create">
104-
Create a new independent Stagehand browser session with full web automation capabilities
105-
106-
<ParamField path="name" type="string">
107-
Human-readable name for tracking (e.g., 'login-flow', 'data-scraping')
108-
</ParamField>
109-
</Accordion>
110-
111-
<Accordion title="multi_browserbase_stagehand_session_list">
112-
List all currently active Stagehand browser sessions with detailed metadata
113-
114-
<Info>No input parameters required</Info>
115-
116-
</Accordion>
117-
118-
<Accordion title="multi_browserbase_stagehand_session_close">
119-
Close and clean up a specific Stagehand browser session
120-
121-
<ParamField path="sessionId" type="string" required>
122-
Exact session ID to close (cannot be undone)
123-
</ParamField>
124-
</Accordion>
125-
126-
### Session-Specific Automation Tools
127-
128-
All core browser automation tools are available with session-specific variants:
129-
130-
<Accordion title="multi_browserbase_stagehand_navigate_session">
131-
Navigate to a URL in a specific browser session
132-
133-
<ParamField path="sessionId" type="string" required>
134-
The session ID to use
135-
</ParamField>
136-
137-
<ParamField path="url" type="string" required>
138-
The URL to navigate to
139-
</ParamField>
140-
</Accordion>
141-
142-
<Accordion title="multi_browserbase_stagehand_act_session">
143-
Perform an action in a specific browser session using natural language
144-
145-
<ParamField path="sessionId" type="string" required>
146-
The session ID to use
147-
</ParamField>
148-
149-
<ParamField path="action" type="string" required>
150-
The action to perform
151-
</ParamField>
152-
153-
</Accordion>
154-
155-
<Accordion title="multi_browserbase_stagehand_extract_session">
156-
Extract structured information from a specific browser session
157-
158-
<ParamField path="sessionId" type="string" required>
159-
The session ID to use
160-
</ParamField>
161-
162-
<ParamField path="instruction" type="string" required>
163-
What to extract from the page
164-
</ParamField>
165-
</Accordion>
166-
167-
<Accordion title="multi_browserbase_stagehand_observe_session">
168-
Observe and find actionable elements in a specific browser session
169-
170-
<ParamField path="sessionId" type="string" required>
171-
The session ID to use
172-
</ParamField>
173-
174-
<ParamField path="instruction" type="string" required>
175-
What to observe (e.g., "find the login button")
176-
</ParamField>
177-
178-
<ParamField path="returnAction" type="boolean">
179-
Whether to return the action to perform
180-
</ParamField>
181-
</Accordion>
182-
183-
<Accordion title="multi_browserbase_stagehand_get_url_session">
184-
Get the current URL of a specific browser session
185-
186-
<ParamField path="sessionId" type="string" required>
187-
The session ID to use
188-
</ParamField>
189-
190-
<ResponseField name="url" type="string">
191-
Complete URL including protocol, domain, path, and any query parameters or fragments
192-
</ResponseField>
193-
</Accordion>
194-
195-
### Multi-Session Use Cases
196-
197-
<CardGroup cols={2}>
198-
<Card title="Parallel Data Collection" icon="globe">
199-
Run multiple scraping sessions simultaneously across different websites
200-
</Card>
201-
202-
<Card title="A/B Testing" icon="flask">
203-
Compare user flows across different browser sessions with varying configurations
204-
</Card>
205-
206-
<Card title="Cross-Site Operations" icon="link">
207-
Perform coordinated actions across multiple websites or applications
208-
</Card>
209-
210-
<Card title="Backup Sessions" icon="shield">
211-
Keep fallback sessions ready in case primary sessions encounter issues
212-
</Card>
213-
</CardGroup>
214-
21591
## Resources
21692

21793
<Card title="Screenshot Resources" icon="camera">

0 commit comments

Comments
 (0)