# Browserbase — MCP server on mcp.ai
> Connect your Browserbase account and use 19 tools for developer tools straight from your AI agent. Connect with your own API key. Browserbase is a serverless platform that enables developers to run, manage, and monitor headless browsers at scale, offering seamless integration with tools like Playwright, Puppeteer, and Selenium.

By: mcp.ai · official
Page: https://mcp.ai/browserbase_tool

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_browserbase_tool?ms=1787293740000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/browserbase_tool/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/browserbase_tool/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/browserbase_tool/skill.md
Postman collection (v2.1): https://mcp.ai/browserbase_tool/postman.json

## Tools
- browserbase_tool_contexts_create(projectId: string) — Tool to create a new browser context. Use when you need to obtain upload credentials for a custom user-data-directory in a project.
- browserbase_tool_contexts_get(id: string) — Tool to retrieve details of a specific browser context. Use when you have a context ID and need its metadata.
- browserbase_tool_contexts_update(id: string) — Tool to update a specific browser context. Use when you need fresh upload URL and encryption details for an existing context, after obtaining a valid context ID.
- browserbase_tool_create_browser_session(region?: string, proxies?: object, timeout?: integer, keepAlive?: boolean, projectId: string, extensionId?: string, userMetadata?: object) — Tool to create a new browser session. Use when you need an isolated browser context before performing any page interactions.
- browserbase_tool_delete_context(id: string) — Tool to delete a browser context and all its stored data (cookies, localStorage, etc.). Use when you need to permanently remove a context.
- browserbase_tool_delete_extension(id: string) — Tool to delete an uploaded browser extension by its ID. Use when you need to remove an extension from Browserbase.
- browserbase_tool_delete_session_downloads(id: string) — Tool to delete all file downloads from a specific browser session. Use when you need to clean up session artifacts or free storage space.
- browserbase_tool_get_extension(id: string) — Tool to retrieve details of a specific browser extension. Use when you have an extension ID and need its metadata (file name, timestamps, project ID).
- browserbase_tool_get_project(id: string) — Tool to retrieve details of a specific project including settings and configuration. Use when you have a project ID and need its metadata.
- browserbase_tool_get_project_usage(id: string) — Tool to retrieve usage statistics for a project including browser minutes and proxy bytes consumed. Use when you need to monitor or track resource usage for a specific project.
- browserbase_tool_list_projects() — Tool to list all projects for the authenticated account. Use when you need to retrieve all projects associated with the current API key.
- browserbase_tool_sessions_get(id: string) — Tool to retrieve details of a specific browser session. Use when you have a session ID and need its metadata (status, URLs, timestamps).
- browserbase_tool_sessions_get_debug(id: string) — Tool to retrieve live debug URLs for a specific session. Use when you need to connect to a running session for debugging.
- browserbase_tool_sessions_get_downloads(id: string) — Tool to download files from a specific session. Use after session completion to retrieve all generated artifacts in a ZIP archive.
- browserbase_tool_sessions_get_logs(id: string) — Tool to retrieve logs of a specific session. Use after actions in a session to inspect network events and data exchange.
- browserbase_tool_sessions_list(q?: string, status?: string) — Tool to list all browser sessions. Use when you need to retrieve sessions with optional filtering by status or metadata query.
- browserbase_tool_sessions_update(id: string, status: string, projectId: string) — Tool to update the status of a specific browser session. Use when you need to request session completion before timeout to avoid additional charges.
- browserbase_tool_upload_extension(file: object) — Tool to upload a browser extension for use in sessions. Supports Chrome extension format (ZIP). Use when you need to add custom browser extensions to your Browserbase project.
- browserbase_tool_upload_session_file(id: string, file: object) — Tool to upload files to a browser session for file input operations. Use when you need to make files available for file input fields or downloads within a browser automation session.

## Example prompts
- "What can I do in Browserbase?"
- "Show me a summary of my Browserbase account"

## Links
Docs: https://mcp.ai/docs/mcps/browserbase_tool
Website: https://mcp.ai/mcps/browserbase_tool