Agent Device MCP Server

Content

Agent Device MCP Server exposes structured MCP tools for Callstack's agent-device CLI. It gives Claude and other agents a device-aware way to open apps, inspect current UI state, interact with visible refs and selectors, verify changes through fresh snapshots, collect debugging evidence, and close sessions.

The project targets iOS, Android, tvOS, Android TV, macOS, Linux desktop, React Native, Expo, Flutter, and native apps. Its docs position the CLI as a live app verification layer for agents, with compact accessibility snapshots, semantic refs, screenshots, recordings, logs, traces, network evidence, performance samples, crash context, React profiles, and replayable .ad scripts.

Source Review

• https://github.com/callstack/agent-device
• https://github.com/callstack/agent-device/blob/main/website/docs/docs/agent-setup.md
• https://registry.npmjs.org/agent-device
• https://github.com/callstack/agent-device/blob/main/README.md
• https://github.com/callstack/agent-device/blob/main/server.json
• https://github.com/callstack/agent-device/blob/main/website/docs/docs/installation.md
• https://github.com/callstack/agent-device/blob/main/website/docs/docs/security-trust.md
• https://github.com/callstack/agent-device/blob/main/package.json
• https://github.com/callstack/agent-device/blob/main/LICENSE

These sources were reviewed on 2026-06-06. Prefer the live repository, agent setup docs, npm registry metadata, README, MCP metadata, installation docs, security guidance, package metadata, and license for current setup commands, supported targets, permissions, and trust guidance.

Features

• Official stdio MCP server through agent-device mcp.
• MCP metadata for the agent-device npm package.
• Claude Code, Cursor, Windsurf, Cline, Goose, Codex, and project-rule setup guidance.
• UI inspection through compact accessibility snapshots, interactive refs, selectors, and React Native component trees.
• App interaction through open, tap, type, scroll, gestures, waits, assertions, alert handling, and session closing.
• Evidence capture with screenshots, video recordings, logs, traces, network traffic, performance samples, crash context, and React profiles.
• Replayable .ad workflow scripts for local runs, CI, and repeatable checks.
• iOS Simulator, Android Emulator, physical device, tvOS, Android TV, macOS, and Linux desktop support.
• Local security guidance for permissions, artifacts, update notices, network captures, and responsible disclosure.

Installation

Install the CLI on the machine where the agent will run:

npm install -g agent-device@latest
agent-device --version
agent-device help workflow

For Claude Code, add the stdio MCP server:

claude mcp add --transport stdio --scope user agent-device -- agent-device mcp

For MCP clients that use JSON configuration:

{
  "mcpServers": {
    "agent-device": {
      "command": "agent-device",
      "args": ["mcp"]
    }
  }
}

Use a project-local install or a human-selected pinned package version for unattended agent workflows. The docs warn against asking agents to choose a version or silently run mutable latest-version npx installs without an explicit trust decision.

Use Cases

• Verify a mobile feature by opening an app, taking a snapshot, acting on refs, and re-checking state.
• Capture screenshots, logs, traces, or network evidence for a regression before proposing a code fix.
• Turn an exploratory interaction into a replayable workflow for later local or CI checks.
• Inspect React Native component trees, props, state, hooks, slow renders, and rerenders when debugging UI behavior.
• Use one agent-facing tool across iOS, Android, TV, desktop, Expo, Flutter, React Native, and native apps.
• Keep device verification close to the coding workflow without exposing a generic shell through MCP.

Safety and Privacy

Agent Device MCP can control real apps and capture rich evidence. Use test devices, simulators, emulators, and test accounts whenever possible. Require review before actions that enter credentials, submit forms, change settings, send messages, install apps, interact with production data, or automate personal devices.

Treat artifacts as sensitive. Screenshots, recordings, logs, traces, network dumps, reports, replay files, app state, and React profiles can include tokens, credentials, private UI, customer data, API payloads, or unreleased product details. Store artifacts in controlled directories, sanitize before sharing, and avoid committing them unless they are intentional test fixtures.

Duplicate Check

The catalog already has mobile-next/mobile-mcp, which focuses on Mobile MCP for iOS and Android automation. Agent Device is a separate Callstack package with its own npm package, MCP metadata, agent setup docs, security guidance, multi-target app verification workflow, evidence capture, replay, debugging, profiling, and desktop/TV support. No callstack/agent-device, agent-device MCP, or matching source URL entry was found in content/mcp, content/tools, content/guides, content/agents, or content/skills.