# Stagehand

> Source: https://agentsindex.ai/stagehand

Open source browser automation with deterministic and agentic flows.

- Best for: Developers who need reliable browser automation with both precision and agentic flexibility.

Starting price

Free

From [github.com/browserbase/stagehand](https://github.com/browserbase/stagehand), checked 15 November 2026

- MCP server Yes Checked by us the Official MCP Registry, 15 November 2026 [Checked by us](https://registry.modelcontextprotocol.io/v0.1/servers/io.github.browserbase%2Fmcp-server-browserbase/versions/latest)
- API Yes From docs.stagehand.dev/v4/first-steps/introduction, 15 November 2026 [docs.stagehand.dev](https://docs.stagehand.dev/v4/first-steps/introduction)
- Open source Yes Checked by us github.com/browserbase/stagehand/blob/main/LICENSE, 15 November 2026 [Checked by us](https://github.com/browserbase/stagehand/blob/main/LICENSE)
- Self-host Not stated

- GitHub stars: 25.7k

[Docs](https://docs.stagehand.dev) [GitHub](https://github.com/browserbase/stagehand)

What we checked

- Pages last read: 15 November 2026
- Facts checked: 5 facts · From 6 sources
- AI answers: Too few read · 58 buyer-question answers read, November 2026

[How we check](https://agentsindex.ai/methodology) [Editorial policy](https://agentsindex.ai/editorial-policy#not-for-sale)

[Visit Stagehand](https://agentsindex.ai/go/stagehand) [Compare](https://agentsindex.ai/compare?cat=browser-agents&products=stagehand)

## At a glance

- Category: [Browser agents](https://agentsindex.ai/categories/browser-agents)
- Tags: BYOK, Open source

### Code

- Last push: 15 October 2026

### For developers

- Works with: OpenAI, Anthropic, Google Gemini, Vercel AI SDK

## Stagehand in our research

[All research](https://agentsindex.ai/blog)

Study 19 October 2026 – 16 November 2026

### [AI Tool Pricing Index, November 2026](https://agentsindex.ai/data/ai-tool-pricing-index)

Pricing

Free only

29 of the 361 tools we checked are free with no paid plan.

Edition price, checked 15 November 2026.

Pricing pages of the AI tools, November 2026 edition as of 16 November 2026 n = 361 tools checked

## What is Stagehand?

Stagehand is an open source browser automation framework for developers that combines deterministic primitives with AI-guided flexibility. Its act(), extract(), and observe() flows handle clicking, filling, navigation, page reading, and multi-step workflows, while supporting OpenAI, Anthropic, and Google Gemini through the Vercel AI SDK. It runs locally with any Chromium browser, can use Browserbase for production deployment, and is fully open source under the MIT license.

## A browser driver for agents, with AI steps where you want them

Stagehand is an SDK that drives Chrome, and its pitch is that ["Playwright was built for testing, Stagehand is built for agents"](https://www.stagehand.dev/). It gives you two layers in one script. Three AI primitives, `act`, `extract` and `observe`, take natural-language instructions, and Playwright-style page methods (`goto`, `click`, `type`, `locator`, `screenshot`) run with no inference at all. The docs say you can ["mix both in the same script and decide how much AI each step uses"](https://docs.stagehand.dev/v4/first-steps/introduction). `extract` checks its output against a schema you define, and `metrics()` reports token usage and inference timing for each method.

The runtime sits in a browser extension next to the page. The homepage says this cuts round-trip latency for every action, and it lists closed Shadow DOM, out-of-process iframes, WebMCP, clipboard access, a domain allowlist and blocklist, and built-in OTel tracing as things Stagehand has and Playwright lacks. The TypeScript, Python and Go SDKs are documented as matching method for method.

## agent() is gone, and you now write the control loop

The current major version dropped the built-in orchestrator. The [v3 to v4 migration guide](https://docs.stagehand.dev/v4/migrations/v3) is blunt about it: "agent() is gone. Nothing in v4 replaces it one-for-one." Browserbase recommends two approaches in its place. In "code mode" a coding assistant writes a Stagehand script once and you run it with no per-step inference. In "tool calling" you expose the SDK's methods to a model as narrow tools, with `page.snapshot()` returning an accessibility tree and an XPath map for the model to read.

The guide also says construction, page access and result shapes changed. Anyone coming from older tutorials, or from model output trained on them, will hit code that no longer runs. The docs ship [AI rules](https://docs.stagehand.dev/v4/first-steps/ai-rules) to keep generated code on the v4 API for exactly this reason.

## The SDK is free; Browserbase is where the bill comes from

Stagehand is MIT-licensed on [GitHub](https://github.com/browserbase/stagehand) and installs from npm, pip or Go. Run it against local Chrome and the only spend is your model provider's tokens. The docs nonetheless steer you to the hosted service: "Browserbase recommends running Stagehand on Browserbase. A hosted browser is what enables server-side caching and the Model Gateway."

[Browserbase's pricing page](https://www.browserbase.com/pricing) lists four plans as of November 2026:

The page says every plan "scales past its included usage, so no caps or throttling", so overage replaces a hard stop.

## Model choice is open, with Gateway tied to hosted browsers

The [models page](https://docs.stagehand.dev/v4/configuration/models) lists five first-class providers: Google, Anthropic, OpenAI, Groq and Cerebras. Anything else, including Amazon Bedrock, Azure OpenAI or a self-hosted model, goes through a bring-your-own-LLM callback that runs in your process. Stagehand validates model names against a list it ships, so a newly released model needs an SDK upgrade before it can be named.

Model Gateway is the convenience layer. Leave the model out and Browserbase picks one per call, billed through your Browserbase key, and the page claims "Market-price tokens: Browserbase charges the same price as going direct to the provider. No markup." The limit is stated plainly: "Model Gateway requires Browserbase-hosted browsers. It does not work with local browsers." Gateway also rejects `stopSequences`, so a pinned model with its own key is needed for those.

## Agent framework and MCP hookups are experimental and build from source

Most connect over a stdio MCP adapter that exposes three tools: `run`, `snapshot` and `screenshot`. The [CLI agents page](https://docs.stagehand.dev/v4/integrations/cli-agents/overview) says "These integrations are experimental and run from the Stagehand repository. The shared adapter is not published as a standalone package." Setup means cloning the repo and building it with Node.js 24 or newer and pnpm.

The same page warns that `run` executes agent-authored JavaScript in the extension's service worker and "can control the browser and access data available in that session", and advises using Browserbase for untrusted browser tasks. Separately, Browserbase promotes a hosted MCP server that needs a Browserbase API key.

## Where it fits, and where it does not

Stagehand suits developers who already write Playwright and want AI only on the steps that break, with code they can review and diff. It is a library with no no-code interface. A team that wanted a ready-made autonomous browsing agent will find the orchestrator removed and the loop left to them.

The speed claims on [the homepage](https://www.stagehand.dev/), "2x faster than playwright" and "80% more token efficient", are Browserbase's own measurements of its own product, and no independent test sits beside them.

## Stagehand price and terms

### Terms

- Free plan: Yes Open-source SDK, free to self-run with local Chrome

The terms in full

LLM provider usage and optional Browserbase hosted browsers are paid separately.

### For AI agents

- MCP server: Yes [Checked by us, 15 November 2026](https://registry.modelcontextprotocol.io/v0.1/servers/io.github.browserbase%2Fmcp-server-browserbase/versions/latest)
- API: Yes [docs.stagehand.dev, 15 November 2026](https://docs.stagehand.dev/v4/first-steps/introduction)

[Developer docs](https://docs.stagehand.dev)

Where these prices come from

[github.com/browserbase/stagehand](https://github.com/browserbase/stagehand), checked 15 November 2026

### All plans and limits

| Plan | Price | Main limits |
| --- | --- | --- |
| Stagehand | Free | None stated |

Read 15 November 2026 from [github.com/browserbase/stagehand](https://github.com/browserbase/stagehand).

## What we checked on Stagehand

Yes Partly No

What it costs to start Yes

### What the price counts

The SDK itself carries no meter or fee because it is MIT-licensed code; spend comes from the model provider you configure and, optionally, Browserbase hosted browsers.

> Licensed under the MIT License.

README, License section [github.com/browserbase/stagehand](https://github.com/browserbase/stagehand) Checked 15 November 2026

What it costs to start Yes

### Free to use

The SDK installs from npm and is MIT-licensed, so it can be used with a local browser without contacting sales or buying a plan.

> $ npm install @browserbasehq/stagehand

Hero install command beside 'Stagehand is the SDK for browser agents.' [stagehand.dev](https://www.stagehand.dev/) Checked 5 November 2026

How you build with it Yes

### Public API

Stagehand is itself a programmatic SDK with documented methods (act, extract, observe, page, locator) and matching TypeScript, Python and Go SDKs; it is a library API, not a hosted REST service.

> First-class TypeScript, Python, and Go SDKs: Every method and option matches across supported languages.

Why developers choose Stagehand list [docs.stagehand.dev/v4/first-steps/intro…](https://docs.stagehand.dev/v4/first-steps/introduction) Checked 15 November 2026

How you build with it Yes

### MCP server

Its MCP server is in the official MCP Registry

> io.github.browserbase/mcp-server-browserbase

Official MCP Registry entry [registry.modelcontextprotocol.io/v0.1/s…](https://registry.modelcontextprotocol.io/v0.1/servers/io.github.browserbase%2Fmcp-server-browserbase/versions/latest) Checked by us, 15 November 2026

How you build with it Yes

### Open source

MIT licence in its public repository

> MIT License

LICENSE in github.com/browserbase/stagehand [github.com/browserbase/stagehand/blob/m…](https://github.com/browserbase/stagehand/blob/main/LICENSE) Checked by us, 15 November 2026

## Stagehand alternatives

- [TinyFish](https://agentsindex.ai/tinyfish) · The team behind TinyFish runs this listing · Web search, page fetching, cloud browsers and goal-driven web automation for AI agents, with search and fetch free. · Free, then $0.002 per minute Checked 17 Nov · ISO 27001 · [Visit](https://agentsindex.ai/go/tinyfish)
  - MCP server: yes
  - API: yes
  - Open source: no
  - Self-host: partly
- Stagehand and TinyFish
  | Stagehand | Free | 15 Nov |
  | --- | --- | --- |
  | [TinyFish](https://agentsindex.ai/tinyfish) | Free, then $0.002 per minute | 17 Nov |

## Questions about Stagehand

- How much does Stagehand cost?: Stagehand is free to use. From github.com/browserbase/stagehand, checked 15 November 2026.
- Does Stagehand have an API or an MCP server?: Stagehand has an API. From docs.stagehand.dev/v4/first-steps/introduction, checked 15 November 2026. Stagehand has an MCP server. We checked the Official MCP Registry ourselves on 15 November 2026.
- Is Stagehand open source, and can you host it yourself?: Stagehand is open source. We checked github.com/browserbase/stagehand/blob/main/LICENSE ourselves on 15 November 2026.
- What have we checked on Stagehand?: 5 facts, under these headings: What it costs to start, how you build with it.
- How do we check Stagehand?: We hold 5 facts on Stagehand, quoted from 6 pages. Facts and price last checked 15 November 2026, when we also found the last change.

[How we check every listing](https://agentsindex.ai/methodology)

## Sources and changes

Last changed 15 November 2026

Sources 4

- Read 15 November 2026 · [github.com](https://github.com/browserbase/stagehand) /browserbase/stagehand
- Read 5 November 2026 · [stagehand.dev](https://www.stagehand.dev/) /
- Read 15 November 2026 · [docs.stagehand.dev](https://docs.stagehand.dev/v4/first-steps/introduction) /v4/first-steps/introduction
- Read 5 November 2026 · [docs.stagehand.dev](https://docs.stagehand.dev/v4/integrations/agent-frameworks/overview) /v4/integrations/agent-frameworks/overview

What changed 1

- 15 November 2026 What it does

Repository

- Licence: MIT
- Stars: 25,687
- Last push: 15 October 2026

## Stagehand price history

We have read the price once so far, on 15 November 2026: free.

| Price | Plan | First seen | Last seen | Readings | Source |
| --- | --- | --- | --- | --- | --- |
| Free |   | 15 November 2026 | 15 November 2026 | 1 | [Pricing page, read 15 November 2026](https://github.com/browserbase/stagehand) |

From our research on 15 November 2026. A date is when we read the page, not when the price changed.

## Similar to Stagehand

- [ERIUS PHONE](https://agentsindex.ai/eriusphone) Isolated Android phones rented by the month that keep their state while an agent installs apps, taps and takes calls. From about $44 a month
- [ClineFlow](https://agentsindex.ai/clineflow) Git-native project memory and handoffs for coding agents. Free plan
- [Smithery](https://agentsindex.ai/smithery) Public MCP server registry, now run by Arcade, listing direct vendor MCP URLs after its proxy shut down. Free plan
- [UI Discovery](https://agentsindex.ai/uidiscovery) A library of real websites, iOS apps and dashboards with each one's palette, fonts and original build prompt. From $20 a month

## Is Stagehand yours?

Free, and the page then carries the verified owner mark. You confirm it with an email at stagehand.dev. [Claim this listing](https://agentsindex.ai/claim/stagehand?from=owner-line)

[Report an error](mailto:hello@agentsindex.ai?subject=Report%20an%20error%3A%20Stagehand%20(stagehand)&body=What%20is%20wrong%20on%20the%20page%2C%20and%20where%20on%20the%20product) if a fact is wrong.
