SERVER

agent-device

Rank #5

io.github.callstack/agent-device

MCP server for mobile app automation: verify, control, and debug iOS, Android, TV, and desktop apps

37 versions
5,028 GitHub stars
by callstackincubator (1 servers)View repository ↗
First listed
Jan 30, 2026
Last publish date
Oct 15, 2026
PURPOSE

What you can do with agent-device

agent-device gives coding agents a live feedback loop with mobile apps: inspect, control, debug and verify an app on simulators, emulators or devices through a CLI, its built-in MCP server or a typed Node API, saving evidence for review.

Suitable tasks
  • Verify a screen on iOS and Android after a change
  • Reproduce a crash and collect logs and traces
  • Fill forms and tap through flows by accessibility ref
  • Profile React Native re-renders
  • Save repeatable steps as .ad scripts or Maestro YAML
CAPABILITIES AND LIMITATIONS

What agent-device can and cannot do

Capabilities

agent-device mcp exposes the CLI's commands as structured tools: open an app, take an interactive accessibility snapshot with refs, press, fill, scroll and gesture with --settle diffs, capture screenshots, video, logs, network and performance data, and close the session. Targets: iOS, Android and HarmonyOS (simulators, emulators, physical devices), tvOS, Android TV and Vega OS TV, plus basic web, macOS and Linux.

Limitations
  • Support depth varies by target; HarmonyOS and Vega OS cover a subset of commands
  • Refs are only valid in the latest output; after a --settle command use the refs from its diff
  • Snapshots depend on the app's accessibility tree; poor labels force fallback to screenshots and video
  • Not a test-suite framework; it complements Appium, Detox and Maestro rather than replacing them
REQUIREMENTS

What you need before using agent-device

DeclaredNo credentialsNo credentials declared

The registry listing declares no required environment variables or authentication. This is declared metadata, not a verified install — the repository README is the authority.

Declared by Glama, last synced Oct 16, 2026. Not independently verified by MCP Toplist.

Runtime
Node.js 22.12+ (24+ for web automation); install with npm install -g agent-device@latest
Credentials
None
Also needed
Platform tooling for your targets (XCTest for iOS, ADB for Android); run agent-device doctor to check
INSTALLATION AND FIRST TASK

Connect agent-device and confirm it works

  1. npm install -g agent-device@latest
  2. Run agent-device doctor to verify the setup
  3. Add an mcpServers entry with command agent-device and args ["mcp"]
  4. Check a target's support with agent-device capabilities --platform <platform>
npm package
claude mcp add agent-device -- npx -y agent-device mcp
First successful task

Open Contacts on the iOS simulator, take a snapshot, press the Add button, fill First name with "Ada" and screenshot it.

Expected: Each --settle step returns a diff (a new First name field, then its value Ada), and ./contact-form.png shows the new-contact form.

ALTERNATIVES

When to choose another server

MAINTENANCE AND EVIDENCE

What changed, and when this was checked

First listed
Jan 30, 2026
Latest version published
Oct 15, 2026
Version history
37 versions tracked (below)
Requirements evidence
Declared by Glama, last synced Oct 16, 2026. Not independently verified by MCP Toplist.
Profile checked
Oct 9, 2026 against README
Ranking data as of
Oct 16, 2026
Registry sightings

Do you maintain agent-device? to correct or enrich this profile.

VERSIONS

Available versions (37)

