Local Android tooling

Android workbench.

Operate Android, replay UI tests, and inspect APKs, ELF files, and kernel modules from your MCP client.

VANTAMCP / STDIO
  1. MCP client
  2. Vanta
  3. Android
Release
v0.11.0 Preview
Runtime
Node.js 22 / 24
License
MIT

Foreground interaction

Device Use.

Read the screenshot and UI tree together, target controls by selector, and replay the same interaction as a regression test.

device_useInteractive example

Request

{
  "action": "observe",
  "session": "SESSION_ID",
  "image": true,
  "tree": true
}

Returns a PNG frame and its corresponding UI tree.

Use an unlocked device with the app in the foreground. Send keys, long presses, and swipes at adjustable speed. The optional Vanta input method supports Unicode and symbols.

View replay example

Inspection & diagnostics

Toolset.

Inspect the application, its native code, and the Android system from the same client.

APK & ELF

Compare manifests, DEX files, and native libraries across base and split APKs. Diagnose ABI, dependency, and 16 KB alignment issues.

apk_inspect

VM traces

Compare captured VM execution traces to locate differences in opcodes, state hashes, and control flow.

vm_trace

Root diagnostics

Review processes, threads, memory maps, and device logs. Record a test process’s PID, start tick, and exit status.

run

Kernel modules

Check a .ko file’s architecture, vermagic, and symbol CRCs. Record module experiments, dmesg, and available pstore logs with explicit Root access.

kernel_snapshot

Connections

ADB

Use the device’s authorized Android shell.

Shizuku

Use an existing rish setup over ADB.

Root

Request an existing Root grant for individual operations.

Paired USB setupfor Windows and ARM64 test devices with KernelSU Next.

Local installation

Quick start.

Install Node.js 22 or 24. Add adb from Android Platform Tools to PATH or set ADB_PATH. Enable USB debugging and approve the host on the device.

Android Platform Tools

Get YOUR_SERIAL from the output of adb devices -l.

codex mcp add vanta --env VANTA_TRANSPORT=adb --env VANTA_SERIAL=YOUR_SERIAL -- npx --yes --ignore-scripts vanta-mcp@0.11.0

Release verification

Verification.

Replay passed on an Android 17 emulator with ADB and Shizuku. Native checks covered offline 16 KB alignment and a missing dependency on the emulator.

Rendered terminal summary of Device Use replay over ADB
Device Use · ADB replay
Rendered terminal summary of native dependency and alignment checks
Native diagnostics · APK and ELF

Physical-device foreground replay, paired USB replay, Shizuku app-level revocation, and kernel diagnostics still need verification.

View GitHub Actions