Greet someone by name

Get the MCP server version and toolkit information

Get device configuration. Uses the default device when no name is given; returns all devices when 'all' is specified.

Demonstrate server-to-client notifications: send logging messages or trigger list_changed events

Query active session metadata. Pass session_id for one session, device for all sessions of a device, or neither for all active sessions. Each session returns: session id, connection type (serial/ssh/adb), device name, connection info (e.g. COM3@115200), creation time, and the raw session log file path (serial/ssh/adb traffic recorded continuously by the server, including full boot logs after reset/reboot).

Query the MCP host endpoint (username@ip) for constructing cross-machine file transfers (scp) when this MCP runs on Windows and the AI client runs on Linux. Returns 'local started' with no endpoint for local launches.

Open an interactive SSH shell session to the board. Returns the initial banner output.

Close an SSH shell session and release the connection.

Send a command to an SSH shell session. Do NOT call this concurrently with ssh_shell_exec/ssh_shell_read on the same session_id — concurrent access to the same SSH shell corrupts the output buffer.

Read output from an SSH shell session. Do NOT call this concurrently with ssh_shell_exec/ssh_shell_write on the same session_id — concurrent access to the same SSH shell corrupts the output buffer.

Send a command to an SSH shell session and wait for the output. Combines write + delay + read in one call. IMPORTANT: Do NOT issue concurrent commands to the same session_id — the SSH shell is a single channel; concurrent calls will interleave output and corrupt results. Always wait for the previous command to finish before sending the next one. If you need parallel execution, open multiple sessions via ssh_shell_open.

Send a control character (Ctrl+C/U/D/Z) to an SSH shell session without appending a newline.

Check active SSH connections on the remote board. Shows which client IPs are connected to the SSH service (port 22).

One-click SSH login: connect, detect PSH state, auto-unlock if locked, and return a ready session. Combines open + PSH detect + unlock into a single call.

Execute a build command on the remote server via SSH, wait for completion, classify errors/warnings, and return structured build results for AI analysis. IMPORTANT: Each session supports only ONE build at a time. For concurrent builds, open multiple sessions via ssh_shell_open and assign one build per session.

Upload a local file to the remote board over SFTP, reusing an existing SSH session.

Download a remote file from the board to local over SFTP, reusing an existing SSH session.

Open a serial port connection and start an interactive shell session. Returns the initial banner output.

Close a serial port session and release the port.

Send a command to a serial shell session. Do NOT call this concurrently with serial_exec/serial_read on the same session_id — concurrent access to the same serial console corrupts the output buffer.

Read output from a serial shell session. Do NOT call this concurrently with serial_exec/serial_write on the same session_id — concurrent access to the same serial console corrupts the output buffer.

Send a command to a serial shell session and wait for the output. Combines write + delay + read in one call. IMPORTANT: Do NOT issue concurrent commands to the same session_id — the serial console is a single channel; concurrent calls will interleave output and corrupt results. Always wait for the previous command to finish before sending the next one. If you need parallel execution, open multiple sessions via serial_open.

Send a control character (Ctrl+C/U/D/Z) to a serial shell session without appending a newline.

One-click serial login: connect, detect PSH state, auto-unlock if locked, and return a ready session. Combines open + PSH detect + unlock into a single call.

Enter U-Boot by rebooting the device and stopping autoboot. Detection rules (autoboot prompts, command prompt, verify env keys) are configurable via device config serial.uboot; falls back to built-in defaults. Two-layer strategy: prompt match first; if not matched within a short window, sends 'printenv' and verifies U-Boot env keys. Fails fast on kernel boot or verify timeout.

Query, detect, or force-set the U-Boot mark of a serial session. The mark decides serial_exec's marker wrapping (U-Boot sessions use plain style without subshell). Actions: 'detect' (default) — classify the live environment from buffered tail evidence first (zero side effects); if inconclusive, send a bare Enter to redraw the prompt. Conclusive results sync the mark automatically. WARNING: do NOT detect while a command may still be running or waiting for interactive input (e.g. Y/N) — the probe Enter could answer it. 'set'/'clear' — force the mark when auto-detection is out of sync; 'status' — read the mark only, no device I/O.

