Docs

Quick start for MCP mobile QA.

Install free and open-source Swipium, register it with an MCP client, and start with qa_test_this to run simulator-based checks with evidence and reports.

Verify

npx -y swipium verify

Starts the server, checks that all 55 tools are listed, and runs qa_doctor on your toolchain.

Install

npm install -g swipium
swipium verify

Use a global install when you want a stable local binary for multiple mobile repositories.

Configure

swipium init codex --apply
swipium init gemini --apply
swipium init cursor --apply
swipium init vscode --apply
swipium init claude \
  --scope project --apply

Register Swipium with your agent client from the mobile app repository root. Run without --apply to preview the change first.

Run

qa_test_this {
  "goal": "smoke",
  "waitForCompletion": true
}

Runs by default after you approve the consent prompt. Poll qa_job_status if it is still going, then read report.md. Pass mode:"plan" for a preview with no side effects.

CI reports

npx swipium report \
  --latest --format junit \
  --out swipium.xml \
  --fail-on-gate

Export a finished run as JUnit, SARIF, or a GitHub summary. CI still needs an agent to drive the app. CI guide

Upgrading to 2.3

Use Node.js 22.12 or newer and restart your MCP client. qa_test_this now runs by default, and CI gates fail on runs that tested nothing.

Upgrade checklist

Full reference lives in the repository.

Open GitHub docs