Capture the target computer's screen (HDMI input) as JPEG.

max_width: downscale to this width (0 = native resolution). Mouse tools use the
coordinate space of the most recent screenshot.
wait_ms: extra wait before capturing. The tool already waits (up to ARKKVM_SETTLE_MAX_MS)
until the picture stops changing, so this is rarely needed.

Move the mouse pointer to (x, y) in screenshot pixel coordinates.

Click at (x, y) in screenshot pixel coordinates. count=2 for a double click.

Press at (x1, y1), move to (x2, y2) and release.

Scroll at (x, y). Negative amount scrolls down (or left), positive up (or right).

Type text on the target as keystrokes. '\n' presses Enter, '\t' Tab.

layout: keyboard layout configured on the TARGET OS ('us' or 'de'); defaults to
ARKKVM_KEYBOARD_LAYOUT. In BIOS/UEFI the layout is usually 'us'.

Press a key or key combination, e.g. 'enter', 'f2', 'esc', 'ctrl+alt+delete', 'super+r', 'alt+f4', 'shift+tab', 'down'. Keys use US physical positions.

repeat: press the combination this many times (e.g. 'down' x5 in a boot menu).
hold_ms: keep the keys pressed this long (e.g. to hold F12 during POST).

Press the target's ATX buttons (requires the ArkKVM ATX board wired to the mainboard).

power-short: short press of the power button (power on / ACPI shutdown).
power-long: hold power (~5 s, hard power off). reset: press the reset button.

Send a Wake-on-LAN magic packet from the KVM to the given MAC address.

Attach an ISO/IMG reachable over HTTP(S) as a read-only virtual USB CD-ROM or disk.

cdrom: optical drive, most compatible in BIOS/UEFI and for Windows installers.
disk: USB stick, faster, suits Linux/modern installers. Changing the mode re-enumerates
the KVM's USB devices; detach_usb_drive=true allows detaching the KVM's file-transfer
'Virtual USB Drive' from the host when that blocks the switch.

List images stored on the KVM's internal storage, free space and what is mounted now.

Attach an image stored on the KVM (see list_media) as a read-only virtual USB CD-ROM or disk. Mode semantics and detach_usb_drive as in mount_media_url.

Detach the currently mounted virtual media.

Status of the KVM's Virtual USB Drive (FAT file-transfer drive): enabled, where it is attached ('host' = USB stick on the target, 'kvm' = files accessible via these tools, 'none') and, when attached to the KVM, its capacity.

Attach the Virtual USB Drive to the target computer ('host', appears as a USB stick), to the KVM ('kvm', needed for usb_drive_list/upload/download/delete) or detach it ('none'). The drive is only ever attached to one side. After attaching to the host, wait a few seconds before the OS shows it; drive letters can change.

List a directory on the Virtual USB Drive. Requires the drive attached to the KVM.

Copy a file onto the Virtual USB Drive, e.g. remote_path='/drivers/setup.exe'. Source is either local_path (a file on the machine running this MCP server) or content (text, written as UTF-8). Missing parent folders are created.

Read a file from the Virtual USB Drive. With local_path it is saved there (on the machine running this MCP server); without, text files up to 100 KB are returned inline.

Delete a file or folder on the Virtual USB Drive. Folders that are not empty are only deleted with recursive=true (the firmware deletes folders including their contents).

Report KVM status: firmware, HDMI/video signal, USB attachment, virtual media, keyboard LEDs and last known ATX LED state.

Advanced: call any ArkKVM JSON-RPC method (e.g. getNetworkState, getEDID, getStorageSpace, listStorageFiles, setJigglerState). Destructive/configuration methods are blocked unless ARKKVM_ALLOW_DANGEROUS_RPC=1.

Disconnect from the KVM now so the web UI can be used without being taken over.