Read Hyper-V host and service health.

List VMs visible through the optional allowlist.

Get VM state, devices, memory, network, and checkpoint count.

Poll until a VM reaches one of the requested states. Returns matched=false on timeout and never changes power state.

Start, gracefully shut down, save, pause, resume, forcibly turn off, or reset a VM. turn_off/reset require confirm_vm equal to vm_name. Requires ALLOW_POWER and an allowlist.

List checkpoint IDs, names, parents, and creation times.

Create a manual checkpoint. Requires ALLOW_CHECKPOINTS and an allowlist.

Restore a checkpoint, discarding later guest state. confirm_vm and confirm_snapshot_id must match exactly.

Delete one checkpoint and merge its disks. Child checkpoints are not recursively included. Requires exact confirmations.

Read guest OS, boot time, memory, system-drive free space, and kernel debug settings through PowerShell Direct.

List up to 200 guest processes, optionally filtered by process name. Requires ALLOW_GUEST and guest credentials.

List up to 200 guest services filtered by name; stopped services are excluded by default.

Read recent System, Application, Security, or Setup event records with optional event ID and level filters.

Run PowerShell in the guest through PowerShell Direct. Credentials come only from the server environment. Returns combined output, exit code, and truncation status. A host-side timeout may leave the guest command running.

Read an absolute guest file path as base64, with SHA-256. Default limit 64 KiB; maximum 8 MiB. For large files, request bounded chunks through the lab APIs rather than inflating model context.

Write base64 content to an absolute guest path. Existing files require overwrite=true and confirm_path equal to guest_path.

Install or verify fixed lab tools in C:\DriverLab and create package/run/evidence directories. Never executes a payload. Requires confirm_vm.

Read guest boot, Secure Boot, VBS/HVCI, test-signing, debugger, disk, and crash-dump configuration.

Stage a hash-verified package from a subdirectory of HYPERV_MCP_LAB_ROOT. Supports chunked large files and never executes staged content.

Re-verify all package files and the exact manifest SHA-256 in the guest without executing the package.

Collect a new run's logs, events, diagnostics and dumps into HYPERV_MCP_EVIDENCE_ROOT. A kernel dump is opt-in; no new test is started.

Read recent operation lifecycle events from this MCP instance, without commands, passwords, typed text, or file contents.

Read guest video-head resolutions for mouse coordinate planning.

Type printable ASCII, tab, CR, or LF through Msvm_Keyboard. Unicode/ABNT2 text is rejected; use guest_exec for Unicode and match the guest keyboard layout. No VMConnect focus is required.

Press and release a key chord (for example ['ctrl','s'] or ['enter']) using Hyper-V virtual-key codes.

Explicitly press or release one supported key. Release held keys when finished; prefer console_press_keys for ordinary chords.

Set explicit left, right, and middle synthetic-mouse button states for drag operations.

Run up to 32 ordered text, key-chord, click, move, scroll, wait, or Ctrl+Alt+Delete actions. Stops at the first failure.

Send the Hyper-V secure-attention sequence to the guest.

Move the synthetic mouse to absolute guest-display pixel coordinates, not host-window coordinates.

Click left, right, or middle. Optionally move to guest-display x/y first.

Apply a relative synthetic-mouse wheel delta. Positive values normally scroll up.

List VM DVD drives, mounted ISO paths, controller locations, generation, and power state.

Mount an existing host ISO in an existing VM DVD drive while the VM is Off, optionally making it first boot device. Never stops the VM automatically. Requires ALLOW_MEDIA and confirm_vm equal to vm_name.

Eject an existing VM DVD drive while the VM is Off. Requires ALLOW_MEDIA and confirm_vm equal to vm_name.

Read COM1 configuration and whether this server has an attached serial-console reader.

Attach a dedicated reader to the existing COM1 named pipe of a Running VM and append output to a local .log file. Requires ALLOW_DEBUGGER and confirm_vm; does not configure the port or guest.

Read the retained tail of an attached serial console. Requires ALLOW_DEBUGGER.

Write UTF-8 text to an attached COM1 serial console, with CRLF appended by default.

Detach this server's serial reader and close its pipe handle without changing the VM COM port.

Read Hyper-V COM port debug configuration and local WinDbg/KDNET availability.

Configure COM1 kernel debugging over a local named pipe while the VM is Off. Guest BCD settings are a separate Running-VM operation. Never stops or reboots automatically. Requires ALLOW_DEBUGGER and confirm_vm.

Enable fixed COM1/115200 guest BCD debugging through PowerShell Direct while the VM is Running. Requires ALLOW_DEBUGGER, guest credentials, and confirm_vm. A deliberate later reboot is required.

Experimental PNG capture of an existing visible VMConnect window in the MCP server's interactive session. It does not read the guest framebuffer. Requires ALLOW_SCREENSHOTS and an allowlist.