Каталог MCP
callstackincubator/agent-device

callstackincubator/agent-device

agent-device — CLI для автоматизации устройств, позволяющий AI-агентам открывать приложения на iOS, Android и десктопе, инспектировать UI, взаимодействовать с элементами и собирать отладочную инфор...

README

57 инструментов

Версии

Установить сервер

agent-device

Mobile app verification for AI agents.

A device automation CLI for real apps on iOS, Android, TV, web, and desktop. Agents get token-efficient snapshots, semantic refs, and evidence captured only when needed.

agent-device lets coding agents open apps, inspect the current UI, interact with visible elements, and collect debugging evidence through one CLI. Use it when an agent needs to verify what actually happens on a device, not just reason about code.

The CLI is the agent's hands, eyes, and evidence collector; it is not the brain. Your coding agent or QA harness reads the task, interprets the current screen, chooses the next command, and decides whether the result satisfies the test. agent-device keeps that loop grounded in structured accessibility data, deterministic actions, and files an engineer can inspect.

If you know Vercel's agent-browser, agent-device is the same idea for mobile, TV, and desktop apps. Minimal --platform web support reuses agent-browser when a browser session needs to fit into the same command/session/replay loop.

Инструменты были проиндексированы: 11.09.2026

alert

Inspect, wait for, accept, or dismiss a platform alert. Use get before acting when the alert content matters; accept and dismiss change the active alert state. Each iOS XCTest execution activates once, then only observes. Inspect again after an unconfirmed action; never assume a timeout means nothing happened. Times out after 90s.

Параметры

actionenum
androidDeviceAllowliststring
Android serial allowlist used for device resolution.
debugboolean
Enable debug diagnostics.
devicestring
Device name selector (a UDID belongs in udid, a serial in serial).
deviceTargetenum
Device target form. Maps to the CLI --target flag.
includeCostboolean
Include per-command agent-cost (cost.wallClockMs, …) in structuredContent. Defaults to off; the default response shape is unchanged.
leaseIdstring
Existing lease identifier.
mcpOutputFormatenum
MCP text content format. Defaults to optimized agent-friendly text; use json for JSON text. Structured content is always returned separately.
noRecordboolean
Do not record this action.
platformenum
Platform selector used to resolve a device.
responseLevelenum
Response verbosity: token-cheap digest / default (today) / full. Defaults to default; the default response shape is unchanged.
runIdstring
Lease run identifier.
serialstring
Android, HarmonyOS, or Vega VVD serial selector.
sessionstring
Agent-device session name.
targetenum
Alias for deviceTarget on commands without a UI target field. Interaction commands reserve target for the UI element.
tenantstring
Remote tenant identifier.
timeoutMsinteger
udidstring
Apple device or simulator UDID; the selector that pins one device when several share a name.

apps

List the apps installed on the selected device. Include system or OEM apps only when they are needed as automation targets. Times out after 90s.

Параметры

androidDeviceAllowliststring
Android serial allowlist used for device resolution.
appsFilterenum
Restrict the listing to user-installed apps, or include system and OEM apps.
debugboolean
Enable debug diagnostics.
devicestring
Device name selector (a UDID belongs in udid, a serial in serial).
deviceTargetenum
Device target form. Maps to the CLI --target flag.
includeCostboolean
Include per-command agent-cost (cost.wallClockMs, …) in structuredContent. Defaults to off; the default response shape is unchanged.
leaseIdstring
Existing lease identifier.
mcpOutputFormatenum
MCP text content format. Defaults to optimized agent-friendly text; use json for JSON text. Structured content is always returned separately.
platformenum
Platform selector used to resolve a device.
responseLevelenum
Response verbosity: token-cheap digest / default (today) / full. Defaults to default; the default response shape is unchanged.
runIdstring
Lease run identifier.
serialstring
Android, HarmonyOS, or Vega VVD serial selector.
sessionstring
Agent-device session name.
targetenum
Alias for deviceTarget on commands without a UI target field. Interaction commands reserve target for the UI element.
tenantstring
Remote tenant identifier.
udidstring
Apple device or simulator UDID; the selector that pins one device when several share a name.

appstate

Show foreground app/activity Times out after 90s.

Параметры

androidDeviceAllowliststring
Android serial allowlist used for device resolution.
debugboolean
Enable debug diagnostics.
devicestring
Device name selector (a UDID belongs in udid, a serial in serial).
deviceTargetenum
Device target form. Maps to the CLI --target flag.
includeCostboolean
Include per-command agent-cost (cost.wallClockMs, …) in structuredContent. Defaults to off; the default response shape is unchanged.
leaseIdstring
Existing lease identifier.
mcpOutputFormatenum
MCP text content format. Defaults to optimized agent-friendly text; use json for JSON text. Structured content is always returned separately.
platformenum
Platform selector used to resolve a device.
responseLevelenum
Response verbosity: token-cheap digest / default (today) / full. Defaults to default; the default response shape is unchanged.
runIdstring
Lease run identifier.
serialstring
Android, HarmonyOS, or Vega VVD serial selector.
sessionstring
Agent-device session name.
targetenum
Alias for deviceTarget on commands without a UI target field. Interaction commands reserve target for the UI element.
tenantstring
Remote tenant identifier.
udidstring
Apple device or simulator UDID; the selector that pins one device when several share a name.

app-switcher

Open the device app switcher to inspect or change foreground apps. This changes the visible system UI and may move focus away from the current app. Times out after 90s.

Параметры

androidDeviceAllowliststring
Android serial allowlist used for device resolution.
debugboolean
Enable debug diagnostics.
devicestring
Device name selector (a UDID belongs in udid, a serial in serial).
deviceTargetenum
Device target form. Maps to the CLI --target flag.
includeCostboolean
Include per-command agent-cost (cost.wallClockMs, …) in structuredContent. Defaults to off; the default response shape is unchanged.
leaseIdstring
Existing lease identifier.
mcpOutputFormatenum
MCP text content format. Defaults to optimized agent-friendly text; use json for JSON text. Structured content is always returned separately.
noRecordboolean
Do not record this action.
platformenum
Platform selector used to resolve a device.
responseLevelenum
Response verbosity: token-cheap digest / default (today) / full. Defaults to default; the default response shape is unchanged.
runIdstring
Lease run identifier.
serialstring
Android, HarmonyOS, or Vega VVD serial selector.
sessionstring
Agent-device session name.
targetenum
Alias for deviceTarget on commands without a UI target field. Interaction commands reserve target for the UI element.
tenantstring
Remote tenant identifier.
udidstring
Apple device or simulator UDID; the selector that pins one device when several share a name.

artifacts

List daemon or cloud provider artifacts for an active or completed session. Times out after 90s.

Параметры

androidDeviceAllowliststring
Android serial allowlist used for device resolution.
debugboolean
Enable debug diagnostics.
devicestring
Device name selector (a UDID belongs in udid, a serial in serial).
deviceTargetenum
Device target form. Maps to the CLI --target flag.
includeCostboolean
Include per-command agent-cost (cost.wallClockMs, …) in structuredContent. Defaults to off; the default response shape is unchanged.
leaseIdstring
Existing lease identifier.
mcpOutputFormatenum
MCP text content format. Defaults to optimized agent-friendly text; use json for JSON text. Structured content is always returned separately.
platformenum
Platform selector used to resolve a device.
providerstring
Cloud provider name, for example browserstack or aws-device-farm.
providerSessionIdstring
Cloud provider session id or ARN.
responseLevelenum
Response verbosity: token-cheap digest / default (today) / full. Defaults to default; the default response shape is unchanged.
runIdstring
Lease run identifier.
serialstring
Android, HarmonyOS, or Vega VVD serial selector.
sessionstring
Agent-device session name.
targetenum
Alias for deviceTarget on commands without a UI target field. Interaction commands reserve target for the UI element.
tenantstring
Remote tenant identifier.
udidstring
Apple device or simulator UDID; the selector that pins one device when several share a name.

audio

Measure browser or host-rendered simulator/emulator audio as compact dBFS buckets. Start a probe before requesting its status or stopping it. Times out after 90s.

Параметры

actionenum
androidDeviceAllowliststring
Android serial allowlist used for device resolution.
bucketMsinteger
Audio level bucket size in milliseconds.
debugboolean
Enable debug diagnostics.
devicestring
Device name selector (a UDID belongs in udid, a serial in serial).
deviceTargetenum
Device target form. Maps to the CLI --target flag.
durationMsinteger
Probe duration in milliseconds.
includeCostboolean
Include per-command agent-cost (cost.wallClockMs, …) in structuredContent. Defaults to off; the default response shape is unchanged.
leaseIdstring
Existing lease identifier.
mcpOutputFormatenum
MCP text content format. Defaults to optimized agent-friendly text; use json for JSON text. Structured content is always returned separately.
platformenum
Platform selector used to resolve a device.
probeActionenum
responseLevelenum
Response verbosity: token-cheap digest / default (today) / full. Defaults to default; the default response shape is unchanged.
runIdstring
Lease run identifier.
serialstring
Android, HarmonyOS, or Vega VVD serial selector.
sessionstring
Agent-device session name.
targetenum
Alias for deviceTarget on commands without a UI target field. Interaction commands reserve target for the UI element.
tenantstring
Remote tenant identifier.
udidstring
Apple device or simulator UDID; the selector that pins one device when several share a name.

back

Navigate back in the app or through system navigation. Use in-app for the app navigation stack and system when the platform back behavior is required. Times out after 90s; a caller-supplied budget extends it.

Параметры

androidDeviceAllowliststring
Android serial allowlist used for device resolution.
debugboolean
Enable debug diagnostics.
devicestring
Device name selector (a UDID belongs in udid, a serial in serial).
deviceTargetenum
Device target form. Maps to the CLI --target flag.
includeCostboolean
Include per-command agent-cost (cost.wallClockMs, …) in structuredContent. Defaults to off; the default response shape is unchanged.
leaseIdstring
Existing lease identifier.
mcpOutputFormatenum
MCP text content format. Defaults to optimized agent-friendly text; use json for JSON text. Structured content is always returned separately.
modeenum
noRecordboolean
Do not record this action.
platformenum
Platform selector used to resolve a device.
responseLevelenum
Response verbosity: token-cheap digest / default (today) / full. Defaults to default; the default response shape is unchanged.
runIdstring
Lease run identifier.
serialstring
Android, HarmonyOS, or Vega VVD serial selector.
sessionstring
Agent-device session name.
settleboolean
After the action, wait for the UI to go quiet and return the settled diff vs the pre-action tree in the same response. Best-effort; never fails the action.
settleQuietMsinteger
Settle: quiet window in milliseconds (default 500).
targetenum
Alias for deviceTarget on commands without a UI target field. Interaction commands reserve target for the UI element.
tenantstring
Remote tenant identifier.
timeoutMsinteger
Settle: wait deadline in milliseconds (default 10000).
udidstring
Apple device or simulator UDID; the selector that pins one device when several share a name.

batch

Execute multiple commands in one daemon request. Times out after 90s.

Параметры

