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.

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.