agent-droid-bridge MCP server

Text input into the currently focused Android input field. Spaces are encoded automatically.

An Android app launched by its component name (package/activity).

Structured list of UI elements currently visible on the Android screen. Returns elements filtered and shaped by the chosen mode. Prefer 'tappable' for navigation and 'interactive' when you need XPath or bounds for ADB commands. Only use 'all' as a last resort — it returns every node and can be large.

A tap gesture at the given pixel coordinates on the Android screen.

A PNG screenshot of the current Android device screen with width, height, and base64-encoded image data.

Takes a lightweight snapshot of the current UI state and returns a short token. Use this before performing an action (tap, swipe, launch, key press) when you only need to confirm the screen changed afterward — not read its content. Pass the returned token to detect_ui_change as baseline_token. This avoids loading the full XML hierarchy into context unnecessarily. Do not use this when you need to read or interact with screen elements — use get_ui_hierarchy for that.

Device capabilities and hardware profile for the connected Android device. Use 'identity' to establish what device you are working with before starting a session. Use 'security' when a task requires root permissions or you need to confirm privilege level. Use 'hardware' when you need screen dimensions or memory constraints for layout decisions. Use 'all' only when you need a complete profile and latency is not a concern.

Returns the current Android screen as an XML UI hierarchy. Use this when you need to locate element coordinates, read text, or find resource IDs to interact with. Do not call this after every action — only call it when you actually need to read screen content. To check if the screen changed after an action, use snapshot_ui before the action and detect_ui_change after.

A key event sent to the Android device using the given keycode integer.

The output of an ADB command. Parsed safely via shlex and never passed to a system shell.

Returns all visible text on the current Android screen, sorted top-to-bottom. Use this when you need to read what is on screen. Does not include coordinates or element info — for tapping or interacting, use `get_screen_elements`.

A swipe gesture on the Android screen from (x1,y1) to (x2,y2) over the given duration.

All Android devices currently visible to ADB, with their serial numbers, connection state, and model names.

Polls the UI hierarchy after an action and returns when the screen content changes or the timeout is reached. Returns changed status and elapsed time. By default, omits the XML hierarchy for efficiency — set return_hierarchy=True to receive the full hierarchy. For efficient change detection: call snapshot_ui before the action, perform the action, then call detect_ui_change with baseline_token. Only use without baseline_token when you need to wait for a slow transition (loading screens, animations). Do not use to read the current screen state — use get_ui_hierarchy for that.