androidDeviceAllowliststring
Android serial allowlist used for device resolution.
debugboolean
Enable debug diagnostics.
devicestring
Device name selector (a UDID belongs in udid, a serial in serial).
deviceTargetenum
Device target form. Maps to the CLI --target flag.
includeCostboolean
Include per-command agent-cost (cost.wallClockMs, …) in structuredContent. Defaults to off; the default response shape is unchanged.
leaseIdstring
Existing lease identifier.
maxStepsinteger
Maximum number of steps accepted for this batch.
mcpOutputFormatenum
MCP text content format. Defaults to optimized agent-friendly text; use json for JSON text. Structured content is always returned separately.
onErrorenum
Batch failure policy.
outstring
Optional output path for command artifacts.
platformenum
Platform selector used to resolve a device.
responseLevelenum
Response verbosity: token-cheap digest / default (today) / full. Defaults to default; the default response shape is unchanged.
runIdstring
Lease run identifier.
serialstring
Android, HarmonyOS, or Vega VVD serial selector.
sessionstring
Agent-device session name.
stepsobject[]обязательный
Structured batch steps. Each step uses a command name and the same input object as that command tool.
targetenum
Alias for deviceTarget on commands without a UI target field. Interaction commands reserve target for the UI element.
tenantstring
Remote tenant identifier.
udidstring
Apple device or simulator UDID; the selector that pins one device when several share a name.

boot

Boot or prepare the selected device or simulator so later commands can target it. The device is chosen through the device-selection inputs, not by naming it here. Times out after 90s.

Параметры

androidDeviceAllowliststring
Android serial allowlist used for device resolution.
debugboolean
Enable debug diagnostics.
devicestring
Device name selector (a UDID belongs in udid, a serial in serial).
deviceTargetenum
Device target form. Maps to the CLI --target flag.
headlessboolean
Boot without showing simulator UI when supported.
includeCostboolean
Include per-command agent-cost (cost.wallClockMs, …) in structuredContent. Defaults to off; the default response shape is unchanged.
leaseIdstring
Existing lease identifier.
mcpOutputFormatenum
MCP text content format. Defaults to optimized agent-friendly text; use json for JSON text. Structured content is always returned separately.
platformenum
Platform selector used to resolve a device.
responseLevelenum
Response verbosity: token-cheap digest / default (today) / full. Defaults to default; the default response shape is unchanged.
runIdstring
Lease run identifier.
serialstring
Android, HarmonyOS, or Vega VVD serial selector.
sessionstring
Agent-device session name.
targetenum
Alias for deviceTarget on commands without a UI target field. Interaction commands reserve target for the UI element.
tenantstring
Remote tenant identifier.
udidstring
Apple device or simulator UDID; the selector that pins one device when several share a name.

capabilities

List the commands supported by the selected device or active session. Use device-selection inputs when checking support before a session is open. Times out after 90s.

Параметры

androidDeviceAllowliststring
Android serial allowlist used for device resolution.
debugboolean
Enable debug diagnostics.
devicestring
Device name selector (a UDID belongs in udid, a serial in serial).
deviceTargetenum
Device target form. Maps to the CLI --target flag.
includeCostboolean
Include per-command agent-cost (cost.wallClockMs, …) in structuredContent. Defaults to off; the default response shape is unchanged.
leaseIdstring
Existing lease identifier.
mcpOutputFormatenum
MCP text content format. Defaults to optimized agent-friendly text; use json for JSON text. Structured content is always returned separately.
platformenum
Platform selector used to resolve a device.
responseLevelenum
Response verbosity: token-cheap digest / default (today) / full. Defaults to default; the default response shape is unchanged.
runIdstring
Lease run identifier.
serialstring
Android, HarmonyOS, or Vega VVD serial selector.
sessionstring
Agent-device session name.
targetenum
Alias for deviceTarget on commands without a UI target field. Interaction commands reserve target for the UI element.
tenantstring
Remote tenant identifier.
udidstring
Apple device or simulator UDID; the selector that pins one device when several share a name.

click

Activate a UI target by snapshot ref, selector, or coordinates. Prefer a ref or selector after a snapshot; use coordinates only when semantic targeting is unavailable. This can change app state; use settle or verify to confirm the result without a follow-up snapshot. Times out after 90s; a caller-supplied budget extends it.

Параметры

androidDeviceAllowliststring
Android serial allowlist used for device resolution.
buttonenum
Pointer button for platforms that support mouse buttons.
countinteger
Number of press/click repetitions.
debugboolean
Enable debug diagnostics.
depthinteger
Snapshot traversal depth.
devicestring
Device name selector (a UDID belongs in udid, a serial in serial).
deviceTargetenum
Device target form. Maps to the CLI --target flag.
doubleTapboolean
Request a double-tap action.
holdMsinteger
Hold duration for each action.
includeCostboolean
Include per-command agent-cost (cost.wallClockMs, …) in structuredContent. Defaults to off; the default response shape is unchanged.
intervalMsinteger
Delay between repeated press/click actions.
jitterPxinteger
Randomization radius in pixels.
leaseIdstring
Existing lease identifier.
mcpOutputFormatenum
MCP text content format. Defaults to optimized agent-friendly text; use json for JSON text. Structured content is always returned separately.
noRecordboolean
Do not record this action.
platformenum
Platform selector used to resolve a device.
rawboolean
Use raw snapshot data during selector resolution.
responseLevelenum
Response verbosity: token-cheap digest / default (today) / full. Defaults to default; the default response shape is unchanged.
runIdstring
Lease run identifier.
scopestring
Snapshot scope selector used before resolution.
serialstring
Android, HarmonyOS, or Vega VVD serial selector.
sessionstring
Agent-device session name.
settleboolean
After the action, wait for the UI to go quiet and return the settled diff vs the pre-action tree in the same response. Best-effort; never fails the action.
settleQuietMsinteger
Settle: quiet window in milliseconds (default 500).
targetobjectобязательный
UI target. This is separate from deviceTarget, which selects the device form.
tenantstring
Remote tenant identifier.
timeoutMsinteger
Settle: wait deadline in milliseconds (default 10000).
udidstring
Apple device or simulator UDID; the selector that pins one device when several share a name.
verifyboolean
Capture cheap post-action evidence (AX digest, node counts, changedFromBefore) instead of a follow-up snapshot.

clipboard

Read the current device clipboard text, or replace its contents with the given text. Times out after 90s.

Параметры

actionenumобязательный
androidDeviceAllowliststring
Android serial allowlist used for device resolution.
debugboolean
Enable debug diagnostics.
devicestring
Device name selector (a UDID belongs in udid, a serial in serial).
deviceTargetenum
Device target form. Maps to the CLI --target flag.
includeCostboolean
Include per-command agent-cost (cost.wallClockMs, …) in structuredContent. Defaults to off; the default response shape is unchanged.
leaseIdstring
Existing lease identifier.
mcpOutputFormatenum
MCP text content format. Defaults to optimized agent-friendly text; use json for JSON text. Structured content is always returned separately.
noRecordboolean
Do not record this action.
platformenum
Platform selector used to resolve a device.
responseLevelenum
Response verbosity: token-cheap digest / default (today) / full. Defaults to default; the default response shape is unchanged.
runIdstring
Lease run identifier.
serialstring
Android, HarmonyOS, or Vega VVD serial selector.
sessionstring
Agent-device session name.
targetenum
Alias for deviceTarget on commands without a UI target field. Interaction commands reserve target for the UI element.
tenantstring
Remote tenant identifier.
textstring
udidstring
Apple device or simulator UDID; the selector that pins one device when several share a name.

close

Close the named app, or close the active session app when app is omitted. Use shutdown only when the selected simulator or emulator should also stop. Times out after 90s.

Параметры

androidDeviceAllowliststring
Android serial allowlist used for device resolution.
appstring
Optional app to close.
debugboolean
Enable debug diagnostics.
devicestring
Device name selector (a UDID belongs in udid, a serial in serial).
deviceTargetenum
Device target form. Maps to the CLI --target flag.
forceboolean
Overwrite an existing --save-script target instead of refusing (alias: --overwrite).
includeCostboolean
Include per-command agent-cost (cost.wallClockMs, …) in structuredContent. Defaults to off; the default response shape is unchanged.
leaseIdstring
Existing lease identifier.
mcpOutputFormatenum
MCP text content format. Defaults to optimized agent-friendly text; use json for JSON text. Structured content is always returned separately.
noRecordboolean
Do not record this action.
platformenum
Platform selector used to resolve a device.
responseLevelenum
Response verbosity: token-cheap digest / default (today) / full. Defaults to default; the default response shape is unchanged.
runIdstring
Lease run identifier.
saveScriptboolean | string
serialstring
Android, HarmonyOS, or Vega VVD serial selector.
sessionstring
Agent-device session name.
shutdownboolean
Shutdown the session/device where supported.
targetenum
Alias for deviceTarget on commands without a UI target field. Interaction commands reserve target for the UI element.
tenantstring
Remote tenant identifier.
udidstring
Apple device or simulator UDID; the selector that pins one device when several share a name.

debug

Symbolicate Apple crash artifacts with matching dSYM UUIDs. This debug namespace is intentionally narrow: use logs for app logs, network for HTTP evidence, perf for performance samples, record/trace for media and traces, and react-devtools for React Native profiles. Times out after 90s.

Параметры

actionenumобязательный
androidDeviceAllowliststring
Android serial allowlist used for device resolution.
artifactstringобязательный
Apple crash artifact path (.ips, .crash, or .log).
debugboolean
Enable debug diagnostics.
devicestring
Device name selector (a UDID belongs in udid, a serial in serial).
deviceTargetenum
Device target form. Maps to the CLI --target flag.
dsymstring
Path to a matching .dSYM bundle.
includeCostboolean
Include per-command agent-cost (cost.wallClockMs, …) in structuredContent. Defaults to off; the default response shape is unchanged.
leaseIdstring
Existing lease identifier.
mcpOutputFormatenum
MCP text content format. Defaults to optimized agent-friendly text; use json for JSON text. Structured content is always returned separately.
outstring
Output path for the symbolicated artifact.
platformenum
Platform selector used to resolve a device.
responseLevelenum
Response verbosity: token-cheap digest / default (today) / full. Defaults to default; the default response shape is unchanged.
runIdstring
Lease run identifier.
searchPathstring
Directory to scan for matching .dSYM bundles.
serialstring
Android, HarmonyOS, or Vega VVD serial selector.
sessionstring
Agent-device session name.
targetenum
Alias for deviceTarget on commands without a UI target field. Interaction commands reserve target for the UI element.
tenantstring
Remote tenant identifier.
udidstring
Apple device or simulator UDID; the selector that pins one device when several share a name.

devices

List available devices and simulators that can be selected for automation. Use platform, device, udid, or serial inputs on later commands to target one result. Times out after 90s.

Параметры

androidDeviceAllowliststring
Android serial allowlist used for device resolution.
debugboolean
Enable debug diagnostics.
devicestring
Device name selector (a UDID belongs in udid, a serial in serial).
deviceTargetenum
Device target form. Maps to the CLI --target flag.
includeCostboolean
Include per-command agent-cost (cost.wallClockMs, …) in structuredContent. Defaults to off; the default response shape is unchanged.
leaseIdstring
Existing lease identifier.
mcpOutputFormatenum
MCP text content format. Defaults to optimized agent-friendly text; use json for JSON text. Structured content is always returned separately.
platformenum
Platform selector used to resolve a device.
responseLevelenum
Response verbosity: token-cheap digest / default (today) / full. Defaults to default; the default response shape is unchanged.
runIdstring
Lease run identifier.
serialstring
Android, HarmonyOS, or Vega VVD serial selector.
sessionstring
Agent-device session name.
targetenum
Alias for deviceTarget on commands without a UI target field. Interaction commands reserve target for the UI element.
tenantstring
Remote tenant identifier.
udidstring
Apple device or simulator UDID; the selector that pins one device when several share a name.

