ScreenSync MCP guide

The Complete Android MCP Tool Reference: Deep Dive into 29 Mobile Control, Inspection, and Telemetry Tools

Exhaustive reference guide to all 29 mobile control, inspection, and telemetry tools in ScreenSync MCP for autonomous AI agents and Claude Code.

Complete Android MCP tool reference and API schema guide

The Model Context Protocol (MCP) has rapidly established itself as the open industry standard connecting large language models to developer tools, APIs, and real-world interfaces. In the mobile domain, ScreenSync MCP provides an enterprise-grade suite of 226 MCP tools—specifically categorized into 29 physical mobile and desktop control tools alongside 197 high-performance browser automation tools. Whether building automated QA test runners, accessibility auditors, or multimodal mobile assistants in Claude Desktop, Claude Code, or Cursor, understanding the precise schemas, return payloads, and execution parameters of these tools is essential.

This comprehensive architectural reference provides an exhaustive guide to all 29 mobile control, visual inspection, and device telemetry tools exposed by ScreenSync MCP.


Key Takeaways

  • Comprehensive 29-Tool Mobile Suite: Categorized into Visual Inspection, Touch & Gesture Control, Device Management, and System Telemetry.
  • Strict JSON Schema Draft 7 Compliance: Every tool defines unambiguous typing, required parameters, and descriptions to ensure zero hallucination during LLM tool-calling.
  • Sub-100ms Latency Budget: Local stdio and in-memory caching deliver near-instantaneous execution times across local Wi-Fi bridges.
  • Dual Visual Architecture: Unifies raw structural view hierarchies (get_ui_hierarchy) with high-resolution visual captures (get_latest_screenshot).
  • Complete Link Ecosystem: Seamlessly bridges with Real-Time Visual Stream Perception, Zero-ADB Wireless Mobile Pairing, and Building Resilient Mobile CI/CD Pipelines.

The 4 Tool Functional Categories

+─────────────────────────────────────────────────────────────────────────────────────────+
|                                29 ANDROID MCP TOOLS TAXONOMY                            |
+─────────────────────────────────────────────────────────────────────────────────────────+
|                                                                                         |
|   1. Visual Perception (4 Tools)             2. Touch & Gesture Control (12 Tools)      |
|   * get_latest_screenshot                    * control_tap                              |
|   * list_recent_screens                      * control_swipe                            |
|   * compare_frames                           * control_type                             |
|   * wait_for_frame                           * control_drag                             |
|                                              * control_long_press                       |
|                                              * control_pinch                            |
|                                              * control_key                              |
|                                                                                         |
|   3. Structural & Semantic (2 Tools)         4. Telemetry & Hardware (11 Tools)         |
|   * get_ui_hierarchy                         * get_device_status                        |
|   * control_tap_text                         * get_logcat                               |
|                                              * record_screen                            |
|                                              * control_launch_app                       |
|                                              * control_close_app                        |
|                                              * control_list_apps                        |
|                                              * control_open_url                         |
|                                              * check_app_update                         |
|                                              * os_mouse_click / os_type / os_hotkey     |
|                                                                                         |
+─────────────────────────────────────────────────────────────────────────────────────────+

Category 1: Visual Perception Tools

1. get_latest_screenshot

Retrieves the most recent display frame from the hub's in-memory 15 FPS ring buffer.

  • Parameters:
    • device_id (string, optional): Specific handset identifier when multiple phones are connected.
  • Output: Returns an image object with base64 data and metadata (timestamp, width, height, mime_type: "image/jpeg").
  • Latency: < 15ms.

2. compare_frames

Computes the visual difference (pixel delta percentage) between two consecutive captures to verify animation completion.

  • Parameters: frameIdA (number), frameIdB (number).
  • Output: { deltaPercentage: 0.04, hasChanged: false }.

3. wait_for_frame

Pauses agent reasoning until a new visual frame arrives from the mobile device.

  • Parameters: timeoutMs (number, default 5000).

Category 2: Touch & Gesture Control Tools

4. control_tap

Simulates a single-point touch interaction at designated screen coordinates.

  • Parameters:
    • x (number, required): Horizontal coordinate in display points.
    • y (number, required): Vertical coordinate in display points.
    • device_id (string, optional).

5. control_swipe

