Application GUI catalog
app_catalogUse this when the user needs to discover curated workflows and, with include_detected=true, new OS software records. Linux prefers visible XDG GUI launchers; macOS .app copies have separate IDs and require PID executable provenance; Windows uses local Start Menu shortcuts with exact PID executable attestation; registry-only rows cannot authorize GUI access. Detection is not proof of an active GUI, permissions or a trusted connector. Use local- ids for inspect/find-visible-controls or explicit checked focus_control and one bounded set_control_text with old-value CAS; other effects are forbidden.
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": {
"device": "<device>"
},
"name": "app_catalog"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| app | No | Exact app id or alias, e.g. blender, Outlook, VS Code; system for OS panels. | |
| device | Yes | ReMCP device id returned by list_devices. Required for every device operation. | |
| filter | No | Optional substring matching application names, categories or direct destinations. | |
| refresh | No | Force a fresh native presence scan when check_installed=true; otherwise use the short-lived cache. | |
| category | No | Category: system, office, browsers, development, media, communication, graphics, security, utilities or web. | |
| include_guides | No | Include detailed task-specific safe UI guidance; requires app, category or filter to avoid huge results. | |
| check_installed | No | Check OS-specific presence hints for registered apps (not proof of absence). Optional; adds bounded native discovery latency. | |
| include_detected | No | Also discover unprofiled applications/packages from the current OS. Linux uses visible XDG launchers, Windows uses local Start Menu .lnk entries with executable provenance, and macOS distinguishes app bundles; read-only inventory with at most 60 entries; future installs appear after cache refresh. |
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. |