diff

Compare accessibility snapshots or screenshots to identify UI changes. Use snapshot comparisons for semantic tree changes and screenshot comparisons for pixel differences. Times out after 90s.

Параметры

androidDeviceAllowliststring
Android serial allowlist used for device resolution.
debugboolean
Enable debug diagnostics.
depthinteger
devicestring
Device name selector (a UDID belongs in udid, a serial in serial).
deviceTargetenum
Device target form. Maps to the CLI --target flag.
includeCostboolean
Include per-command agent-cost (cost.wallClockMs, …) in structuredContent. Defaults to off; the default response shape is unchanged.
interactiveOnlyboolean
kindstringобязательный
leaseIdstring
Existing lease identifier.
mcpOutputFormatenum
MCP text content format. Defaults to optimized agent-friendly text; use json for JSON text. Structured content is always returned separately.
noRecordboolean
Do not record this action.
outstring
platformenum
Platform selector used to resolve a device.
rawboolean
responseLevelenum
Response verbosity: token-cheap digest / default (today) / full. Defaults to default; the default response shape is unchanged.
runIdstring
Lease run identifier.
scopestring
serialstring
Android, HarmonyOS, or Vega VVD serial selector.
sessionstring
Agent-device session name.
targetenum
Alias for deviceTarget on commands without a UI target field. Interaction commands reserve target for the UI element.
tenantstring
Remote tenant identifier.
udidstring
Apple device or simulator UDID; the selector that pins one device when several share a name.

doctor

Diagnose device, app, development-server, and React Native or Expo readiness issues. Returns compact evidence for local inventory, sessions, optional app discovery, toolchains, and server reachability. On iOS simulators it also warms the XCTest runner build cache in the background when missing, so run it before the first Apple snapshot or interaction of a session. Times out after 90s.

Параметры

androidDeviceAllowliststring
Android serial allowlist used for device resolution.
debugboolean
Enable debug diagnostics.
devicestring
Device name selector (a UDID belongs in udid, a serial in serial).
deviceTargetenum
Device target form. Maps to the CLI --target flag.
includeCostboolean
Include per-command agent-cost (cost.wallClockMs, …) in structuredContent. Defaults to off; the default response shape is unchanged.
leaseIdstring
Existing lease identifier.
mcpOutputFormatenum
MCP text content format. Defaults to optimized agent-friendly text; use json for JSON text. Structured content is always returned separately.
platformenum
Platform selector used to resolve a device.
remoteboolean
Check remote connection setup instead of local device inventory.
responseLevelenum
Response verbosity: token-cheap digest / default (today) / full. Defaults to default; the default response shape is unchanged.
runIdstring
Lease run identifier.
serialstring
Android, HarmonyOS, or Vega VVD serial selector.
sessionstring
Agent-device session name.
targetenum
Alias for deviceTarget on commands without a UI target field. Interaction commands reserve target for the UI element.
targetAppstring
Installed app package/bundle id or app name to verify without opening a session.
tenantstring
Remote tenant identifier.
udidstring
Apple device or simulator UDID; the selector that pins one device when several share a name.

events

Read the daemon-owned session event timeline as paged JSON-friendly entries Times out after 90s.

Параметры

androidDeviceAllowliststring
Android serial allowlist used for device resolution.
cursorstring
debugboolean
Enable debug diagnostics.
devicestring
Device name selector (a UDID belongs in udid, a serial in serial).
deviceTargetenum
Device target form. Maps to the CLI --target flag.
includeCostboolean
Include per-command agent-cost (cost.wallClockMs, …) in structuredContent. Defaults to off; the default response shape is unchanged.
leaseIdstring
Existing lease identifier.
limitinteger
mcpOutputFormatenum
MCP text content format. Defaults to optimized agent-friendly text; use json for JSON text. Structured content is always returned separately.
platformenum
Platform selector used to resolve a device.
responseLevelenum
Response verbosity: token-cheap digest / default (today) / full. Defaults to default; the default response shape is unchanged.
runIdstring
Lease run identifier.
serialstring
Android, HarmonyOS, or Vega VVD serial selector.
sessionstring
Agent-device session name.
targetenum
Alias for deviceTarget on commands without a UI target field. Interaction commands reserve target for the UI element.
tenantstring
Remote tenant identifier.
udidstring
Apple device or simulator UDID; the selector that pins one device when several share a name.

fill

Replace text in a UI input selected by snapshot ref, selector, or coordinates. Pass an empty text to clear the field. Prefer refs or selectors after snapshot; use recordAs to keep sensitive text out of a recorded replay while sending it to the live app. Times out after 90s; a caller-supplied budget extends it.

Параметры

androidDeviceAllowliststring
Android serial allowlist used for device resolution.
debugboolean
Enable debug diagnostics.
delayMsinteger
Delay between typed characters.
depthinteger
Snapshot traversal depth.
devicestring
Device name selector (a UDID belongs in udid, a serial in serial).
deviceTargetenum
Device target form. Maps to the CLI --target flag.
includeCostboolean
Include per-command agent-cost (cost.wallClockMs, …) in structuredContent. Defaults to off; the default response shape is unchanged.
leaseIdstring
Existing lease identifier.
mcpOutputFormatenum
MCP text content format. Defaults to optimized agent-friendly text; use json for JSON text. Structured content is always returned separately.
noRecordboolean
Do not record this action.
platformenum
Platform selector used to resolve a device.
rawboolean
Use raw snapshot data during selector resolution.
recordAsstring
When script recording is armed, send text to the live app but publish it as ${VAR}. Use an uppercase replay variable name such as PASSWORD.
responseLevelenum
Response verbosity: token-cheap digest / default (today) / full. Defaults to default; the default response shape is unchanged.
runIdstring
Lease run identifier.
scopestring
Snapshot scope selector used before resolution.
serialstring
Android, HarmonyOS, or Vega VVD serial selector.
sessionstring
Agent-device session name.
settleboolean
After the action, wait for the UI to go quiet and return the settled diff vs the pre-action tree in the same response. Best-effort; never fails the action.
settleQuietMsinteger
Settle: quiet window in milliseconds (default 500).
targetobjectобязательный
UI target. This is separate from deviceTarget, which selects the device form.
tenantstring
Remote tenant identifier.
textstringобязательный
Text to enter into the target. Pass "" to clear it.
timeoutMsinteger
Settle: wait deadline in milliseconds (default 10000).
udidstring
Apple device or simulator UDID; the selector that pins one device when several share a name.
verifyboolean
Capture cheap post-action evidence (AX digest, node counts, changedFromBefore) instead of a follow-up snapshot.

find

Find by text/label/value/role/id and run action Times out after 90s.

Параметры

actionenum
androidDeviceAllowliststring
Android serial allowlist used for device resolution.
debugboolean
Enable debug diagnostics.
depthinteger
devicestring
Device name selector (a UDID belongs in udid, a serial in serial).
deviceTargetenum
Device target form. Maps to the CLI --target flag.
firstboolean
includeCostboolean
Include per-command agent-cost (cost.wallClockMs, …) in structuredContent. Defaults to off; the default response shape is unchanged.
lastboolean
leaseIdstring
Existing lease identifier.
locatorenum
mcpOutputFormatenum
MCP text content format. Defaults to optimized agent-friendly text; use json for JSON text. Structured content is always returned separately.
noRecordboolean
Do not record this action.
platformenum
Platform selector used to resolve a device.
querystringобязательный
rawboolean
recordboolean
Force-record this out-of-band observation into a repair-armed heal (mutually exclusive with noRecord). Authored replay steps are recorded automatically and never need this. On find, valid only for a read-only action.
responseLevelenum
Response verbosity: token-cheap digest / default (today) / full. Defaults to default; the default response shape is unchanged.
runIdstring
Lease run identifier.
serialstring
Android, HarmonyOS, or Vega VVD serial selector.
sessionstring
Agent-device session name.
targetenum
Alias for deviceTarget on commands without a UI target field. Interaction commands reserve target for the UI element.
tenantstring
Remote tenant identifier.
timeoutMsinteger
udidstring
Apple device or simulator UDID; the selector that pins one device when several share a name.
valuestring

focus

Move input focus to explicit screen coordinates without entering text. Prefer semantic interactions when a snapshot ref or selector is available; use type or fill after focus. Times out after 90s.

Параметры

androidDeviceAllowliststring
Android serial allowlist used for device resolution.
debugboolean
Enable debug diagnostics.
devicestring
Device name selector (a UDID belongs in udid, a serial in serial).
deviceTargetenum
Device target form. Maps to the CLI --target flag.
includeCostboolean
Include per-command agent-cost (cost.wallClockMs, …) in structuredContent. Defaults to off; the default response shape is unchanged.
leaseIdstring
Existing lease identifier.
mcpOutputFormatenum
MCP text content format. Defaults to optimized agent-friendly text; use json for JSON text. Structured content is always returned separately.
noRecordboolean
Do not record this action.
platformenum
Platform selector used to resolve a device.
responseLevelenum
Response verbosity: token-cheap digest / default (today) / full. Defaults to default; the default response shape is unchanged.
runIdstring
Lease run identifier.
serialstring
Android, HarmonyOS, or Vega VVD serial selector.
sessionstring
Agent-device session name.
targetenum
Alias for deviceTarget on commands without a UI target field. Interaction commands reserve target for the UI element.
tenantstring
Remote tenant identifier.
udidstring
Apple device or simulator UDID; the selector that pins one device when several share a name.
xnumberобязательный
X coordinate.
ynumberобязательный
Y coordinate.

gesture

Perform a structured pan, fling, swipe, pinch, rotate, transform, or drag gesture. Select the gesture kind, then provide only the inputs that apply to that kind. Times out after 90s.

Параметры

androidDeviceAllowliststring
Android serial allowlist used for device resolution.
debugboolean
Enable debug diagnostics.
degreesnumber
Rotation in degrees.
deltaobject
Movement delta for pan or transform gestures.
destinationstring
Drag destination @ref or selector.
destinationHoldMsinteger
Hold before releasing at the destination.
devicestring
Device name selector (a UDID belongs in udid, a serial in serial).
deviceTargetenum
Device target form. Maps to the CLI --target flag.
directionenum
Fling direction.
distanceinteger
Fling distance.
durationMsinteger
Pan/transform duration.
includeCostboolean
Include per-command agent-cost (cost.wallClockMs, …) in structuredContent. Defaults to off; the default response shape is unchanged.
kindenumобязательный
Gesture variant.
leaseIdstring
Existing lease identifier.
mcpOutputFormatenum
MCP text content format. Defaults to optimized agent-friendly text; use json for JSON text. Structured content is always returned separately.
moveMsinteger
Drag movement duration.
noRecordboolean
Do not record this action.
originobject
Gesture origin point.
platformenum
Platform selector used to resolve a device.
pointerCountinteger
Pan touch pointer count (1 or 2).
presetenum
Swipe preset.
responseLevelenum
Response verbosity: token-cheap digest / default (today) / full. Defaults to default; the default response shape is unchanged.
runIdstring
Lease run identifier.
scalenumber
Pinch or transform scale.
serialstring
Android, HarmonyOS, or Vega VVD serial selector.
sessionstring
Agent-device session name.
sourcestring
Drag source @ref or selector.
sourceHoldMsinteger
Drag activation hold duration.
targetenum
Alias for deviceTarget on commands without a UI target field. Interaction commands reserve target for the UI element.
tenantstring
Remote tenant identifier.
udidstring
Apple device or simulator UDID; the selector that pins one device when several share a name.

