Agent Device
Discovery router for the agent-device CLI with status, install, help, prompts, and resources.
What is Agent Device?
Agent Device is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to discovery router for the agent-device cli with status, install, help, prompts, and resources.
Discovery router for the agent-device CLI with status, install, help, prompts, and resources.
This server falls under the Browser Automation category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Discovery router for the agent-device CLI with status, insta
Use Cases
Maintainer
Works with
Installation
NPM
npx -y agent-deviceManual Installation
npx -y agent-deviceConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Agent Device
Agent Device is a CLI and MCP server from Callstack that gives AI agents full control over iOS Simulators, Android Emulators, physical mobile devices, and desktop apps for end-to-end testing and agentic automation. It exposes structured accessibility snapshots, interactive element references, tap/type/scroll gestures, screenshot and video capture, network traffic recording, and script replay — enabling AI agents in Claude Code, Cursor, Codex, or Windsurf to drive real mobile UIs, write E2E tests, and debug React Native apps without manual device interaction.
Prerequisites
- Node.js 22 or higher
- Xcode installed (for iOS Simulator and tvOS/macOS targets)
- Android SDK with ADB configured in PATH (for Android Emulator and physical Android devices)
- macOS Accessibility permissions granted to your terminal application
- An MCP-compatible AI client such as Claude Code, Cursor, or Windsurf
Install agent-device globally
Install the agent-device CLI globally via npm. This makes both the CLI commands and the MCP server entry point available system-wide.
npm install -g agent-device@latestVerify the installation
Confirm the CLI is installed and check its version to make sure the install succeeded.
agent-device --versionAdd the MCP server to your AI client configuration
Register agent-device as an MCP server in your client's config file. It runs in-process via npx so no separate daemon is needed.
Launch a simulator and open your app
Use the CLI (or ask your AI agent) to list available platforms, start a simulator, and open the target app before beginning any interaction.
agent-device apps --platform ios
agent-device open SampleApp --platform iosTake an accessibility snapshot to inspect the UI
Capture a structured snapshot of the current screen. The snapshot lists all interactive elements with stable @eN reference IDs that the agent can use for subsequent interactions.
agent-device snapshot -iInteract with elements and capture evidence
Use element references from the snapshot to tap, type, scroll, or assert. Capture a screenshot to document the app state.
agent-device fill @e3 "[email protected]"
agent-device screenshot ./artifacts/login.pngAgent Device Examples
Client configuration
Add this block to your claude_desktop_config.json or equivalent MCP client config to register agent-device as an MCP server.
{
"mcpServers": {
"agent-device": {
"command": "npx",
"args": ["-y", "agent-device"]
}
}
}Prompts to try
Once connected, ask your AI agent to drive mobile devices or write automated tests using natural language.
- "Open the iOS Simulator, launch the SampleApp, and take a screenshot of the home screen."
- "Fill in the email field with [email protected] and tap the Login button, then snapshot the result."
- "Record a video of the checkout flow on the Android Emulator."
- "Write an E2E test script for the onboarding flow and export it as Maestro YAML."
- "Capture network traffic while the app loads and list any failed requests."Troubleshooting Agent Device
iOS Simulator commands fail with 'xcode-select: error' or simulator not found
Ensure Xcode is fully installed (not just Command Line Tools) and that `xcode-select -p` points to your Xcode.app/Contents/Developer directory. Run `sudo xcode-select -s /Applications/Xcode.app/Contents/Developer` if needed.
Android ADB commands time out or cannot detect the emulator
Verify that `adb devices` lists your running emulator before invoking agent-device. If ADB is not in PATH, add the Android SDK platform-tools directory to your PATH environment variable.
Accessibility snapshot returns empty or only the root element on macOS
macOS requires Accessibility permissions for the terminal app. Go to System Settings → Privacy & Security → Accessibility and grant access to your terminal (e.g., iTerm2, Terminal).
Frequently Asked Questions about Agent Device
What is Agent Device?
Agent Device is a Model Context Protocol (MCP) server that discovery router for the agent-device cli with status, install, help, prompts, and resources. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Agent Device?
Install via npm with the command: npx -y agent-device. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with Agent Device?
Agent Device works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Agent Device free to use?
Yes, Agent Device is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Agent Device Alternatives — Similar Browser Automation Servers
Looking for alternatives to Agent Device? Here are other popular browser automation servers you can use with Claude, Cursor, and VS Code.
Chrome DevTools MCP
★ 40.6kAI-powered Chrome automation server with natural language element detection. Control Chrome browser through MCP protocol for testing, debugging, and performance analysis. Features 91% accuracy in element location, works with free AI models, and suppo
UI TARS Desktop
★ 34.9k📇 🏠 - Browser automation capabilities using Puppeteer, both support local and remote browser connection.
Playwright
★ 32.8kA production-ready browser automation server that enables AI assistants to interact with web pages using tools for navigation, element interaction, and data extraction. It features a built-in Inspector UI and robust crash recovery for reliable automa
Page Agent
★ 18.0kJavaScript in-page GUI agent. Control web interfaces with natural language.
Chrome
★ 11.7kAn extension-based MCP server that enables AI assistants to control your browser, leveraging existing sessions and login states for automation and content analysis. It provides over 20 tools for semantic tab search, interactive element manipulation,
LAMDA
★ 7.8kThe most powerful Android RPA agent framework, next generation mobile automation.
Browse More Browser Automation MCP Servers
Explore all browser automation servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Agent Device in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Agent Device?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.