GET /apps/list
Find installed apps by name or bundle ID.
This is a device HTTP route. Set DEVICE_URL to your reachable device URL; connection and examples explain how. Do not append this path to the public MCP URL.
Parameters
| Parameter | Type | Meaning |
|---|---|---|
query | query string | Optional case-insensitive substring; default all apps. |
limit | query string | Integer 1..300; default 100. |
Response
JSON {apps:[{bundleId,name}],limit}. The result is capped, not paginated.
Example
sh
curl --fail-with-body "$DEVICE_URL/apps/list?query=Settings&limit=20"Check the HTTP status and any JSON error. HTTP workflows and error handling explain shared limits. All endpoints.