get

Read text or accessibility attributes from a snapshot ref or selector without changing the app. Use format text for visible content or attrs for the element attribute map. Times out after 90s.

Параметры

androidDeviceAllowliststring
Android serial allowlist used for device resolution.
debugboolean
Enable debug diagnostics.
depthinteger
Snapshot traversal depth.
devicestring
Device name selector (a UDID belongs in udid, a serial in serial).
deviceTargetenum
Device target form. Maps to the CLI --target flag.
formatenumобязательный
includeCostboolean
Include per-command agent-cost (cost.wallClockMs, …) in structuredContent. Defaults to off; the default response shape is unchanged.
leaseIdstring
Existing lease identifier.
mcpOutputFormatenum
MCP text content format. Defaults to optimized agent-friendly text; use json for JSON text. Structured content is always returned separately.
noRecordboolean
Do not record this action.
platformenum
Platform selector used to resolve a device.
rawboolean
Use raw snapshot data during selector resolution.
recordboolean
Force-record this out-of-band observation into a repair-armed heal (mutually exclusive with noRecord). Authored replay steps are recorded automatically and never need this. On find, valid only for a read-only action.
responseLevelenum
Response verbosity: token-cheap digest / default (today) / full. Defaults to default; the default response shape is unchanged.
runIdstring
Lease run identifier.
scopestring
Snapshot scope selector used before resolution.
serialstring
Android, HarmonyOS, or Vega VVD serial selector.
sessionstring
Agent-device session name.
targetobjectобязательный
UI element target by snapshot ref or selector expression.
tenantstring
Remote tenant identifier.
udidstring
Apple device or simulator UDID; the selector that pins one device when several share a name.

help

Руководства по использованию. Если тема не указана: полная карточка рабочего процесса. topic = одно из: commands, manual-qa, maestro, workflow, scripting, gestures, tv, debugging, react-devtools, cdp, react-native, physical-device, ios-system-ui, remote, macos, web, dogfood, validate для этого руководства, или имя инструмента для получения полного справочника флагов. Только для специализированной работы или неясной формы команды; не для начального шага, не требуется после ошибки, которая содержит подсказку.

Параметры

topicstring
Guide topic or tool name; omit for the card.

home

Send the selected device to its home screen. This leaves the app session open but moves the foreground away from the app. Times out after 90s.

Параметры

androidDeviceAllowliststring
Android serial allowlist used for device resolution.
debugboolean
Enable debug diagnostics.
devicestring
Device name selector (a UDID belongs in udid, a serial in serial).
deviceTargetenum
Device target form. Maps to the CLI --target flag.
includeCostboolean
Include per-command agent-cost (cost.wallClockMs, …) in structuredContent. Defaults to off; the default response shape is unchanged.
leaseIdstring
Existing lease identifier.
mcpOutputFormatenum
MCP text content format. Defaults to optimized agent-friendly text; use json for JSON text. Structured content is always returned separately.
noRecordboolean
Do not record this action.
platformenum
Platform selector used to resolve a device.
responseLevelenum
Response verbosity: token-cheap digest / default (today) / full. Defaults to default; the default response shape is unchanged.
runIdstring
Lease run identifier.
serialstring
Android, HarmonyOS, or Vega VVD serial selector.
sessionstring
Agent-device session name.
targetenum
Alias for deviceTarget on commands without a UI target field. Interaction commands reserve target for the UI element.
tenantstring
Remote tenant identifier.
udidstring
Apple device or simulator UDID; the selector that pins one device when several share a name.

hover

Move the pointer over a UI target by snapshot ref, selector, or coordinates without pressing, to reveal hover-gated UI such as row toolbars or menus. Web only; touch platforms have no hover state. Use settle to observe what the hover revealed without a follow-up snapshot. Times out after 90s; a caller-supplied budget extends it.

Параметры

androidDeviceAllowliststring
Android serial allowlist used for device resolution.
debugboolean
Enable debug diagnostics.
depthinteger
Snapshot traversal depth.
devicestring
Device name selector (a UDID belongs in udid, a serial in serial).
deviceTargetenum
Device target form. Maps to the CLI --target flag.
includeCostboolean
Include per-command agent-cost (cost.wallClockMs, …) in structuredContent. Defaults to off; the default response shape is unchanged.
leaseIdstring
Existing lease identifier.
mcpOutputFormatenum
MCP text content format. Defaults to optimized agent-friendly text; use json for JSON text. Structured content is always returned separately.
noRecordboolean
Do not record this action.
platformenum
Platform selector used to resolve a device.
rawboolean
Use raw snapshot data during selector resolution.
responseLevelenum
Response verbosity: token-cheap digest / default (today) / full. Defaults to default; the default response shape is unchanged.
runIdstring
Lease run identifier.
scopestring
Snapshot scope selector used before resolution.
serialstring
Android, HarmonyOS, or Vega VVD serial selector.
sessionstring
Agent-device session name.
settleboolean
After the action, wait for the UI to go quiet and return the settled diff vs the pre-action tree in the same response. Best-effort; never fails the action.
settleQuietMsinteger
Settle: quiet window in milliseconds (default 500).
targetobjectобязательный
UI target. This is separate from deviceTarget, which selects the device form.
tenantstring
Remote tenant identifier.
timeoutMsinteger
Settle: wait deadline in milliseconds (default 10000).
udidstring
Apple device or simulator UDID; the selector that pins one device when several share a name.

install

Install an app binary from a local path. Provide an app identifier with the path when the target needs explicit app selection; use reinstall to replace an already installed app. Times out after 180s.

Параметры

androidDeviceAllowliststring
Android serial allowlist used for device resolution.
appstring
Optional app identifier hint.
appPathstringобязательный
Path to app binary.
debugboolean
Enable debug diagnostics.
devicestring
Device name selector (a UDID belongs in udid, a serial in serial).
deviceTargetenum
Device target form. Maps to the CLI --target flag.
includeCostboolean
Include per-command agent-cost (cost.wallClockMs, …) in structuredContent. Defaults to off; the default response shape is unchanged.
leaseIdstring
Existing lease identifier.
mcpOutputFormatenum
MCP text content format. Defaults to optimized agent-friendly text; use json for JSON text. Structured content is always returned separately.
noRecordboolean
Do not record this action.
platformenum
Platform selector used to resolve a device.
responseLevelenum
Response verbosity: token-cheap digest / default (today) / full. Defaults to default; the default response shape is unchanged.
runIdstring
Lease run identifier.
serialstring
Android, HarmonyOS, or Vega VVD serial selector.
sessionstring
Agent-device session name.
targetenum
Alias for deviceTarget on commands without a UI target field. Interaction commands reserve target for the UI element.
tenantstring
Remote tenant identifier.
udidstring
Apple device or simulator UDID; the selector that pins one device when several share a name.

install-from-source

Install app builds from URLs, remote source specs, or CI artifacts resolved by a remote daemon. Times out after 90s.

Параметры

androidDeviceAllowliststring
Android serial allowlist used for device resolution.
debugboolean
Enable debug diagnostics.
devicestring
Device name selector (a UDID belongs in udid, a serial in serial).
deviceTargetenum
Device target form. Maps to the CLI --target flag.
includeCostboolean
Include per-command agent-cost (cost.wallClockMs, …) in structuredContent. Defaults to off; the default response shape is unchanged.
leaseIdstring
Existing lease identifier.
mcpOutputFormatenum
MCP text content format. Defaults to optimized agent-friendly text; use json for JSON text. Structured content is always returned separately.
noRecordboolean
Do not record this action.
platformenum
Platform selector used to resolve a device.
responseLevelenum
Response verbosity: token-cheap digest / default (today) / full. Defaults to default; the default response shape is unchanged.
retainPathsboolean
retentionMsinteger
runIdstring
Lease run identifier.
serialstring
Android, HarmonyOS, or Vega VVD serial selector.
sessionstring
Agent-device session name.
sourceobjectобязательный
Install source object.
targetenum
Alias for deviceTarget on commands without a UI target field. Interaction commands reserve target for the UI element.
tenantstring
Remote tenant identifier.
udidstring
Apple device or simulator UDID; the selector that pins one device when several share a name.

is

Check whether a selector satisfies a UI predicate such as visible, hidden, exists, absent, editable, selected, focused, or text. absent passes only when one readable, complete, unscoped, full-depth accessibility capture has zero matches. Use wait when the condition may appear asynchronously. Times out after 90s.

Параметры

androidDeviceAllowliststring
Android serial allowlist used for device resolution.
debugboolean
Enable debug diagnostics.
depthinteger
Snapshot traversal depth.
devicestring
Device name selector (a UDID belongs in udid, a serial in serial).
deviceTargetenum
Device target form. Maps to the CLI --target flag.
includeCostboolean
Include per-command agent-cost (cost.wallClockMs, …) in structuredContent. Defaults to off; the default response shape is unchanged.
leaseIdstring
Existing lease identifier.
mcpOutputFormatenum
MCP text content format. Defaults to optimized agent-friendly text; use json for JSON text. Structured content is always returned separately.
noRecordboolean
Do not record this action.
platformenum
Platform selector used to resolve a device.
predicateenumобязательный
rawboolean
Use raw snapshot data during selector resolution.
recordboolean
Force-record this out-of-band observation into a repair-armed heal (mutually exclusive with noRecord). Authored replay steps are recorded automatically and never need this. On find, valid only for a read-only action.
responseLevelenum
Response verbosity: token-cheap digest / default (today) / full. Defaults to default; the default response shape is unchanged.
runIdstring
Lease run identifier.
scopestring
Snapshot scope selector used before resolution.
selectorstringобязательный
serialstring
Android, HarmonyOS, or Vega VVD serial selector.
sessionstring
Agent-device session name.
targetenum
Alias for deviceTarget on commands without a UI target field. Interaction commands reserve target for the UI element.
tenantstring
Remote tenant identifier.
udidstring
Apple device or simulator UDID; the selector that pins one device when several share a name.
valuestring

keyboard

Inspect Android keyboard visibility/type or press/dismiss the device keyboard. To hide the keyboard, use keyboard dismiss. It taps the keyboard dismiss/hide key when one is exposed, verifies the keyboard closed, and reports UNSUPPORTED_OPERATION when no dismiss key exists — background taps are never attempted. Times out after 90s.

Параметры

actionenum
androidDeviceAllowliststring
Android serial allowlist used for device resolution.
debugboolean
Enable debug diagnostics.
devicestring
Device name selector (a UDID belongs in udid, a serial in serial).
deviceTargetenum
Device target form. Maps to the CLI --target flag.
includeCostboolean
Include per-command agent-cost (cost.wallClockMs, …) in structuredContent. Defaults to off; the default response shape is unchanged.
leaseIdstring
Existing lease identifier.
mcpOutputFormatenum
MCP text content format. Defaults to optimized agent-friendly text; use json for JSON text. Structured content is always returned separately.
noRecordboolean
Do not record this action.
platformenum
Platform selector used to resolve a device.
responseLevelenum
Response verbosity: token-cheap digest / default (today) / full. Defaults to default; the default response shape is unchanged.
runIdstring
Lease run identifier.
serialstring
Android, HarmonyOS, or Vega VVD serial selector.
sessionstring
Agent-device session name.
targetenum
Alias for deviceTarget on commands without a UI target field. Interaction commands reserve target for the UI element.
tenantstring
Remote tenant identifier.
udidstring
Apple device or simulator UDID; the selector that pins one device when several share a name.

