MCP tools
launch_app
Open an app by bundle ID, package name or display name; fresh restarts it first. To change apps, use launch_app with the app’s name; never press home.
| REST operation | act (POST /v1/devices/{deviceId}/actions) |
| Action type | launchApp |
| Needs a device | yes |
| Read only | no |
| Profiles | core, testing, full |
Parameters
Section titled “Parameters”| Name | Required | Type | Goes to | What it is |
|---|---|---|---|---|
device_id |
yes | string | path deviceId |
Stable device id such as ios:00008120-001A2B3C4D5E6F70 or android:R58M123ABC. |
lease |
no | string | header Silan-Lease |
Lease token when the device is claimed. |
app |
yes | string | body action.app |
Bundle ID, package name, or the app’s display name. |
fresh |
no | boolean | body action.fresh |
Terminate first. |
return |
no | object | body returning |
Example call
Section titled “Example call”launch_app({ device_id: "ios:00008120-001A2B3C4D5E6F70", app: … })