TesterArmy MCP server

Quickstart | Docs | Platform | API Keys | Skills | MCP | Examples

Agents that test your app like real users.

TesterArmy CLI (testerarmy / ta) manages QA coverage in the TesterArmy dashboard and queues runs that execute in TesterArmy cloud.

• Create and organize saved tests with plain-language steps.
• Run browser and mobile checks against saved environments.
• Wait for results and inspect run transcripts through JSON output.
• Feed concrete validation back to coding agents.

Start here:

tester.army/dashboard/profile/api-keys

• Docs: tester.army/docs
• Platform: tester.army
• API keys:

https://github.com/user-attachments/assets/f7524c3f-018e-46eb-9bae-cb69335fda64

Quickstart

Install globally:

npm install -g testerarmy

Then create API key:

tester.army/dashboard/profile/api-keys

Authenticate (pick one):

ta auth

Or run without install:

npx testerarmy --help

Find a project and its saved tests, then wait for a cloud run:

ta projects list --json
ta tests list --project <projectId> --json
ta tests run <testId> --wait --json

Use IDs returned by the list commands. Without --wait, a successful command only confirms that the run was queued. To validate development changes, save a cloud-reachable preview or tunnel URL as a project environment and select it with --env .

Skill Installation

Use skills CLI install:

npx skills add tester-army/cli

MCP server and plugins

TesterArmy also runs as a hosted MCP server at https://tester.army/mcp (Streamable HTTP). It signs you in with your TesterArmy account through OAuth, so there is no API key to create or paste.

Claude Code:

claude mcp add --transport http testerarmy https://tester.army/mcp

Codex:

codex mcp add testerarmy --url https://tester.army/mcp

Or add it to ~/.codex/config.toml and run codex mcp login testerarmy:

[mcp_servers.testerarmy]
url = "https://tester.army/mcp"

Cursor: open Customize and search for testerarmy, or click Add to Cursor on the marketplace listing. If the plugin is not listed yet, add the server by hand to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "testerarmy": {
      "url": "https://tester.army/mcp"
    }
  }
}

This repo is also a plugin that installs the MCP server and the testerarmy-cli skill together.

Claude Code: run /plugin marketplace add tester-army/cli, then /plugin install testerarmy@testerarmy-agent-skills.

Codex: the repo is a plugin marketplace too, so until TesterArmy appears in the Plugins Directory you can add it from here:

codex plugin marketplace add tester-army/cli
codex plugin add testerarmy@testerarmy-agent-skills

Shortened. The full README is on GitHub.