logs

Session app log info, start/stop streaming, diagnostics, and markers Times out after 90s.

Параметры

actionenum
androidDeviceAllowliststring
Android serial allowlist used for device resolution.
debugboolean
Enable debug diagnostics.
devicestring
Device name selector (a UDID belongs in udid, a serial in serial).
deviceTargetenum
Device target form. Maps to the CLI --target flag.
includeCostboolean
Include per-command agent-cost (cost.wallClockMs, …) in structuredContent. Defaults to off; the default response shape is unchanged.
leaseIdstring
Existing lease identifier.
mcpOutputFormatenum
MCP text content format. Defaults to optimized agent-friendly text; use json for JSON text. Structured content is always returned separately.
messagestring
platformenum
Platform selector used to resolve a device.
responseLevelenum
Response verbosity: token-cheap digest / default (today) / full. Defaults to default; the default response shape is unchanged.
restartboolean
runIdstring
Lease run identifier.
serialstring
Android, HarmonyOS, or Vega VVD serial selector.
sessionstring
Agent-device session name.
targetenum
Alias for deviceTarget on commands without a UI target field. Interaction commands reserve target for the UI element.
tenantstring
Remote tenant identifier.
udidstring
Apple device or simulator UDID; the selector that pins one device when several share a name.

longpress

Hold a UI target by snapshot ref, selector, or coordinates to open a context menu or perform another hold gesture. Set durationMs when the default hold duration is unsuitable. Times out after 210s; a caller-supplied budget extends it.

Параметры

androidDeviceAllowliststring
Android serial allowlist used for device resolution.
debugboolean
Enable debug diagnostics.
depthinteger
Snapshot traversal depth.
devicestring
Device name selector (a UDID belongs in udid, a serial in serial).
deviceTargetenum
Device target form. Maps to the CLI --target flag.
durationMsinteger
Long press duration in milliseconds.
includeCostboolean
Include per-command agent-cost (cost.wallClockMs, …) in structuredContent. Defaults to off; the default response shape is unchanged.
leaseIdstring
Existing lease identifier.
mcpOutputFormatenum
MCP text content format. Defaults to optimized agent-friendly text; use json for JSON text. Structured content is always returned separately.
noRecordboolean
Do not record this action.
platformenum
Platform selector used to resolve a device.
rawboolean
Use raw snapshot data during selector resolution.
responseLevelenum
Response verbosity: token-cheap digest / default (today) / full. Defaults to default; the default response shape is unchanged.
runIdstring
Lease run identifier.
scopestring
Snapshot scope selector used before resolution.
serialstring
Android, HarmonyOS, or Vega VVD serial selector.
sessionstring
Agent-device session name.
settleboolean
After the action, wait for the UI to go quiet and return the settled diff vs the pre-action tree in the same response. Best-effort; never fails the action.
settleQuietMsinteger
Settle: quiet window in milliseconds (default 500).
targetobjectобязательный
UI target. This is separate from deviceTarget, which selects the device form.
tenantstring
Remote tenant identifier.
timeoutMsinteger
Settle: wait deadline in milliseconds (default 10000).
udidstring
Apple device or simulator UDID; the selector that pins one device when several share a name.

metro

Prepare a React Native development server or ask connected apps to reload, using the development server this session is bound to. Provide explicit runtime inputs only to override that binding for one call. The binding is cleared when the session closes, and a fresh open without runtime hints also clears any leftover binding from a previous same-name session. Times out after 90s.

Параметры

actionenumобязательный
androidDeviceAllowliststring
Android serial allowlist used for device resolution.
bridgeScopeobject
bundleUrlstring
debugboolean
Enable debug diagnostics.
devicestring
Device name selector (a UDID belongs in udid, a serial in serial).
deviceTargetenum
Device target form. Maps to the CLI --target flag.
includeCostboolean
Include per-command agent-cost (cost.wallClockMs, …) in structuredContent. Defaults to off; the default response shape is unchanged.
installDependenciesIfNeededboolean
kindstring
launchUrlstring
leaseIdstring
Existing lease identifier.
listenHoststring
logPathstring
mcpOutputFormatenum
MCP text content format. Defaults to optimized agent-friendly text; use json for JSON text. Structured content is always returned separately.
metroHoststring
metroPortinteger
platformenum
Platform selector used to resolve a device.
portinteger
probeTimeoutMsinteger
projectRootstring
publicBaseUrlstring
responseLevelenum
Response verbosity: token-cheap digest / default (today) / full. Defaults to default; the default response shape is unchanged.
reuseExistingboolean
runIdstring
Lease run identifier.
runtimeFilePathstring
serialstring
Android, HarmonyOS, or Vega VVD serial selector.
sessionstring
Agent-device session name.
startupTimeoutMsinteger
statusHoststring
targetenum
Alias for deviceTarget on commands without a UI target field. Interaction commands reserve target for the UI element.
tenantstring
Remote tenant identifier.
timeoutMsinteger
udidstring
Apple device or simulator UDID; the selector that pins one device when several share a name.

network

Dump recent HTTP(s) traffic parsed from the session app log Times out after 90s.

Параметры

actionenum
androidDeviceAllowliststring
Android serial allowlist used for device resolution.
debugboolean
Enable debug diagnostics.
devicestring
Device name selector (a UDID belongs in udid, a serial in serial).
deviceTargetenum
Device target form. Maps to the CLI --target flag.
includeenum
includeCostboolean
Include per-command agent-cost (cost.wallClockMs, …) in structuredContent. Defaults to off; the default response shape is unchanged.
leaseIdstring
Existing lease identifier.
limitinteger
mcpOutputFormatenum
MCP text content format. Defaults to optimized agent-friendly text; use json for JSON text. Structured content is always returned separately.
platformenum
Platform selector used to resolve a device.
responseLevelenum
Response verbosity: token-cheap digest / default (today) / full. Defaults to default; the default response shape is unchanged.
runIdstring
Lease run identifier.
serialstring
Android, HarmonyOS, or Vega VVD serial selector.
sessionstring
Agent-device session name.
targetenum
Alias for deviceTarget on commands without a UI target field. Interaction commands reserve target for the UI element.
tenantstring
Remote tenant identifier.
udidstring
Apple device or simulator UDID; the selector that pins one device when several share a name.

open

Boot the selected device when needed, then open an app, deep link, or URL in a session. Use the app or URL inputs to choose what becomes the foreground automation target. Metro and debug runtime hints given here are recorded as the session's dev-server binding, so a later reload reuses them; a fresh open without them clears any binding left by a previous same-name session. Times out after 90s; a caller-supplied budget extends it.

Параметры

activitystring
Android activity name.
androidDeviceAllowliststring
Android serial allowlist used for device resolution.
appstring
App name, bundle id, package, or URL.
bundleUrlstring
Session-scoped bundle URL hint applied to the opened app.
debugboolean
Enable debug diagnostics.
devicestring
Device name selector (a UDID belongs in udid, a serial in serial).
deviceHubboolean
Use Xcode Device Hub when surfacing Apple simulators.
deviceTargetenum
Device target form. Maps to the CLI --target flag.
forceboolean
Overwrite an existing --save-script target instead of refusing (alias: --overwrite).
foregroundboolean
Include an initial interactive snapshot in a fresh open response. With no app argument, discover the sole running app on the sole booted iOS simulator; ambiguous environments fail closed.
includeCostboolean
Include per-command agent-cost (cost.wallClockMs, …) in structuredContent. Defaults to off; the default response shape is unchanged.
launchArgsstring[]
Launch arguments forwarded verbatim to the platform launch command.
launchConsolestring
Launch console mode.
launchUrlstring
Session-scoped launch URL hint applied to the opened app.
leaseIdstring
Existing lease identifier.
mcpOutputFormatenum
MCP text content format. Defaults to optimized agent-friendly text; use json for JSON text. Structured content is always returned separately.
metroHoststring
Session-scoped Metro/debug host hint applied to the opened app.
metroPortinteger
Session-scoped Metro/debug port hint applied to the opened app. On an emulator/simulator the host defaults to the loopback alias (Android 10.0.2.2, iOS 127.0.0.1) when --metro-host is omitted; physical devices still require an explicit --metro-host.
noRecordboolean
Do not record this action.
platformenum
Platform selector used to resolve a device.
relaunchboolean
Force relaunch.
responseLevelenum
Response verbosity: token-cheap digest / default (today) / full. Defaults to default; the default response shape is unchanged.
runIdstring
Lease run identifier.
saveScriptboolean | string
serialstring
Android, HarmonyOS, or Vega VVD serial selector.
sessionstring
Agent-device session name.
surfaceenum
macOS presentation surface to open: the app itself, the frontmost app, the desktop, or the menu bar.
targetenum
Alias for deviceTarget on commands without a UI target field. Interaction commands reserve target for the UI element.
tenantstring
Remote tenant identifier.
testImeboolean
Activate the headless Android test IME for deterministic Unicode text entry (default on for emulators; opt-in on real devices).
timeoutMsinteger
Startup budget in milliseconds. Bounds the Simulator boot wait, so a never-booted Simulator can finish its first-boot migration; omit for the default startup behavior.
udidstring
Apple device or simulator UDID; the selector that pins one device when several share a name.
urlstring
Optional URL passed with an app shell.

orientation

Set device orientation on iOS and Android Times out after 90s.

Параметры

androidDeviceAllowliststring
Android serial allowlist used for device resolution.
debugboolean
Enable debug diagnostics.
devicestring
Device name selector (a UDID belongs in udid, a serial in serial).
deviceTargetenum
Device target form. Maps to the CLI --target flag.
includeCostboolean
Include per-command agent-cost (cost.wallClockMs, …) in structuredContent. Defaults to off; the default response shape is unchanged.
leaseIdstring
Existing lease identifier.
mcpOutputFormatenum
MCP text content format. Defaults to optimized agent-friendly text; use json for JSON text. Structured content is always returned separately.
noRecordboolean
Do not record this action.
orientationenumобязательный
platformenum
Platform selector used to resolve a device.
responseLevelenum
Response verbosity: token-cheap digest / default (today) / full. Defaults to default; the default response shape is unchanged.
runIdstring
Lease run identifier.
serialstring
Android, HarmonyOS, or Vega VVD serial selector.
sessionstring
Agent-device session name.
targetenum
Alias for deviceTarget on commands without a UI target field. Interaction commands reserve target for the UI element.
tenantstring
Remote tenant identifier.
udidstring
Apple device or simulator UDID; the selector that pins one device when several share a name.

perf

Collect frame health, memory diagnostics, and platform profiling artifacts with compact agent-readable summaries. For CPU profiles, start and stop write the raw artifact while report writes a compact summary; request the report when the task needs readable native CPU evidence. Profiling output is evidence only: compact state, artifact path, and size. Times out after 90s.

Параметры

