Get automation-server status: uptime, idle-watchdog countdown and currently connected devices. The underlying server auto-starts on demand and exits after the idle timeout.

Manually stop the background automation server to free resources. It is re-spawned automatically on the next tool call, so this is always safe.

List all Android devices attached via ADB, with their online state and whether a uiautomator2 session is already established.

Connect to an Android device and remember it as the default for all subsequent tool calls in this session. Returns screen size and current app.

Disconnect a device and release its uiautomator2 session. Omit serial to disconnect the current default device.

Get info about the current device: serial, screen resolution, Android SDK level, screen-on state and the foreground app.

Launch an app on the current device by package name.

Force-stop an app by package name.

DESTRUCTIVE: clear all user data of an app (logs the user out, wipes settings). Requires confirm=true.

Dump the current screen as a compact numbered list of interactive elements: [index] text="..." id="..." [flags] center=(x,y). This is the cheapest way to observe the screen; use the center coordinates with tap(x, y) or the text/resource_id with selector-based actions.

Capture the current screen as an image so you can visually verify state. Returns the image plus a text summary. Combine with_som=true with get_screen_elements to map numbered boxes to element indices.

Tap the screen either at (x, y) coordinates or on an element found by selector. Provide coordinates OR at least one selector field.

Double-tap at (x, y) or on an element found by selector (text / resource_id / index).

Long-press at (x, y) or on an element found by selector (context menus, selection mode, drag handles).

Type text into an input field found by selector, or into whatever field currently has focus when no selector is given.

Clear the text of an input field found by selector, or of the currently focused field when no selector is given.

Swipe/drag from (sx, sy) to (ex, ey). Get the screen size from get_device_info to compute coordinates.

Scroll the current scrollable view in a direction without needing coordinates.

Press a device key: home, back, enter, delete, recent (app switcher), menu, search, volume_up/down, power, camera, or D-pad keys.

Check whether an element matching the selector currently exists on screen. Provide at least one selector field.

Block until an element matching the selector appears (e.g. after tapping a button, wait for the next page). Provide at least one selector field.

Ask the server-side LLM to semantically analyze the current screen: page type (login/form/list/dialog), purpose and key elements. Requires OPENAI_API_KEY (or LLM_API_KEY / OPENAI_BASE_URL / LLM_MODEL) to be configured; otherwise prefer get_screen_elements + screenshot and analyze yourself.

Delegate a natural-language goal to the server-side AI agent, which runs its own observe-think-act loop on the device and returns a step log. Needs OPENAI_API_KEY (or LLM_API_KEY / OPENAI_BASE_URL / LLM_MODEL). Prefer the primitive tools (get_screen_elements + tap + input_text) unless the user explicitly asks to delegate.

Diagnose the current screen for crashes, ANRs, permission blockers or unexpected overlays and report findings; with auto_fix=true it also attempts recovery. Requires OPENAI_API_KEY (or LLM_* env).