Navigate system or application
app_navigateUse this when the task calls for a registered app destination or native system settings panel when one safe route can replace multiple clicks; call app_catalog first and verify the opened UI with ui_snapshot.
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": {
"destination": "<destination>",
"device": "<device>"
},
"name": "app_navigate"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| app | No | Application id or alias from app_catalog; use system for OS menus and settings. | |
| pid | No | Optional exact native application PID, used only for inspect=true to select one of several windows. | |
| step | No | Execute exactly one allowlisted step inside a guided app. For set_search_query also provide query. No arbitrary clicks, sends or submissions. | |
| query | No | Only with step=set_search_query: 1–256 single-line characters to enter into an exact verified search field. Never presses Enter; omitted from result. | |
| device | Yes | ReMCP device id returned by list_devices. Required for every device operation. | |
| verify | No | For application launch only, verify the presence of a real native Accessibility window; opt-in because a busy desktop may require up to 20 seconds. Does not verify foreground focus. | |
| dry_run | No | Return the resolved navigation plan without changing the desktop. | |
| inspect | No | For guided workflows only: read-only inspection of the exact native app window or verified-origin browser tab, without executing the task. | |
| target_id | No | Optional exact CDP tab ID for disambiguating multiple matching web-service tabs during inspect=true. | |
| window_id | No | Optional exact native window ID, used to disambiguate windows for inspection or a safe step. | |
| destination | Yes | Allowlisted destination id from app_catalog. Use launch for opening registered third-party applications. | |
| verify_timeout_ms | No | Optional verification timeout in milliseconds; default 20000, clamped to 2000–30000. Used only with verify=true. | |
| inspect_timeout_ms | No | Native Accessibility inspection timeout, 2000–30000 ms; default 20000. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | Array/scalar payload wrapper used when the natural result is not an object. | |
| text | Yes | Concise human-readable result of the tool call. |