actionenum
androidDeviceAllowliststring
Android serial allowlist used for device resolution.
areaenumобязательный
debugboolean
Enable debug diagnostics.
devicestring
Device name selector (a UDID belongs in udid, a serial in serial).
deviceTargetenum
Device target form. Maps to the CLI --target flag.
includeCostboolean
Include per-command agent-cost (cost.wallClockMs, …) in structuredContent. Defaults to off; the default response shape is unchanged.
kindenum
leaseIdstring
Existing lease identifier.
mcpOutputFormatenum
MCP text content format. Defaults to optimized agent-friendly text; use json for JSON text. Structured content is always returned separately.
noRecordboolean
Do not record this action.
outstring
Output artifact path.
platformenum
Platform selector used to resolve a device.
responseLevelenum
Response verbosity: token-cheap digest / default (today) / full. Defaults to default; the default response shape is unchanged.
runIdstring
Lease run identifier.
serialstring
Android, HarmonyOS, or Vega VVD serial selector.
sessionstring
Agent-device session name.
subjectenum
targetenum
Alias for deviceTarget on commands without a UI target field. Interaction commands reserve target for the UI element.
templatestring
xctrace template name, for example Time Profiler.
tenantstring
Remote tenant identifier.
tracePathstring
Existing .trace path to report, defaults to the latest session trace.
udidstring
Apple device or simulator UDID; the selector that pins one device when several share a name.

press

Short-press a UI target by snapshot ref, selector, or coordinates. Use longpress instead when the target requires a context-menu or hold gesture. Times out after 90s; a caller-supplied budget extends it.

Параметры

androidDeviceAllowliststring
Android serial allowlist used for device resolution.
countinteger
Number of press/click repetitions.
debugboolean
Enable debug diagnostics.
depthinteger
Snapshot traversal depth.
devicestring
Device name selector (a UDID belongs in udid, a serial in serial).
deviceTargetenum
Device target form. Maps to the CLI --target flag.
doubleTapboolean
Request a double-tap action.
holdMsinteger
Hold duration for each action.
includeCostboolean
Include per-command agent-cost (cost.wallClockMs, …) in structuredContent. Defaults to off; the default response shape is unchanged.
intervalMsinteger
Delay between repeated press/click actions.
jitterPxinteger
Randomization radius in pixels.
leaseIdstring
Existing lease identifier.
mcpOutputFormatenum
MCP text content format. Defaults to optimized agent-friendly text; use json for JSON text. Structured content is always returned separately.
noRecordboolean
Do not record this action.
platformenum
Platform selector used to resolve a device.
rawboolean
Use raw snapshot data during selector resolution.
responseLevelenum
Response verbosity: token-cheap digest / default (today) / full. Defaults to default; the default response shape is unchanged.
runIdstring
Lease run identifier.
scopestring
Snapshot scope selector used before resolution.
serialstring
Android, HarmonyOS, or Vega VVD serial selector.
sessionstring
Agent-device session name.
settleboolean
After the action, wait for the UI to go quiet and return the settled diff vs the pre-action tree in the same response. Best-effort; never fails the action.
settleQuietMsinteger
Settle: quiet window in milliseconds (default 500).
targetobjectобязательный
UI target. This is separate from deviceTarget, which selects the device form.
tenantstring
Remote tenant identifier.
timeoutMsinteger
Settle: wait deadline in milliseconds (default 10000).
udidstring
Apple device or simulator UDID; the selector that pins one device when several share a name.
verifyboolean
Capture cheap post-action evidence (AX digest, node counts, changedFromBefore) instead of a follow-up snapshot.

push

Deliver push notification payloads to an installed app. Times out after 90s.

Параметры

androidDeviceAllowliststring
Android serial allowlist used for device resolution.
appstringобязательный
debugboolean
Enable debug diagnostics.
devicestring
Device name selector (a UDID belongs in udid, a serial in serial).
deviceTargetenum
Device target form. Maps to the CLI --target flag.
includeCostboolean
Include per-command agent-cost (cost.wallClockMs, …) in structuredContent. Defaults to off; the default response shape is unchanged.
leaseIdstring
Existing lease identifier.
mcpOutputFormatenum
MCP text content format. Defaults to optimized agent-friendly text; use json for JSON text. Structured content is always returned separately.
noRecordboolean
Do not record this action.
payloadstring | objectобязательный
platformenum
Platform selector used to resolve a device.
responseLevelenum
Response verbosity: token-cheap digest / default (today) / full. Defaults to default; the default response shape is unchanged.
runIdstring
Lease run identifier.
serialstring
Android, HarmonyOS, or Vega VVD serial selector.
sessionstring
Agent-device session name.
targetenum
Alias for deviceTarget on commands without a UI target field. Interaction commands reserve target for the UI element.
tenantstring
Remote tenant identifier.
udidstring
Apple device or simulator UDID; the selector that pins one device when several share a name.

react-native

Run supported React Native automation helpers. Use dismiss-overlay to close a visible development error overlay before continuing normal UI automation. Times out after 90s.

Параметры

actionenumобязательный
androidDeviceAllowliststring
Android serial allowlist used for device resolution.
debugboolean
Enable debug diagnostics.
devicestring
Device name selector (a UDID belongs in udid, a serial in serial).
deviceTargetenum
Device target form. Maps to the CLI --target flag.
includeCostboolean
Include per-command agent-cost (cost.wallClockMs, …) in structuredContent. Defaults to off; the default response shape is unchanged.
leaseIdstring
Existing lease identifier.
mcpOutputFormatenum
MCP text content format. Defaults to optimized agent-friendly text; use json for JSON text. Structured content is always returned separately.
noRecordboolean
Do not record this action.
platformenum
Platform selector used to resolve a device.
responseLevelenum
Response verbosity: token-cheap digest / default (today) / full. Defaults to default; the default response shape is unchanged.
runIdstring
Lease run identifier.
serialstring
Android, HarmonyOS, or Vega VVD serial selector.
sessionstring
Agent-device session name.
targetenum
Alias for deviceTarget on commands without a UI target field. Interaction commands reserve target for the UI element.
tenantstring
Remote tenant identifier.
udidstring
Apple device or simulator UDID; the selector that pins one device when several share a name.

record

Start or stop a screen recording for the active app session or, where supported, the selected device. Long Android recordings can return multiple video artifacts; HarmonyOS supports whole-screen recording on physical devices. Times out after 90s.

Параметры

actionenumобязательный
androidDeviceAllowliststring
Android serial allowlist used for device resolution.
debugboolean
Enable debug diagnostics.
devicestring
Device name selector (a UDID belongs in udid, a serial in serial).
deviceTargetenum
Device target form. Maps to the CLI --target flag.
fpsinteger
hideTouchesboolean
includeCostboolean
Include per-command agent-cost (cost.wallClockMs, …) in structuredContent. Defaults to off; the default response shape is unchanged.
leaseIdstring
Existing lease identifier.
mcpOutputFormatenum
MCP text content format. Defaults to optimized agent-friendly text; use json for JSON text. Structured content is always returned separately.
noRecordboolean
Do not record this action.
pathstring
platformenum
Platform selector used to resolve a device.
qualityenum
recordingScopeenum
responseLevelenum
Response verbosity: token-cheap digest / default (today) / full. Defaults to default; the default response shape is unchanged.
runIdstring
Lease run identifier.
serialstring
Android, HarmonyOS, or Vega VVD serial selector.
sessionstring
Agent-device session name.
targetenum
Alias for deviceTarget on commands without a UI target field. Interaction commands reserve target for the UI element.
tenantstring
Remote tenant identifier.
udidstring
Apple device or simulator UDID; the selector that pins one device when several share a name.

reinstall

Replace an installed app with a binary from a local path. Use this when preserving the same app identity while installing a new build on the selected device. Times out after 180s.

Параметры

androidDeviceAllowliststring
Android serial allowlist used for device resolution.
appstringобязательный
appPathstringобязательный
Path to app binary.
debugboolean
Enable debug diagnostics.
devicestring
Device name selector (a UDID belongs in udid, a serial in serial).
deviceTargetenum
Device target form. Maps to the CLI --target flag.
includeCostboolean
Include per-command agent-cost (cost.wallClockMs, …) in structuredContent. Defaults to off; the default response shape is unchanged.
leaseIdstring
Existing lease identifier.
mcpOutputFormatenum
MCP text content format. Defaults to optimized agent-friendly text; use json for JSON text. Structured content is always returned separately.
noRecordboolean
Do not record this action.
platformenum
Platform selector used to resolve a device.
responseLevelenum
Response verbosity: token-cheap digest / default (today) / full. Defaults to default; the default response shape is unchanged.
runIdstring
Lease run identifier.
serialstring
Android, HarmonyOS, or Vega VVD serial selector.
sessionstring
Agent-device session name.
targetenum
Alias for deviceTarget on commands without a UI target field. Interaction commands reserve target for the UI element.
tenantstring
Remote tenant identifier.
udidstring
Apple device or simulator UDID; the selector that pins one device when several share a name.

replay

Run a recorded automation script, including compatible Maestro YAML flows. A script without a terminal close leaves its session active for subsequent automation. Times out after 90s; a caller-supplied budget extends it.

Параметры

androidDeviceAllowliststring
Android serial allowlist used for device resolution.
backendstring
bundleUrlstring
Bundle URL hint inherited by replay-opened sessions.
debugboolean
Enable debug diagnostics.
devicestring
Device name selector (a UDID belongs in udid, a serial in serial).
deviceTargetenum
Device target form. Maps to the CLI --target flag.
envstring[]
forceboolean
includeCostboolean
Include per-command agent-cost (cost.wallClockMs, …) in structuredContent. Defaults to off; the default response shape is unchanged.
keepSessionboolean
Leave the session active by suppressing exactly an authored terminal close in native .ad.
leaseIdstring
Existing lease identifier.
maestroboolean
mcpOutputFormatenum
MCP text content format. Defaults to optimized agent-friendly text; use json for JSON text. Structured content is always returned separately.
metroHoststring
Metro/debug host hint inherited by replay-opened sessions.
metroPortinteger
Metro/debug port hint inherited by replay-opened sessions.
pathstringобязательный
platformenum
Platform selector used to resolve a device.
responseLevelenum
Response verbosity: token-cheap digest / default (today) / full. Defaults to default; the default response shape is unchanged.
resumeFrominteger
resumePlanDigeststring
runIdstring
Lease run identifier.
saveScriptboolean | string
serialstring
Android, HarmonyOS, or Vega VVD serial selector.
sessionstring
Agent-device session name.
targetenum
Alias for deviceTarget on commands without a UI target field. Interaction commands reserve target for the UI element.
tenantstring
Remote tenant identifier.
timeoutMsinteger
Maximum wall-clock duration for the replay request.
udidstring
Apple device or simulator UDID; the selector that pins one device when several share a name.
updateboolean

screenshot

Capture a screenshot of the active app or web session. Choose the capture scope, density, size, or annotations through the corresponding input fields when needed. Times out after 90s.

Параметры