Upload a binary file to the device over ZMODEM via an existing serial session. The device must have lrzsz installed (rz command). IMPORTANT: this tool triggers the device-side rz by itself (via recv_cmd); do NOT manually run rz (or serial_exec/write rz) on the session beforehand — a pre-started rz enters its own waiting state that breaks the tool's ZMODEM handshake. Just call this tool and pass recv_cmd when a working directory change is needed (e.g. "cd /home && rz"). Blocks until transfer completes, fails, or times out; progress is logged to stderr. Two timeouts: idle_timeout aborts on stalled transfer (real failure); timeout caps total duration and reports a suggested value if still progressing.

Download a binary file from the device over ZMODEM via an existing serial session. The device must have lrzsz installed (sz command). IMPORTANT: this tool triggers the device-side sz by itself (via send_cmd); do NOT manually run sz (or serial_exec/write sz) on the session beforehand — a pre-started sz enters its own sending state that breaks the tool's ZMODEM handshake. Just call this tool and pass send_cmd when a directory change is needed (e.g. "cd /home && sz {remote}"). remote_path resolves on the device relative to the shell's current working directory — prefer an absolute path, or combine send_cmd with a cd to pin the directory. If the remote file does not exist or is unreadable, sz errors out and the transfer fails (a partial local file, if any, is removed on failure). Blocks until transfer completes, fails, or times out; progress is logged to stderr. Two timeouts: idle_timeout aborts on stalled transfer (real failure); timeout caps total duration and reports a suggested value if still progressing.

Scan Windows Device Manager for available COM (serial) and LPT (parallel) ports

Scan Windows network adapters and configurations (IP, MAC, status, speed)

Analyze subnet information for a target IP address. Retrieves host IP, subnet mask, and gateway, calculates subnet range (network address, broadcast address, usable host range, CIDR), and determines whether the target IP falls within the same subnet as the host.

Open an interactive PowerShell shell session on the local Windows machine. Returns the initial banner output.

Close a PowerShell shell session and terminate the process.

Send a command to a PowerShell shell session. Do NOT call this concurrently with power_shell_exec/power_shell_read on the same session_id — concurrent access to the same PowerShell process corrupts the output buffer.

Read output from a PowerShell shell session. Do NOT call this concurrently with power_shell_exec/power_shell_write on the same session_id — concurrent access to the same PowerShell process corrupts the output buffer.

Send a command to a PowerShell shell session and wait for the output. Combines write + delay + read in one call. IMPORTANT: Do NOT issue concurrent commands to the same session_id — the PowerShell process is a single channel; concurrent calls will interleave output and corrupt results. Always wait for the previous command to finish before sending the next one.

List all connected ADB devices and their status (device, offline, unauthorized, etc.)

Execute a one-shot ADB command without a persistent session. Use for adb devices, install, push, or short shell commands.

Open an interactive ADB shell session to an Android device. Returns the initial banner output.

Close an ADB shell session and terminate the adb process.

Send a command to an ADB shell session. Do NOT call this concurrently with adb_shell_exec/adb_shell_read on the same session_id — concurrent access to the same ADB shell corrupts the output buffer.

Read output from an ADB shell session. Do NOT call this concurrently with adb_shell_exec/adb_shell_write on the same session_id — concurrent access to the same ADB shell corrupts the output buffer.

Send a command to an ADB shell session and wait for the output. Combines write + delay + read in one call. IMPORTANT: Do NOT issue concurrent commands to the same session_id — the ADB shell is a single channel; concurrent calls will interleave output and corrupt results. Always wait for the previous command to finish before sending the next one. If you need parallel execution, open multiple sessions via adb_shell_open.

Send a control character (Ctrl+C/U/D/Z) to an ADB shell session without appending a newline.