Skip to content

Commit e7b81df

Browse files
committed
readme changes + remove cookies from options
1 parent f42ad84 commit e7b81df

File tree

3 files changed

+41
-21
lines changed

3 files changed

+41
-21
lines changed

README.md

Lines changed: 41 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,20 @@
88

99
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, take screenshots, extract information, and perform automated actions with atomic precision.
1010

11+
## What's New in Stagehand v3
12+
13+
Powered by [Stagehand v3.0](https://github.com/browserbase/stagehand), this MCP server now includes:
14+
15+
- **20-40% Faster Performance**: Speed improvements across all core operations (`act`, `extract`, `observe`) through automatic caching
16+
- **Enhanced Extraction**: Targeted extraction and observation across iframes and shadow roots
17+
- **Improved Schemas**: Streamlined extract schemas for more intuitive data extraction
18+
- **Advanced Selector Support**: CSS selector support with improved element targeting
19+
- **Multi-Browser Support**: Compatible with Playwright, Puppeteer, and Patchright
20+
- **New Primitives**: Built-in `page`, `locator`, `frameLocator`, and `deepLocator` for simplified automation
21+
- **Experimental Features**: Enable cutting-edge capabilities with the `--experimental` flag
22+
23+
For more details, visit the [Stagehand v3 documentation](https://docs.stagehand.dev/).
24+
1125
## Features
1226

1327
| Feature | Description |
@@ -19,6 +33,8 @@ This server provides cloud browser automation capabilities using [Browserbase](h
1933
| Model Flexibility | Supports multiple models (OpenAI, Claude, Gemini, and more) |
2034
| Vision Support | Use annotated screenshots for complex DOMs |
2135
| Session Management | Create, manage, and close browser sessions |
36+
| High Performance | 20-40% faster operations with automatic caching (v3) |
37+
| Advanced Selectors | Enhanced CSS selector support for precise element targeting |
2238

2339
## How to Setup
2440

@@ -190,7 +206,6 @@ The Browserbase MCP server accepts the following command-line flags:
190206
| `--persist` | Whether to persist the Browserbase context (default: true) |
191207
| `--port <port>` | Port to listen on for HTTP/SHTTP transport |
192208
| `--host <host>` | Host to bind server to (default: localhost, use 0.0.0.0 for all interfaces) |
193-
| `--cookies [json]` | JSON array of cookies to inject into the browser |
194209
| `--browserWidth <width>` | Browser viewport width (default: 1024) |
195210
| `--browserHeight <height>` | Browser viewport height (default: 768) |
196211
| `--modelName <model>` | The model to use for Stagehand (default: gemini-2.0-flash) |
@@ -343,6 +358,30 @@ Here's how to use it for custom browser sizing. We recommend to stick with 16:9
343358
}
344359
```
345360

361+
### Experimental Features
362+
363+
Stagehand v3 includes experimental features that can be enabled with the `--experimental` flag. These features provide cutting-edge capabilities that are actively being developed and refined.
364+
365+
To enable experimental features:
366+
367+
```json
368+
{
369+
"mcpServers": {
370+
"browserbase": {
371+
"command": "npx",
372+
"args": ["@browserbasehq/mcp-server-browserbase", "--experimental"],
373+
"env": {
374+
"BROWSERBASE_API_KEY": "",
375+
"BROWSERBASE_PROJECT_ID": "",
376+
"GEMINI_API_KEY": ""
377+
}
378+
}
379+
}
380+
}
381+
```
382+
383+
_Note: Experimental features may change or be removed in future releases. Use them at your own discretion._
384+
346385
### Model Configuration
347386

348387
Stagehand defaults to using Google's Gemini 2.0 Flash model, but you can configure it to use other models like GPT-4o, Claude, or other providers.
@@ -359,7 +398,7 @@ Here's how to configure different models:
359398
"args": [
360399
"@browserbasehq/mcp-server-browserbase",
361400
"--modelName",
362-
"anthropic/claude-3-5-sonnet-latest",
401+
"anthropic/claude-sonnet-4.5",
363402
"--modelApiKey",
364403
"your-anthropic-api-key"
365404
],

src/index.ts

Lines changed: 0 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -18,17 +18,6 @@ import {
1818
ListResourceTemplatesRequestSchema,
1919
} from "@modelcontextprotocol/sdk/types.js";
2020

21-
const cookieSchema = z.object({
22-
name: z.string(),
23-
value: z.string(),
24-
domain: z.string(),
25-
path: z.string().optional(),
26-
expires: z.number().optional(),
27-
httpOnly: z.boolean().optional(),
28-
secure: z.boolean().optional(),
29-
sameSite: z.enum(["Strict", "Lax", "None"]).optional(),
30-
});
31-
3221
// Configuration schema for Smithery - matches existing Config interface
3322
export const configSchema = z
3423
.object({
@@ -74,10 +63,6 @@ export const configSchema = z
7463
.describe("The height of the browser"),
7564
})
7665
.optional(),
77-
cookies: z
78-
.array(cookieSchema)
79-
.optional()
80-
.describe("Cookies to inject into the Browserbase context"),
8166
server: z
8267
.object({
8368
port: z

src/program.ts

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -50,10 +50,6 @@ program
5050
"--host <host>",
5151
"Host to bind server to. Default is localhost. Use 0.0.0.0 to bind to all interfaces.",
5252
)
53-
.option(
54-
"--cookies [json]",
55-
'JSON array of cookies to inject into the browser. Format: [{"name":"cookie1","value":"val1","domain":"example.com"}, ...]',
56-
)
5753
.option("--browserWidth <width>", "Browser width to use for the browser.")
5854
.option("--browserHeight <height>", "Browser height to use for the browser.")
5955
.option(

0 commit comments

Comments
 (0)