Quickstart
- 1
Paste this prompt into your AI agent. It signs you in, adds the SIMZO MCP server and checks which phones are free.
Agent promptSoonSet 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
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
Upload an
.ipaor.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.appbuild 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 mcpWith 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 mcpOr 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.