Mobile Tool Reference

All 78 mobile MCP tools for Android and iOS automation — sessions, gestures, elements, app lifecycle, device control, and more.

Session & Device

Tool	Description	Key Params
`mobile_devices`	List connected ADB devices	—
`mobile_session_start`	Start Appium session	`deviceUdid`, `platformName`, `app` or `bundleId`, `noReset`, `extraCaps`
`mobile_session_stop`	Close session	`sessionId`
`mobile_session_status`	Check session health	`sessionId`

`mobile_session_start` parameters

Param	Type	Required	Description
`appiumUrl`	string	No	Appium server URL. Default: `http://localhost:4723`
`deviceUdid`	string	Yes	Device ID from `adb devices`
`platformName`	string	Yes	`Android` or `iOS`
`app`	string	No	Path to APK/IPA — installs before launching
`appPackage`	string	No	Android: package name of an already-installed app (e.g. `com.android.settings`)
`appActivity`	string	No	Android: activity to launch (default: `.MainActivity`)
`bundleId`	string	No	iOS: bundle ID of an already-installed app
`noReset`	boolean	No	Don't reset app state between sessions. Default: `false`
`automationName`	string	No	`UiAutomator2` (Android default) or `XCUITest` (iOS)
`extraCaps`	object	No	Extra `appium:` capabilities. Useful for slow emulators: `{ uiautomator2ServerLaunchTimeout: 60000 }`

The mobile_session_start, mobile_screenshot, and mobile_uitree tools also accept legacy parameter names (device, platform) as deprecated aliases for deviceUdid and platformName. Prefer the canonical names above for new code.

Screenshot & Screen Analysis

Tool	Description	Key Params
`mobile_screenshot`	ADB screenshot — no session needed	`deviceUdid`
`mobile_screenshot_element`	Crop screenshot to element bounds	`sessionId`, `elementId`
`mobile_describe_screen`	AI-readable list of elements on screen	`sessionId`
`mobile_assert_text`	Assert text is visible — throws if not found	`sessionId`, `text`
`mobile_wait_for_screen_change`	Wait until screen content changes after an action	`sessionId`, `timeout`
`mobile_uitree`	Raw accessibility XML via ADB — no session needed	`deviceUdid`
`mobile_source`	Full Appium page source as XML	`sessionId`

Nine tools accept screenshot: true to return a confirmation screenshot after the action: mobile_tap, mobile_tap_text, mobile_swipe, mobile_type, mobile_fill_field, mobile_long_press, mobile_double_tap, mobile_drag, mobile_scroll_to_text

Tool	Description	Key Params
`mobile_tap`	Tap at coordinates	`sessionId`, `x`, `y`, `screenshot`
`mobile_tap_text`	Find element by visible text and tap	`sessionId`, `text`, `screenshot`
`mobile_double_tap`	Double-tap	`sessionId`, `x`, `y`, `screenshot`
`mobile_long_press`	Long press / hold	`sessionId`, `x`, `y`, `duration`, `screenshot`
`mobile_swipe`	Swipe between two points	`sessionId`, `startX`, `startY`, `endX`, `endY`, `duration`, `screenshot`
`mobile_drag`	Drag-and-drop	`sessionId`, `startX`, `startY`, `endX`, `endY`, `screenshot`
`mobile_pinch`	Pinch gesture	`sessionId`, `x`, `y`, `scale`
`mobile_zoom`	Zoom gesture	`sessionId`, `x`, `y`, `scale`
`mobile_type`	Type text via keyboard	`sessionId`, `text`, `screenshot`
`mobile_key`	Press hardware key	`sessionId`, `key` (HOME, BACK, ENTER, VOLUME_UP, VOLUME_DOWN, POWER, DELETE…)
`mobile_hide_keyboard`	Dismiss soft keyboard	`sessionId`
`mobile_press_home`	Home button — Android only	`sessionId`
`mobile_press_back`	Back button — Android only	`sessionId`
`mobile_set_orientation`	Set screen orientation	`sessionId`, `orientation` (PORTRAIT or LANDSCAPE)
`mobile_get_orientation`	Get current orientation	`sessionId`

Elements

Tool	Description	Key Params
`mobile_find_element`	Find element by strategy	`sessionId`, `strategy`, `selector`
`mobile_find_all_elements`	Find all matching elements	`sessionId`, `strategy`, `selector`
`mobile_find_by_text`	Cross-platform text search	`sessionId`, `text`
`mobile_wait_for_element`	Wait until element appears	`sessionId`, `strategy`, `selector`, `timeout`
`mobile_scroll_to_text`	Scroll until text is visible	`sessionId`, `text`, `screenshot`
`mobile_element_text`	Get element's visible text	`sessionId`, `elementId`
`mobile_fill_field`	Clear field + type text	`sessionId`, `elementId`, `text`, `screenshot`
`mobile_set_value`	Set field value bypassing keyboard	`sessionId`, `elementId`, `value`
`mobile_element_exists`	Check if element is present	`sessionId`, `strategy`, `selector`
`mobile_execute`	Run `mobile:` script escape hatch	`sessionId`, `script`, `args`

