# Squally

This MCP server for Claude Code reads test analytics from Squally. It surfaces flaky tests, failure causes, and CI time spent on retries.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: squallydev-admin
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/squallydev-admin/squally-mcp
- Updated: 2026-11-16
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/squally

## What it does

Squally gives an agent access to Playwright run data and per-test results. It can locate a run, inspect a failing test’s error and stack, check test stability, and group recurring error signatures across runs.

The server runs locally over stdio and connects to Squally’s API over HTTPS. Access is read-only: an organization key covers that organization’s projects, but does not expose secrets, webhook URLs, screenshots, videos, or traces. It requires Node 22 or newer, an organization read key, and Squally’s Standard plan. A project ingest key used to send Playwright results is rejected.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `SQUALLY_API_KEY`, `SQUALLY_API_URL`, `SQUALLY_USE_SYSTEM_CA` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env SQUALLY_API_KEY=<SQUALLY_API_KEY> --env SQUALLY_API_URL=<SQUALLY_API_URL> --env SQUALLY_USE_SYSTEM_CA=<SQUALLY_USE_SYSTEM_CA> --transport stdio squally -- npx -y squally-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add squally --env SQUALLY_API_KEY=<SQUALLY_API_KEY> --env SQUALLY_API_URL=<SQUALLY_API_URL> --env SQUALLY_USE_SYSTEM_CA=<SQUALLY_USE_SYSTEM_CA> -- npx -y squally-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "squally": {
            "command": "npx",
            "args": [
                "-y",
                "squally-mcp"
            ],
            "env": {
                "SQUALLY_API_KEY": "<SQUALLY_API_KEY>",
                "SQUALLY_API_URL": "<SQUALLY_API_URL>",
                "SQUALLY_USE_SYSTEM_CA": "<SQUALLY_USE_SYSTEM_CA>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "squally": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "squally-mcp"
            ],
            "env": {
                "SQUALLY_API_KEY": "<SQUALLY_API_KEY>",
                "SQUALLY_API_URL": "<SQUALLY_API_URL>",
                "SQUALLY_USE_SYSTEM_CA": "<SQUALLY_USE_SYSTEM_CA>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e SQUALLY_API_KEY=<SQUALLY_API_KEY> -e SQUALLY_API_URL=<SQUALLY_API_URL> -e SQUALLY_USE_SYSTEM_CA=<SQUALLY_USE_SYSTEM_CA> squally npx -y squally-mcp
```
Replace <…> with your own values

## When to use it
- find tests that pass only after a retry
- inspect why a test failed in a particular run
- measure CI time lost to retries and failures
- group recurring errors across test runs

## Example prompts
- Find flaky tests in the project and show how often they retry.
- Investigate the failure of `checkout.spec.ts` in the latest run on the main branch.
- Group errors from the period and show which tests fail most often.

## Similar
- [Webhook Tester — Send & Measure HTTP Endpoints](https://affpapa.org/en/nevibecode/mcp/webhook-tester-send-measure-http-endpoints.md) — MCP server · 2465 installs
- [pentest-mcp-server](https://affpapa.org/en/nevibecode/mcp/pentest-mcp-server.md) — MCP server · 1203 installs
- [run-tests-after-changes](https://affpapa.org/en/nevibecode/hooks/run-tests-after-changes.md) — hook · 1967 installs
- [tdd](https://affpapa.org/en/nevibecode/skills/pandoscope-tdd.md) — skill · 1900 installs
- [alan-test-feature](https://affpapa.org/en/nevibecode/skills/alan-test-feature.md) — skill · 1800 installs
- [api-security-best-practices](https://affpapa.org/en/nevibecode/skills/api-security-best-practices.md) — skill · 1739 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
