# TurnSignal for Playwright

> TurnSignal for Playwright is a freemium MCP server for browser automation. Read-only Playwright CI results for agents: new versus known failures and flaky tests. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $44 a month
- **Platforms:** CLI, Web
- **Website:** https://turnsignal.ai
- **MCP Registry name:** ai.turnsignal/turnsignal
- **Categories:** browser automation, developer tools
- **Listing updated:** 2026-11-16

## About

TurnSignal is a Playwright reporting service, and this server gives a coding agent read access to its results. After a red run the agent can ask whether a failure is new on the branch, was already failing on the default branch, is known flaky, or never reported at all because a shard crashed. Flaky tests come with evidence over 7 to 90 days and the exact runs and attempts behind each label.

The reporter behind the data writes results to disk in CI before sending them, so a killed runner leaves a list of missing tests with the likely cause and the lowest free memory seen. It fails open: if the API is down, tests run as normal and the exit code is untouched. Common secret formats are redacted in errors and traces before leaving CI.

The server runs locally as an npm package over stdio and needs a project token from app.turnsignal.ai, used read-only. A TURNSIGNAL_API_URL variable points it at a self-hosted server. The site says every feature is free during the public beta.

## Features

- **Failure classification:** Labels failures as new, also failing on main, known flaky or missing.
- **Missing-test detection:** Lists tests a crashed shard never finished, with the likely reason.
- **Flaky history:** Shows how often a test was flaky over 7 to 90 days, with the runs behind it.
- **PR verdicts:** The service posts a plain-language verdict as a sticky GitHub PR comment.
- **Fails open:** The reporter never changes your CI exit code if the API is down.
- **Secret redaction:** Common token and password formats are redacted before upload.

## Good for

- Ask an agent whether a PR broke a test or it was already failing
- Triage flaky Playwright tests with run evidence
- Find tests lost to a crashed CI shard
- Review test history before merging

## Install

### Claude Code (Terminal)

```sh
claude mcp add turnsignal --env TURNSIGNAL_TOKEN='<TURNSIGNAL_TOKEN>' -- npx -y turnsignal
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "turnsignal": {
      "command": "npx",
      "args": [
        "-y",
        "turnsignal"
      ],
      "env": {
        "TURNSIGNAL_TOKEN": "<TURNSIGNAL_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "turnsignal": {
      "command": "npx",
      "args": [
        "-y",
        "turnsignal"
      ],
      "env": {
        "TURNSIGNAL_TOKEN": "<TURNSIGNAL_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "turnsignal": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "turnsignal"
      ],
      "env": {
        "TURNSIGNAL_TOKEN": "<TURNSIGNAL_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "turnsignal": {
      "command": "npx",
      "args": [
        "-y",
        "turnsignal"
      ],
      "env": {
        "TURNSIGNAL_TOKEN": "<TURNSIGNAL_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "turnsignal": {
      "command": "npx",
      "args": [
        "-y",
        "turnsignal"
      ],
      "env": {
        "TURNSIGNAL_TOKEN": "<TURNSIGNAL_TOKEN>"
      }
    }
  }
}
```

## FAQ

### What credentials does the server need?

A project token from app.turnsignal.ai, set as TURNSIGNAL_TOKEN and used read-only.

### Is it free?

The site says every feature is free during the public beta, with limits of 3,000 runs and 300,000 test results a month per organization.

### Will it break my CI if it is down?

No. The reporter fails open and results stay on disk for a later upload.

### Can I self-host the API?

The registry entry lists a TURNSIGNAL_API_URL variable for a self-hosted server.

### Is TurnSignal for Playwright free?

TurnSignal for Playwright has a free plan, with paid plans for more usage or features. Paid plans start at $44 a month.

### How do I add TurnSignal for Playwright to Claude Code?

Run this command in your terminal: claude mcp add turnsignal --env TURNSIGNAL_TOKEN='<TURNSIGNAL_TOKEN>' -- npx -y turnsignal

### What are the best alternatives to TurnSignal for Playwright?

The closest alternatives to TurnSignal for Playwright 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/turnsignal-for-playwright
