Skip to main content

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)​

ToolDescriptionEffect
backend_discover_devicesSubmit UDP device discovery broadcasts.May modify
backend_import_deviceImport a device by endpoint.May modify
backend_import_devicesSubmit a batch device import job.May modify
backend_list_devicesList recorded devices.Read-only
backend_scan_ipsCheck TCP responses at IPv4 addresses and ports.May modify
backend_scan_networksList backend host IPv4 prefixes.Read-only
device_check_authRead XXTouch license status.Read-only
device_clear_app_dataClear the selected app’s data.May modify
device_clear_logsClear persisted device log history.May modify
device_collect_realtime_logsRead live device script logs.Read-only
device_delete_recordDelete a backend device record.May modify
device_export_logsExport persisted device log history.May modify
device_get_app_pathsRead app container, group, and plugin paths.Read-only
device_get_applistList device app metadata.Read-only
device_get_statusRead one device’s current status.Read-only
device_get_xxtlc_logsRead stored control-center logs for a channel.Read-only
device_input_sequenceRun ordered touch, key, and wait steps.May modify
device_install_packageUpdate XXTouch on the device.May modify
device_list_appsList installed apps and their bundle IDs.Read-only
device_lockRequest device screen locking.May modify
device_package_update_statusRead XXTouch update progress on Android Root.Read-only
device_rebootRequest a device reboot.May modify
device_respringRequest a SpringBoard restart.May modify
device_set_brightnessSet device brightness.May modify
device_set_volumeSet device volume.May modify
device_trollstore_installRequest an IPA/TIPA installation through TrollStore.May modify
device_ui_element_actionRun an action on a selected UI element.May modify
device_ui_element_queryRead UI elements matching a selector or point.Read-only
device_ui_element_snapshotRead UI elements, bounds, and hittability.Read-only
device_unlockRequest device screen unlocking.May modify

Groups (groups)​

ToolDescriptionEffect
backend_group_add_devicesAdd group members.May modify
backend_group_createCreate device groups.May modify
backend_group_deleteDelete device groups.May modify
backend_group_delete_script_configDelete group configuration for one script.May modify
backend_group_get_script_configRead group configuration for one script.Read-only
backend_group_listList device groups.Read-only
backend_group_list_script_configsList saved group script configurations.Read-only
backend_group_remove_devicesRemove group members.May modify
backend_group_renameRename device groups.May modify
backend_group_reorderReorder device groups.May modify
backend_group_set_scriptSet the group-bound script.May modify
backend_group_set_script_configReplace all group configuration for one script.May modify

Scripts (scripts)​

ToolDescriptionEffect
backend_list_scriptsList runnable backend scripts.Read-only
backend_read_scriptRead backend script UTF-8 content.Read-only
backend_write_scriptWrite or overwrite backend script UTF-8 content.May modify
device_get_selected_scriptRead the device-selected script.Read-only
device_launch_scriptRun the device script.May modify
device_pause_scriptPause the device script.May modify
device_resume_scriptResume the device script.May modify
device_run_script_snippetRun a short device Lua snippet.May modify
device_select_scriptSet the device-selected script.May modify
device_send_script_and_encryptRun device-side encryption and backend saving of a script or project.May modify
device_send_script_and_runRun script or project transfer and launch.May modify
device_stop_scriptStop the device script.May modify
device_upload_scriptRun a backend script upload to a device.May modify

Files (files)​

ToolDescriptionEffect
backend_file_copyCopy backend files or directories.May modify
backend_file_deleteDelete backend files or directories.May modify
backend_file_existsCheck backend files or directories.Read-only
backend_file_hashRead backend file checksums.Read-only
backend_file_listList backend files or directories.Read-only
backend_file_mkdirCreate backend directories.May modify
backend_file_moveMove backend files or directories.May modify
backend_file_readRead backend file content.Read-only
backend_file_renameRename backend files or directories.May modify
backend_file_writeWrite or overwrite backend file content.May modify
device_root_file_copyCopy device files or directories by absolute path.May modify
device_root_file_listList device files or directories by absolute path.Read-only
device_root_file_mkdirCreate an absolute-path device directory.May modify
device_root_file_moveMove device files or directories by absolute path.May modify
device_root_file_removeDelete device files or directories by absolute path.May modify
device_root_file_save_to_backendRun saving absolute-path device files to a backend directory.May modify
device_root_file_statRead device file metadata by absolute path.Read-only
device_xxt_home_file_copyCopy a file or directory within XXT Home.May modify
device_xxt_home_file_listList files and directories in XXT Home.Read-only
device_xxt_home_file_mkdirCreate a directory in XXT Home.May modify
device_xxt_home_file_moveMove a file or directory within XXT Home.May modify
device_xxt_home_file_readRead a file in XXT Home.Read-only
device_xxt_home_file_removeDelete a file from XXT Home.May modify
device_xxt_home_file_rmdirDelete an empty directory from XXT Home.May modify
device_xxt_home_file_writeWrite or overwrite a file in XXT Home.May modify
device_xxt_home_save_file_to_backendSave a file or directory from XXT Home to a backend directory.May modify
device_xxt_home_send_filesSend backend files or directories to XXT Home on the device.May modify

Images (images)​

ToolDescriptionEffect
backend_binarize_imageRun image binarization and saving.May modify
backend_crop_imageRun rectangular image cropping and saving.May modify
backend_extract_matrixRun single-glyph matrix extraction and image saving.May modify
backend_fit_binary_selectionRun tight fitting of a binary-content selection.Read-only
backend_matrix_line_from_binary_imageRun binary-image conversion to a MatrixDict line.Read-only
backend_pick_image_colorsRead colors at selected image pixels.Read-only
backend_split_matrixRun glyph-strip splitting into matrices at blank columns.Read-only
backend_view_imageRead an image preview from backend storage.Read-only
device_get_screen_sizeRead physical screen size and coordinate conversion.Read-only
device_get_screenshotRead a device screenshot and coordinate metadata.Read-only

Data (data)​

ToolDescriptionEffect
backend_kvdb_dict_clearClear KVDB dictionary entries.May modify
backend_kvdb_dict_createCreate KVDB dictionaries.May modify
backend_kvdb_dict_delete_allDelete KVDB dictionaries.May modify
backend_kvdb_dict_delete_keyDelete one KVDB dictionary key.May modify
backend_kvdb_dict_delete_keysDelete selected KVDB dictionary keys.May modify
backend_kvdb_dict_getRead one KVDB dictionary value.Read-only
backend_kvdb_dict_get_allList KVDB dictionary entries.Read-only
backend_kvdb_dict_incrAtomically increment an integer string in a dictionary.May modify
backend_kvdb_dict_putWrite or overwrite one KVDB dictionary value.May modify
backend_kvdb_dict_renameRename KVDB dictionaries.May modify
backend_kvdb_dict_replaceReplace all KVDB dictionary entries.May modify
backend_kvdb_dict_upsertMerge and write KVDB dictionary entries.May modify
backend_kvdb_exportExport a complete KVDB SQLite backup.May modify
backend_kvdb_importImport a complete KVDB SQLite backup.May modify
backend_kvdb_list_dictsList KVDB dictionaries.Read-only
backend_kvdb_list_queuesList KVDB queues.Read-only
backend_kvdb_queue_clearClear KVDB queue values.May modify
backend_kvdb_queue_countCount KVDB queue values.Read-only
backend_kvdb_queue_createCreate KVDB queues.May modify
backend_kvdb_queue_delete_allDelete KVDB queues.May modify
backend_kvdb_queue_delete_indicesDelete queue entries at selected indices.May modify
backend_kvdb_queue_listList KVDB queue values.Read-only
backend_kvdb_queue_moveRun an atomic transfer between KVDB queues.May modify
backend_kvdb_queue_popConsume and return KVDB queue values.May modify
backend_kvdb_queue_pushEnqueue KVDB queue values.May modify
backend_kvdb_queue_renameRename KVDB queues.May modify
backend_kvdb_queue_replaceReplace all KVDB queue values.May modify
backend_tabledb_add_columnsAdd TableDB user columns.May modify
backend_tabledb_add_rowsAdd TableDB rows.May modify
backend_tabledb_count_rowsCount matching TableDB rows.Read-only
backend_tabledb_createCreate TableDB tables.May modify
backend_tabledb_delete_rowsDelete TableDB rows.May modify
backend_tabledb_delete_tableDelete TableDB tables.May modify
backend_tabledb_drop_columnsDelete TableDB user columns.May modify
backend_tabledb_edit_rowsUpdate TableDB rows.May modify
backend_tabledb_exportExport TableDB rows.May modify
backend_tabledb_export_allExport a complete TableDB SQLite backup.May modify
backend_tabledb_export_selectionExport selected TableDB rows and columns.May modify
backend_tabledb_fetch_oneRun an atomic row fetch with optional update.May modify
backend_tabledb_get_rowRead a TableDB row by ID.Read-only
backend_tabledb_get_schemaRead a TableDB table schema.Read-only
backend_tabledb_importImport TableDB rows.May modify
backend_tabledb_import_allImport a complete TableDB SQLite backup.May modify
backend_tabledb_list_rowsList TableDB rows.Read-only
backend_tabledb_list_tablesList TableDB tables.Read-only
backend_tabledb_rename_columnRename TableDB user columns.May modify
backend_tabledb_rename_tableRename TableDB tables.May modify
backend_tabledb_reorder_columnsSet TableDB column order.May modify
backend_tabledb_truncateClear TableDB rows.May modify

