Type text
type_textUse this when the task calls for reliable Unicode text entry into a native semantic target or focused native control. Prefer method=auto so Accessibility is used when the target supports verified semantic editing. For Chromium page DOM, use browser_action instead of forcing desktop accessibility text input; auto fails safely when a semantic element rejects the write rather than claiming an unverified paste. Use method=keys only for deliberate physical key-by-key input, and keyboard for shortcuts/navigation/control keys.
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": {
"text": "<text>",
"device": "<device>"
},
"name": "type_text"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Element id returned by ui_snapshot or ui_find. Linux ids are stable per-process accessibility paths and legacy linux:<index> ids remain accepted. | |
| app | No | Limit matching to an application/process name substring when available. | |
| pid | No | Limit matching to one owning process id when available. | |
| name | No | Accessible name/title substring. | |
| role | No | Accessible role such as Button, Edit, textbox or AXButton. | |
| text | Yes | Text to enter. | |
| clear | No | Replace existing text for semantic/window-scoped accessibility input, or clear it before keyboard/paste fallback. | |
| label | No | Compact numeric label from the most recent ui_snapshot/ui_find; useful for repeated actions without repeating names or coordinates. | |
| title | No | Optional target window title substring. With auto/accessibility + clear=true, a unique editable control may be updated semantically without compositor focus. | |
| device | Yes | ReMCP device id returned by list_devices. Required for every device operation. | |
| method | No | Default auto prefers verified accessibility editing and falls back to clipboard paste. keys sends physical key events and therefore follows the active keyboard layout. | |
| backend | No | Input backend preference. auto uses proven local backends and already-authorized portal input; portal explicitly requests XDG RemoteDesktop consent on Wayland; x11 forces XWayland/xdotool only for operations where read-back testing shows it is reliable. GNOME Wayland keyboard/text deliberately reject x11. | |
| delay_ms | No | Per-key delay for method=keys. | |
| window_id | No | Optional target window id. With auto/accessibility + clear=true, a unique editable control may be updated semantically without focus; keyboard/clipboard fallbacks verify focus before dispatch. | |
| press_enter | No | Press Enter after typing; physical Enter delivery requires verified window focus. | |
| window_title | No | Limit matching to a top-level accessibility window/frame title substring when available. | |
| automation_id | No | Windows AutomationId when available. | |
| caret_position | No | Where text insertion should occur when the semantic editor supports caret placement. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | Type text structured result for type_text. Stable fields are declared explicitly; platform-specific fields may be added. Large results may return truncated/bytes/preview instead of the full payload. | |
| text | Yes | Concise human-readable result of the tool call. |