feat(mcp): add browser_set_checked tool by Suhaib3100 · Pull Request #38958 · microsoft/playwright

Suhaib3100 · 2026-01-26T10:12:08Z

Description

Adds a new browser_set_checked MCP tool that allows setting the checked state of checkboxes and radio buttons.

What does this PR do?

Adds browser_set_checked tool in packages/playwright/src/mcp/browser/tools/snapshot.ts
The tool accepts:
- element: Human-readable element description
- ref: Exact target element reference from the page snapshot
- checked: Boolean to set the checked state (true/false)
Generates Playwright code like await page.getByRole('checkbox', { name: 'Accept' }).setChecked(true);
Includes snapshot in response for verification

Why is this needed?

The existing browser_check and browser_uncheck tools are marked as skillOnly: true (not exposed to MCP). This new tool provides a single interface to both check and uncheck elements, which is the expected API for LLM agents interacting with forms.

Tests

Added tests/mcp/set-checked.spec.ts with 3 tests:

browser_set_checked (checkbox) - Tests checking and unchecking a checkbox
browser_set_checked (radio button) - Tests selecting a radio button
browser_set_checked (already checked) - Tests unchecking a pre-checked element

All tests pass locally with npm run ctest-mcp.

Fixes microsoft/playwright-mcp#1342

Adds a new browser_set_checked MCP tool that allows setting the checked state of checkboxes and radio buttons. This tool provides a single interface to both check and uncheck elements, complementing the existing browser_check and browser_uncheck tools. Fixes microsoft/playwright-mcp#1342

Suhaib3100 · 2026-01-26T10:14:38Z

@microsoft-github-policy-service agree

github-actions · 2026-01-27T22:34:39Z

Test results for "MCP"