Element strategies

Strategy	Example selector	Platform
`accessibility id`	`"Login Button"`	Android (content-desc) + iOS (accessibilityIdentifier)
`xpath`	`"//android.widget.EditText[@resource-id='email']"`	Both
`id`	`"com.example.app:id/login_button"`	Android
`class name`	`"android.widget.TextView"`	Android
`-android uiautomator`	`"new UiSelector().text(\"Login\")"`	Android
`-ios predicate string`	`"label == 'Login'"`	iOS

App Lifecycle

Tool	Description	Key Params
`mobile_install_app`	Install APK or IPA	`sessionId`, `appPath`
`mobile_uninstall_app`	Remove app from device	`sessionId`, `bundleId` or `appPackage`
`mobile_activate_app`	Bring app to foreground	`sessionId`, `bundleId` or `appPackage`
`mobile_clear_app_data`	Clear data/cache without uninstalling — Android only	`sessionId`, `appPackage`
`mobile_app_launch`	Launch by package via ADB — no session needed	`deviceUdid`, `appPackage`, `activity`
`mobile_app_stop`	Force-stop via ADB — no session needed	`deviceUdid`, `appPackage`
`mobile_app_state`	Get app state	`sessionId`, `bundleId`

App states returned by mobile_app_state: not_installed, not_running, background_or_suspended, background, running.

Device Control

Tool	Description	Key Params
`mobile_grant_permission`	Grant app permission — Android only	`sessionId`, `appPackage`, `permission`
`mobile_revoke_permission`	Revoke app permission — Android only	`sessionId`, `appPackage`, `permission`
`mobile_deep_link`	Open URL scheme or universal link	`sessionId`, `url`
`mobile_clipboard`	Get or set clipboard text	`sessionId`, `action` (get\|set), `text`
`mobile_geolocation`	Mock GPS coordinates	`sessionId`, `latitude`, `longitude`
`mobile_push_file`	Push local file to device	`sessionId`, `localPath`, `remotePath`
`mobile_pull_file`	Pull file from device	`sessionId`, `remotePath`

Common Android permissions

android.permission.CAMERA
android.permission.ACCESS_FINE_LOCATION
android.permission.READ_CONTACTS
android.permission.RECORD_AUDIO
android.permission.READ_EXTERNAL_STORAGE
android.permission.WRITE_EXTERNAL_STORAGE
android.permission.POST_NOTIFICATIONS

Alerts, Context & WebView

Tool	Description	Key Params
`mobile_handle_alert`	Accept or dismiss alert/dialog	`sessionId`, `action` (accept\|dismiss)
`mobile_get_contexts`	List Native + WebView contexts	`sessionId`
`mobile_switch_context`	Switch between native and WebView	`sessionId`, `contextName`

To automate Chrome on-device or a WebView embedded in a native app:

mobile_get_contexts — lists contexts like NATIVE_APP, WEBVIEW_com.example.app
mobile_switch_context with the WebView context name
Use mobile_browser_* tools — 20 CDP tools covering navigate, tap, type, evaluate JS, cookies, localStorage, network throttle, geolocation, user agent, and more

Screen Recording

Tool	Description	Key Params
`mobile_record_start`	Start screen recording	`deviceUdid`
`mobile_record_stop`	Stop recording and return file path	`deviceUdid`

Common Patterns

Explore an unfamiliar app

mobile_session_start
→ mobile_screenshot        # see the screen
→ mobile_describe_screen   # get AI-readable element list
→ mobile_tap_text("Menu")  # tap something
→ mobile_screenshot        # see the result

mobile_session_start
→ mobile_find_by_text("Email") → mobile_fill_field(email)
→ mobile_find_by_text("Password") → mobile_fill_field(password)
→ mobile_tap_text("Sign In")
→ mobile_wait_for_screen_change
→ mobile_assert_text("Dashboard")
→ mobile_screenshot

Verify a deep link

mobile_session_start
→ mobile_deep_link("myapp://product/abc123")
→ mobile_assert_text("Product Name")
→ mobile_screenshot

Test with camera permission

mobile_session_start
→ mobile_grant_permission("android.permission.CAMERA")
→ mobile_activate_app("com.example.app")
→ mobile_tap_text("Enable Camera")
→ mobile_assert_text("Camera ready")

Slow emulator fix

mobile_session_start with extraCaps:
{
  "uiautomator2ServerLaunchTimeout": 60000,
  "uiautomator2ServerInstallTimeout": 60000,
  "adbExecTimeout": 60000
}