An MCP server that gives an agent hands-on control of an Android device via adb: screenshot, tap, swipe, type, read the UI tree, install/launch/stop apps, pull logs.
Strong tool naming (verb_noun pattern throughout) and comprehensive descriptions (avg 180 chars, well within 10-1024 range). All 20 tools have clear, actionable descriptions explaining WHAT, WHEN, and consequences. Input schemas present with type definitions for all parameters. However, output schemas are undocumented (no return type specs), and error handling lacks recovery guidance. Missing tool annotations (readOnlyHint, destructiveHint, idempotentHint) despite clear risk classifications. Parameter descriptions are solid but some lack format/constraint details (e.g., 'port' has no range; 'lines' defaults to 100 with no bounds stated). No pagination support for list_devices despite potentially large output.
Run an arbitrary shell command on the device. Opt-in via ANDROID_MCP_ALLOW_SHELL=1 environment variable. Blocked patterns include rm -rf, mkfs, factory reset, SMS/call-log/contacts content-provider access, and su.
Clear all data for an app (cache, preferences, databases, etc.). The app is force-stopped first.
Clear the device's logcat buffer.
Connect to a device already in Wi-Fi debugging mode. address is 'ip:port', e.g. from enable_wireless_debugging or from Settings > Developer options > Wireless debugging on the phone itself.
Disconnect a network-attached device. Omit address to disconnect all.
Bootstrap wireless debugging over an existing USB connection. Plug the phone in via USB once, call this, then you can unplug the cable — the device stays reachable over Wi-Fi at the returned address. Returns the ip:port to pass to connect_network. Only reliable when the device's Wi-Fi is actually connected — mobile data alone won't work, since your PC can't reach it.
Output schemas undocumented. No return type specifications for any tool. LLMs cannot plan downstream calls or extract structured data without knowing response fields.
Missing tool annotations. Tools have clear risk levels (READ_ONLY, WRITE, DESTRUCTIVE, IRREVERSIBLE) but no readOnlyHint, destructiveHint, or idempotentHint annotations in schema. Agents cannot distinguish safe from dangerous operations.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 61 | 2026-07-28+ | v2 |
Fetch device logcat output. By default returns the last 100 lines; pass lines=N to get more or fewer. Useful for debugging app crashes and behavior.
Dump the device's current UI hierarchy as XML (the accessibility tree). Useful for finding element names, IDs, and text content to target with tap/swipe/type.
Install an APK onto the device. apk_path is a local filesystem path, e.g. the debug build your agent just compiled with Gradle.
Send a key event to the device. keycode is the Android keycode (e.g. 4 for BACK, 3 for HOME, 66 for ENTER). See https://developer.android.com/reference/android/view/KeyEvent for the full list.
Launch an app by package name (e.g. 'com.nox.kana'). If activity_name is omitted, launches the app's default launcher activity via monkey, which works without knowing the exact Activity class.
List all devices adb currently sees (USB and network-attached), with their connection state. Call this first to get a device_id to pass to the other tools — if only one device is attached you can omit device_id everywhere and it'll be used automatically.
Cable-free pairing for Android 11+ wireless debugging. On the phone: Settings > Developer options > Wireless debugging > Pair device with pairing code — it'll show an address:port (different from the main debugging port) and a 6-digit code. Pass those here, then use connect_network with the *main* wireless debugging address shown on that same screen.
Pull a file from the device to the local filesystem. device_path is the path on the device (e.g. /sdcard/Download/file.txt), local_path is where to save it locally.
Push a file from the local filesystem to the device. local_path is the local file, device_path is where to write it on the device (e.g. /sdcard/Download/file.txt).
Take a screenshot of the device's current screen and return it as a base64-encoded PNG.
Force-stop an app by package name.
Swipe from one point to another. Coordinates are in pixels, (0, 0) is top-left.
Tap a point on the screen. Coordinates are in pixels, (0, 0) is top-left.
Type text on the device. The text is sent character-by-character via adb shell input text, which works in most text fields.
Error handling lacks recovery guidance. Code raises RuntimeError with messages, but no structured error classification (retryable vs user-fixable vs fatal). LLMs receive raw exceptions without actionable next steps.
Parameter constraints missing. 'port' parameter (enable_wireless_debugging) has no range; 'lines' (get_logcat) defaults to 100 with no min/max bounds; 'keycode' (key_event) has no validation range. LLMs may pass invalid values.
No pagination for list_devices. If many devices are attached, output could be large. No limit, offset, or cursor parameters. Large responses waste tokens and risk context window exhaustion.