agent-device
Rank #5io.github.callstack/agent-device
MCP server for mobile app automation: verify, control, and debug iOS, Android, TV, and desktop apps
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.
- 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
What agent-device can and cannot do
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.
- 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
What you need before using agent-device
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
Connect agent-device and confirm it works
- npm install -g agent-device@latest
- Run agent-device doctor to verify the setup
- Add an mcpServers entry with command agent-device and args ["mcp"]
- Check a target's support with agent-device capabilities --platform <platform>
claude mcp add agent-device -- npx -y agent-device mcp[mcp_servers.agent-device]
command = "npx"
args = ["-y", "agent-device", "mcp"]Add to ~/.codex/config.toml.
{
"mcpServers": {
"agent-device": {
"command": "npx",
"args": [
"-y",
"agent-device",
"mcp"
]
}
}
}Add to claude_desktop_config.json (Settings → Developer → Edit Config).
{
"mcpServers": {
"agent-device": {
"command": "npx",
"args": [
"-y",
"agent-device",
"mcp"
]
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project).
{
"servers": {
"agent-device": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"agent-device",
"mcp"
]
}
}
}Save as .vscode/mcp.json in your workspace.
{
"mcpServers": {
"agent-device": {
"command": "npx",
"args": [
"-y",
"agent-device",
"mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
{
"mcpServers": {
"agent-device": {
"command": "npx",
"args": [
"-y",
"agent-device",
"mcp"
]
}
}
}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.
When to choose another server
- Mobile MCP#28
You want a pure MCP server with coordinate taps and cloud devices, without a CLI.
- Maestro#180
You already maintain Maestro flows and want the agent to drive them.
- MCP Appium - Mobile Development and Automation Server#5,018
Your team's mobile automation is standardised on Appium.
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
- Official MCP ↗listed since May 11, 2026 · still listed
- PulseMCP ↗listed since Jun 4, 2026 · still listed
- Glama ↗listed since Jun 4, 2026 · delisted, last seen Jun 9, 2026
- Glama ↗listed since Jun 10, 2026 · still listed
- Official MCP ↗listed since Aug 7, 2026 · still listed
- mcp.so ↗listed since Aug 25, 2026 · still listed
Do you maintain agent-device? to correct or enrich this profile.
Available versions (37)
| Version | Published |
|---|---|
| 0.21.28 | Oct 15, 2026 |
| 0.21.27 | Oct 12, 2026 |
| 0.21.26 | Oct 12, 2026 |
| 0.21.25 | Oct 11, 2026 |
| 0.21.24 | Oct 9, 2026 |
| 0.21.23 | Oct 9, 2026 |
| 0.21.22 | Oct 6, 2026 |
| 0.21.21 | Oct 6, 2026 |
| 0.21.19 | Oct 6, 2026 |
| 0.21.20 | Oct 6, 2026 |
| 0.21.18 | Sep 30, 2026 |
| 0.21.16 | Sep 30, 2026 |
| 0.21.17 | Sep 30, 2026 |
| 0.21.15 | Sep 25, 2026 |
| 0.21.14 | Sep 25, 2026 |
| 0.21.12 | Sep 22, 2026 |
| 0.21.10 | Sep 22, 2026 |
| 0.21.9 | Sep 22, 2026 |
| 0.21.8 | Sep 21, 2026 |
| 0.21.7 | Sep 21, 2026 |
| 0.21.6 | Sep 21, 2026 |
| 0.21.5 | Sep 21, 2026 |
| 0.21.4 | Sep 16, 2026 |
| 0.21.3 | Sep 16, 2026 |
| 0.21.2 | Sep 14, 2026 |
| 0.21.1 | Sep 14, 2026 |
| 0.21.0 | Sep 8, 2026 |
| 0.20.10 | Aug 24, 2026 |
| 0.20.9 | Aug 17, 2026 |
| 0.20.7 | Aug 10, 2026 |
| 0.20.6 | Aug 7, 2026 |
| 0.16.9 | Jun 1, 2026 |
| 0.16.8 | Jun 1, 2026 |
| 0.16.7 | Jun 1, 2026 |
| 0.16.6 | Jun 1, 2026 |
| 0.16.5 | May 30, 2026 |
| 0.14.8 | May 11, 2026 |
Ranks ahead of 144,391 of 144,396 servers on MCP Toplist.
Show your rank
Maintain this server? Add the live rank badge to your README — it updates automatically as the leaderboard changes.
[](https://mcptoplist.com/server/io.github.callstack%2Fagent-device)<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.
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.
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.