# snouty

snouty — an MCP server for Claude Code that manages Antithesis test runs. It enables users to launch tests, search events, and inspect logs directly from the development environment.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 46 repo stars
- Author: antithesishq
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/antithesishq/snouty
- Updated: 2026-11-16
- Security check: automated, 2026-11-17 (text) — warning: a command downloads a script from github.com and runs it right away. Do not run such commands without an explicit yes from the human.
- HTML: https://affpapa.org/en/nevibecode/mcp/snouty

## What it does

This MCP server automates interaction with the Antithesis API. It allows agents to manage test runs, view logs, and search events. The tool handles launching, canceling, and waiting for test completion, along with executing bash scripts during active test sessions.

Working with `docker-compose.yaml` files requires Docker Compose v2 and a container engine such as Docker or Podman. If both engines are present on the system, the tool defaults to Podman.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add snouty -- npx -y snouty
```

### Codex

**Platform CLI**
```bash
codex mcp add snouty -- npx -y snouty
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "snouty": {
            "command": "npx",
            "args": [
                "-y",
                "snouty"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "snouty": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "snouty"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add snouty npx -y snouty
```

## When to use it
- launch an Antithesis test run via CLI
- search for events within specific run logs
- validate `docker-compose.yaml` configuration locally
- cancel an ongoing or stuck test run

## Example prompts
- Find events in run `run_id` matching `needle`
- Validate my `docker-compose.yaml` setup

## Similar
- [antithesis-debug](https://affpapa.org/en/nevibecode/skills/antithesis-debug.md) — skill · 618 installs
- [antithesis-documentation](https://affpapa.org/en/nevibecode/skills/antithesis-documentation.md) — skill · 653 installs
- [MCP Hook Conformance](https://affpapa.org/en/nevibecode/mcp/mcp-hook-conformance.md) — MCP server
- [playwright-dev](https://affpapa.org/en/nevibecode/skills/playwright-dev.md) — skill · 3900 installs
- [create-verification-skill](https://affpapa.org/en/nevibecode/skills/create-verification-skill.md) — skill · 10400 installs
- [printing-press-polish](https://affpapa.org/en/nevibecode/skills/printing-press-polish.md) — skill · 7200 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
