# TesterArmy

Hooks cloud runs of your saved tests into a coding agent: browser and mobile checks with plain-language steps, results back as JSON.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 72
- Author: tester-army
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/tester-army/cli
- Updated: 2026-09-21
- HTML: https://affpapa.org/en/nevibecode/mcp/testerarmy

## What it does

The server sits at `https://tester.army/mcp` and speaks Streamable HTTP. Sign-in goes through your TesterArmy account with OAuth, so there is no API key to make or paste. From the agent you build and group saved tests whose steps are written in ordinary words, then fire them in TesterArmy cloud against a stored environment.

Runs can be awaited and transcripts read, which gives the agent a concrete failure to act on. A CLI ships alongside: `testerarmy`, shortened to `ta`. It lists projects and their tests and puts runs in the queue. Without `--wait`, a successful call means only that the run was queued — pass the flag when you want validation.

For a run to hit your latest build, keep the preview or tunnel address in a project environment and pick it with `--env <nameOrSlug>`. That address has to be reachable from the cloud; otherwise the check runs against something other than your changes. The repository doubles as a plugin that brings the server and the `testerarmy-cli` skill together. Codex asks you to log in once with `codex mcp login testerarmy`.

## Requirements
- Remote server: `https://tester.army/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http testerarmy https://tester.army/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add testerarmy --url https://tester.army/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "testerarmy": {
            "url": "https://tester.army/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "testerarmy": {
            "type": "http",
            "url": "https://tester.army/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http testerarmy https://tester.army/mcp
```

## When to use it
- Run a saved browser test set against a fresh preview build
- Fire mobile app checks in the cloud and wait for the transcript
- Write a test scenario in plain language and keep it in the dashboard
- Hand a coding agent the exact failure instead of a raw log
- Re-run a smoke group before merging

## Example prompts
- Find my TesterArmy project and run the saved test, then wait for the result
- Save a test: open the landing page, log in, check the profile heading
- Run the smoke group on the preview environment and list what broke

## Similar
- [Front-End Checklist](https://affpapa.org/en/nevibecode/mcp/front-end-checklist.md) — MCP server · ★ 74559
- [Keploy](https://affpapa.org/en/nevibecode/mcp/keploy.md) — MCP server · ★ 18727
- [SeleniumBase MCP](https://affpapa.org/en/nevibecode/mcp/seleniumbase-mcp.md) — MCP server · ★ 13169
- [mobile-mcp](https://affpapa.org/en/nevibecode/mcp/mobile-mcp.md) — MCP server · ★ 9946
- [e2e](https://affpapa.org/en/nevibecode/mcp/e2e.md) — MCP server · ★ 11912
- [mockserver](https://affpapa.org/en/nevibecode/mcp/mockserver.md) — MCP server · ★ 4996

---
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