iphone_tap
Trigger single, double, or long-press touches at exact iPhone screen coordinates. Use positions from the UI tree or screenshot to act on whatever is at that point.
Instructions
Touch the screen at a coordinate: single tap, double tap or long press.
Use it when you know the position – from iphone_ui_tree (center point) or iphone_screenshot (pixel =
point). To hit an element by its visible text, iphone_tap_text is more robust. The touch acts on
whatever is at that point, like a finger would; it does not wait for the app to finish reacting, so
look again (or call iphone_wait_for) before the next step.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": {
"x": "<x>",
"y": "<y>"
},
"name": "iphone_tap"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| x | Yes | Horizontal position in iOS points, from the left edge (0) to the screen width shown by iphone_status / iphone_screenshot. | |
| y | Yes | Vertical position in iOS points, from the top edge (0) to the screen height shown by iphone_status / iphone_screenshot. | |
| gesture | No | 'tap' = single tap (buttons, links, fields); 'double' = double tap (zoom, select a word); 'long' = touch and hold (context menus, moving icons). | tap |
| hold_seconds | No | How long to hold for gesture='long' (0.3–10 s). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |