Test passwordless SSH connectivity and return the remote identity.

Read a UTF-8 text file from a remote host. offset and limit select a 1-based line range; limit=0 means unlimited. Defaults to first 200 lines.

Write UTF-8 text content directly to a file on the remote host (creates or overwrites; use append=true to append instead). Avoids the round-trip of writing a local temp file and scp-ing it.

Create a directory (and parents) on the remote host, equivalent to mkdir -p.

Read a remote image and return it as an MCP image. Supports common raster formats.

List a remote directory with file metadata in ls -lAh style.

Search remote text files recursively with ripgrep, falling back to grep. Output format is file:line:match.

Apply a unified diff on the remote host. Tries apply_patch (strip=0 only), then git apply, then patch. Supports dry-run and strip level.

Delete a remote file or directory. Directories require recursive=true.

Execute an intentional shell command on the remote host. Supports stdin, cwd, env, custom output limit, and acceptable exit codes. Set background=true to run a command detached and get a job_id; stdin is not allowed for background jobs. Use ssh_exec_result to poll/wait and ssh_exec_kill to stop or clean up.

Check the status and output of a background job started with ssh_exec background=true. Optionally wait until it exits.

Send a signal to a background job started with ssh_exec background=true. Optionally remove the job log directory.

Start a command on the remote host with a PTY allocated, for programs that prompt for input (sudo asking for a password, y/N confirmations, setup wizards, REPLs). Waits until output goes quiet (likely waiting for input) or the process exits, then returns the output so far plus a session_id. If the command finishes without prompting, the session is closed automatically and there is nothing further to do. Otherwise, use ssh_interactive_input to reply or poll, and ssh_interactive_close when finished. Idle sessions auto-expire after 10 minutes.

Send a line of input to a running ssh_interactive_exec session (e.g. answer a sudo password or y/N prompt), or just poll for more output if input is omitted. Returns newly produced output and status.

Kill and remove an interactive SSH session started with ssh_interactive_exec.

List currently open interactive SSH sessions.

Upload a local file or directory to the remote host via scp (reuses the multiplexed SSH connection when mux is enabled).

Download a remote file or directory to the local machine via scp (reuses the multiplexed SSH connection when mux is enabled).

Close the multiplexed SSH master connection for a target (no-op when multiplexing is disabled, e.g. native Windows OpenSSH).