Skip to content

Tool reference

Complete list of MCP tools in the Emu server.

Tool Description
list_devices Serial, state, transport (Emulator/USB/Wi-Fi)
device_info Model, API level, ABI, battery, RAM, storage
shell Run an ADB shell command with configurable timeout
Tool Description
tap Tap at pixel coordinates
swipe Swipe between two points
long_press Long press at coordinates
double_tap Double tap at coordinates
drag Drag from one point to another
pinch Pinch gesture (zoom in/out)
input_text Type text into the focused field
press_key Key event (KEYCODE_HOME, KEYCODE_BACK, etc.)
get_clipboard Read device clipboard
set_clipboard Write to device clipboard
Tool Description
touchpad_tap Tap via the touchpad input device
touchpad_scroll Scroll via the touchpad input device
Tool Description
tap_element Tap an element found by accessibility selector
fill_element Fill a text field found by accessibility selector
fill_form Fill multiple form fields at once
scroll_to_element Scroll until an element matching the selector is visible
wait_for_element Wait for an element to appear on screen
Tool Description
screenshot Capture the device screen as PNG or JPEG
ui_dump Accessibility tree (compressed BFS or raw XML)
annotated_screenshot Screenshot with structured element index overlay
get_orientation Get the current screen orientation
set_orientation Lock to portrait, landscape, reverse portrait, or reverse landscape
Tool Description
list_apps List installed packages
launch_app Launch by package name, optionally set a per-app locale (Android 13+)
stop_app Force-stop by package name
uninstall_app Uninstall by package name
install_apk Install APK(s) with split-APK support
open_url Open a URL or deep link on the device
Tool Description
file_list_dir List files and directories (symlink-aware)
file_pull Pull file content (text or base64)
file_push Push a host file to the device
Tool Description
list_databases List SQLite databases for a debuggable app
sqlite_query Run a SQL query against an app’s database
Tool Description
logcat Logcat snapshot with level, tag, query, PID, and package filtering
Tool Description
set_location [Emulator only] Set GPS coordinates, altitude, speed, bearing
set_battery [Emulator only] Set level, charging status, health
list_network_profiles List available network throttling profiles
set_network [Emulator only] Apply a network profile or custom bandwidth/latency
Tool Description
list_avds List available AVDs
start_emulator Start an emulator by AVD name (waits for boot)
stop_emulator Stop a running emulator by serial
create_avd Create a new AVD with device profile and system image
delete_avd Delete an AVD
clone_avd Clone an AVD with copy-on-write
update_avd_config Update AVD hardware configuration
get_avd_config Read AVD hardware configuration
Tool Description
check_licenses Check which SDK licenses need acceptance
accept_licenses Accept pending SDK licenses
install_system_image Download and install a system image
Tool Description
list_snapshots [Emulator only] List saved snapshots
save_snapshot [Emulator only] Save current state
load_snapshot [Emulator only] Restore a saved snapshot
delete_snapshot [Emulator only] Delete a snapshot
Tool Description
start_recording Start screen recording
stop_recording Stop screen recording
collect_bug_report Capture a bug report with video, inputs, and logs
list_bug_reports List saved bug reports
read_bug_report Read bug report metadata and content
export_bug_report Export as a single .emubug file
update_bug_report Update bug report metadata
import_bug_report Import a .emubug file
Tool Description
network_proxy_status Check if the proxy is running
start_network_proxy Start the HTTPS interception proxy
stop_network_proxy Stop the proxy
list_network_requests List captured HTTP requests
get_network_request Get details of a specific request
clear_network_requests Clear captured requests
Tool Description
start_android_auto Start Android Auto projection
stop_android_auto Stop Android Auto projection
aa_tap Tap on the head unit display
aa_swipe Swipe on the head unit display
aa_screenshot Capture the head unit screen
aa_send_location Send GPS location to Android Auto
aa_set_night_mode Toggle day/night mode
aa_set_driving_status Set driving status (Parked, Idle, Moving)
Resource URI Description
device://list Subscribable device list (auto-notify on changes)