Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
HOSTNoBind host for HTTP transports0.0.0.0
PORTNoBind port for HTTP transports8000
DEBUGNoVerbose loggingFalse
TRANSPORTNoTransport protocol (stdio, streamable-http, sse)stdio
TUNNEL_PASSWORDNoSSH password (when not using a key)
TUNNEL_USERNAMENoSSH username
PYTHONUNBUFFEREDNoUnbuffered stdout1
TUNNEL_INVENTORYNoPath to the shared inventory~/.config/agent-utilities/inventory.yml
TUNNEL_CERTIFICATENoPath to an SSH certificate
TUNNEL_REMOTE_HOSTNoDefault remote host
TUNNEL_REMOTE_PORTNoDefault remote SSH port22
TUNNEL_IDENTITY_FILEYesPath 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

CapabilityDetails
tools
{
  "listChanged": true
}
logging
{}
prompts
{
  "listChanged": true
}
resources
{
  "subscribe": false,
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
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 None when the alias is simply unknown (unchanged, callers fall back to raw connection params), but raises PermissionError when the alias exists and the caller's identity is not entitled to it.

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 password/password_ref in favor of a password_configured boolean so listing hosts never leaks secrets.

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 :Host node (+ :HostGroup / :SshKey and their :inGroup / :usesKey links). Best-effort: no-ops cleanly when no KG engine is reachable.

Prompts

Interactive templates invoked by user choice

NameDescription
connector-statusAsk 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

NameDescription
_connector_status_resourceNative resource exposing this server's static status payload.
ontology://tunnel-manager-mcp/tunnel.ttl
ontology://tunnel-manager-mcp/contracts.ttl
connector-resourcesData sources, ontology mappings and resources of this connector.
tunnel-manager-ssh-hardening/SKILL.mdHarden 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/_manifestFile listing for tunnel-manager-ssh-hardening
tunnel-manager-operations/SKILL.mdInspect 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/_manifestFile listing for tunnel-manager-operations
tunnel-manager-development/SKILL.mdDevelop, 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/_manifestFile listing for tunnel-manager-development
tunnel-manager-host-inventory/SKILL.mdManage 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/_manifestFile listing for tunnel-manager-host-inventory
tunnel-manager-remote-execution/SKILL.mdRun 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/_manifestFile listing for tunnel-manager-remote-execution

TDQS

C2.3/5.0

Scored across 41 tools

Disambiguation3/5

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.

Naming Consistency3/5

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.

Tool Count2/5

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.

Completeness3/5

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.

Maintenance

ActivityActive
ResponsivenessLimited data