Tunnel Manager
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| HOST | No | Bind host for HTTP transports | 0.0.0.0 |
| PORT | No | Bind port for HTTP transports | 8000 |
| DEBUG | No | Verbose logging | False |
| TRANSPORT | No | Transport protocol (stdio, streamable-http, sse) | stdio |
| TUNNEL_PASSWORD | No | SSH password (when not using a key) | |
| TUNNEL_USERNAME | No | SSH username | |
| PYTHONUNBUFFERED | No | Unbuffered stdout | 1 |
| TUNNEL_INVENTORY | No | Path to the shared inventory | ~/.config/agent-utilities/inventory.yml |
| TUNNEL_CERTIFICATE | No | Path to an SSH certificate | |
| TUNNEL_REMOTE_HOST | No | Default remote host | |
| TUNNEL_REMOTE_PORT | No | Default remote SSH port | 22 |
| TUNNEL_IDENTITY_FILE | Yes | Path to the SSH private key (default ~/.ssh/id_ed25519) |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
Tunnel Manager MCP Utility — Manage SSH tunnels, managed hosts, and remote execution.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| logging | {} |
| prompts | {
"listChanged": true
} |
| resources | {
"subscribe": false,
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| tunnel_manager_add_hostD | Invoke the add_host operation. |
| tunnel_manager_get_hostA | Get a host config by alias, denying an alias the caller isn't entitled to. Returns |
| tunnel_manager_list_hostsA | List the host aliases the CALLER is entitled to, secrets redacted. Scoped to the caller's Okta/Keycloak identity
(CONCEPT:AU-OS.identity.identity-scoped-resource-autoload); an
unauthenticated/local caller (SYSTEM_ACTOR) sees all — unchanged from
today. Each entry excludes |
| tunnel_manager_load_inventoryC | Invoke the load_inventory operation. |
| tunnel_manager_remove_hostD | Invoke the remove_host operation. |
| tunnel_manager_save_inventoryC | Invoke the save_inventory operation. |
| tm_remote_run_commandC | Run command (tm_remote). Single-host SSH operations with shared connection params. |
| tm_remote_send_fileC | Send file (tm_remote). Single-host SSH operations with shared connection params. |
| tm_remote_receive_fileC | Receive file (tm_remote). Single-host SSH operations with shared connection params. |
| tm_remote_check_sshC | Check ssh (tm_remote). Single-host SSH operations with shared connection params. |
| tm_remote_test_key_authC | Test key auth (tm_remote). Single-host SSH operations with shared connection params. |
| tm_remote_setup_passwordlessC | Setup passwordless (tm_remote). Single-host SSH operations with shared connection params. |
| tm_remote_copy_ssh_configC | Copy ssh config (tm_remote). Single-host SSH operations with shared connection params. |
| tm_remote_rotate_keyC | Rotate key (tm_remote). Single-host SSH operations with shared connection params. |
| tm_remote_remove_host_keyC | Remove host key (tm_remote). Single-host SSH operations with shared connection params. |
| tm_inventory_configure_key_authC | Configure key auth (tm_inventory). Bulk inventory operations against YAML host groups. |
| tm_inventory_mesh_bootstrapC | Mesh bootstrap (tm_inventory). Bulk inventory operations against YAML host groups. |
| tm_inventory_run_commandC | Run command (tm_inventory). Bulk inventory operations against YAML host groups. |
| tm_inventory_copy_ssh_configC | Copy ssh config (tm_inventory). Bulk inventory operations against YAML host groups. |
| tm_inventory_rotate_keyC | Rotate key (tm_inventory). Bulk inventory operations against YAML host groups. |
| tm_inventory_send_fileC | Send file (tm_inventory). Bulk inventory operations against YAML host groups. |
| tm_inventory_receive_fileC | Receive file (tm_inventory). Bulk inventory operations against YAML host groups. |
| tm_operation_startC | Start (tm_operations). Operation lifecycle and session management. |
| tm_operation_get_progressC | Get progress (tm_operations). Operation lifecycle and session management. |
| tm_operation_cancelC | Cancel (tm_operations). Operation lifecycle and session management. |
| tm_operation_get_metricsC | Get metrics (tm_operations). Operation lifecycle and session management. |
| tm_operation_list_sessionsC | List sessions (tm_operations). Operation lifecycle and session management. |
| tm_system_get_infoC | Get info (tm_system). Remote system intelligence via SSH. |
| tm_system_discover_servicesC | Discover services (tm_system). Remote system intelligence via SSH. |
| tm_system_analyze_logsC | Analyze logs (tm_system). Remote system intelligence via SSH. |
| tm_system_network_topologyC | Network topology (tm_system). Remote system intelligence via SSH. |
| tm_file_recursive_opsC | Recursive ops (tm_files). Advanced file operations on remote hosts. |
| tm_file_content_searchC | Content search (tm_files). Advanced file operations on remote hosts. |
| tm_file_watchC | Watch (tm_files). Advanced file operations on remote hosts. |
| tm_file_diff_compareC | Diff compare (tm_files). Advanced file operations on remote hosts. |
| tm_file_backupC | Backup (tm_files). Advanced file operations on remote hosts. |
| tm_security_security_auditC | Security audit (tm_security). Security scanning and compliance. |
| tm_security_compliance_checkC | Compliance check (tm_security). Security scanning and compliance. |
| tm_security_vulnerability_scanC | Vulnerability scan (tm_security). Security scanning and compliance. |
| tm_security_access_control_auditC | Access control audit (tm_security). Security scanning and compliance. |
| tunnel_ingest_hostsB | List the managed SSH inventory and push it into the medulla KG. Maps each alias → a typed |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| connector-status | Ask for this connector server's current operational status. |
| tunnel-manager-inventory-administrator | |
| tunnel-manager-operator | |
| tunnel-manager-remote-operator | |
| tunnel-manager-ssh-security-administrator |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| _connector_status_resource | Native resource exposing this server's static status payload. |
| ontology://tunnel-manager-mcp/tunnel.ttl | |
| ontology://tunnel-manager-mcp/contracts.ttl | |
| connector-resources | Data sources, ontology mappings and resources of this connector. |
| tunnel-manager-ssh-hardening/SKILL.md | Harden SSH access through tunnel-manager: test key login, install and rotate keys on one host or a group, bootstrap host-to-host mesh access, copy SSH config, drop stale host keys, and run read-only security, access, compliance and vulnerability audits. Use to move a fleet to key authentication or check its SSH posture. |
| tunnel-manager-ssh-hardening/_manifest | File listing for tunnel-manager-ssh-hardening |
| tunnel-manager-operations/SKILL.md | Inspect hosts, track long operations and work with remote files through tunnel-manager: system information, services, logs and network topology; start, watch, measure and cancel tracked operations; search, compare, back up, watch and bulk-change files. Use for read-only host discovery, for progress on a long fan-out, or for file work on a host. |
| tunnel-manager-operations/_manifest | File listing for tunnel-manager-operations |
| tunnel-manager-development/SKILL.md | Develop, test, and publish tunnel-manager without breaking its typed SSH inventory, remote-execution, MCP action, packaged-content, spec-dashboard, or governed Pages contracts. Use when changing connector code, docs, skills, workflows, or repository-owned specifications. |
| tunnel-manager-development/_manifest | File listing for tunnel-manager-development |
| tunnel-manager-host-inventory/SKILL.md | Manage the shared SSH host inventory through tunnel-manager: list and look up host aliases, add, remove, load and save them, and push the inventory into the knowledge graph. Use to register an SSH target, see how a host is reached, prune a stale alias, or sync the fleet into the graph. |
| tunnel-manager-host-inventory/_manifest | File listing for tunnel-manager-host-inventory |
| tunnel-manager-remote-execution/SKILL.md | Run commands and move files over SSH through tunnel-manager, on one host (tm_remote_*) or across an inventory group (tm_inventory_*), with a reachability check first. Use to execute a command remotely, copy a file to or from hosts, or run something across a group. |
| tunnel-manager-remote-execution/_manifest | File listing for tunnel-manager-remote-execution |
TDQS
Scored across 41 tools
The remote vs. inventory families mirror each other almost one-for-one (run_command, send_file, receive_file, copy_ssh_config, rotate_key), so an agent must read the description to know whether it wants single-host or bulk. Host management is also split across tunnel_manager_add_host/get_host/list_hosts/remove_host, tunnel_manager_load_inventory/save_inventory, and tunnel_ingest_hosts, which blur into each other. The namespace prefixes and terse descriptions help somewhat, but boundaries remain fuzzy.
Most tools follow tm_<domain>_<verb>_<noun> (tm_remote_run_command, tm_file_content_search), which is readable and consistent. However, host CRUD uses a completely different tunnel_manager_* prefix, there is an orphan tunnel_ingest_hosts, and the descriptions for the tunnel_manager_* tools are generic 'Invoke the X operation' stubs. Two parallel naming schemes for overlapping concerns drag this down.
41 tools is well past the point where a set stays scannable, and much of the bulk comes from duplicated single-host/bulk-inventory pairs. The domain is broad (SSH, inventory, files, security, system intel) but several tools feel like namespace filler rather than distinct capabilities.
Coverage is broad — connection checks, key rotation, file transfer, inventory sync, operation lifecycle, security auditing, and system discovery are all present. But there are notable gaps: no update/edit_host despite add/get/list/remove, no session close or per-operation result retrieval beyond progress/metrics, and no key or credential management surface. Agents would hit dead ends on common edit-style workflows.