playwright-mcp-dev

Add and debug Playwright MCP tools and CLI commands with TypeScript.

Updated Feb 28, 2026
One-click install
npx skills add https://github.com/raphaelmans/agent-skills --skill playwright-mcp-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: playwright-mcp-dev
Source: https://github.com/raphaelmans/agent-skills/tree/main/playwright-mcp-dev
Command: npx skills add https://github.com/raphaelmans/agent-skills --skill playwright-mcp-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Explains how to add and debug Playwright MCP tools and CLI commands, unifying setup, registration, testing, and lint workflows.

Core Features & Use Cases

  • Guided MCP Tool Creation: Create a new tool file under packages/playwright/src/mcp/browser/tools/your-tool.ts and register it in packages/playwright/src/mcp/browser/tools.ts.
  • Registration & Configuration: Add ToolCapability in packages/playwright/src/mcp/config.d.ts and wire the tool into the CLI command set.
  • Testing & Lint: Place tests in tests/mcp/mcp-<category>.spec.ts and run npm run ctest-mcp <category>, with lint checks before commit.
  • CLI Integration: Extend CLI categories and commands as needed, updating docs and references accordingly.

Quick Start

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, and ensure the MCP workflow is wired for testing.

Frequently Asked Questions about playwright-mcp-dev

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a new Playwright MCP tool to my project?

To register a Playwright MCP tool, add ToolCapability in packages/playwright/src/mcp/config.d.ts and wire the tool into the CLI command set. This configuration unifies setup, registration, and CLI workflows for the Playwright project.

How do I test Playwright MCP tools and CLI commands?

To test Playwright MCP tools, place your tests in tests/mcp/mcp-<category>.spec.ts and run npm run ctest-mcp <category>. You must also run lint checks before committing your changes to ensure code quality.

What is the required project structure for Playwright MCP development?

Playwright MCP development requires access to the project structure under packages/playwright and tests/mcp. The setup uses TypeScript tooling and npm scripts like ctest-mcp to manage testing and integration workflows.

Can I extend CLI categories when adding Playwright MCP tools?

Yes, you can extend CLI categories and commands as needed when adding Playwright MCP tools. You must update the CLI command set, configuration, and any relevant docs and references accordingly to maintain integration.

Does Playwright MCP development require TypeScript tooling?

Yes, Playwright MCP development requires TypeScript tooling and npm scripts for ctest-mcp. The project structure under packages/playwright and tests/mcp relies on TypeScript to manage tool creation, integration, and lint workflows.

Why do I need to run lint checks before committing Playwright MCP tools?

You need to run lint checks before committing Playwright MCP tools to maintain code quality across the project structure. The lint workflow unifies setup, registration, and testing processes for packages/playwright and tests/mcp.