Playrunner — Claude Code MCP server for Playwright tests
Playrunner connects an AI agent to Playwright workflows in the cloud, so it can launch checks and inspect their results. Use it to rerun browser tests after code changes.
claude mcp add --transport http mcp https://playrunner.cloud/mcpWhat Playrunner does
The MCP server links an agent to Playrunner Cloud. It can find projects, create workflows, start runs, and inspect their results. Reports include logs and run artefacts such as traces, screenshots, and video.
Build a workflow from an existing Playwright repository or an inline script. Choose an environment, optionally select an Authentication Profile, then pick local Docker, managed cloud runners, or self-hosted execution. Saved workflows can also be used by teammates and CI.
The connection requires an MCP client that supports remote Streamable HTTP and OAuth. A shell-capable agent can use the CLI instead. Starting a job does not mean its tests passed, so check the report before treating the run as successful.
What it helps with
- rerun browser checks after a code change
- find which tests failed in a workflow run
- inspect traces and screenshots from a failed run
- let CI start a saved Playwright workflow
Example prompts for the agent
- Run the checkout smoke workflow once and tell me which tests passed or failed, with the report links.
- Find my Playrunner projects and create a workflow for the Playwright tests in this repository.
- Inspect the latest run and show its report, traces, and screenshots.
How to install Playrunner
Platform CLI: remote server
claude mcp add --transport http mcp https://playrunner.cloud/mcpPlatform CLI: remote server
codex mcp add playrunner --url https://playrunner.cloud/mcpConfig file
{
"mcpServers": {
"playrunner": {
"url": "https://playrunner.cloud/mcp"
}
}
}Config file
{
"servers": {
"playrunner": {
"type": "http",
"url": "https://playrunner.cloud/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http playrunner https://playrunner.cloud/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Playrunner
How do I install Playrunner in Codex?
Add the server with codex mcp add playrunner --url https://playrunner.cloud/mcp. Once connected, Codex can use Playrunner Cloud workflows.
What does Playrunner do?
It connects an MCP agent to Playwright workflows in the cloud. The agent can find projects, start checks, and inspect their results.
What is required to connect Playrunner?
Use an MCP client with remote Streamable HTTP and OAuth support. Alternatively, connect through the CLI from an agent that can run shell commands.
