launch_app
Launch Android applications by specifying their package and activity component names to control apps on connected devices or emulators.
Instructions
An Android app launched by its component name (package/activity).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"component": "<component>"
},
"name": "launch_app"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| component | Yes | Android component in 'package/activity' format, e.g. 'com.android.settings/.Settings'. | |
| device_serial | No | Android device serial (e.g. 'emulator-5554' or '192.168.1.10:5555'). Omit only when a single device is connected. If the tool returns a multi-device error: STOP. Present the device list to the user verbatim and wait for their explicit choice. Do NOT retry with a guessed or inferred serial — this is a hard requirement. Once the user provides a serial, use it for every subsequent call in this session. To switch devices mid-session, ask the user first. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |