Fix execute_playwright_code tool docs

[dprevoznik]

Summary

The execute_playwright_code reference page had two issues, mirroring the tool-description fix in kernel-mcp-server#125:

1. page._snapshotForAI() doesn't work. The Tip recommended it for "a comprehensive page state snapshot," but it's a Playwright internal that isn't exposed in the stealth-patched execution runtime — it throws TypeError: page._snapshotForAI is not a function. It's also a whole-page dump (heavy on tokens). Replaced with region-scoped guidance: prefer a targeted selector or a region-scoped ariaSnapshot() rather than dumping the whole page.
2. Incomplete scope. The code param said "a page object in scope." Per browsers/playwright-execution, page, context, and browser are all in scope. Updated, and noted that the returned value is what's sent back.

Docs-only.

Preview

reference/mcp-server/tools/execute-playwright-code

---

Note

Low Risk
Documentation-only changes to an MCP tool reference page; no runtime or API behavior changes.

Overview
Updates the execute_playwright_code MCP reference so it matches the real execution runtime and Playwright guidance.

The Tip no longer suggests page._snapshotForAI() (not available in the stealth-patched VM and token-heavy). It now steers agents toward targeted reads — e.g. innerText() on a locator or ariaSnapshot() on a region — instead of whole-page dumps, while still recommending computer_action screenshots over page.screenshot().

The code parameter description now documents page, context, and browser in scope and that the return value is what the tool sends back.

^{Reviewed by Cursor Bugbot for commit add1760. Bugbot is set up for automated code reviews on this repo. Configure here.}

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
Kernel	🟢 Ready	View Preview	Jul 21, 2026, 9:41 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

[cursor]

Risk assessment: Very Low

This changes two lines in one documentation page: it clarifies the Playwright objects and return value available to execute_playwright_code, and replaces a broad page-snapshot recommendation with targeted selectors or scoped accessibility snapshots. There are no production codepaths, prompts, dependencies, configuration, infrastructure, or security boundaries affected. The blast radius is limited to user-facing reference guidance, and no CODEOWNERS file requires an ownership review.

  

_{Sent by Cursor Automation: Assign PR reviewers}