androidDeviceAllowliststring
Android serial allowlist used for device resolution.
cropOnstring
Selector expression; the capture is cropped to the frame the selector resolves on the same screen.
debugboolean
Enable debug diagnostics.
devicestring
Device name selector (a UDID belongs in udid, a serial in serial).
deviceTargetenum
Device target form. Maps to the CLI --target flag.
fullscreenboolean
includeCostboolean
Include per-command agent-cost (cost.wallClockMs, …) in structuredContent. Defaults to off; the default response shape is unchanged.
leaseIdstring
Existing lease identifier.
mcpOutputFormatenum
MCP text content format. Defaults to optimized agent-friendly text; use json for JSON text. Structured content is always returned separately.
noRecordboolean
Do not record this action.
normalizeStatusBarboolean
overlayRefsboolean
pathstring
Output path.
pixelDensityinteger
Output screenshot pixel density in pixels per logical point.
platformenum
Platform selector used to resolve a device.
responseLevelenum
Response verbosity: token-cheap digest / default (today) / full. Defaults to default; the default response shape is unchanged.
runIdstring
Lease run identifier.
scalenumber
Screenshot scale factor.
serialstring
Android, HarmonyOS, or Vega VVD serial selector.
sessionstring
Agent-device session name.
stabilizeboolean
surfaceenum
targetenum
Alias for deviceTarget on commands without a UI target field. Interaction commands reserve target for the UI element.
tenantstring
Remote tenant identifier.
udidstring
Apple device or simulator UDID; the selector that pins one device when several share a name.

scroll

Scroll in a direction, or toward the top/bottom edge of scrollable content. The optional amount is the finger-path fraction of the viewport axis; the gesture releases with reduced momentum rather than stopping at an exact offset, so app scroll physics determine where content actually lands. Times out after 90s; a caller-supplied budget extends it.

Параметры

amountnumber
Platform scroll amount.
androidDeviceAllowliststring
Android serial allowlist used for device resolution.
debugboolean
Enable debug diagnostics.
devicestring
Device name selector (a UDID belongs in udid, a serial in serial).
deviceTargetenum
Device target form. Maps to the CLI --target flag.
directionenumобязательный
durationMsinteger
Scroll duration in milliseconds when the backend supports pacing.
includeCostboolean
Include per-command agent-cost (cost.wallClockMs, …) in structuredContent. Defaults to off; the default response shape is unchanged.
leaseIdstring
Existing lease identifier.
mcpOutputFormatenum
MCP text content format. Defaults to optimized agent-friendly text; use json for JSON text. Structured content is always returned separately.
noRecordboolean
Do not record this action.
pixelsinteger
Pixel scroll amount.
platformenum
Platform selector used to resolve a device.
responseLevelenum
Response verbosity: token-cheap digest / default (today) / full. Defaults to default; the default response shape is unchanged.
runIdstring
Lease run identifier.
serialstring
Android, HarmonyOS, or Vega VVD serial selector.
sessionstring
Agent-device session name.
settleboolean
After the action, wait for the UI to go quiet and return the settled diff vs the pre-action tree in the same response. Best-effort; never fails the action.
settleQuietMsinteger
Settle: quiet window in milliseconds (default 500).
targetenum
Alias for deviceTarget on commands without a UI target field. Interaction commands reserve target for the UI element.
tenantstring
Remote tenant identifier.
timeoutMsinteger
Settle: wait deadline in milliseconds (default 10000).
udidstring
Apple device or simulator UDID; the selector that pins one device when several share a name.

session

List active sessions, print the effective daemon state directory, or publish an armed open-to-destination script without closing its session Times out after 90s.

Параметры

actionenum
list shows active sessions; state-dir prints the daemon state directory; save-script publishes an armed recording without teardown.
androidDeviceAllowliststring
Android serial allowlist used for device resolution.
debugboolean
Enable debug diagnostics.
devicestring
Device name selector (a UDID belongs in udid, a serial in serial).
deviceTargetenum
Device target form. Maps to the CLI --target flag.
forceboolean
Atomically replace an existing save-script target.
includeCostboolean
Include per-command agent-cost (cost.wallClockMs, …) in structuredContent. Defaults to off; the default response shape is unchanged.
leaseIdstring
Existing lease identifier.
mcpOutputFormatenum
MCP text content format. Defaults to optimized agent-friendly text; use json for JSON text. Structured content is always returned separately.
pathstring
Optional .ad output path for save-script.
platformenum
Platform selector used to resolve a device.
responseLevelenum
Response verbosity: token-cheap digest / default (today) / full. Defaults to default; the default response shape is unchanged.
runIdstring
Lease run identifier.
serialstring
Android, HarmonyOS, or Vega VVD serial selector.
sessionstring
Agent-device session name.
targetenum
Alias for deviceTarget on commands without a UI target field. Interaction commands reserve target for the UI element.
tenantstring
Remote tenant identifier.
udidstring
Apple device or simulator UDID; the selector that pins one device when several share a name.

settings

Change supported operating-system settings, animation scales, appearance, or app permissions on the selected target. Platform support varies by setting and action. Times out after 90s.

Параметры

androidDeviceAllowliststring
Android serial allowlist used for device resolution.
appstring
debugboolean
Enable debug diagnostics.
devicestring
Device name selector (a UDID belongs in udid, a serial in serial).
deviceTargetenum
Device target form. Maps to the CLI --target flag.
includeCostboolean
Include per-command agent-cost (cost.wallClockMs, …) in structuredContent. Defaults to off; the default response shape is unchanged.
latitudenumber
leaseIdstring
Existing lease identifier.
longitudenumber
mcpOutputFormatenum
MCP text content format. Defaults to optimized agent-friendly text; use json for JSON text. Structured content is always returned separately.
modeenum
noRecordboolean
Do not record this action.
permissionstring
platformenum
Platform selector used to resolve a device.
responseLevelenum
Response verbosity: token-cheap digest / default (today) / full. Defaults to default; the default response shape is unchanged.
runIdstring
Lease run identifier.
serialstring
Android, HarmonyOS, or Vega VVD serial selector.
sessionstring
Agent-device session name.
settingstringобязательный
statestringобязательный
targetenum
Alias for deviceTarget on commands without a UI target field. Interaction commands reserve target for the UI element.
tenantstring
Remote tenant identifier.
udidstring
Apple device or simulator UDID; the selector that pins one device when several share a name.

shutdown

Shutdown a selected simulator or emulator. Times out after 90s.

Параметры

androidDeviceAllowliststring
Android serial allowlist used for device resolution.
debugboolean
Enable debug diagnostics.
devicestring
Device name selector (a UDID belongs in udid, a serial in serial).
deviceTargetenum
Device target form. Maps to the CLI --target flag.
includeCostboolean
Include per-command agent-cost (cost.wallClockMs, …) in structuredContent. Defaults to off; the default response shape is unchanged.
leaseIdstring
Existing lease identifier.
mcpOutputFormatenum
MCP text content format. Defaults to optimized agent-friendly text; use json for JSON text. Structured content is always returned separately.
platformenum
Platform selector used to resolve a device.
responseLevelenum
Response verbosity: token-cheap digest / default (today) / full. Defaults to default; the default response shape is unchanged.
runIdstring
Lease run identifier.
serialstring
Android, HarmonyOS, or Vega VVD serial selector.
sessionstring
Agent-device session name.
targetenum
Alias for deviceTarget on commands without a UI target field. Interaction commands reserve target for the UI element.
tenantstring
Remote tenant identifier.
udidstring
Apple device or simulator UDID; the selector that pins one device when several share a name.

snapshot

Capture the accessibility tree or compare it with the previous session baseline. Use the returned refs for subsequent semantic interactions and the diff option to verify UI changes. Times out after 90s; a caller-supplied budget extends it.

Параметры

androidDeviceAllowliststring
Android serial allowlist used for device resolution.
customActionsboolean
Name the affordances an element merged away (iOS UIAccessibilityCustomAction, React Native accessibilityActions) — a card whose reply/options controls are not separate elements still lists them here. The names are for PLANNING, not invocation: there is no API to trigger them, so reach the affordance through the element detail screen, through the same control exposed as a labeled element elsewhere, or by coordinates from its rect. iOS simulator only; costs one accessibility round trip per merged element.
debugboolean
Enable debug diagnostics.
depthinteger
devicestring
Device name selector (a UDID belongs in udid, a serial in serial).
deviceTargetenum
Device target form. Maps to the CLI --target flag.
forceFullboolean
includeCostboolean
Include per-command agent-cost (cost.wallClockMs, …) in structuredContent. Defaults to off; the default response shape is unchanged.
interactiveOnlyboolean
leaseIdstring
Existing lease identifier.
mcpOutputFormatenum
MCP text content format. Defaults to optimized agent-friendly text; use json for JSON text. Structured content is always returned separately.
noRecordboolean
Do not record this action.
platformenum
Platform selector used to resolve a device.
rawboolean
recordboolean
Force-record this out-of-band observation into a repair-armed heal (mutually exclusive with noRecord). Authored replay steps are recorded automatically and never need this.
responseLevelenum
Response verbosity: token-cheap digest / default (today) / full. Defaults to default; the default response shape is unchanged.
runIdstring
Lease run identifier.
scopestring
serialstring
Android, HarmonyOS, or Vega VVD serial selector.
sessionstring
Agent-device session name.
targetenum
Alias for deviceTarget on commands without a UI target field. Interaction commands reserve target for the UI element.
tenantstring
Remote tenant identifier.
timeoutMsinteger
Maximum wall-clock time for the snapshot command.
udidstring
Apple device or simulator UDID; the selector that pins one device when several share a name.

swipe

Quick coordinate fling with optional repeat pattern. Times out after 90s.

Параметры

androidDeviceAllowliststring
Android serial allowlist used for device resolution.
countinteger
Number of swipe repetitions.
debugboolean
Enable debug diagnostics.
devicestring
Device name selector (a UDID belongs in udid, a serial in serial).
deviceTargetenum
Device target form. Maps to the CLI --target flag.
fromobjectобязательный
Swipe start point.
includeCostboolean
Include per-command agent-cost (cost.wallClockMs, …) in structuredContent. Defaults to off; the default response shape is unchanged.
leaseIdstring
Existing lease identifier.
mcpOutputFormatenum
MCP text content format. Defaults to optimized agent-friendly text; use json for JSON text. Structured content is always returned separately.
noRecordboolean
Do not record this action.
patternenum
pauseMsinteger
Pause between repeated swipes.
platformenum
Platform selector used to resolve a device.
responseLevelenum
Response verbosity: token-cheap digest / default (today) / full. Defaults to default; the default response shape is unchanged.
runIdstring
Lease run identifier.
serialstring
Android, HarmonyOS, or Vega VVD serial selector.
sessionstring
Agent-device session name.
targetenum
Alias for deviceTarget on commands without a UI target field. Interaction commands reserve target for the UI element.
tenantstring
Remote tenant identifier.
toobjectобязательный
Swipe end point.
udidstring
Apple device or simulator UDID; the selector that pins one device when several share a name.

test

Run one or more replay scripts as a serial test suite Streams progress; no fixed client timeout.

Параметры

androidDeviceAllowliststring
Android serial allowlist used for device resolution.
artifactsDirstring
backendstring
bundleUrlstring
Bundle URL hint inherited by each test session.
debugboolean
Enable debug diagnostics.
devicestring
Device name selector (a UDID belongs in udid, a serial in serial).
deviceTargetenum
Device target form. Maps to the CLI --target flag.
envstring[]
failFastboolean
includeCostboolean
Include per-command agent-cost (cost.wallClockMs, …) in structuredContent. Defaults to off; the default response shape is unchanged.
leaseIdstring
Existing lease identifier.
maestroboolean
mcpOutputFormatenum
MCP text content format. Defaults to optimized agent-friendly text; use json for JSON text. Structured content is always returned separately.
metroHoststring
Metro/debug host hint inherited by each test session.
metroPortinteger
Metro/debug port hint inherited by each test session.
pathsstring[]обязательный
platformenum
Platform selector used to resolve a device.
recordVideoboolean
responseLevelenum
Response verbosity: token-cheap digest / default (today) / full. Defaults to default; the default response shape is unchanged.
retriesinteger
runIdstring
Lease run identifier.
serialstring
Android, HarmonyOS, or Vega VVD serial selector.
sessionstring
Agent-device session name.
shardAllinteger
shardSplitinteger
targetenum
Alias for deviceTarget on commands without a UI target field. Interaction commands reserve target for the UI element.
tenantstring
Remote tenant identifier.
timeoutMsinteger
udidstring
Apple device or simulator UDID; the selector that pins one device when several share a name.
updateboolean

