
Playwright Mcp Dev
- 2 installs
- 1 repo stars
- Updated May 27, 2026
- remorses/playwright
Explains how to add and debug Playwright MCP browser tools and their corresponding CLI commands within the Playwright repo.
About
Documents where to create and register new Playwright MCP tools, CLI commands, capabilities and tests. Contributors use it when extending or debugging Playwright's MCP browser tools and CLI.
- Steps to create, register and add capabilities for a new MCP tool
- CLI commands derive from MCP tools; update the SKILL.md and run ctest-mcp
Playwright Mcp Dev by the numbers
- 2 all-time installs (skills.sh)
- Ranked #13,956 of 16,546 AI & Agent Building skills by installs in the Skillselion catalog
- Data as of Aug 4, 2026 (Skillselion catalog sync)
npx skills add https://github.com/remorses/playwright --skill playwright-mcp-devAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 2 |
|---|---|
| repo stars | ★ 1 |
| Last updated | May 27, 2026 |
| Repository | remorses/playwright ↗ |
What it does
Explains how to add and debug Playwright MCP browser tools and their corresponding CLI commands within the Playwright repo.
Files
MCP
Adding MCP Tools
- Create a new tool in
packages/playwright/src/mcp/browser/tools/your-tool.ts - Register the tool in
packages/playwright/src/mcp/browser/tools.ts - Add ToolCapability in
packages/playwright/src/mcp/config.d.ts - Place new tests in
tests/mcp/mcp-<category>.spec.ts
Building
- Assume watch is running at all times, run lint to see type errors
Testing
- Run tests as
npm run ctest-mcp <category> - Do not run test --debug
CLI
Adding commands
- CLI commands are based on MCP tools. Implement the corresponding MCP tool as per
Adding MCP Toolssection above, if needed. - Add new CLI category for tool if needed:
- Add Category in
packages/playwright/src/mcp/terminal/command.ts - Update doc generator
packages/playwright/src/mcp/terminal/helpGenerator.ts - Register command in
packages/playwright/src/mcp/terminal/commands.ts - Update skill file at
packages/playwright/src/skill/SKILL.mdand references if necessary
in packages/playwright/src/skill/references/
- Place new tests in
tests/mcp/cli-<category>.spec.ts
Building
- Assume watch is running at all times, run lint to see type errors
Testing
- Run tests as
npm run ctest-mcp cli-<category> - Do not run test --debug
Lint
- run
npm run flintto lint everything before commit
SKILL File
The skill file is located at packages/playwright/src/skill/SKILL.md. It contains documentation for all available CLI commands and MCP tools. Update it whenever you add new commands or tools. At any point in time you can run "npm run playwright-cli -- --help" to see the latest available commands and use them to update the skill file.