Schedules (schedules)​

ToolDescriptionEffect
backend_schedule_cancel_runCancel one schedule run.May modify
backend_schedule_createCreate schedule definitions.May modify
backend_schedule_deleteDelete schedules.May modify
backend_schedule_exportExport a schedule JSON backup.Read-only
backend_schedule_getRead schedule definitions.Read-only
backend_schedule_importImport a schedule JSON backup.May modify
backend_schedule_listList schedules.Read-only
backend_schedule_list_runsList schedule run history and status.Read-only
backend_schedule_runSubmit one schedule run.May modify
backend_schedule_set_enabledSet a schedule’s automatic trigger state.May modify
backend_schedule_updateReplace all schedule definitions.May modify
backend_schedule_validateStatically validate and normalize schedule definitions.Read-only

Background Tasks (tasks)​

ToolDescriptionEffect
backend_batch_authorize_continueResume a batch authorization job.May modify
backend_batch_authorize_pausePause a batch authorization job.May modify
backend_batch_authorize_startSubmit a batch authorization job.May modify
backend_batch_executeSubmit a batch device-operation job.May modify
backend_task_cancelRequest background task cancellation.May modify
backend_task_getRead background task status and totals.Read-only
backend_task_listList background tasks from one source.Read-only
backend_task_resultsRead individual background task results.Read-only
backend_task_retryRetry failed items of a finished Agent task.May modify

IDE Sessions (ide)​

ToolDescriptionEffect
ide_bind_sessionSet the current MCP connection’s IDE binding.May modify
ide_get_bound_sessionRead the current MCP connection’s IDE binding.Read-only
ide_get_contextRead IDE workspace, file, and selection context.Read-only
ide_list_sessionsList active IDE sessions.Read-only
ide_resolve_selected_deviceRead the IDE-selected device.Read-only

Human Assistance (assist)​

ToolDescriptionEffect
xxt_assist_cancel_taskCancel human-assisted tasks.May modify
xxt_assist_create_taskCreate human-assisted tasks.May modify
xxt_assist_get_taskRead human-assist task status and result.Read-only
xxt_assist_list_tasksList human-assisted tasks.Read-only
xxt_assist_wait_resultRequest a wait for a human-assist result.Read-only

System (system)​

ToolDescriptionEffect
backend_get_app_configRead public typed application settings.Read-only
backend_get_configRead one string configuration entry.Read-only
backend_healthCheck backend availability.Read-only
backend_rename_devicesUpdate device names and synchronize backend records.May modify
backend_set_app_configUpdate public typed application settings.May modify
backend_set_configSet one string configuration entry.May modify
backend_versionRead the backend version.Read-only