# Tools & Prompts

Available tools and prompts for Mobile Next Cloud MCP Server.

## Tools[​](#tools "Direct link to Tools")

| Tool                                             | Description                                                                                                                                          |
| ------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| `mobilenext_list_available_devices`              | List your allocated devices and devices available for allocation                                                                                     |
| `mobilenext_allocate_device`                     | Reserve a device from the remote fleet for testing and development. Allocation is asynchronous — see [How allocation works](#how-allocation-works)   |
| `mobilenext_release_device`                      | Release a device back to the remote fleet                                                                                                            |
| `mobilenext_list_apps`                           | List all the installed apps on the device                                                                                                            |
| `mobilenext_launch_app`                          | Launch an app on mobile device                                                                                                                       |
| `mobilenext_terminate_app`                       | Stop and terminate an app on mobile device                                                                                                           |
| `mobilenext_create_upload`                       | Create a presigned upload URL. `PUT` your `.apk`/`.ipa` file to the returned URL, then pass the `uploadId` to `mobilenext_install_app`               |
| `mobilenext_install_app`                         | Install 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_size`                     | Get the screen size of the mobile device in pixels                                                                                                   |
| `mobilenext_click_on_screen_at_coordinates`      | Click on the screen at given x,y coordinates                                                                                                         |
| `mobilenext_double_tap_on_screen`                | Double-tap on the screen at given x,y coordinates                                                                                                    |
| `mobilenext_long_press_on_screen_at_coordinates` | Long press on the screen at given x,y coordinates                                                                                                    |
| `mobilenext_list_elements_on_screen`             | List elements on screen and their coordinates, with display text or accessibility label                                                              |
| `mobilenext_press_button`                        | Press a device button: `HOME`, `BACK` (Android only), `VOLUME_UP`, `VOLUME_DOWN`, `ENTER`, or a D-pad button                                         |
| `mobilenext_open_url`                            | Open a URL in browser on device                                                                                                                      |
| `mobilenext_swipe_on_screen`                     | Swipe on the screen                                                                                                                                  |
| `mobilenext_type_keys`                           | Type text into the focused element                                                                                                                   |
| `mobilenext_take_screenshot`                     | Take a screenshot of the mobile device.                                                                                                              |
| `mobilenext_save_screenshot`                     | Take a screenshot of the mobile device and return a download URL                                                                                     |
| `mobilenext_set_orientation`                     | Change the screen orientation of the device                                                                                                          |
| `mobilenext_get_orientation`                     | Get the current screen orientation of the device                                                                                                     |
| `mobilenext_start_screen_recording`              | Start recording the screen of a mobile device                                                                                                        |
| `mobilenext_stop_screen_recording`               | Stop an active screen recording on a mobile device                                                                                                   |

## How allocation works[​](#how-allocation-works "Direct link to 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[​](#installing-your-own-app "Direct link to 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.