Skip to main content
View as Markdown

Tools & Prompts

Available tools and prompts for Mobile Next Cloud MCP Server.

Tools

ToolDescription
mobilenext_list_available_devicesList your allocated devices and devices available for allocation
mobilenext_allocate_deviceReserve a device from the remote fleet for testing and development. Allocation is asynchronous — see How allocation works
mobilenext_release_deviceRelease a device back to the remote fleet
mobilenext_list_appsList all the installed apps on the device
mobilenext_launch_appLaunch an app on mobile device
mobilenext_terminate_appStop and terminate an app on mobile device
mobilenext_create_uploadCreate a presigned upload URL. PUT your .apk/.ipa file to the returned URL, then pass the uploadId to mobilenext_install_app
mobilenext_install_appInstall an app on a device — pass an uploadId from mobilenext_create_upload, or a URL to a .apk/.ipa file hosted at github.com/mobile-next
mobilenext_get_screen_sizeGet the screen size of the mobile device in pixels
mobilenext_click_on_screen_at_coordinatesClick on the screen at given x,y coordinates
mobilenext_double_tap_on_screenDouble-tap on the screen at given x,y coordinates
mobilenext_long_press_on_screen_at_coordinatesLong press on the screen at given x,y coordinates
mobilenext_list_elements_on_screenList elements on screen and their coordinates, with display text or accessibility label
mobilenext_press_buttonPress a device button: HOME, BACK (Android only), VOLUME_UP, VOLUME_DOWN, ENTER, or a D-pad button
mobilenext_open_urlOpen a URL in browser on device
mobilenext_swipe_on_screenSwipe on the screen
mobilenext_type_keysType text into the focused element
mobilenext_take_screenshotTake a screenshot of the mobile device.
mobilenext_save_screenshotTake a screenshot of the mobile device and return a download URL
mobilenext_set_orientationChange the screen orientation of the device
mobilenext_get_orientationGet the current screen orientation of the device
mobilenext_start_screen_recordingStart recording the screen of a mobile device
mobilenext_stop_screen_recordingStop an active screen recording on a mobile device

How allocation works

Device allocation is asynchronous. When mobilenext_allocate_device returns a device in the allocating state, provisioning is still in progress — Android devices are typically ready within a minute, while iOS devices can take a few minutes. Your agent can check progress by calling mobilenext_list_available_devices again; there is no need to re-allocate.

Allocating a device creates a session (or joins the session ID you pass in). Keep the returned session ID — mobilenext_release_device needs it to release the device when you're done.

Installing your own app

To test your own build, upload it first: call mobilenext_create_upload, PUT the file to the returned presigned URL, then call mobilenext_install_app with the uploadId.

For iOS, IPA files may be unsigned or ad hoc signed — Mobile Next Cloud re-signs them automatically before installation, so you don't need a device-provisioned signing profile.

Direct-URL installs are limited to .apk/.ipa files hosted at github.com/mobile-next (such as the Milliways sample app); use the upload flow for everything else.