# Playrunner

> Playrunner is an MCP server for developer tools. Find Playwright workflows, start runs and read results in Playrunner Cloud from your agent. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free trial
- **Starting price:** $30 a month
- **Platforms:** Web, CLI, API, self-hosted
- **Website:** https://playrunner.dev
- **Repository:** https://github.com/playrunner/playrunner
- **MCP Registry name:** dev.playrunner/mcp
- **Categories:** developer tools, browser automation
- **Listing updated:** 2026-11-16

## About

The pitch is a safety net for code an AI agent has written. Instead of asking a model to reason through every browser step again, an agent starts a saved Playwright workflow by its ID, reads new run events without refetching earlier ones, and opens the report, trace or video only when it needs to investigate. Failures return the failing step, expected result and captured evidence, and run history is kept so a later conversation or teammate can pick up where the last one stopped.

Workflows combine an existing Playwright test or inline script with an environment, an optional authentication profile and a place to run. They can also be started from a visual editor, the CLI or a schedule. The README lists Codex, Claude, Cursor, Gemini CLI, Antigravity and Grok as clients, and asks for remote Streamable HTTP with OAuth or a shell-capable agent using the CLI.

Playrunner can be self-hosted under its Sustainable Use License, which is source-available rather than open source and forbids selling it or offering a service built on it. Cloud costs $30 a month with 2,000 credits, a 14-day trial with 200 credits, and usage-based credits for orchestration and runner compute.

## Features

- **Saved test workflows:** Turn Playwright tests into reusable workflows an agent can start by ID.
- **Evidence-first results:** Returns failing step, expected result, logs, traces, screenshots and video.
- **Incremental run events:** Agents read only new events since their last check.
- **Environments and sign-ins:** Reuse environments and authentication profiles across runs.
- **Run history:** Earlier failures and later runs stay available across conversations.
- **Self-host or Cloud:** Run locally under the source-available license or use managed orchestration.

## Good for

- Have an agent run a checkout smoke test after each change
- Investigate a failing booking flow using traces and screenshots
- Check that a two-way customer sync creates no duplicates
- Share test evidence with QA and release owners

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mcp https://playrunner.cloud/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://playrunner.cloud/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp": {
      "url": "https://playrunner.cloud/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://playrunner.cloud/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "serverUrl": "https://playrunner.cloud/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://playrunner.cloud/mcp"
    }
  }
}
```

## FAQ

### Is Playrunner open source?

No. It is source-available under the Playrunner Sustainable Use License, which is not OSI-approved.

### What does Cloud cost?

$30 a month before tax with 2,000 credits, plus $10 per 1,000 extra credits.

### Can I use my own runners?

Yes. Own runners avoid the compute charge, but hosted orchestration still uses 0.25 credits per minute.

### Which agents work with it?

Codex, Claude, Cursor, Gemini CLI, Antigravity and Grok are listed.

### Is Playrunner free?

Playrunner is a paid product with a free trial. Paid plans start at $30 a month.

### How do I add Playrunner to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp https://playrunner.cloud/mcp

### What are the best alternatives to Playrunner?

The closest alternatives to Playrunner are REA, Browser Use, Scrapling MCP Server, Codebase Memory and GitHub.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Browser Use](https://ai-powered.com/mcp/browser-use): Browser Use is a freemium MCP server for browser automation.
- [Scrapling MCP Server](https://ai-powered.com/mcp/scrapling-mcp-server): Scrapling MCP Server is an open-source MCP server for web search and scraping.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/playrunner