trace

Start or stop trace-log capture and return the resulting artifact when capture ends. Use the same artifact path for the matching start and stop requests when an explicit path is required. Times out after 90s.

Параметры

actionenumобязательный
androidDeviceAllowliststring
Android serial allowlist used for device resolution.
debugboolean
Enable debug diagnostics.
devicestring
Device name selector (a UDID belongs in udid, a serial in serial).
deviceTargetenum
Device target form. Maps to the CLI --target flag.
includeCostboolean
Include per-command agent-cost (cost.wallClockMs, …) in structuredContent. Defaults to off; the default response shape is unchanged.
leaseIdstring
Existing lease identifier.
mcpOutputFormatenum
MCP text content format. Defaults to optimized agent-friendly text; use json for JSON text. Structured content is always returned separately.
noRecordboolean
Do not record this action.
pathstring
platformenum
Platform selector used to resolve a device.
responseLevelenum
Response verbosity: token-cheap digest / default (today) / full. Defaults to default; the default response shape is unchanged.
runIdstring
Lease run identifier.
serialstring
Android, HarmonyOS, or Vega VVD serial selector.
sessionstring
Agent-device session name.
targetenum
Alias for deviceTarget on commands without a UI target field. Interaction commands reserve target for the UI element.
tenantstring
Remote tenant identifier.
udidstring
Apple device or simulator UDID; the selector that pins one device when several share a name.

trigger-app-event

Ask the app to handle an app-defined automation or test event, with an optional structured payload. Call this only for event names and payload shapes the app documents. Times out after 90s.

Параметры

androidDeviceAllowliststring
Android serial allowlist used for device resolution.
debugboolean
Enable debug diagnostics.
devicestring
Device name selector (a UDID belongs in udid, a serial in serial).
deviceTargetenum
Device target form. Maps to the CLI --target flag.
eventstringобязательный
Name of an app-defined automation or test event the app documents.
includeCostboolean
Include per-command agent-cost (cost.wallClockMs, …) in structuredContent. Defaults to off; the default response shape is unchanged.
leaseIdstring
Existing lease identifier.
mcpOutputFormatenum
MCP text content format. Defaults to optimized agent-friendly text; use json for JSON text. Structured content is always returned separately.
noRecordboolean
Do not record this action.
payloadobject
Structured payload passed to the event, in the shape the app documents for it.
platformenum
Platform selector used to resolve a device.
responseLevelenum
Response verbosity: token-cheap digest / default (today) / full. Defaults to default; the default response shape is unchanged.
runIdstring
Lease run identifier.
serialstring
Android, HarmonyOS, or Vega VVD serial selector.
sessionstring
Agent-device session name.
targetenum
Alias for deviceTarget on commands without a UI target field. Interaction commands reserve target for the UI element.
tenantstring
Remote tenant identifier.
udidstring
Apple device or simulator UDID; the selector that pins one device when several share a name.

tv-remote

Press or long-press a TV remote or D-pad button on Android TV, tvOS, or Vega OS. Choose the button and optional hold duration through the input fields. The aliases ok, center, and enter all map to select. Times out after 90s.

Параметры

androidDeviceAllowliststring
Android serial allowlist used for device resolution.
buttonenumобязательный
debugboolean
Enable debug diagnostics.
devicestring
Device name selector (a UDID belongs in udid, a serial in serial).
deviceTargetenum
Device target form. Maps to the CLI --target flag.
durationMsinteger
Press duration in milliseconds. tvOS and Vega OS use the exact hold duration; Android TV maps any positive value to an ADB longpress (longpress).
includeCostboolean
Include per-command agent-cost (cost.wallClockMs, …) in structuredContent. Defaults to off; the default response shape is unchanged.
leaseIdstring
Existing lease identifier.
mcpOutputFormatenum
MCP text content format. Defaults to optimized agent-friendly text; use json for JSON text. Structured content is always returned separately.
noRecordboolean
Do not record this action.
platformenum
Platform selector used to resolve a device.
responseLevelenum
Response verbosity: token-cheap digest / default (today) / full. Defaults to default; the default response shape is unchanged.
runIdstring
Lease run identifier.
serialstring
Android, HarmonyOS, or Vega VVD serial selector.
sessionstring
Agent-device session name.
targetenum
Alias for deviceTarget on commands without a UI target field. Interaction commands reserve target for the UI element.
tenantstring
Remote tenant identifier.
udidstring
Apple device or simulator UDID; the selector that pins one device when several share a name.

type

Append text to the currently focused input. Use fill when the existing field value should be replaced, and focus first when no input is active. Times out after 90s.

Параметры

androidDeviceAllowliststring
Android serial allowlist used for device resolution.
debugboolean
Enable debug diagnostics.
delayMsinteger
Delay between typed characters.
devicestring
Device name selector (a UDID belongs in udid, a serial in serial).
deviceTargetenum
Device target form. Maps to the CLI --target flag.
includeCostboolean
Include per-command agent-cost (cost.wallClockMs, …) in structuredContent. Defaults to off; the default response shape is unchanged.
leaseIdstring
Existing lease identifier.
mcpOutputFormatenum
MCP text content format. Defaults to optimized agent-friendly text; use json for JSON text. Structured content is always returned separately.
noRecordboolean
Do not record this action.
platformenum
Platform selector used to resolve a device.
responseLevelenum
Response verbosity: token-cheap digest / default (today) / full. Defaults to default; the default response shape is unchanged.
runIdstring
Lease run identifier.
serialstring
Android, HarmonyOS, or Vega VVD serial selector.
sessionstring
Agent-device session name.
targetenum
Alias for deviceTarget on commands without a UI target field. Interaction commands reserve target for the UI element.
tenantstring
Remote tenant identifier.
textstringобязательный
Text to type.
udidstring
Apple device or simulator UDID; the selector that pins one device when several share a name.

viewport

Resize the active web viewport before taking snapshots or screenshots. Useful for fixed-layout or 100vh apps where changing the viewport reveals different content. Times out after 90s.

Параметры

androidDeviceAllowliststring
Android serial allowlist used for device resolution.
debugboolean
Enable debug diagnostics.
devicestring
Device name selector (a UDID belongs in udid, a serial in serial).
deviceTargetenum
Device target form. Maps to the CLI --target flag.
heightintegerобязательный
Viewport height in CSS pixels.
includeCostboolean
Include per-command agent-cost (cost.wallClockMs, …) in structuredContent. Defaults to off; the default response shape is unchanged.
leaseIdstring
Existing lease identifier.
mcpOutputFormatenum
MCP text content format. Defaults to optimized agent-friendly text; use json for JSON text. Structured content is always returned separately.
noRecordboolean
Do not record this action.
platformenum
Platform selector used to resolve a device.
responseLevelenum
Response verbosity: token-cheap digest / default (today) / full. Defaults to default; the default response shape is unchanged.
runIdstring
Lease run identifier.
serialstring
Android, HarmonyOS, or Vega VVD serial selector.
sessionstring
Agent-device session name.
targetenum
Alias for deviceTarget on commands without a UI target field. Interaction commands reserve target for the UI element.
tenantstring
Remote tenant identifier.
udidstring
Apple device or simulator UDID; the selector that pins one device when several share a name.
widthintegerобязательный
Viewport width in CSS pixels.

wait

Wait for a duration, text, snapshot ref, selector to appear, selector to be strictly absent, or stable UI. Use the strict absence target when zero selector matches are required; stable waits until the UI stays quiet for the requested window. Times out after 90s; a caller-supplied budget extends it.

Параметры

absentstring
androidDeviceAllowliststring
Android serial allowlist used for device resolution.
debugboolean
Enable debug diagnostics.
depthinteger
devicestring
Device name selector (a UDID belongs in udid, a serial in serial).
deviceTargetenum
Device target form. Maps to the CLI --target flag.
durationMsinteger
includeCostboolean
Include per-command agent-cost (cost.wallClockMs, …) in structuredContent. Defaults to off; the default response shape is unchanged.
kindenum
leaseIdstring
Existing lease identifier.
mcpOutputFormatenum
MCP text content format. Defaults to optimized agent-friendly text; use json for JSON text. Structured content is always returned separately.
noRecordboolean
Do not record this action.
platformenum
Platform selector used to resolve a device.
quietMsinteger
rawboolean
refstring
responseLevelenum
Response verbosity: token-cheap digest / default (today) / full. Defaults to default; the default response shape is unchanged.
runIdstring
Lease run identifier.
scopestring
selectorstring
serialstring
Android, HarmonyOS, or Vega VVD serial selector.
sessionstring
Agent-device session name.
stableboolean
targetenum
Alias for deviceTarget on commands without a UI target field. Interaction commands reserve target for the UI element.
tenantstring
Remote tenant identifier.
textstring
timeoutMsinteger
udidstring
Apple device or simulator UDID; the selector that pins one device when several share a name.

Github Сайт сервера

Конфиг для установки сервера

{
  "command": "npx",
  "args": [
    "agent-device@latest",
    "mcp"
  ]
}

Нужен npx

Сервер запускается через npx
Без него ничего работать не будет.

Как установить npx

FAQ

Для чего этот сервер?

Этот MCP-сервер даёт AI-агентам возможность проверять мобильные и десктопные приложения на реальных устройствах. Он открывает приложения, снимает текущий экран, позволяет нажимать на элементы и собирает доказательства — скриншоты, логи, видео. Всё это нужно, чтобы агент не просто размышлял о коде, а видел, что на самом деле происходит на экране, и мог подтвердить, что фича работает как надо.

Что он умеет?

Сервер управляет симуляторами и физическими устройствами: загружает, выключает, перечисляет, меняет ориентацию, отправляет на домашний экран, переключает приложения. Взаимодействует с UI: снимает снапшоты доступности, кликает, вводит текст, скроллит, выполняет жесты, ищет элементы по тексту, ролям и id, проверяет состояние, обрабатывает алерты, управляет клавиатурой. Работает с приложениями: устанавливает, переустанавливает, открывает по диплинку, шлёт push и события. Собирает доказательства: скриншоты, записи, логи, сетевой трафик, профили производительности, аудио. Диагностирует окружение, воспроизводит сценарии и запускает тесты.

Информация о сервере

Номер в рейтинге: #35
Звезд на Github: 4505
Форков на Github: 290
Загрузок: 2 294 218
Язык реализации: TypeScript
Лицензия: MIT
Официальный сервер: Нет
Дата обновления данных: 10.09 в 23:51
Идентификатор: KijZc3SKP2gUVl2y
Категории: CI/CD и DevOps, Автоматизация приложений, Агенты для программирования, Инструменты для разработчиков, Тестирование и QA