Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| ANDROID_HOME | No | The path to the Android SDK. If your SDK is not in the default location (~/Library/Android/sdk on macOS), set this variable to point to your SDK directory. |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_devices | List connected Android devices and emulators |
| list_avds | List available Android Virtual Devices |
| start_emulator | Start an Android emulator. Waits up to 60s for it to come online. |
| screenshot | Take a screenshot of the Android device. Returns the image for visual analysis. Optionally saves to a file path. |
| get_ui_tree | Get the UI element hierarchy of the current screen. Returns interactive elements with their bounds, text, resource IDs, and state. Use this to find elements before tapping. |
| tap | Tap at specific screen coordinates |
| tap_element | Tap a UI element by its resource-id, text, or content-desc. Finds the element in the UI tree and taps its center. |
| tap_and_wait | Tap element then wait for UI to settle and return the new UI tree. Combines tap + wait + get_ui_tree into a single fast operation. |
| type_text | Type text into the currently focused input field |
| press_key | Press a hardware/software key |
| swipe | Perform a swipe gesture on the screen |
| scroll_to_element | Scroll down repeatedly until an element matching the given criteria is visible |
| wait_for_element | Wait for a UI element to appear on screen. Polls every 500ms. |
| launch_app | Launch an Android app by package name |
| install_apk | Install an APK file on the device |
| get_current_activity | Get the currently displayed app and activity |
| adb_shell | Run an arbitrary ADB shell command |
| get_logs | Get device logcat output. Use to find crashes, exceptions, and errors after reproducing a bug. |
| clear_logs | Clear the logcat buffer. Call this before reproducing a bug to get clean logs. |
| get_device_info | Get device details: model, manufacturer, Android version, API level, screen size, and DPI. |
| pull_file | Pull a file from the Android device to the local filesystem. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |