tunnel-manager-remote-execution

Tunnel Manager — Remote Execution

Execute commands and move files over SSH via the tunnel-manager MCP server — either against one host or fanned out across an inventory group.

When to use

• Run a shell command on a single host and read stdout/stderr.
• Send or receive a file to/from a host (SFTP).
• Run the same command across every host in a group (optionally in parallel).
• Check SSH reachability or verify key auth before relying on a host.

When NOT to use

• Registering / removing host aliases → tunnel-manager-host-inventory.
• Passwordless key setup, key rotation, mesh, or security audits → tunnel-manager-ssh-hardening.
• Long-running orchestration you want to track → pair with tm_operations.

Prerequisites & environment

Connect via the mcp-client skill against the tunnel-manager MCP server.

Variable	Required	Notes
TUNNEL_REMOTE_HOST / TUNNEL_USERNAME	optional	Defaults for single-host tm_remote
TUNNEL_IDENTITY_FILE	optional	Default private key path
TUNNEL_INVENTORY / TUNNEL_INVENTORY_GROUP	optional	Group ops with tm_inventory
TUNNEL_PARALLEL / TUNNEL_MAX_THREADS	optional	Parallel fan-out controls

Tools & actions

Condensed tool	Actions
tm_remote	run_command, send_file, receive_file, check_ssh, test_key_auth, remove_host_key
tm_inventory	run_command, send_file, receive_file (group fan-out)

Key parameters

• host, user, port, id_file — single-host connection (or password).
• cmd — the shell command for run_command.
• lpath / rpath — local / remote paths for send_file / receive_file.
• group, parallel, max_threads — fan-out controls on tm_inventory.
• timeout — per-command timeout in seconds (default 60).

Recipes

Run a command on one host:

{"action": "run_command", "host": "rw710", "user": "genius", "id_file": "~/.ssh/id_shared", "cmd": "uptime"}

Copy a file up to a host:

{"action": "send_file", "host": "rw710", "user": "genius", "lpath": "./deploy.sh", "rpath": "/tmp/deploy.sh"}

Verify a host is reachable before using it:

{"action": "check_ssh", "host": "rw710", "user": "genius", "id_file": "~/.ssh/id_shared"}

Fan a command across a whole group (tm_inventory), in parallel:

{"action": "run_command", "group": "homelab", "cmd": "df -h /", "parallel": true, "max_threads": 6}