> ## Documentation Index
> Fetch the complete documentation index at: https://docs.toolshed.philo.ventures/llms.txt
> Use this file to discover all available pages before exploring further.

# Browserbase Plugin

> Browserbase cloud browser automation — create sessions, debug, record, and manage cloud browser instances.

**Plugin ID:** `browserbase` | **Auth:** API Key (`x-bb-api-key` header)

<Note>
  Browserbase provides cloud browser infrastructure for AI agents. Create a session, then use the connect URL with Playwright/Puppeteer for full browser interaction. The plugin covers session lifecycle management via the REST API.
</Note>

## Tools

### browserbase.sessions.create

**Name:** Create Session

Create a new Browserbase cloud browser session.

**Input:**

| Parameter   | Type      | Required | Default | Description                                     |
| ----------- | --------- | -------- | ------- | ----------------------------------------------- |
| `projectId` | `string`  | Yes      | --      | Browserbase project ID                          |
| `proxies`   | `boolean` | No       | `false` | Enable residential proxies for stealth browsing |

**Output:**

```json theme={null}
{ "sessionId": "sess_abc123", "status": "created", "connectUrl": "wss://connect.browserbase.com/...", "debuggerUrl": "https://debug.browserbase.com/..." }
```

***

### browserbase.sessions.get

**Name:** Get Session

Get the status and details of a browser session.

**Input:**

| Parameter   | Type     | Required | Description |
| ----------- | -------- | -------- | ----------- |
| `sessionId` | `string` | Yes      | Session ID  |

**Output:**

```json theme={null}
{ "sessionId": "sess_abc123", "status": "running", "startedAt": "2026-04-20T10:00:00Z", "endedAt": null, "proxy": false }
```

***

### browserbase.sessions.debug

**Name:** Get Debug URLs

Get live debug/viewer URLs for a session. Use the debugger URL to watch the session in real time.

**Input:**

| Parameter   | Type     | Required | Description |
| ----------- | -------- | -------- | ----------- |
| `sessionId` | `string` | Yes      | Session ID  |

**Output:**

```json theme={null}
{ "debuggerUrl": "https://debug.browserbase.com/sess_abc123", "debuggerFullscreenUrl": "https://debug.browserbase.com/sess_abc123/fullscreen" }
```

***

### browserbase.sessions.close

**Name:** Close Session | **Destructive:** Yes

Close and terminate a browser session. Requires user approval.

**Input:**

| Parameter   | Type     | Required | Default             | Description                                     |
| ----------- | -------- | -------- | ------------------- | ----------------------------------------------- |
| `sessionId` | `string` | Yes      | --                  | Session ID                                      |
| `status`    | `string` | No       | `"REQUEST_RELEASE"` | `"REQUEST_RELEASE"` (graceful) or `"COMPLETED"` |

**Output:**

```json theme={null}
{ "sessionId": "sess_abc123", "status": "REQUEST_RELEASE" }
```

***

### browserbase.sessions.recording

**Name:** Get Session Recording

Get the recording/replay data for a completed session.

**Input:**

| Parameter   | Type     | Required | Description |
| ----------- | -------- | -------- | ----------- |
| `sessionId` | `string` | Yes      | Session ID  |

**Output:**

```json theme={null}
{ "recording": { "events": [], "duration": 45000 } }
```

***

### browserbase.usage

**Name:** Get Usage

Get usage metrics for a Browserbase project.

**Input:**

| Parameter   | Type     | Required | Description            |
| ----------- | -------- | -------- | ---------------------- |
| `projectId` | `string` | Yes      | Browserbase project ID |

**Output:**

```json theme={null}
{ "usage": { "sessionsCreated": 150, "totalMinutes": 420 } }
```