// MCP TOOL REFERENCE

SCRCPY TOOLS

38 tools from the Scrcpy MCP Server, categorised by risk level.

// ALL 38 SCRCPY TOOLS

READ 8 tools

Read app_current Get the currently foregrounded app package name and activity. Read app_list List installed packages on the device. Optionally filter by name or restrict to system/third-party apps. Read clipboard_get Get the current clipboard content from the device. Uses scrcpy GET_CLIPBOARD when a session is active (work... Read device_info Get detailed info about a device: model, Android version, screen size, SDK level, battery level Read device_list List all connected Android devices with their serial numbers, state, and model Read file_list List directory contents on the device. Read screenshot Take a screenshot of the Android device screen. Returns the image as base64. Read ui_find_element Find UI elements on screen by text, resource ID, class name, or content description. Returns matching eleme...

WRITE 20 tools

Write app_install Install an APK file on the device from the host machine. Write clipboard_set Set the clipboard content on the device. Uses scrcpy SET_CLIPBOARD when a session is active (with optional ... Write collapse_panels Collapse all open panels (notification, settings) (requires active scrcpy session) Write connect_wifi Enable WiFi ADB and connect to the device wirelessly. Returns the connection address. Write disconnect_wifi Disconnect from a wireless ADB device Write drag_drop Perform a drag and drop gesture from one point to another. Uses input draganddrop on Android 8.0+ (API 26),... Write expand_notifications Expand the notification panel (requires active scrcpy session) Write expand_settings Expand the quick settings panel (requires active scrcpy session) Write file_pull Pull a file from the device to the host machine. Write file_push Push a file from the host machine to the device. Write input_text Type text into the currently focused input field Write key_event Send a key event to the device. Supports keycodes like HOME, BACK, ENTER, VOLUME_UP, etc. Write long_press Perform a long press at the specified coordinates Write rotate_device Rotate the device screen (requires active scrcpy session) Write screen_off Turn the device screen off Write screen_on Wake the device screen (turn screen on) Write scroll Scroll at the specified position. dx and dy are scroll amounts (-1 to 1 range approximated for ADB). Write swipe Perform a swipe gesture from one point to another Write tap Tap at the specified screen coordinates Write ui_dump Dump the full UI hierarchy of the current screen as XML. Useful for understanding screen structure before u...

DESTRUCTIVE 1 tools

Destructive app_uninstall Uninstall an app from the device.

EXECUTE 9 tools

Execute app_start Launch an app on the device. Uses scrcpy START_APP when a session is active for faster launch, falls back t... Execute app_stop Force-stop an app on the device. Execute screen_record_start Start recording the screen. Recording continues until screen_record_stop is called. Execute screen_record_stop Stop screen recording and optionally pull the file to the host. Execute shell_exec Execute an arbitrary ADB shell command on the device and return the output. Use this for any device operati... Execute start_session Start a scrcpy session for fast input control and screenshots. When a session is active, tap/swipe/text/scr... Execute start_video_stream Start an HTTP MJPEG video stream of the device screen. Opens a native ffplay window that connects to the st... Execute stop_session Stop the active scrcpy session. Tools will fall back to ADB commands. Execute stop_video_stream Stop the HTTP MJPEG video stream and close the viewer window for a device.

// RUNNING THIS SERVER

The managed route: connect Scrcpy through the PolicyLayer gateway — every tool call above is checked against your policy before it runs, with a full audit log.

DIRECT INSTALL (UNMANAGED) npx -y scrcpy-mcp

// FAQ

How many tools does the Scrcpy MCP server have? +

The Scrcpy MCP server exposes 38 tools across 4 categories: Read, Write, Destructive, Execute.

How do I enforce policies on Scrcpy tools? +

Route the Scrcpy server through the PolicyLayer gateway. Define allow, deny, or approval rules per tool in the dashboard — they are enforced on every call before it reaches the server.

What risk categories do Scrcpy tools fall into? +

Scrcpy tools are categorised as Read (8), Write (20), Destructive (1), Execute (9). Each category has a recommended default policy.

Let agents act without letting them run wild.

Route your MCP servers through PolicyLayer and every tool call is checked against your policy before it runs — allow, deny, or require approval. Per-identity grants. Full audit log. Live in minutes.

SECURE YOUR MCP →

Free to start. No card required.

4,600+ MCP servers and 31,000+ tools scanned and risk-classified.