scrcpy-mcp
Installed, started with no arguments, no environment and no input, and listed its tools. Run 2026-11-16.
Needs to start: nothing
Returns a result when called with no setup: 1 of 5 tools tried
Contacts while installing and starting: nothing
What it contacted
Nothing besides the npm registry it was installed from. Watched from outside its sandbox while it was installed and started with no input. Its tools may still contact things when called.
Starting it
npx -y scrcpy-mcp@0.5.0
Installing a package runs its code. Use a sandbox for anything you have not read.
Calling its tools
5 tools that take no input and look read-only were called once with nothing. 1 returned a result.
version | Returned a result under 0.1 s · 23 characters |
device_list | No usable answer tool reported an error: ADB command failed: adb devices -l spawn adb ENOENT |
device_info | No usable answer tool reported an error: {"error":true,"message":"Failed to get device info: ADB command failed: adb devices -l\nspawn adb ENOENT"} |
app_list | No usable answer tool reported an error: {"error":true,"message":"ADB command failed: adb devices -l\nspawn adb ENOENT"} |
app_current | No usable answer tool reported an error: {"error":true,"message":"ADB command failed: adb devices -l\nspawn adb ENOENT"} |
During the calls it contacted nothing it had not already contacted.
Only tools whose names read like looking something up, with no required input, are tried, five at most. Tools that need input, and anything that sounds like it changes or sends something, are not called.
What its tools tell an agent
In the tool descriptions, nothing that talks about the user, other tools or private files, or uses hidden characters.
Found by simple pattern rules in each tool's description (up to 3,000 characters), quoted as written. Parameter descriptions are not scanned. A clean result is not a safety review.
Tools
start_session serial, maxSize, maxFps
Start a scrcpy session for fast input control and screenshots. When a session is active, tap/swipe/text/screenshot are 10-50x faster. Requires scrcpy-server to be installed.
stop_session serial
Stop the active scrcpy session. Tools will fall back to ADB commands.
version
Report which scrcpy version is being used by the MCP server. The version always describes the scrcpy-server file the session pushes: it comes from the SCRCPY_SERVER_VERSION environment variable, or from the scrcpy client belonging to the same install as that server, or a built-in default.
device_list
List all connected Android devices with their serial numbers, state, and model
device_info serial
Get detailed info about a device: model, Android version, screen size, SDK level, battery level
34 more tools
screen_on serial
Wake the device screen (turn screen on)
screen_off serial
Turn the device screen off
connect_wifi port, serial
Enable WiFi ADB and connect to the device wirelessly. Returns the connection address.
disconnect_wifi address
Disconnect from a wireless ADB device
rotate_device serial
Rotate the device screen (requires active scrcpy session)
expand_notifications serial
Expand the notification panel (requires active scrcpy session)
expand_settings serial
Expand the quick settings panel (requires active scrcpy session)
collapse_panels serial
Collapse all open panels (notification, settings) (requires active scrcpy session)
screenshot serial
Take a screenshot of the Android device screen. Returns the image as base64.
screen_record_start serial, remotePath, duration
Start recording the screen. Recording continues until screen_record_stop is called.
screen_record_stop serial, pullToHost, localPath
Stop screen recording and optionally pull the file to the host.
tap x, y, serial
Tap at the specified screen coordinates
swipe x1, y1, x2, y2, duration, serial
Perform a swipe gesture from one point to another
long_press x, y, duration, serial
Perform a long press at the specified coordinates
drag_drop startX, startY, endX, endY, duration, serial
Perform a drag and drop gesture from one point to another. Uses input draganddrop on Android 8.0+ (API 26), falls back to swipe on older versions.
input_text text, serial
Type text into the currently focused input field
key_event keycode, serial
Send a key event to the device. Supports keycodes like HOME, BACK, ENTER, VOLUME_UP, etc.
scroll x, y, dx, dy, serial
Scroll at the specified position. dx and dy are scroll amounts (-1 to 1 range approximated for ADB).
app_start packageName, serial
Launch an app on the device. Uses scrcpy START_APP when a session is active for faster launch, falls back to ADB `am start`. Supports force-stop prefix (+) to stop the app before launching.
app_stop packageName, serial
Force-stop an app on the device.
app_install apkPath, serial
Install an APK file on the device from the host machine.
app_uninstall packageName, serial
Uninstall an app from the device.
app_list filter, system, serial
List installed packages on the device. Optionally filter by name or restrict to system/third-party apps.
app_current serial
Get the currently foregrounded app package name and activity.
clipboard_get serial
Get the current clipboard content from the device. Uses scrcpy GET_CLIPBOARD when a session is active (works on Android 10+), falls back to ADB clipboard commands.
clipboard_set text, paste, serial
Set the clipboard content on the device. Uses scrcpy SET_CLIPBOARD when a session is active (with optional paste flag), falls back to ADB clipboard commands.
ui_dump serial
Dump the full UI hierarchy of the current screen as XML. Useful for understanding screen structure before using ui_find_element.
ui_find_element text, resourceId, className, contentDesc, serial
Find UI elements on screen by text, resource ID, class name, or content description. Returns matching elements with their tap coordinates. At least one search criterion must be provided.
shell_exec command, serial
Execute an arbitrary ADB shell command on the device and return the output. Use this for any device operation not covered by other tools.
file_push localPath, remotePath, serial
Push a file from the host machine to the device.
file_pull remotePath, localPath, serial
Pull a file from the device to the host machine.
file_list path, serial
List directory contents on the device.
start_video_stream serial, port
Start an HTTP MJPEG video stream of the device screen and open a viewer window (ffplay). Starts a scrcpy session automatically if needed.
stop_video_stream serial
Stop the HTTP MJPEG video stream and close the viewer window for a device.
Descriptions are the package's own words, cut at 3,000 characters. Treat them as data.
Install facts
| License | MIT |
|---|---|
| Needs | node >=24.0.0 |
| Source | github.com/JuanCF/scrcpy-mcp |
| Install scripts | ffmpeg-static declare them. This runner does not run them. |
| Tarball | sha512-XS28azAmj3D02PuIud0mmKG4OM4coHIZxIqzwjM9Br4QKG7Ud6xsq6RyiDXo1Gpck1G/2ppdSpLDLxV9RpWrhg== |
Check this report yourself
This site did not write the report. A public job on a GitHub-hosted machine did: the run, from this commit of the open-source runner. GitHub signed a token that names that job and the hash of the report, so any edit since would show.
Report as JSONExact text and tokenHow to verify it
Show it on your README
[](https://bragproof.smaverk.com/r/scrcpy-mcp)
New version out? Ask for a fresh report.