Skip to content

docs(mcp): bring tool reference up to date with implementation - #2134

Open
Dmitry Gozman (dgozman) wants to merge 1 commit into
microsoft:mainfrom
dgozman:mcp-docs-refresh
Open

docs(mcp): bring tool reference up to date with implementation#2134
Dmitry Gozman (dgozman) wants to merge 1 commit into
microsoft:mainfrom
dgozman:mcp-docs-refresh

Conversation

@dgozman

@dgozman Dmitry Gozman (dgozman) commented Sep 4, 2026

Copy link
Copy Markdown
Collaborator

Summary

  • Refresh mcp/ against the current tool definitions in playwright-core: element-targeting tools take target (a snapshot ref or a selector) rather than ref, browser_run_code is now browser_run_code_unsafe, and the parameter tables match the schemas again.
  • Document the tools that were missing: browser_find, browser_network_request, browser_drop, the highlight/annotate/recording tools and the video action overlays (new mcp/tools/devtools.mdx).
  • Drop tools that are not exposed over MCP and point at the equivalent MCP call, and remove --save-video, which no longer exists.
  • Add the orphaned tools/file-upload page to the sidebar.

Fixes microsoft/playwright#42517.

Refresh mcp/ against the current tool definitions in playwright-core:

- Element-targeting tools take `target` (a snapshot ref or a selector),
  not `ref`; `browser_drag` takes `startTarget`/`endTarget`.
- Rename `browser_run_code` to `browser_run_code_unsafe`.
- Document `browser_find`, `browser_network_request`, `browser_drop`,
  the highlight/annotate/recording tools and the video action overlays.
- Drop tools that are not exposed over MCP (`browser_reload`,
  `browser_check`, `browser_console_clear`, ...) and point at the
  equivalent MCP call instead.
- Fix parameter tables that did not match the schemas, notably
  `browser_network_requests`, `browser_evaluate`, `browser_route`,
  `browser_set_storage_state` and the verify tools.
- Remove `--save-video`, which no longer exists, and refresh the CLI
  option list and config schema.

@yury-s Yury Semikhatsky (yury-s) left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

do we need the same for CLI?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Docs]: Fix parameter name for element screenshots in browser_take_screenshot MCP Tool

2 participants