Skip to directory

About agent-device MCP

Callstack agent-device provides local structured app and device automation over a CLI-backed stdio MCP server.

What you can use it for

  • Inspect, control and verify mobile, TV, web, macOS and Linux applications.
  • Capture accessibility snapshots, interact through selectors and save evidence.
Connection and setup
Hosting
local
Transport
stdio
Endpoint
Local process; no hosted endpoint documented
Authentication
Uses configured local device/app access; the MCP server itself has no remote endpoint.

Requirements

  • Install agent-device CLI and its supported target dependencies
  • Run agent-device mcp as stdio server

Setup steps

  1. Install the official CLI with `npm install -g agent-device@latest`, then verify it with `agent-device --version`.
  2. Configure the MCP client to launch the installed binary with command `agent-device` and args [`mcp`].
  3. Reconnect the MCP client and inspect tools/list. The server documentation says tools are structured wrappers over installed CLI commands and the tool inventory may depend on the installed CLI version and platform.
  4. Install only the platform dependencies needed for the intended target, grant required device permissions, and follow the product's target-specific setup guide.
Tools 18+

18 exact MCP-exposed command identifiers extracted from the current maintainer registry and MCP exposure predicate; versions can change this registry, so this is a current-source snapshot, not a cross-version guarantee.

  • appstate

    Read the current application state. Current agent-device MCP source registry.

    01
  • apps

    List available applications. Current agent-device MCP source registry.

    02
  • artifacts

    Inspect or manage captured artifacts. Current agent-device MCP source registry.

    03
  • boot

    Boot or start a target device. Current agent-device MCP source registry.

    04
  • capabilities

    List available device capabilities. Current agent-device MCP source registry.

    05
  • debug

    Run device debugging operations. Current agent-device MCP source registry.

    06
  • devices

    List available target devices. Current agent-device MCP source registry.

    07
  • doctor

    Check agent-device setup and dependencies. Current agent-device MCP source registry.

    08
  • events

    Read device or application events. Current agent-device MCP source registry.

    09
  • hardware-button

    Press a hardware button. Current agent-device MCP source registry.

    10
  • install-from-source

    Install an application from source. Current agent-device MCP source registry.

    11
  • logs

    Read application or device logs. Current agent-device MCP source registry.

    12
  • metro

    Control or inspect Metro. Current agent-device MCP source registry.

    13
  • perf

    Collect performance information. Current agent-device MCP source registry.

    14
  • scroll

    Scroll the current application view. Current agent-device MCP source registry.

    15
  • session

    Inspect or manage a device session. Current agent-device MCP source registry.

    16
  • shutdown

    Shut down a target device. Current agent-device MCP source registry.

    17
  • swipe

    Perform a swipe gesture. Current agent-device MCP source registry.

    18

This server’s available tools can vary by account, permissions, or configuration. The list shown is not its full runtime catalog.

Limitations and notes
  • MCP is a local process and depends on the installed agent-device CLI plus platform-specific device tools and permissions.
  • The publisher recommends a user-selected or project-pinned package for unattended use rather than silently installing a mutable latest version.
  • No MCP initialize, tools/list, or representative tool call was performed for this catalog entry.
Original sources
  • Official Callstack MCP setup guide

    Documents Node/npm installation, `agent-device mcp` stdio startup, client configuration, target-specific prerequisites, and version-matched dynamic tools.

  • Official product website and brand asset

    Official product site identifies the product and links the downloaded SVG icon; it was rendered to PNG, decoded, and visually reviewed on light/dark contact sheets.

  • official documentation

    Maintainer repo documents the official stdio MCP entrypoint agent-device mcp and broad device/app automation commands; its exact structured tools depend on the installed package/version and are not enumerated as a stable list in the setup guide.

Documentation checked 2026-10-28T18:15:00.000Z. Connection has not been runtime tested.

Similar tools