Mobile MCP Catalog

The Mobile MCP server provides structured tools that allow AI assistants (e.g., GitHub Copilot, Cursor, Elitea) to automate browser sessions within Mobitru’s infrastructure.
Each command can be executed manually via JSON or through natural language prompts.

Tip: You can explore all commands interactively in your IDE by running “List all MCP tools for Mobile MCP.”  Each command entry below follows the same format — Purpose, Example JSON Input, Example Prompt, and Output/Notes.

DEVICE MANAGEMENT & SETUP

check_device_farm_status

Purpose: Check device farm connection and available devices.
Input example:

{
}

Output/Notes: Returns connection status and device availability list.
Additional Notes: Use before starting any device operations.
Example Prompt: “Check if device farm is available”

get_device_farm_config_status

Purpose: Get device farm configuration status and setup instructions.
Input example:

{
}

Output/Notes: Returns configuration status and setup guidance.
Additional Notes: Helps troubleshoot connection issues.
Example Prompt: “Show device farm configuration status”

device_farm_find_device

Purpose: Find available device matching specific requirements.
Input example:

{
}

Output/Notes: Returns device details meeting specified criteria.
Additional Notes: Specify platform, OS version, manufacturer optionally.
Example Prompt: “Find available Android device”

device_farm_take_device_by_id

Purpose: Reserve specific device by serial number.
Input example:

{
  "serial": "19161FDF600DJP"
}

Output/Notes: Returns reservation confirmation with session details.
Additional Notes: By default, the duration is 180 minutes. The user can request the agent to extend it to 300 minutes.
Example Prompt: “Reserve device with serial 19161FDF600DJP”

device_farm_release_device

Purpose: Release currently reserved device.
Input example:

{
}

Output/Notes: Returns release confirmation message.
Additional Notes: Frees device for other users.
Example Prompt: “Release device 19161FDF600DJP”

mobile_use_device

Purpose: Select cloud device for mobile operations.
Input example:

{
}

Output/Notes: Returns device selection confirmation.
Additional Notes: Use after finding available device.
Example Prompt: “Use device 19161FDF600DJP”

BOOKING MANAGEMENT

get_current_date

Purpose: Get current date in ISO format.
Input example:

{
}

Output/Notes: Returns formatted current timestamp.
Additional Notes: Useful for booking time calculations.
Example Prompt: “Get current date”

device_farm_create_booking

Purpose: Create new device booking for scheduled usage.
Input example:

{
  "name": "Device booking for 19161FDF600DJP - 2pm tomorrow",
  "start": "2026-01-27T14:00:00.000Z",
  "end": "2026-01-27T15:00:00.000Z",
  "devices": ["19161FDF600DJP"]
}

Output/Notes: Returns booking ID and confirmation details.
Additional Notes: Requires start/end times and device list.
Example Prompt: “Book device 19161FDF600DJP for tomorrow 2pm”

device_farm_get_booking_by_id

Purpose: Get specific booking details by ID.
Input example:

{
}

Output/Notes: Returns booking information and status.
Additional Notes: Shows booking times and device list.
Example Prompt: “Get booking details for ID f578efdc-c689-48e3-94ae-03b90387a82f”

device_farm_get_bookings

Purpose: List all current and upcoming bookings.
Input example:

{
}

Output/Notes: Returns array of booking objects.
Additional Notes: Can filter by time period.
Example Prompt: “Show all bookings”

device_farm_cancel_booking

Purpose: Cancel existing device booking.
Input example:

{
}

Output/Notes: Returns cancellation confirmation.
Additional Notes: Frees booked devices immediately.
Example Prompt: “Cancel booking f578efdc-c689-48e3-94ae-03b90387a82f”

TEST EXECUTION – ESPRESSO

device_farm_create_espresso_test_run

Purpose: Start new Espresso test run.
Input example:

{
}

Output/Notes: Returns test run ID and status.
Additional Notes: Requires app and test APK artifacts.
Example Prompt: “Run Espresso tests on device 19161FDF600DJP”

device_farm_get_espresso_test_run

Purpose: Get specific Espresso test run details.
Input example:

{
}

Output/Notes: Returns test execution status.
Additional Notes: Shows test progress and outcomes.
Example Prompt: “Get Espresso test run 3040cc0f-32d1-4ddf-9cba-fd806f2f955c status”

device_farm_get_all_espresso_test_runs

Purpose: List all Espresso test runs.
Input example:

{
}

Output/Notes: Returns array of test run objects.
Additional Notes: Shows historical and current runs.
Example Prompt: “Show all Espresso test runs”

device_farm_cancel_espresso_test_run

Purpose: Cancel running Espresso test.
Input example:

{
}

Output/Notes: Returns cancellation confirmation.
Additional Notes: Stops test execution immediately.
Example Prompt: “Cancel Espresso test run 3040cc0f-32d1-4ddf-9cba-fd806f2f955c”

TEST EXECUTION – XCUITEST

device_farm_create_xcuitest_test_run

Purpose: Start new XCUITest run.
Input example:

{
}

Output/Notes: Returns test run ID and status.
Additional Notes: Requires app and test IPA artifacts.
Example Prompt: “Run XCUITest on iPhone 00008020-000669981A43002E”

device_farm_get_xcuitest_test_run

Purpose: Get specific XCUITest run details.
Input example:

{
}

Output/Notes: Returns test results and execution status.
Additional Notes: Shows test progress and outcomes.
Example Prompt: “Get XCUITest run 4e8e2dd0-89e7-409b-9afa-dbbd54485b80 status”

device_farm_get_all_xcuitest_test_runs

Purpose: List all XCUITest runs.
Input example:

{
}

Output/Notes: Returns array of test run objects.
Additional Notes: Shows historical and current runs.
Example Prompt: “Show all XCUITest runs”

device_farm_cancel_xcuitest_test_run

Purpose: Cancel running XCUITest.
Input example:

{
}

Output/Notes: Returns cancellation confirmation.
Additional Notes: Stops test execution immediately.
Example Prompt: “Cancel XCUITest run 79a861b5-66ae-49c4-8205-d6289d6702f1”

APPLICATION MANAGEMENT

device_farm_install_app

Purpose: Install application on device from artifact.
Input example:

{
}

Output/Notes: Returns installation confirmation.
Additional Notes: Supports re-signing and code injection options.
Example Prompt: “Install app artifact e553ddb2-c20f-401c-8cc9-587fca58854b on 00008101-000604E92178001E”

device_farm_install_app_ota

Purpose: Install iOS app via Over-The-Air URL.
Input example:

{
}

Output/Notes: Returns installation status.
Additional Notes: iOS only, requires OTA URL (API documentation).
Example Prompt: “Install app from OTA URL itms-services://?action=download-manifest&url=https://example.mobitru.com:2030/manifest.plist on device 00008101-000604E92178001E”

device_farm_uninstall_app

Purpose: Remove application from device.
Input example:

{
}

Output/Notes: Returns uninstallation confirmation.
Additional Notes: Requires app package name (on Android) or bundle ID (on iOS).
Example Prompt: “Uninstall app com.example.app”

mobile_is_app_installed

Purpose: Check if app is installed.
Input example:

{
}

Output/Notes: Returns boolean installation status.
Additional Notes: Requires app package name (on Android) or bundle ID (on iOS).
Example Prompt: “Check if com.example.app is installed”

mobile_launch_app

Purpose: Launch application on device.
Input example:

{
  "packageName": "com.example.app"
}

Output/Notes: Returns app launch confirmation.
Additional Notes: Requires app package name (on Android) or bundle ID (on iOS).
Example Prompt: “Launch com.example.app”

mobile_terminate_app

Purpose: Stop running application.
Input example:

{
  "packageName": "com.example.app"
}

Output/Notes: Returns termination confirmation.
Additional Notes: The app is not fully closed; it is stopped and minimized.
Example Prompt: “Stop com.example.app”

ARTIFACT & FILE MANAGEMENT

device_farm_upload_artifact

Purpose: Upload file to device farm workspace.
Input example:

{
}

Output/Notes: Returns artifact ID for reference.
Additional Notes: Supports APK, IPA files.
Example Prompt: “Upload app.apk file”

device_farm_upload_artifact_to_device

Purpose: Upload artifact from storage to device.
Input example:

{
}

Output/Notes: Returns transfer confirmation.
Additional Notes: Asset management.
Example Prompt: “Upload artifact c9f81352-712f-471e-9d8e-c03a399f90c4 to device 00008101-000604E92178001E”

device_farm_list_artifacts

Purpose: List all uploaded artifacts.
Input example:

{
}

Output/Notes: Returns array of artifact objects.
Additional Notes: Can filter by type.
Example Prompt: “Show all uploaded artifacts in Storage”

device_farm_get_artifact_info

Purpose: Get detailed artifact information.
Input example:

{
}

Output/Notes: Returns artifact metadata and status.
Additional Notes: Shows file size and verification.
Example Prompt: “Get info for artifact c9f81352-712f-471e-9d8e-c03a399f90c4”

device_farm_get_artifact_status

Purpose: Check artifact verification status after uploading it to Storage.
Input example:

{
}

Output/Notes: Returns verification result.
Additional Notes: Use after recent upload to Storage.
Example Prompt: “Check artifact c9f81352-712f-471e-9d8e-c03a399f90c4 status”

device_farm_download_artifact_by_id

Purpose: Download artifact file by ID.
Input example:

{
}

Output/Notes: Returns download path and confirmation.
Additional Notes: Saves to default or specified location.
Example Prompt: “Download artifact c9f81352-712f-471e-9d8e-c03a399f90c4”

RECORDING & MONITORING

device_farm_start_recording

Purpose: Begin screen recording on device.
Input example:

{
}

Output/Notes: Returns recording session confirmation.
Additional Notes: Records until manually stopped, but no longer than 15 minutes.
Example Prompt: “Start recording device screen”

device_farm_stop_recording

Purpose: End screen recording session.
Input example:

{
}

Output/Notes: Returns recording ID for download.
Additional Notes: Use recording ID to download.
Example Prompt: “Stop screen recording”

device_farm_download_recording

Purpose: Download recorded video file.
Input example:

{
}

Output/Notes: Returns video file path.
Additional Notes: Saves to default or specified location.
Example Prompt: “Download recording a711e05c-fdfc-440b-bf8e-6cd240eaeeb6”

device_farm_start_logs_recording

Purpose: Begin device log capture.
Input example:

{
}

Output/Notes: Returns log recording confirmation.
Additional Notes: Captures system and app logs.
Example Prompt: “Start logging device 00008101-000604E92178001E”

device_farm_stop_logs_recording

Purpose: End log capture session.
Input example:

{
}

Output/Notes: Returns artifact ID for logs.
Additional Notes: Use artifact ID to download.
Example Prompt: “Stop logging device 00008101-000604E92178001E”

device_farm_get_device_crashlogs

Purpose: Retrieve device crash logs.
Input example:

{
}

Output/Notes: Returns crash log file path.
Additional Notes: iOS only, downloads recent crash information.
Example Prompt: “Get crash logs for 00008101-000604E92178001E”

mobile_take_screenshot

Purpose: Capture device screen image.
Input example:

{
}

Output/Notes: Returns screenshot file path.
Additional Notes: Saves with timestamp by default.
Example Prompt: “Take screenshot”

NETWORK & PERFOMANCE TESTING

device_farm_enable_throttling

Purpose: Apply network throttling to device.
Input example:

{
}

Output/Notes: Returns throttling configuration confirmation.
Additional Notes: Android only, various presets available.
Example Prompt: “Enable 3G throttling on 19161FDF600DJP”

device_farm_disable_throttling

Purpose: Remove network throttling from device.
Input example:

{
}

Output/Notes: Returns throttling disable confirmation.
Additional Notes: Restores normal network speed.
Example Prompt: “Disable throttling on 19161FDF600DJP”

device_farm_get_throttling_presets

Purpose: List available network throttling options.
Input example:

{
}

Output/Notes: Returns array of preset configurations.
Additional Notes: Shows speed and latency settings.
Example Prompt: “Show throttling presets”

device_farm_get_throttling_status

Purpose: Check current throttling configuration.
Input example:

{
}

Output/Notes: Returns active throttling settings.
Additional Notes: Shows current speed limits.
Example Prompt: “Check throttling status 19161FDF600DJP”

device_farm_start_http_inspection

Purpose: Begin HTTP traffic monitoring.
Input example:

{
}

Output/Notes: Returns inspection session confirmation.
Additional Notes: Android only, creates HAR files.
Example Prompt: “Start HTTP inspection 19161FDF600DJP”

device_farm_stop_http_inspection

Purpose: End HTTP traffic monitoring.
Input example:

{
}

Output/Notes: Returns HAR file ID.
Additional Notes: Use HAR ID to download.
Example Prompt: “Stop HTTP inspection 19161FDF600DJP”

device_farm_get_har_file

Purpose: Download HTTP traffic HAR file.
Input example:

{
}

Output/Notes: Returns HAR file path.
Additional Notes: Contains network request details.
Example Prompt: “Download HAR file 19161FDF600DJP”

device_farm_start_profiler

Purpose: Begin application performance profiling.
Input example:

{
  "appPackage": "com.mobitru.example.test",
  "serial": "19161FDF600DJP"
}

Output/Notes: Returns profiler session confirmation.
Additional Notes: Device must be reserved and the app must be running before starting the command. Monitors CPU, memory usage.
Example Prompt: “Start profiling com.example.app on 19161FDF600DJP”

device_farm_stop_profiler

Purpose: End performance profiling session.
Input example:

{
}

Output/Notes: Returns profile file path.
Additional Notes: Downloads performance analysis data.
Example Prompt: “Stop profiling device 19161FDF600DJP”

LOCATION & DEVICE SIMULATION

device_farm_get_device_geolocation

Purpose: Get current device GPS coordinates.
Input example:

{
}

Output/Notes: Returns latitude and longitude values.
Additional Notes: Shows current location settings.
Example Prompt: “Get location for 19161FDF600DJP”

device_farm_set_device_geolocation

Purpose: Set device GPS coordinates.
Input example:

{
}

Output/Notes: Returns location update confirmation.
Additional Notes: Requires latitude and longitude.
Example Prompt: “Set location to New York”

device_farm_set_ip_location

Purpose: Change device IP geolocation.
Input example:

{
}

Output/Notes: Returns IP location update confirmation.
Additional Notes: Use country codes/names or DEFAULT.
Example Prompt: “Set IP location to Argentina”

device_farm_get_ip_locations

Purpose: List available IP location options.
Input example:

{
}

Output/Notes: Returns array of country codes.
Additional Notes: Shows supported geolocation countries.
Example Prompt: “Show available IP locations”

device_farm_inject_image

Purpose: Mock camera input with image file.
Input example:

{
  "filePath": "/Users/Ivan_Ivanov/Desktop/photo.png",
  "serial": "19161FDF600DJP"
}

Output/Notes: Returns image injection confirmation.
Additional Notes: Requires app with injection enabled.
Example Prompt: “Inject photo.png to camera, filePath /Users/Ivan_Ivanov/Desktop/photo.png”

device_farm_inject_touch

Purpose: Simulate biometric authentication touch.
Input example:

{
  "serial": "19161FDF600DJP",
  "touchValid": true
}

Output/Notes: Returns touch simulation confirmation.
Additional Notes: Requires app with injection enabled.
Example Prompt: “Inject successful touch authentication”

MOBILE AUTOMATION (APPIUM)

mobile_appium_init

Purpose: Initialize Appium automation session.
Input example:

{
}

Output/Notes: Returns session initialization confirmation.
Additional Notes: Supports native and web sessions.
Example Prompt: “Start Appium session on 19161FDF600DJP”

mobile_appium_close

Purpose: Close active Appium session.
Input example:

{
}

Output/Notes: Returns session closure confirmation.
Additional Notes: Frees device for other operations.
Example Prompt: “Close Appium session”

mobile_click_on_screen_at_coordinates

Purpose: Click at specific screen coordinates.
Input example:

{
}

Output/Notes: Returns click action confirmation.
Additional Notes: Requires X, Y pixel coordinates.
Example Prompt: “Click at coordinates 100, 200”

mobile_list_elements_on_screen

Purpose: List all visible UI elements.
Input example:

{
}

Output/Notes: Returns array of element details.
Additional Notes: Shows coordinates, text, selectors.
Example Prompt: “Show all screen elements”

mobile_open_url

Purpose: Open URL in device browser.
Input example:

{
}

Output/Notes: Returns URL navigation confirmation.
Additional Notes: Launches default browser application.
Example Prompt: “Open mobitru.com in Safari”

mobile_press_button

Purpose: Press physical device button.
Input example:

{
}

Output/Notes: Returns button press confirmation.
Additional Notes: Supports HOME, BACK, VOLUME buttons.
Example Prompt: “Press HOME button”

mobile_type_keys

Purpose: Type text into focused element.
Input example:

{
}

Output/Notes: Returns text input confirmation.
Additional Notes: Can submit text automatically.
Example Prompt: “Type "hello world"”

swipe_on_screen

Purpose: Perform swipe gesture on screen.
Input example:

{
}

Output/Notes: Returns swipe action confirmation.
Additional Notes: Supports up, down, left, and right from the center of the device screen.
Example Prompt: “Swipe up”

mobile_get_orientation

Purpose: Get current screen orientation.
Input example:

{
}

Output/Notes: Returns portrait or landscape status.
Additional Notes: Shows current device orientation.
Example Prompt: “Get screen orientation”

mobile_set_orientation

Purpose: Change device screen orientation.
Input example:

{
}

Output/Notes: Returns orientation change confirmation.
Additional Notes: Supports portrait and landscape.
Example Prompt: “Set landscape orientation”

mobile_get_screen_size

Purpose: Get device screen dimensions.
Input example:

{
}

Output/Notes: Returns width and height pixels.
Additional Notes: Shows actual screen resolution.
Example Prompt: “Get screen size”

run_appium_test

Purpose: Execute custom Appium test script.
Input example:

{
}

Output/Notes: Returns test execution results.
Additional Notes:
Example Prompt: “Run Appium automation script”

UTILITIES & INFORMATION

appium_script_requirements

Purpose: Get Appium script generation requirements.
Input example:

{
}

Output/Notes: Returns coding guidelines and capabilities.
Additional Notes: Shows required format and structure.
Example Prompt: “Show Appium script requirements”

get_persistent_storage_info

Purpose: Get artifact storage location information.
Input example:

{
}

Output/Notes: Returns storage path and settings.
Additional Notes: Shows where files are saved.
Example Prompt: “Show storage information”

mcp_server_info

Purpose: Get MCP server configuration details.
Input example:

{
}

Output/Notes: Returns server status and settings.
Additional Notes: Shows current server information.
Example Prompt: “Show server info”

mobile_cloud_verify_setup

Purpose: Verify mobile cloud service setup and configuration.
Input example:

{
}

Output/Notes: Returns setup verification status and connectivity.
Additional Notes: Checks cloud connection before device operations.
Example Prompt: “Verify mobile cloud setup”