simzo

Command palette

Go to a page or run a command

Sign inStart testing

Quickstart

  1. 1

    Paste this prompt into your AI agent. It signs you in, adds the SIMZO MCP server and checks which phones are free.

    Agent promptSoon
    Set up SIMZO so you can test my mobile app on a virtual iPhone or an Android emulator.
    
    1. Sign me in. Run: npx simzo@latest connect
       It prints a code and opens a browser page. I confirm the code there. The API key is saved to ~/.config/simzo/config.json.
    
    2. Add the SIMZO MCP server.
       Claude Code: claude mcp add simzo -- npx -y simzo@latest mcp
       Any other MCP client: add this to its MCP config file.
       {
         "mcpServers": {
           "simzo": {
             "command": "npx",
             "args": ["-y", "simzo@latest", "mcp"]
           }
         }
       }
    
    3. Reload your MCP servers so the simzo_ tools load. Then call simzo_list_devices and tell me which phones are free.
    
    4. Find the app build in this project. That is a device .ipa for iPhone or an .apk for Android. Upload it with simzo_upload_app. Start a session with simzo_create_session and launch the app. Then show me a screenshot from simzo_get_screen.
    
    5. Stop the session with simzo_stop_session when we are done.
  2. 2

    Or do it by hand. The command opens a browser page, you confirm a code, and an API key is saved on your machine.

    $ npx simzo@latest connectSoon
  3. 3

    Upload an .ipa or .apk, then ask your agent to test it, or open a session in the dashboard.

App files

  • iPhone: an .ipa. An unsigned device build works. A Simulator .app build does not install, because the virtual iPhone runs real iOS, not the Simulator.
  • Android: an .apk.
  • During the beta, only upload apps you trust. Sessions run on shared test servers.

MCP setup

The connect command saves your key to ~/.config/simzo/config.json, and the MCP server reads it from there. Add the server to Claude Code:

Claude CodeSoon
claude mcp add simzo -- npx -y simzo@latest mcp

With an API key from Settings instead of the connect command:

TerminalSoon
claude mcp add simzo -e SIMZO_API_KEY=<your key> -- npx -y simzo@latest mcp

Or add it to any MCP client config. Set SIMZO_API_URL only for a self-hosted API (host only, no /v1).

mcp.jsonSoon
{
  "mcpServers": {
    "simzo": {
      "command": "npx",
      "args": ["-y", "simzo@latest", "mcp"],
      "env": { "SIMZO_API_KEY": "<your key>" }
    }
  }
}

Limits

Control

  • Install appiPhoneAndroid
  • Tap and swipeiPhoneAndroid
  • Type textiPhonePartial
  • RotateComingAndroid
  • GPS locationComingComing

Observe

  • ScreenshotiPhoneAndroid
  • UI treePartialAndroid
  • App logsiPhoneAndroid
  • Screen recordingComingPartial

Test

  • Maestro flowsComingPartial
  • Network timingsComingComing
  • Real battery drainNoNo
  • The iPhone UI tree is partial. It can take 10 to 30 seconds to fill in, and some screens return only the root, so iPhone tests can fall back to screenshots and screen positions.
  • iPhone sessions are portrait only.
  • Location is off by default on the virtual iPhone. GPS control is coming on both platforms.
  • Virtual iPhones have no microphone, Bluetooth, Face ID, battery or cellular radio.
  • Emulators and virtual phones cannot measure real battery drain. SIMZO marks it unsupported, never zero.
  • Every metric is labelled measured, sampled, estimated or unsupported.