Lets an AI client execute browser and mobile app tests using plain-language steps and inspect run transcripts and recordings.
Also known as tester-army/cli, cli
- Stars
- 75
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.0.0
- Last commit
- Nov 12, 2026
- License
- MIT
What is TesterArmy MCP?
TesterArmy lets an AI client execute browser and mobile app tests using plain-language steps and inspect run transcripts and recordings.
Summary generated from the project's README
About TesterArmy MCP server
TesterArmy provides a way for AI clients to perform quality assurance for browser and mobile applications. It allows users to create and organize tests using plain-language steps, which are then executed in the TesterArmy cloud. Developers can use the CLI or a hosted MCP server to manage these processes, making it possible to automate testing directly through an agentic workflow.
Users can interact with the service via the testerarmy CLI or by connecting to the hosted MCP server at the provided URL. When using the hosted server, authentication is handled through OAuth with a TesterArmy account, removing the need for manual API key management. The system supports various clients including Claude Code, Codex, and Cursor. Once tests are running, the tool provides access to run transcripts, recordings, and JUnit reports to help identify and triage issues.
What you can do with it
- 1Execute browser and mobile testsAsk the AI to run specific browser or mobile checks against a saved environment.
- 2Review test execution detailsRequest the AI to inspect the results of a test run using transcripts or recordings.
- 3Validate development changesDirect the agent to run tests against a specific preview or tunnel URL to verify new code.
- 4Manage test suitesHave the AI list and organize projects and saved tests within the dashboard.
Written from the project's README. Every use case is checked against a quote from it.
How to install TesterArmy MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall TesterArmy MCP in Claude Code
$ claude mcp add --transport http cli https://tester.army/mcpInstall TesterArmy MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"cli": {
"url": "https://tester.army/mcp"
}
}
}Install TesterArmy MCP in VS Code
.vscode/mcp.json
{
"servers": {
"cli": {
"type": "http",
"url": "https://tester.army/mcp"
}
}
}Install TesterArmy MCP in VS Code CLI
$ code --add-mcp '{"name":"cli","type":"http","url":"https://tester.army/mcp"}'Install TesterArmy MCP in Codex
$ codex mcp add cli --url https://tester.army/mcpInstall TesterArmy MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.cli] url = "https://tester.army/mcp"
Install TesterArmy MCP in Gemini CLI
$ gemini mcp add -s user --transport http cli https://tester.army/mcpInstall TesterArmy MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"cli": {
"url": "https://tester.army/mcp",
"type": "http"
}
}
}Automated checks
Ran Nov 13, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablePass
- Open source license (OSI)Pass
- Commit or release in the last yearPass
- Package name not close to a popular packageNot checked
- Remote endpoint uses HTTPSPass
- Destructive tools are labelledNot checked
- No hidden instructions to the modelPass
- No critical advisory in the package or its dependenciesNot checked
README
View on GitHubAgents 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, recordings, and JUnit reports.
- Schedule groups, explore with discovery runs, and triage the issues they find.
- Feed concrete validation back to coding agents.
Start here:
- Docs: tester.army/docs
- Platform: tester.army
- API keys: tester.army/dashboard/profile/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 <nameOrSlug>.
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. MCP and the CLI cover the same features; pick whichever your agent drives more easily.
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
The plugin registers the hosted server for you; sign in once with codex mcp login testerarmy, or accept the sign-in prompt the ChatGPT app shows at install. In the ChatGPT desktop app, open this repository in Codex and the marketplace appears as a source in the Plugins tab.
Full reference for the server and its tools: https://docs.tester.army/cli/mcp
Examples
Use the markdown scenarios in examples/ as authoring
references when creating saved dashboard tests with ta tests create.
examples/TESTER.mdexamples/tests/01-landing-page.mdexamples/tests/02-auth-smoke.mdexamples/tests/03-project-create.mdexamples/prompts/ad-hoc-regression.md
Run a saved smoke group:
ta groups list --project <projectId> --json
ta tests run --group <groupId> --project <projectId> --wait --json
Contributing
PRs welcome, especially for:
- improving skill quality and references
- better issue templates and triage process
- better real-world test examples
License
MIT
TesterArmy MCP questions
How do I add TesterArmy MCP to Claude Code?
Run claude mcp add --transport http cli https://tester.army/mcp in your terminal. Add --scope user to make it available in every project.
How do I add TesterArmy MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
How do I authenticate with the TesterArmy MCP server?
The hosted MCP server uses OAuth to sign you in with your TesterArmy account, so you do not need to create or paste an API key.
Can I run tests against a local development environment?
Yes, you can save a cloud-reachable preview or tunnel URL as a project environment and select it during the run.
What kind of test results can I inspect?
You can inspect run transcripts, recordings, and JUnit reports.