Documentation
How to drive iPhones, Android phones, simulators and emulators with MobAI. From a coding agent, from a script, from the terminal or from CI.
Overview
MobAI runs a local HTTP API on localhost:8686
that controls the devices connected to this computer. Coding agents reach it through MobAI's MCP server. Scripts call it directly, or send a whole DSL script in one request.
Every route: screenshots, UI tree, tap, type, apps, web pages, logs, crash reports, metrics, simulators.
Many steps in one call, with predicates, waits, assertions and retries. JSON and .mob forms.
mobai for the shell and scripts, mobai-ci for pipelines.
A POST to your service when a device connects or its bridge starts or stops.
Connect Claude Code or Cursor to an iOS simulator through MCP.
Build, run, sign and ship your app with your agent, to TestFlight and Google Play.
iOS development from a Linux sandbox with mobai-dev.
Quick Start
Building an app with your agent? App Builder covers adding an app, running it on devices, signing, TestFlight, Google Play and CI.
Setting up an AI coding agent? Control an iOS simulator with AI walks through simulator setup, connecting Claude Code or Cursor through MCP, and checking your first interaction.
Calling the API yourself? Start the MobAI app, connect a device, then send a request. The bridge on the device starts by itself on the first request that needs it.
# List connected devices
GET http://127.0.0.1:8686/api/v1/devices
# Take a screenshot
GET http://127.0.0.1:8686/api/v1/devices/{id}/screenshot
# Tap at coordinates
POST http://127.0.0.1:8686/api/v1/devices/{id}/tap
{"x": 150, "y": 300}
# Run a DSL script
POST http://127.0.0.1:8686/api/v1/devices/{id}/dsl/execute
{"version": "0.2", "steps": [{"action": "open_app", "bundle_id": "com.apple.Preferences"}]}
Base URL: http://127.0.0.1:8686/api/v1. Every route is in the HTTP API reference.