Skip to main content
Use the TesterArmy MCP server to create tests, run tests, and debug failed runs from your coding agent.

Quick start

  1. Add the server to the coding agents that add-mcp finds:
  2. Sign in from each client.
To add the server to the current repository only, remove --global. add-mcp does not configure Claude, and ignores CLAUDE_CONFIG_DIR. For these, use Setup.

Setup

Authenticate

Sign in once per client with your TesterArmy account. You do not need an API key. Your browser opens the TesterArmy sign-in page. Sign in and go back to your client. The client refreshes the token automatically. To check the connection, ask the agent: “List my TesterArmy projects.” To change accounts, sign out in your client and sign in again. In Codex, run codex mcp logout testerarmy.
The MCP server does not accept API keys. For CI, use the CLI or the API with an API key.

Teams

One sign-in gives access to all your teams. If you are in more than one team, tell the agent which team to use. The agent can call list_teams to find it.

What your agent can do

  • Create projects, environments, credentials, and project memories.
  • Upload mobile app builds.
  • Create, edit, and delete tests and groups.
  • Run tests and groups. Schedule groups.
  • Read transcripts, console logs, and network requests of a run.
  • Get a download link for a run video.
The agent can load TesterArmy best practices with the get_guide tool. Example prompts:

Security

  • Each tool call checks your current team membership.
  • The MCP server does not see your password.
  • Tools do not return stored passwords. Transcripts hide steps that use credentials.
  • The agent can delete projects, tests, and groups. Connect only clients that you trust.

Troubleshooting

Your client is not signed in. Sign in and try again. If no browser opens, use mcp-remote (see the Other tab).
You are in more than one team. Tell the agent the team name.
Telemetry is available after the run ends. Mobile runs have app logs only when the run installs an uploaded app. Safari runs on iOS have no telemetry. Use the transcript instead.