app_check

This tool on every surface: CLI · MCP · Python · JavaScript · Go · Java · .NET

Put a checkbox or switch into a state, rather than toggling whatever it is in. Idempotent: asking for a state it is already in does nothing and says so, which is what makes it safe to call without reading first. That is the difference from app_tap — tapping a checkbox flips it, so reaching a known state with tap means read, compare, tap, read again, on every checkbox. Refuses anything with no checked state rather than tapping it and calling it checked, and refuses to uncheck a radio button, which is not a thing a radio does: a group is cleared by choosing a different member. The tap is confirmed by reading the state back, so a control that did not respond is reported rather than assumed.

Changes the device, the app or the session: readOnlyHint is false.

Arguments

Name	Type	Required	What it is
checked	boolean		The state to put it in. Defaults to true.
device	string		Device serial to target, e.g. "emulator-5554". Omit when only one device is running.
driver	string: uiautomator2, uiautomator, wda		Driver to use: "uiautomator2" (default for Android; fast, installs a server APK on first use), "uiautomator" (Android, installs nothing, slower, cannot type), or "wda" (WebDriverAgent: iOS simulators and iPhones).
target	string	yes	A ref from app_map ("@e2") or a locator ("testid=terms").

Examples

Each is the arguments of a tools/call request; the first is shown whole.

Tick a checkbox, whatever state it is in

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "app_check",
    "arguments": {
      "target": "testid=termsCheck"
    }
  }
}

On an Android 15 emulator the answer's text was:

testid=termsCheck is now checked

Before	After

mobium check testid=termsCheck on an Android 15 emulator

Turn a switch off

{
  "target": "@e4",
  "checked": false
}

On a device

Before	After

mobium uncheck testid=termsCheck on an Android 15 emulator