Skip to content

feat(mcp): add browser_set_checked tool #38958

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Open
Suhaib3100 wants to merge 1 commit into
base: main
Choose a base branch
from
Open

feat(mcp): add browser_set_checked tool #38958

Suhaib3100 wants to merge 1 commit into from
+156 −0

Conversation

@Suhaib3100
Copy link

@Suhaib3100 Suhaib3100 commented Jan 26, 2026

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

@Suhaib3100
feat(mcp): add browser_set_checked tool
4a32044 
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
Copy link
Author

Suhaib3100 commented Jan 26, 2026

@microsoft-github-policy-service agree

@github-actions
Copy link
Contributor

github-actions bot commented Jan 27, 2026

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
Copy link
Member

pavelfeldman commented Jan 28, 2026

Could you rebase?

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

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

[Bug]: browser_set_checked mcp tool is missing

2 participants

@Suhaib3100 @pavelfeldman