scroll_until
Scroll the Android viewport in a chosen direction until a specified semantic element becomes visible, or stop automatically when the scroll reaches its end. Configurable maximum scroll attempts.
Instructions
Scroll until a semantic target appears (or the scroll reaches its end).
Uses one-viewport-page scrolling and stops as soon as the container boundary is reached (no useless swipes at the end).
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": {
"target": "<target>"
},
"name": "scroll_until"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| device | No | ADB serial; omit with a single connected device. | |
| target | Yes | {"by": "text"|"desc"|"id", "value": str} — the element to find. | |
| direction | No | "down" (default) | "up" | "left" | "right" — *content* direction ("down" searches content below the fold). | down |
| session_id | No | ||
| max_scrolls | No | scroll attempts before giving up (default 10). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||