Launch Roku App
launch_appLaunch a Roku channel or app by its app ID, bringing it to the device home screen. Use with ECP app discovery to find IDs, or specify 'dev' for a sideloaded app.
Instructions
Launch a channel / app on the device to its home screen by app id. Discover ids with ecp_query "/query/apps"; "dev" is the sideloaded Dev App. Changes device state (foregrounds the app). To open the app directly on a specific title use deep_link instead; optional launch params are passed through as ECP query params.
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": {
"appId": "<appId>"
},
"name": "launch_app"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| appId | Yes | Channel id (e.g. "837" for YouTube, "dev" for sideloaded). | |
| device | No | Target device — IP (e.g. "192.168.1.137") or serial (e.g. "X0004EX9Q7M"). Omit to use the focused device. | |
| params | No | Optional URL-encoded launch params. |