List every Android device your API key can access, with live status (booted, Android version, screen size). Call this first to get device ids.

Show which ERIUS PHONE account (tenant) and key id this server is using, and the device ids it can access. Handy to check the API key works.

Get full status of one device: boot state, Android version, screen size, and the app currently in the foreground. Omit device to use the default.

Get an accessibility-tree snapshot of the current screen: every visible element with its text, role, and a ref id you can pass to tap/type/scroll. This is how the agent 'sees' the phone — read it before acting, and take a fresh one after any action since refs reset on every snapshot.

Take a screenshot of the device screen right now and return it as an image you can look at, plus one line of text with the image size and the device's real screen size.

The default is a JPEG whose longest side is 1024 px (tens of KB). A full-size PNG of a 1440x3120 phone is about 3 MB, which is more than many MCP clients accept in a tool result, so ask for it only when you need it: format="png", max_side=None.

format is "jpeg", "webp" or "png"; quality is 1-100 (jpeg/webp); max_side caps the longest side in pixels (64-8192); scale (0.1-1) shrinks by a factor instead. When the image is smaller than the screen, pass its size as image_width/image_height to tap(), long_press() or swipe() so x,y are read in the image's pixels. Prefer snapshot() when you only need text and refs: it's far smaller.

Get just the foreground app: package, activity, and whether a crash dialog is showing. Cheaper than a full snapshot when you only need this.

Tap an element. Prefer ref from a snapshot(), or text/content_desc to tap by visible label. Falls back to raw x,y pixel coordinates: in device pixels, or, with image_width and image_height, in the pixels of a screenshot of that size (the API maps the point to the screen).

Long-press an element (e.g. to open a context menu or start a drag). Targets work like tap(): ref, text/content_desc, or raw x,y (with image_width/image_height when they come from a scaled screenshot). ms (hold time, default 800) only applies to the x,y form.

Type text into a field. Optionally tap a ref or text_target label first to focus the field, clear the existing value, or press Enter after. Keystrokes sent while the field is still opening are lost, so if tapping the field opens a new screen (e.g. a search page), tap it first, wait for it with snapshot() or wait_for_text(), then type with no target. Check the result with snapshot(). Only printable ASCII is supported (adb limitation).

Press a hardware/navigation key: back, home, enter, delete, tab, escape, up, down, left, right, space, power, volup, voldown, recent, menu, wakeup.

Swipe from one point to another: in device pixel coordinates, or, with image_width and image_height, in the pixels of a screenshot of that size.

Scroll a list/container up, down, left, or right. ref must be the ref of the scrollable container itself (a ScrollView or List line in the snapshot), not of a row inside it: scrolling a single row does nothing. If the container has no ref, use swipe() instead.

Wait until text appears somewhere on screen (e.g. after a slow screen transition), up to timeout_ms (max 120000). Returns the settled snapshot.

Launch an installed app by package name (e.g. com.android.chrome). Pass activity only if the app has no launcher activity resolvable automatically.

Open a URL (http/https/market) on the device, optionally forcing it into a specific app package (e.g. open a link in Chrome specifically).

Start an activity with an arbitrary Android intent (am start -a ACTION), e.g. action="android.settings.WIFI_SETTINGS" to jump straight to a settings page. component is "package/.Activity"; extras values become string, int or boolean extras by their type. Returns ok plus the new foreground app.

Force-stop a running app by package name.

List installed apps on the device. Set third_party_only=True to skip pre-installed system apps and see only user-installed ones.

Uninstall an app by package name.

Read the device's crash log buffer (logcat -b crash) — use this after an app crashes during QA testing to see the real stack trace.

Install an APK from a local file path on the machine running this MCP server (not on the phone) onto the device. Use this for APK QA testing — the real use case ERIUS PHONE is built for. Returns the parsed package info (name, version) and whether the install actually succeeded.