Tools

This page reflects the current MCP tool schema. Availability can still vary by platform, runner, and enabled feature gates; inspect the registered schema for the exact arguments supported by your connection.

Observe & navigate

Tool	What it does
👀 observe	Gets the current screen view hierarchy.
🔍 explore	Explores an app to build a navigation graph.
🗺️ navigateTo	Navigates using the learned navigation graph.
📊 getNavigationGraph	Retrieves the navigation graph for debugging.
🔗 identifyInteractions	Suggests likely interactions.
🖍️ highlight	Draws a visual highlight around a UI element.
🔍 debugSearch	Shows selector matches, the chosen match, and near-misses.

Interact with the UI

Tool	What it does
👆 tapOn	Taps by text, content description, resource ID, or Android test tag.
🎯 tapAny	Taps any clickable element, optionally scoped to a container.
👉 swipeOn	Swipes or scrolls the screen or an element.
↔️ dragAndDrop	Drags one element to another.
🤏 pinchOn	Pinches to zoom.
⌨️ inputText	Types text; its optional mode is Android-only.
🧩 setUIState	Sets multiple form fields to a desired state.
🗑️ clearText	Clears the focused input.
✨ selectAllText	Selects all text in the focused input.
↩️ imeAction	Performs an IME action.
🔘 pressButton	Presses a device or navigation button.
⌨️ keyboard	Opens, closes, or detects the on-screen keyboard.
📋 clipboard	Copies, pastes, clears, or reads the clipboard.

Pinch rotation semantics

pinchOn.rotationDegrees describes how far the two-finger axis rotates during the pinch. The fingers start horizontally and finish on the rotated axis, so a non-zero value combines pinch and rotation. The default 0 is a plain pinch. Android and iOS share this convention.

Apps, files & app data

Tool	What it does
📱 listApps	Provides guidance for listing installed apps through MCP resources.
🚀 launchApp	Launches an app by package name.
❌ terminateApp	Terminates an app by package name.
💥 crashApp	Intentionally crashes a running app through the platform crash path.
📦 installApp	Installs an APK, app bundle, or IPA.
🗑️ uninstallApp	Uninstalls an app by package name or bundle identifier.
🔗 getDeepLinks	Queries an app’s deep links.
📄 putAppFile	Writes local-file, UTF-8, or base64 content into an app container.
📥 stageSharedStorage	Stages host-file, UTF-8, or base64 fixtures into a bounded Android Downloads namespace for system pickers (Android only).
⚙️ getPreference / ⚙️ setPreference	Reads or writes Android system properties, SharedPreferences, or iOS UserDefaults.
🔑 setKeyValue / 🔑 removeKeyValue / 🔑 clearKeyValueFile	Manages an app key-value storage file.
🗃️ listDataStores / 🗃️ getDataStore	Lists or reads Android Jetpack DataStore entries with the SDK adapter.
🗄️ sqlQuery	Executes SQL against an app SQLite database.
🔐 resetKeychain	Resets all Keychain data on an iOS Simulator after explicit confirmation; unsupported on Android and physical iOS devices.

Intentional crash contract

crashApp accepts only an appId; it never accepts a PID, signal, or shell command. Android uses ActivityManager’s VM-crash path for the resolved user. iOS Simulator sends SIGABRT to the exact launchd application process. Physical iOS devices return supported: false and never fall back to normal termination.

Every result reports success, supported, platform, appId, mechanism, timestamp, and confirmed. It reports wasRunning whenever preflight established process state; confirmed crashes also report processId when available and include immediate OS diagnostic evidence. success: true and confirmed: true require fresh, target-specific crash evidence, not merely command dispatch or process disappearance.

Copy a fixture into an app container

{
  "tool": "putAppFile",
  "params": {
    "platform": "ios",
    "target": {
      "domain": "app_containers",
      "appId": "com.example.app",
      "container": "documents"
    },
    "files": [
      {
        "sourcePath": "/Users/me/fixtures/welcome.png",
        "destinationPath": "fixtures/welcome.png"
      }
    ]
  }
}

File containers

Android externalFiles maps to /sdcard/Android/data/{appId}/files. Private containers (documents, cache, and tmp) use run-as and require a debuggable app. iOS simulator containers include documents, library, cache, and tmp.

Devices & system state

Tool	What it does
📋 listDevices	Lists booted devices; a note points to MCP resources for images and detail.
🖼️ listDeviceImages	Lists available device images.
🤖 getAndroid / 🍎 getApple	Finds or recovers an Android AVD or iOS Simulator for automation.
🧱 provisionDevice	Provisions an exact virtual-device identity.
🔧 setActiveDevice	Sets the active device.
❌ killDevice / 🧹 deleteDevice	Stops a device, or stops and permanently deletes it.
📸 deviceSnapshot	Captures or restores a device snapshot.
🔄 rotate	Changes device orientation.
🌐 openLink	Opens web URLs or routes app and universal deep links.
🧰 homeScreen / recentApps / systemTray	Controls core system surfaces and notifications.
🔓 wakeAndUnlock	Wakes and unlocks the keyguard.
🌍 changeLocalization	Changes locale, time zone, text direction, time format, and calendar.
⚙️ getDeviceState / ⚙️ setDeviceState	Reads or changes Do Not Disturb and simulator biometric enrollment.
🧬 getIosSimulatorCapabilities	Discovers biometrics for a selected iOS Simulator device type and runtime.
🫆 biometricAuth	Simulates biometric authentication.
📳 shake	Shakes an Android emulator or iOS Simulator.
📞 phoneCall / 💬 sendSms	Simulates an Android emulator phone call or incoming SMS.
🔔 postNotification	Posts a notification through Android SDK hooks or iOS Simulator push.
🔔 getNotificationPolicy / 🔔 setNotificationPolicy	Reads or changes app notification and Do Not Disturb policy.
🛂 getAppPermissions / 🛂 setAppPermissions	Reads or changes app permissions.

Network, plans & recording

Tool	What it does
🌐 network	Controls network capture and error simulation.
🎭 mockNetwork / 🧹 clearMockNetwork	Adds or clears mock network response rules.
🕸️ getNetworkGraph	Returns the aggregate captured network graph.
🧪 executePlan	Executes YAML plan steps and stops at the first failure.
🔒 criticalSection	Synchronizes devices, then runs steps serially.
🚧 barrier	Synchronizes devices, then lets them proceed concurrently.
📝 recordSteps	Records MCP calls to YAML; begin and end require –mcp-recording.
⏺️ startTestRecording	Starts recording user interactions for exportPlan.
📤 exportPlan	Stops the active recording and exports a YAML plan.
🎥 videoRecording	Starts or stops device video recording.
🐛 bugReport	Saves screen state, hierarchy, logs, window info, and a screenshot to a shareable report.

Accessibility & session tools

Tool	What it does
♿ accessibility	Reads or controls Android TalkBack and iOS VoiceOver, returning fresh device state.
🎯 accessibilityFocus	Sets or clears Android TalkBack focus by resource ID, text, or content description.
🔀 setToolEnabled	Enables or disables one exact AutoMobile tool for the current MCP session.

For the observe → act → observe behavior behind interaction tools, see the interaction loop. For per-session public tool selection, see Dynamic Tools.