Skip to content

Commit 6b9b46d

Browse files
authored
[STG-1837] Document MCP start sessionId support (#2017)
# why The v3 MCP docs now need to describe the hosted server behavior where `start` can attach to an existing Browserbase session via an optional `sessionId`. # what changed - Updated the MCP setup and tools docs to document optional `start.sessionId`. - Clarified that omitting `sessionId` creates a new Browserbase session. - Added a patch changeset for `@browserbasehq/stagehand-docs`. # test plan - `pnpm exec prettier --check packages/docs/v3/integrations/mcp/setup.mdx packages/docs/v3/integrations/mcp/tools.mdx` <!-- This is an auto-generated description by cubic. --> --- ## Summary by cubic Added docs for optional `sessionId` on MCP `start` to attach to an existing Browserbase session; omitting it creates a new session. Addresses STG-1837 and publishes a patch to `@browserbasehq/stagehand-docs`. <sup>Written for commit edc7cbd. Summary will update on new commits. <a href="https://cubic.dev/pr/browserbase/stagehand/pull/2017">Review in cubic</a></sup> <!-- End of auto-generated description by cubic. -->
1 parent 8f7192c commit 6b9b46d

3 files changed

Lines changed: 15 additions & 6 deletions

File tree

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
---
2+
"@browserbasehq/stagehand-docs": patch
3+
---
4+
5+
Document the optional MCP `start` `sessionId` parameter for attaching to an existing Browserbase session.

packages/docs/v3/integrations/mcp/setup.mdx

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -102,12 +102,14 @@ Optional extraction instruction.
102102
</Accordion>
103103

104104
<Accordion title="start">
105-
Create or reuse a Browserbase session and set it as active for the current MCP transport session.
105+
Create a new Browserbase session, or attach to an existing Browserbase session, and set it as active for the current MCP transport session.
106106

107-
<Info>No input parameters required.</Info>
107+
<ParamField path="sessionId" type="string">
108+
Optional Browserbase session ID to attach to. If omitted, `start` creates a new Browserbase session.
109+
</ParamField>
108110

109111
<ResponseField name="sessionId" type="string">
110-
Browserbase session ID.
112+
Browserbase session ID now active for the current MCP transport session.
111113
</ResponseField>
112114
</Accordion>
113115

packages/docs/v3/integrations/mcp/tools.mdx

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -52,12 +52,14 @@ Extract data from the current page.
5252
## Session Management
5353

5454
<Accordion title="start">
55-
Create or reuse a Browserbase session and set it as active for the current MCP transport session.
55+
Create a new Browserbase session, or attach to an existing Browserbase session, and set it as active for the current MCP transport session.
5656

57-
<Info>No input parameters required.</Info>
57+
<ParamField path="sessionId" type="string">
58+
Optional Browserbase session ID to attach to. If omitted, `start` creates a new Browserbase session.
59+
</ParamField>
5860

5961
<ResponseField name="sessionId" type="string">
60-
Browserbase session ID.
62+
Browserbase session ID now active for the current MCP transport session.
6163
</ResponseField>
6264
</Accordion>
6365

0 commit comments

Comments
 (0)