app_current
This tool on every surface: CLI · MCP · Python · JavaScript · Go · Java · .NET
Report the app currently in the foreground, as a package name or bundle id. Use it to confirm that a tap opened what you expected.
Read-only: readOnlyHint is true.
Arguments
| Name | Type | Required | What it is |
|---|---|---|---|
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). |
Examples
Each is the arguments of a tools/call request; the first is shown whole.
Ask which app is in front
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "app_current",
"arguments": {}
}
}
On an Android 15 emulator the answer's text was:
com.android.settings