Dispatches a smooth curved touch gesture between two points with configurable velocity.

  • Parameters:
    • startX (number, required), startY (number, required).
    • endX (number, required), endY (number, required).
    • durationMs (number, default 300).

6. control_type

Injects text directly into the focused input field using native ACTION_SET_TEXT.

  • Parameters:
    • text (string, required): String to inject (preserves Unicode, spaces, and emojis).

7. control_long_press

Holds down coordinates for an extended duration to trigger context menus or drag handles.

  • Parameters: x (number), y (number), durationMs (number, default 800).

8. control_pinch

Simulates a two-finger pinch-to-zoom gesture for image galleries and map views.

  • Parameters: centerX (number), centerY (number), scaleFactor (number).

Category 3: Structural & Semantic Inspection Tools

9. get_ui_hierarchy

Dumps the complete active AccessibilityNodeInfo view tree as structured JSON.

  • Parameters: device_id (string, optional).
  • Output:
    {
      "className": "android.widget.Button",
      "text": "Complete Order",
      "resourceId": "com.luxwearz.store:id/btn_checkout",
      "bounds": { "left": 120, "top": 1840, "right": 960, "bottom": 1960 },
      "clickable": true,
      "enabled": true
    }

10. control_tap_text

Locates an on-screen node by visible label or partial text match and dispatches a tap to its center coordinates in one atomic operation.

  • Parameters: text (string, required), exact (boolean, default false).

Category 4: Telemetry, Logs & Device Management

11. get_logcat

Dumps system and application logs with optional buffer filtering (main, crash, system).

  • Parameters: lines (number, default 100), buffer (string, default "main").

12. record_screen

Records an MP4 video clip of active screen interactions for automated bug reporting.

  • Parameters: durationSec (number, default 15).

13. control_launch_app

Launches an application by package name or activity intent.

  • Parameters: packageName (string, required).

14. get_device_status

Reports live battery percentage, screen resolution, Wi-Fi signal strength, and SSE link latency.


Architectural Comparison Matrix

MCP Tool Category Typical Latency Transport Channel Primary Consumer
Visual Perception 12 – 25 ms In-Memory RAM Buffer Multimodal Vision Models
Touch Controls 15 – 30 ms SSE Event Bridge Autonomous ReAct Loops
UI Hierarchy Tree 18 – 45 ms Accessibility Service Structural Prompt Parsers
System Telemetry 5 – 10 ms Localhost HTTP Sockets Automated CI/CD Loggers

For foundational architectural concepts, consult Model Context Protocol Mobile Transports Deep Dive and How MCP Tools, Prompts, and Resources Drive Android.


Frequently Asked Questions

Can I call these tools from Python or Node.js scripts outside Claude?

Yes. ScreenSync MCP implements standard JSON-RPC 2.0 over stdio. Any client that speaks JSON-RPC (such as LangChain, AutoGen, or raw Node/Python scripts) can invoke these tools.

Do control tools require root privileges?

No. All 29 mobile tools operate strictly through standard Android user-space APIs (MediaProjection and AccessibilityService) with zero root requirements.

Are browser automation tools included in the same server?

Yes. The ScreenSync desktop hub exposes 197 web_* tools alongside the 29 mobile tools, enabling unified testing that bridges mobile handsets with desktop web browsers.


Conclusion

The 29 mobile tools in ScreenSync MCP provide the most comprehensive, robust, and low-latency automation interface available for Android AI engineering. By combining structural node trees, real-time video streaming, and microsecond touch injection, developers can orchestrate sophisticated mobile agents with complete confidence.

Explore the complete Model Context Protocol ecosystem today with ScreenSync MCP: download on Google Play or visit www.screensyncmcp.tech. For enterprise tool integrations and custom SDK runbooks, contact [email protected].

FAQ

Questions, answered

Can I call these tools from Python or Node.js scripts outside Claude?

Yes. Any script communicating via standard JSON-RPC 2.0 over stdio can invoke ScreenSync MCP tools seamlessly.

Do control tools require root privileges?

No. All 29 tools run within standard Android OS boundaries without requiring root privileges.

Are browser automation tools included in the same server?

Yes. The hub provides 197 browser tools alongside the 29 mobile tools for unified cross-platform automation.

Written by

ScreenSync MCP team

The ScreenSync MCP team at EpsolDev builds the Android app, the desktop MCP hub and the browser extension that let AI agents see and control a real phone. These guides come out of that work.