107 failed
❌ [chrome] › mcp/capabilities.spec.ts:19 › test snapshot tool list @mcp-ubuntu-latest
❌ [chrome] › mcp/config.spec.ts:82 › sandbox configuration › should enable sandbox by default (no --no-sandbox flag) @mcp-ubuntu-latest
❌ [chromium] › mcp/capabilities.spec.ts:19 › test snapshot tool list @mcp-ubuntu-latest
❌ [chromium] › mcp/config.spec.ts:82 › sandbox configuration › should enable sandbox by default (no --no-sandbox flag) @mcp-ubuntu-latest
❌ [firefox] › mcp/capabilities.spec.ts:19 › test snapshot tool list @mcp-ubuntu-latest
❌ [firefox] › mcp/config.spec.ts:82 › sandbox configuration › should enable sandbox by default (no --no-sandbox flag) @mcp-ubuntu-latest
❌ [webkit] › mcp/capabilities.spec.ts:19 › test snapshot tool list @mcp-ubuntu-latest
❌ [webkit] › mcp/config.spec.ts:82 › sandbox configuration › should enable sandbox by default (no --no-sandbox flag) @mcp-ubuntu-latest
❌ [chrome] › mcp/capabilities.spec.ts:19 › test snapshot tool list @mcp-windows-latest
❌ [chrome] › mcp/cli.spec.ts:33 › core › open @mcp-windows-latest
❌ [chrome] › mcp/cli.spec.ts:48 › core › click button @mcp-windows-latest
❌ [chrome] › mcp/cli.spec.ts:58 › core › click link @mcp-windows-latest
❌ [chrome] › mcp/cli.spec.ts:87 › core › fill @mcp-windows-latest
❌ [chrome] › mcp/cli.spec.ts:104 › core › select @mcp-windows-latest
❌ [chrome] › mcp/cli.spec.ts:121 › core › uncheck @mcp-windows-latest
❌ [chrome] › mcp/cli.spec.ts:130 › core › eval @mcp-windows-latest
❌ [chrome] › mcp/cli.spec.ts:142 › core › eval @mcp-windows-latest
❌ [chrome] › mcp/cli.spec.ts:197 › navigation › go-forward @mcp-windows-latest
❌ [chrome] › mcp/cli.spec.ts:209 › keyboard › press @mcp-windows-latest
❌ [chrome] › mcp/cli.spec.ts:218 › keyboard › keydown keyup @mcp-windows-latest
❌ [chrome] › mcp/cli.spec.ts:238 › mouse › mousedown mouseup @mcp-windows-latest
❌ [chrome] › mcp/cli.spec.ts:249 › mouse › mousewheel @mcp-windows-latest
❌ [chrome] › mcp/cli.spec.ts:315 › devtools › console --clear @mcp-windows-latest
❌ [chrome] › mcp/cli.spec.ts:366 › config › user-data-dir @mcp-windows-latest
❌ [chrome] › mcp/cli.spec.ts:416 › session › session-stop @mcp-windows-latest
❌ [chrome] › mcp/cli.spec.ts:438 › session › session-stop-all @mcp-windows-latest
❌ [chromium] › mcp/capabilities.spec.ts:19 › test snapshot tool list @mcp-windows-latest
❌ [chromium] › mcp/cli.spec.ts:42 › core › close @mcp-windows-latest
❌ [chromium] › mcp/cli.spec.ts:96 › core › hover @mcp-windows-latest
❌ [chromium] › mcp/cli.spec.ts:130 › core › eval @mcp-windows-latest
❌ [chromium] › mcp/cli.spec.ts:142 › core › eval @mcp-windows-latest
❌ [chromium] › mcp/cli.spec.ts:197 › navigation › go-forward @mcp-windows-latest
❌ [chromium] › mcp/cli.spec.ts:209 › keyboard › press @mcp-windows-latest
❌ [chromium] › mcp/cli.spec.ts:218 › keyboard › keydown keyup @mcp-windows-latest
❌ [chromium] › mcp/cli.spec.ts:265 › save as › screenshot @mcp-windows-latest
❌ [chromium] › mcp/cli.spec.ts:280 › save as › screenshot --full-page @mcp-windows-latest
❌ [chromium] › mcp/cli.spec.ts:324 › devtools › network @mcp-windows-latest
❌ [chromium] › mcp/cli.spec.ts:355 › devtools › tracing-start-stop @mcp-windows-latest
❌ [chromium] › mcp/cli.spec.ts:377 › config › context options @mcp-windows-latest
❌ [firefox] › mcp/capabilities.spec.ts:19 › test snapshot tool list @mcp-windows-latest
❌ [firefox] › mcp/cli.spec.ts:42 › core › close @mcp-windows-latest
❌ [firefox] › mcp/cli.spec.ts:48 › core › click button @mcp-windows-latest
❌ [firefox] › mcp/cli.spec.ts:58 › core › click link @mcp-windows-latest
❌ [firefox] › mcp/cli.spec.ts:78 › core › type @mcp-windows-latest
❌ [firefox] › mcp/cli.spec.ts:104 › core › select @mcp-windows-latest
❌ [firefox] › mcp/cli.spec.ts:142 › core › eval @mcp-windows-latest
❌ [firefox] › mcp/cli.spec.ts:197 › navigation › go-forward @mcp-windows-latest
❌ [firefox] › mcp/cli.spec.ts:218 › keyboard › keydown keyup @mcp-windows-latest
❌ [firefox] › mcp/cli.spec.ts:238 › mouse › mousedown mouseup @mcp-windows-latest
❌ [firefox] › mcp/cli.spec.ts:249 › mouse › mousewheel @mcp-windows-latest
❌ [firefox] › mcp/cli.spec.ts:272 › save as › screenshot @mcp-windows-latest
❌ [firefox] › mcp/cli.spec.ts:280 › save as › screenshot --full-page @mcp-windows-latest
❌ [firefox] › mcp/cli.spec.ts:315 › devtools › console --clear @mcp-windows-latest
❌ [firefox] › mcp/cli.spec.ts:340 › devtools › network --clear @mcp-windows-latest
❌ [firefox] › mcp/cli.spec.ts:349 › devtools › run-code @mcp-windows-latest
❌ [firefox] › mcp/cli.spec.ts:391 › config › isolated @mcp-windows-latest
❌ [firefox] › mcp/cli.spec.ts:416 › session › session-stop @mcp-windows-latest
❌ [firefox] › mcp/cli.spec.ts:464 › session › session-delete named session @mcp-windows-latest
❌ [webkit] › mcp/capabilities.spec.ts:19 › test snapshot tool list @mcp-windows-latest
❌ [webkit] › mcp/cli.spec.ts:58 › core › click link @mcp-windows-latest
❌ [webkit] › mcp/cli.spec.ts:112 › core › check @mcp-windows-latest
❌ [webkit] › mcp/cli.spec.ts:121 › core › uncheck @mcp-windows-latest
❌ [webkit] › mcp/cli.spec.ts:130 › core › eval @mcp-windows-latest
❌ [webkit] › mcp/cli.spec.ts:170 › core › dialog-accept @mcp-windows-latest
❌ [webkit] › mcp/cli.spec.ts:179 › core › resize @mcp-windows-latest
❌ [webkit] › mcp/cli.spec.ts:188 › navigation › go-back @mcp-windows-latest
❌ [webkit] › mcp/cli.spec.ts:197 › navigation › go-forward @mcp-windows-latest
❌ [webkit] › mcp/cli.spec.ts:209 › keyboard › press @mcp-windows-latest
❌ [webkit] › mcp/cli.spec.ts:218 › keyboard › keydown keyup @mcp-windows-latest
❌ [webkit] › mcp/cli.spec.ts:238 › mouse › mousedown mouseup @mcp-windows-latest
❌ [webkit] › mcp/cli.spec.ts:249 › mouse › mousewheel @mcp-windows-latest
❌ [webkit] › mcp/cli.spec.ts:272 › save as › screenshot @mcp-windows-latest
❌ [webkit] › mcp/cli.spec.ts:280 › save as › screenshot --full-page @mcp-windows-latest
❌ [webkit] › mcp/cli.spec.ts:315 › devtools › console --clear @mcp-windows-latest
❌ [webkit] › mcp/cli.spec.ts:333 › devtools › network --static @mcp-windows-latest
❌ [webkit] › mcp/cli.spec.ts:340 › devtools › network --clear @mcp-windows-latest
❌ [webkit] › mcp/cli.spec.ts:355 › devtools › tracing-start-stop @mcp-windows-latest
❌ [webkit] › mcp/cli.spec.ts:416 › session › session-stop @mcp-windows-latest
❌ [webkit] › mcp/cli.spec.ts:426 › session › session-stop named session @mcp-windows-latest
❌ [webkit] › mcp/cli.spec.ts:452 › session › session-delete @mcp-windows-latest
❌ [msedge] › mcp/capabilities.spec.ts:19 › test snapshot tool list @mcp-windows-latest
❌ [msedge] › mcp/cli.spec.ts:33 › core › open @mcp-windows-latest
❌ [msedge] › mcp/cli.spec.ts:42 › core › close @mcp-windows-latest
❌ [msedge] › mcp/cli.spec.ts:48 › core › click button @mcp-windows-latest
❌ [msedge] › mcp/cli.spec.ts:71 › core › dblclick @mcp-windows-latest
❌ [msedge] › mcp/cli.spec.ts:87 › core › fill @mcp-windows-latest
❌ [msedge] › mcp/cli.spec.ts:104 › core › select @mcp-windows-latest
❌ [msedge] › mcp/cli.spec.ts:112 › core › check @mcp-windows-latest
❌ [msedge] › mcp/cli.spec.ts:121 › core › uncheck @mcp-windows-latest
❌ [msedge] › mcp/cli.spec.ts:149 › core › dialog-accept @mcp-windows-latest
❌ [msedge] › mcp/cli.spec.ts:160 › core › dialog-dismiss @mcp-windows-latest
❌ [msedge] › mcp/cli.spec.ts:170 › core › dialog-accept @mcp-windows-latest
❌ [msedge] › mcp/cli.spec.ts:179 › core › resize @mcp-windows-latest
❌ [msedge] › mcp/cli.spec.ts:197 › navigation › go-forward @mcp-windows-latest
❌ [msedge] › mcp/cli.spec.ts:218 › keyboard › keydown keyup @mcp-windows-latest
❌ [msedge] › mcp/cli.spec.ts:230 › mouse › mousemove @mcp-windows-latest
❌ [msedge] › mcp/cli.spec.ts:238 › mouse › mousedown mouseup @mcp-windows-latest
❌ [msedge] › mcp/cli.spec.ts:249 › mouse › mousewheel @mcp-windows-latest
❌ [msedge] › mcp/cli.spec.ts:272 › save as › screenshot @mcp-windows-latest
❌ [msedge] › mcp/cli.spec.ts:280 › save as › screenshot --full-page @mcp-windows-latest
❌ [msedge] › mcp/cli.spec.ts:297 › devtools › console @mcp-windows-latest
❌ [msedge] › mcp/cli.spec.ts:305 › devtools › console error @mcp-windows-latest
❌ [msedge] › mcp/cli.spec.ts:315 › devtools › console --clear @mcp-windows-latest
❌ [msedge] › mcp/cli.spec.ts:333 › devtools › network --static @mcp-windows-latest
❌ [msedge] › mcp/cli.spec.ts:377 › config › context options @mcp-windows-latest
❌ [msedge] › mcp/cli.spec.ts:452 › session › session-delete @mcp-windows-latest
❌ [msedge] › mcp/cli.spec.ts:464 › session › session-delete named session @mcp-windows-latest

2306 passed, 80 skipped

Merge workflow run.

pavelfeldman · 2026-01-28T21:29:24Z

Could you rebase?

pavelfeldman closed this Feb 7, 2026

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat(mcp): add browser_set_checked tool#38958

feat(mcp): add browser_set_checked tool#38958
Suhaib3100 wants to merge 1 commit intomicrosoft:mainfrom
Suhaib3100:feat/mcp-browser-set-checked

Suhaib3100 commented Jan 26, 2026

Uh oh!

Suhaib3100 commented Jan 26, 2026

Uh oh!

github-actions bot commented Jan 27, 2026

Uh oh!

pavelfeldman commented Jan 28, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

Suhaib3100 commented Jan 26, 2026

Description

What does this PR do?

Why is this needed?

Tests

Uh oh!

Suhaib3100 commented Jan 26, 2026

Uh oh!

github-actions bot commented Jan 27, 2026

Test results for "MCP"

Uh oh!

pavelfeldman commented Jan 28, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants