MCP Business Operation Catalog
The following MCP business operations are grouped by tool_list category. Pass the name as tool to tool_call and business parameters in args. Use tool_info for complete parameters and constraints. Read-only and May modify follow each definition’s readOnly flag.
XXT Home (XXT_HOME_PATH) is the XXTouch working directory on the device.
Devices (devices)
| Tool | Description | Effect |
|---|---|---|
backend_discover_devices | Submit UDP device discovery broadcasts. | May modify |
backend_import_device | Import a device by endpoint. | May modify |
backend_import_devices | Submit a batch device import job. | May modify |
backend_list_devices | List recorded devices. | Read-only |
backend_scan_ips | Check TCP responses at IPv4 addresses and ports. | May modify |
backend_scan_networks | List backend host IPv4 prefixes. | Read-only |
device_check_auth | Read XXTouch license status. | Read-only |
device_clear_app_data | Clear the selected app’s data. | May modify |
device_clear_logs | Clear persisted device log history. | May modify |
device_collect_realtime_logs | Read live device script logs. | Read-only |
device_delete_record | Delete a backend device record. | May modify |
device_export_logs | Export persisted device log history. | May modify |
device_get_app_paths | Read app container, group, and plugin paths. | Read-only |
device_get_applist | List device app metadata. | Read-only |
device_get_status | Read one device’s current status. | Read-only |
device_get_xxtlc_logs | Read stored control-center logs for a channel. | Read-only |
device_input_sequence | Run ordered touch, key, and wait steps. | May modify |
device_install_package | Update XXTouch on the device. | May modify |
device_list_apps | List installed apps and their bundle IDs. | Read-only |
device_lock | Request device screen locking. | May modify |
device_package_update_status | Read XXTouch update progress on Android Root. | Read-only |
device_reboot | Request a device reboot. | May modify |
device_respring | Request a SpringBoard restart. | May modify |
device_set_brightness | Set device brightness. | May modify |
device_set_volume | Set device volume. | May modify |
device_trollstore_install | Request an IPA/TIPA installation through TrollStore. | May modify |
device_ui_element_action | Run an action on a selected UI element. | May modify |
device_ui_element_query | Read UI elements matching a selector or point. | Read-only |
device_ui_element_snapshot | Read UI elements, bounds, and hittability. | Read-only |
device_unlock | Request device screen unlocking. | May modify |
Groups (groups)
| Tool | Description | Effect |
|---|---|---|
backend_group_add_devices | Add group members. | May modify |
backend_group_create | Create device groups. | May modify |
backend_group_delete | Delete device groups. | May modify |
backend_group_delete_script_config | Delete group configuration for one script. | May modify |
backend_group_get_script_config | Read group configuration for one script. | Read-only |
backend_group_list | List device groups. | Read-only |
backend_group_list_script_configs | List saved group script configurations. | Read-only |
backend_group_remove_devices | Remove group members. | May modify |
backend_group_rename | Rename device groups. | May modify |
backend_group_reorder | Reorder device groups. | May modify |
backend_group_set_script | Set the group-bound script. | May modify |
backend_group_set_script_config | Replace all group configuration for one script. | May modify |
Scripts (scripts)
| Tool | Description | Effect |
|---|---|---|
backend_list_scripts | List runnable backend scripts. | Read-only |
backend_read_script | Read backend script UTF-8 content. | Read-only |
backend_write_script | Write or overwrite backend script UTF-8 content. | May modify |
device_get_selected_script | Read the device-selected script. | Read-only |
device_launch_script | Run the device script. | May modify |
device_pause_script | Pause the device script. | May modify |
device_resume_script | Resume the device script. | May modify |
device_run_script_snippet | Run a short device Lua snippet. | May modify |
device_select_script | Set the device-selected script. | May modify |
device_send_script_and_encrypt | Run device-side encryption and backend saving of a script or project. | May modify |
device_send_script_and_run | Run script or project transfer and launch. | May modify |
device_stop_script | Stop the device script. | May modify |
device_upload_script | Run a backend script upload to a device. | May modify |
Files (files)
| Tool | Description | Effect |
|---|---|---|
backend_file_copy | Copy backend files or directories. | May modify |
backend_file_delete | Delete backend files or directories. | May modify |
backend_file_exists | Check backend files or directories. | Read-only |
backend_file_hash | Read backend file checksums. | Read-only |
backend_file_list | List backend files or directories. | Read-only |
backend_file_mkdir | Create backend directories. | May modify |
backend_file_move | Move backend files or directories. | May modify |
backend_file_read | Read backend file content. | Read-only |
backend_file_rename | Rename backend files or directories. | May modify |
backend_file_write | Write or overwrite backend file content. | May modify |
device_root_file_copy | Copy device files or directories by absolute path. | May modify |
device_root_file_list | List device files or directories by absolute path. | Read-only |
device_root_file_mkdir | Create an absolute-path device directory. | May modify |
device_root_file_move | Move device files or directories by absolute path. | May modify |
device_root_file_remove | Delete device files or directories by absolute path. | May modify |
device_root_file_save_to_backend | Run saving absolute-path device files to a backend directory. | May modify |
device_root_file_stat | Read device file metadata by absolute path. | Read-only |
device_xxt_home_file_copy | Copy a file or directory within XXT Home. | May modify |
device_xxt_home_file_list | List files and directories in XXT Home. | Read-only |
device_xxt_home_file_mkdir | Create a directory in XXT Home. | May modify |
device_xxt_home_file_move | Move a file or directory within XXT Home. | May modify |
device_xxt_home_file_read | Read a file in XXT Home. | Read-only |
device_xxt_home_file_remove | Delete a file from XXT Home. | May modify |
device_xxt_home_file_rmdir | Delete an empty directory from XXT Home. | May modify |
device_xxt_home_file_write | Write or overwrite a file in XXT Home. | May modify |
device_xxt_home_save_file_to_backend | Save a file or directory from XXT Home to a backend directory. | May modify |
device_xxt_home_send_files | Send backend files or directories to XXT Home on the device. | May modify |
Images (images)
| Tool | Description | Effect |
|---|---|---|
backend_binarize_image | Run image binarization and saving. | May modify |
backend_crop_image | Run rectangular image cropping and saving. | May modify |
backend_extract_matrix | Run single-glyph matrix extraction and image saving. | May modify |
backend_fit_binary_selection | Run tight fitting of a binary-content selection. | Read-only |
backend_matrix_line_from_binary_image | Run binary-image conversion to a MatrixDict line. | Read-only |
backend_pick_image_colors | Read colors at selected image pixels. | Read-only |
backend_split_matrix | Run glyph-strip splitting into matrices at blank columns. | Read-only |
backend_view_image | Read an image preview from backend storage. | Read-only |
device_get_screen_size | Read physical screen size and coordinate conversion. | Read-only |
device_get_screenshot | Read a device screenshot and coordinate metadata. | Read-only |
Data (data)
| Tool | Description | Effect |
|---|---|---|
backend_kvdb_dict_clear | Clear KVDB dictionary entries. | May modify |
backend_kvdb_dict_create | Create KVDB dictionaries. | May modify |
backend_kvdb_dict_delete_all | Delete KVDB dictionaries. | May modify |
backend_kvdb_dict_delete_key | Delete one KVDB dictionary key. | May modify |
backend_kvdb_dict_delete_keys | Delete selected KVDB dictionary keys. | May modify |
backend_kvdb_dict_get | Read one KVDB dictionary value. | Read-only |
backend_kvdb_dict_get_all | List KVDB dictionary entries. | Read-only |
backend_kvdb_dict_incr | Atomically increment an integer string in a dictionary. | May modify |
backend_kvdb_dict_put | Write or overwrite one KVDB dictionary value. | May modify |
backend_kvdb_dict_rename | Rename KVDB dictionaries. | May modify |
backend_kvdb_dict_replace | Replace all KVDB dictionary entries. | May modify |
backend_kvdb_dict_upsert | Merge and write KVDB dictionary entries. | May modify |
backend_kvdb_export | Export a complete KVDB SQLite backup. | May modify |
backend_kvdb_import | Import a complete KVDB SQLite backup. | May modify |
backend_kvdb_list_dicts | List KVDB dictionaries. | Read-only |
backend_kvdb_list_queues | List KVDB queues. | Read-only |
backend_kvdb_queue_clear | Clear KVDB queue values. | May modify |
backend_kvdb_queue_count | Count KVDB queue values. | Read-only |
backend_kvdb_queue_create | Create KVDB queues. | May modify |
backend_kvdb_queue_delete_all | Delete KVDB queues. | May modify |
backend_kvdb_queue_delete_indices | Delete queue entries at selected indices. | May modify |
backend_kvdb_queue_list | List KVDB queue values. | Read-only |
backend_kvdb_queue_move | Run an atomic transfer between KVDB queues. | May modify |
backend_kvdb_queue_pop | Consume and return KVDB queue values. | May modify |
backend_kvdb_queue_push | Enqueue KVDB queue values. | May modify |
backend_kvdb_queue_rename | Rename KVDB queues. | May modify |
backend_kvdb_queue_replace | Replace all KVDB queue values. | May modify |
backend_tabledb_add_columns | Add TableDB user columns. | May modify |
backend_tabledb_add_rows | Add TableDB rows. | May modify |
backend_tabledb_count_rows | Count matching TableDB rows. | Read-only |
backend_tabledb_create | Create TableDB tables. | May modify |
backend_tabledb_delete_rows | Delete TableDB rows. | May modify |
backend_tabledb_delete_table | Delete TableDB tables. | May modify |
backend_tabledb_drop_columns | Delete TableDB user columns. | May modify |
backend_tabledb_edit_rows | Update TableDB rows. | May modify |
backend_tabledb_export | Export TableDB rows. | May modify |
backend_tabledb_export_all | Export a complete TableDB SQLite backup. | May modify |
backend_tabledb_export_selection | Export selected TableDB rows and columns. | May modify |
backend_tabledb_fetch_one | Run an atomic row fetch with optional update. | May modify |
backend_tabledb_get_row | Read a TableDB row by ID. | Read-only |
backend_tabledb_get_schema | Read a TableDB table schema. | Read-only |
backend_tabledb_import | Import TableDB rows. | May modify |
backend_tabledb_import_all | Import a complete TableDB SQLite backup. | May modify |
backend_tabledb_list_rows | List TableDB rows. | Read-only |
backend_tabledb_list_tables | List TableDB tables. | Read-only |
backend_tabledb_rename_column | Rename TableDB user columns. | May modify |
backend_tabledb_rename_table | Rename TableDB tables. | May modify |
backend_tabledb_reorder_columns | Set TableDB column order. | May modify |
backend_tabledb_truncate | Clear TableDB rows. | May modify |
Schedules (schedules)
| Tool | Description | Effect |
|---|---|---|
backend_schedule_cancel_run | Cancel one schedule run. | May modify |
backend_schedule_create | Create schedule definitions. | May modify |
backend_schedule_delete | Delete schedules. | May modify |
backend_schedule_export | Export a schedule JSON backup. | Read-only |
backend_schedule_get | Read schedule definitions. | Read-only |
backend_schedule_import | Import a schedule JSON backup. | May modify |
backend_schedule_list | List schedules. | Read-only |
backend_schedule_list_runs | List schedule run history and status. | Read-only |
backend_schedule_run | Submit one schedule run. | May modify |
backend_schedule_set_enabled | Set a schedule’s automatic trigger state. | May modify |
backend_schedule_update | Replace all schedule definitions. | May modify |
backend_schedule_validate | Statically validate and normalize schedule definitions. | Read-only |
Background Tasks (tasks)
| Tool | Description | Effect |
|---|---|---|
backend_batch_authorize_continue | Resume a batch authorization job. | May modify |
backend_batch_authorize_pause | Pause a batch authorization job. | May modify |
backend_batch_authorize_start | Submit a batch authorization job. | May modify |
backend_batch_execute | Submit a batch device-operation job. | May modify |
backend_task_cancel | Request background task cancellation. | May modify |
backend_task_get | Read background task status and totals. | Read-only |
backend_task_list | List background tasks from one source. | Read-only |
backend_task_results | Read individual background task results. | Read-only |
backend_task_retry | Retry failed items of a finished Agent task. | May modify |
IDE Sessions (ide)
| Tool | Description | Effect |
|---|---|---|
ide_bind_session | Set the current MCP connection’s IDE binding. | May modify |
ide_get_bound_session | Read the current MCP connection’s IDE binding. | Read-only |
ide_get_context | Read IDE workspace, file, and selection context. | Read-only |
ide_list_sessions | List active IDE sessions. | Read-only |
ide_resolve_selected_device | Read the IDE-selected device. | Read-only |
Human Assistance (assist)
| Tool | Description | Effect |
|---|---|---|
xxt_assist_cancel_task | Cancel human-assisted tasks. | May modify |
xxt_assist_create_task | Create human-assisted tasks. | May modify |
xxt_assist_get_task | Read human-assist task status and result. | Read-only |
xxt_assist_list_tasks | List human-assisted tasks. | Read-only |
xxt_assist_wait_result | Request a wait for a human-assist result. | Read-only |
System (system)
| Tool | Description | Effect |
|---|---|---|
backend_get_app_config | Read public typed application settings. | Read-only |
backend_get_config | Read one string configuration entry. | Read-only |
backend_health | Check backend availability. | Read-only |
backend_rename_devices | Update device names and synchronize backend records. | May modify |
backend_set_app_config | Update public typed application settings. | May modify |
backend_set_config | Set one string configuration entry. | May modify |
backend_version | Read the backend version. | Read-only |