Fill browser fields or perform a supported app task
app_actionUse this when the user needs to fill 1–20 form fields in one selected Chromium tab or perform one supported application task on a paired computer. Browser form writes verify the exact origin, specified prior field values and resulting values. App tasks use the existing scoped permissions. Changes require commit=true and a unique operation_id UUID; otherwise the tool previews the action. Read-only inspections do not require commit. It does not automatically submit forms or run arbitrary scripts or commands.
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": {
"mode": "<mode>",
"device": "<device>"
},
"name": "app_action"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | Yes | Execution backend: one browser form batch or one existing registered application intent. | |
| task | No | app_task: one registered app intent; not arbitrary code, selectors, commands or coordinates. | |
| commit | No | Explicitly authorize one local mutation. Read-only app inspection does not require commit. | |
| device | Yes | ReMCP device id returned by list_devices. Required for every device operation. | |
| fields | No | browser_form: exact label or CSS selector, new value, optional old value / HTML-kind CAS guards. | |
| origin | No | browser_form: exact http(s) origin without path, credentials or query. Checked inside the same page evaluation. | |
| dry_run | No | Return the bounded plan without touching the target. | |
| endpoint | No | Optional local CDP endpoint, loopback-only. | |
| target_id | No | browser_form: exact target id from browser_tabs. | |
| timeout_ms | No | Operation timeout hint in milliseconds, 100–12000. | |
| operation_id | No | Unique caller UUID for every committed mutation; same-id retry is blocked across worker restarts by a private on-disk journal; the caller must inspect uncertain results. |
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. |