0.14.8 · May 11, 20260.16.5 · May 30, 20260.16.6 · Jun 1, 20260.16.7 · Jun 1, 20260.16.8 · Jun 1, 20260.16.9 · Jun 1, 20260.20.6 · Aug 7, 20260.20.7 · Aug 10, 20260.20.9 · Aug 17, 20260.20.10 · Aug 24, 20260.21.0 · Sep 8, 20260.21.1 · Sep 14, 20260.21.2 · Sep 14, 20260.21.3 · Sep 16, 20260.21.4 · Sep 16, 20260.21.5 · Sep 21, 20260.21.6 · Sep 21, 20260.21.7 · Sep 21, 20260.21.8 · Sep 21, 20260.21.9 · Sep 22, 20260.21.10 · Sep 22, 20260.21.12 · Sep 22, 20260.21.14 · Sep 25, 20260.21.15 · Sep 25, 20260.21.17 · Sep 30, 20260.21.16 · Sep 30, 20260.21.18 · Sep 30, 20260.21.20 · Oct 6, 20260.21.19 · Oct 6, 20260.21.21 · Oct 6, 20260.21.22 · Oct 6, 20260.21.23 · Oct 9, 20260.21.24 · Oct 9, 20260.21.25 · Oct 11, 20260.21.26 · Oct 12, 20260.21.27 · Oct 12, 20260.21.28 · Oct 15, 2026May 11, 2026Oct 15, 2026
VersionPublished
0.21.28Oct 15, 2026
0.21.27Oct 12, 2026
0.21.26Oct 12, 2026
0.21.25Oct 11, 2026
0.21.24Oct 9, 2026
0.21.23Oct 9, 2026
0.21.22Oct 6, 2026
0.21.21Oct 6, 2026
0.21.19Oct 6, 2026
0.21.20Oct 6, 2026
0.21.18Sep 30, 2026
0.21.16Sep 30, 2026
0.21.17Sep 30, 2026
0.21.15Sep 25, 2026
0.21.14Sep 25, 2026
0.21.12Sep 22, 2026
0.21.10Sep 22, 2026
0.21.9Sep 22, 2026
0.21.8Sep 21, 2026
0.21.7Sep 21, 2026
0.21.6Sep 21, 2026
0.21.5Sep 21, 2026
0.21.4Sep 16, 2026
0.21.3Sep 16, 2026
0.21.2Sep 14, 2026
0.21.1Sep 14, 2026
0.21.0Sep 8, 2026
0.20.10Aug 24, 2026
0.20.9Aug 17, 2026
0.20.7Aug 10, 2026
0.20.6Aug 7, 2026
0.16.9Jun 1, 2026
0.16.8Jun 1, 2026
0.16.7Jun 1, 2026
0.16.6Jun 1, 2026
0.16.5May 30, 2026
0.14.8May 11, 2026
STANDING
#5of 144,396 active serversTop 0.1%

Ranks ahead of 144,391 of 144,396 servers on MCP Toplist.

Recent momentum
+2,933GitHub stars since May 11 (+140%)
BADGE

Show your rank

Maintain this server? Add the live rank badge to your README — it updates automatically as the leaderboard changes.

MCP Toplist: #5 of 144,396
Markdown
[![MCP Toplist](https://mcptoplist.com/badge/io.github.callstack%2Fagent-device.svg)](https://mcptoplist.com/server/io.github.callstack%2Fagent-device)
HTML
<a href="https://mcptoplist.com/server/io.github.callstack%2Fagent-device"><img src="https://mcptoplist.com/badge/io.github.callstack%2Fagent-device.svg" alt="MCP Toplist: #5 of 144,396" /></a>

Variants: append ?metric=score or ?metric=stars to the image URL.

FAQ

Frequently asked questions

Who maintains agent-device?
agent-device is maintained by callstackincubator, which publishes 1 MCP server (37 total versions) tracked on MCP Toplist.
Is agent-device listed on the Official MCP Registry?
Yes — agent-device is listed on the Official MCP Registry, alongside PulseMCP, Glama and mcp.so.
How many versions does agent-device have?
MCP Toplist tracks 37 versions of agent-device, most recently published on Oct 15, 2026.
Where can I find the source code for agent-device?
The source code for agent-device is hosted at github.com/callstackincubator/agent-device.
Used in projects

Do you run this server?

Community projects list the MCP servers behind real agents and apps. Publish yours and this page will link to it.

EXPLORE