Skip to main content
Glama
anthonysbr

mobile-agent-mcp

by anthonysbr
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript

mobile-agent-mcp

MCP + CLI for iOS sims, Android emulators, and USB devices. Maestro runs flows; this handles config, doctor, logs, screenshots, RN diagnosis, and Expo/Android host plumbing.

Quick start

npm install -D mobile-agent-mcp
mobile-agent doctor
mobile-agent run-with-context smoke-login ios --json

Requires Node 20+, Maestro, Xcode (iOS), adb (Android).

Related MCP server: local-expo-mcp

Config

mobile-agent.config.json in repo root. See mobile-agent.config.example.json, examples/expo.config.json, examples/bare-rn.config.json.

Set MOBILE_AGENT_PROJECT_ROOT if MCP starts from the wrong cwd.

MCP tools

Tool

Purpose

doctor

Preflight checks

run_flow_with_context

Flow + logs + screenshot + diagnosis

run_maestro_flow / run_smoke_flows

Flow execution

screenshot

PNG + inline image

collect_logs / tail_logs

Metro, logcat, sim logs

metro_status / reload_app / boot_simulator

Dev lifecycle

validate_flow / write_flow

Flow authoring

adb_reverse / open_url / open_dev_url

RN/Expo plumbing

Resource: mobile-agent://screenshot/latest

Responses: docs/mcp-response-schema.md. Agent loop: docs/agent-skill.md.

MCP config:

{
  "mcpServers": {
    "mobile-agent": {
      "command": "npx",
      "args": ["-y", "mobile-agent-mcp"],
      "env": { "MOBILE_AGENT_PROJECT_ROOT": "/absolute/path/to/your/project" }
    }
  }
}

CLI

mobile-agent doctor [--json]
mobile-agent run-with-context <flow> [ios|android] [--json]
mobile-agent run-all [ios|android] [--json]
mobile-agent logs [ios|android] [--json] [--duration-ms 3000]
mobile-agent screenshot [ios|android] [--json]
mobile-agent metro-status | reload-app | boot-simulator [--json]
mobile-agent validate-flow <flow> | write-flow <flow> [--template smoke] [--json]
mobile-agent adb-reverse 8081
mobile-agent open-dev-url [ios|android]

Flags: --project-root, --flows-dir, --screenshot-dir.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityStale
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • lazy-mobile-mcp

    leaf76
    A
    license
    Not graded
    quality
    C
    maintenance
    Local MCP server for Android and iOS mobile automation and performance telemetry, enabling device control (screenshot, tap, swipe, input, app launch) and metric collection (CPU, memory, launch time) via ADB, simctl, and WebDriverAgent with SQLite session history.
    14 npm
    1
    MIT

  • mobile-mcp

    kimkitae
    A
    license
    Not graded
    quality
    D
    maintenance
    MCP server for cross-platform mobile automation (iOS/Android) using accessibility trees and screenshots, enabling agents to interact with apps on simulators, emulators, and physical devices.
    7
    Apache 2.0

  • Mobile Automator MCP Server

    jegriffi91
    F
    license
    A
    quality
    D
    maintenance
    An MCP server that gives AI agents the power to record, replay, and mock mobile app interactions — combining Maestro UI automation with Proxyman network capture to generate complete, self-contained test scripts.
    33
    1
    -