Tunnel Manager
Tunnel Manager is an MCP/agent server for managing SSH access to a fleet of remote hosts: it manages a shared host inventory, runs SSH operations on single hosts or whole groups, and provides system-intelligence, file-management, and security-audit capabilities.
Host inventory management — add, get, list (caller-scoped, secrets redacted), remove, save, and load host aliases in the shared YAML inventory.
Single-host SSH operations (
tm_remote) — run commands, send/receive files, check SSH connectivity, test key auth, set up passwordless login, copy SSH configs, rotate keys, and remove host keys.Bulk fleet operations (
tm_inventory) — the same operations fanned out across an inventory group, withhost/grouptargeting andpreviewscope checks.Operation lifecycle (
tm_operations) — start operations, track progress, cancel, fetch metrics, and list sessions.Remote system intelligence (
tm_system) — host info, service discovery, log analysis, and network topology.Advanced file operations (
tm_files) — recursive copy/move/delete/chmod/chown, content search, path watching, cross-host diff compare, and backups.Security & compliance (
tm_security) — security audits, CIS/PCI/HIPAA compliance checks, vulnerability scans, and access-control audits.Knowledge-graph ingest (
tunnel_ingest_hosts) — push the SSH inventory into the medulla KG as typed host/group/key nodes.Governed deployment — configurable tool surfaces (intent/condensed/verbose/both), Eunomia policies, OIDC delegation, OTel telemetry, and stdio/HTTP transports.
Provides native OpenTelemetry exports for telemetry and tracing, allowing observability integration with OpenTelemetry-compatible backends.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Tunnel Manager add host 'dev-server' with IP 192.168.1.10"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Tunnel Manager
CLI or API | MCP | Agent
Documentation — Installation, deployment, usage across the API, CLI, and MCP and agent interfaces are maintained in the official documentation.
Related MCP server: mcp-ssh
Overview
Tunnel Manager is a production-grade Agent and Model Context Protocol (MCP) server designed to interface directly with Create SSH Tunnels to the operator's remote hosts and host as an MCP Server for Agentic AI!.
Key Features
Consolidated Action-Routed MCP Tools: Minimizes token overhead and eliminates tool bloat in LLM contexts by grouping methods into optimized, togglable tool modules.
Enterprise-Grade Security: Complete support for Eunomia policies, OIDC token delegation, and granular execution context tracking.
Integrated Graph Agent: Built-in Pydantic AI agent supporting the Agent Control Protocol (ACP) and standard Web interfaces (AG-UI).
Native Telemetry & Tracing: Out-of-the-box OpenTelemetry exports and native Langfuse tracing.
CLI or API
This agent wraps the Create SSH Tunnels to the operator's remote hosts and host as an MCP Server for Agentic AI! API. The operator can interact with it programmatically or via its integrated execution entrypoints.
Detailed instructions on how to use the underlying API wrappers, extended schema bindings, and developer SDK references are maintained in docs/index.md.
MCP
This server use dynamic Action-Routed tools to optimize token overhead and maximize IDE compatibility.
Available MCP Tools
Auto-generated from the live MCP server — do not edit by hand.
Condensed action-routed tools (MCP_TOOL_MODE=condensed)
MCP Tool | Toggle Env Var | Description |
|
| Advanced file operations on remote hosts. |
|
| Manage the local host alias inventory. |
|
| Bulk inventory operations against YAML host groups. |
|
| Operation lifecycle and session management. |
|
| Single-host SSH operations with shared connection params. |
|
| Security scanning and compliance. |
|
| Remote system intelligence via SSH. |
|
| List the managed SSH inventory and push it into the medulla KG. |
Verbose 1:1 API-mapped tools (MCP_TOOL_MODE=verbose or both)
MCP Tool | Toggle Env Var | Description |
|
| Invoke the add_host operation. |
|
| Get a host config by alias, denying an alias the caller isn't entitled to. |
|
| List the host aliases the CALLER is entitled to, secrets redacted. |
|
| Invoke the load_inventory operation. |
|
| Invoke the remove_host operation. |
|
| Invoke the save_inventory operation. |
8 action-routed tool(s) · 6 verbose 1:1 tool(s). Each is enabled unless its <DOMAIN>TOOL toggle is set false; MCP_TOOL_MODE selects the surface (intent default — the six verb-tools, granular set loaded on demand · condensed action-routed · verbose 1:1 · both). Auto-generated — do not edit.
Detailed tool schemas, parameter shapes, and validation constraints are preserved in docs/usage.md.
Dynamic Tool Selection & Visibility
This MCP server supports dynamic toolset selection and visibility filtering at runtime. This allows the operator to restrict the set of exposed tools to prevent blowing up the LLM's context window.
The operator can configure tool filtering via multiple input channels:
CLI Arguments: Pass
--toolsor--toolsets(or their disabled counterparts--disabled-toolsand--disabled-toolsets) during startup.Environment Variables: Define standard environment variables:
MCP_ENABLED_TOOLS/MCP_DISABLED_TOOLSMCP_ENABLED_TAGS/MCP_DISABLED_TAGS
HTTP SSE Request Headers: Pass custom headers during transport initialization:
x-mcp-enabled-tools/x-mcp-disabled-toolsx-mcp-enabled-tags/x-mcp-disabled-tags
HTTP SSE Request Query Parameters: Append query parameters directly to the operator's transport connection URL:
?tools=tool1,tool2?tags=tag1
When query strings or parameters are supplied, an LLM-free Knowledge Graph resolution layer (using DynamicToolOrchestrator) matches query intents against known tool tags, names, or descriptions, with safe fallback and automated 24-hour background cache refreshing.
MCP Configuration Examples
Install the connector-focused
[mcp]extra. Examples usetunnel-manager[mcp]to add FastMCP / FastAPI throughscion-sdk[mcp]; the required Meristem core still carriesmedulla[full]. The[agent-runtime]extra additionally enables model orchestration.
stdio Transport (local IDEs — Cursor, Claude Desktop, VS Code)
{
"mcpServers": {
"tunnel-manager-mcp": {
"command": "uvx",
"args": [
"--from",
"tunnel-manager[mcp]",
"tunnel-manager-mcp"
],
"env": {
"MCP_TOOL_MODE": "intent",
"FILETOOL": "True",
"HOSTTOOL": "True",
"INGESTTOOL": "True",
"INVENTORYTOOL": "True",
"OPERATIONSTOOL": "True",
"REMOTETOOL": "True",
"SECURITYTOOL": "True",
"SYSTEMTOOL": "True",
"TUNNEL_IDENTITY_FILE": "~/.ssh/id_ed25519",
"TUNNEL_INVENTORY_GROUP": "all",
"TUNNEL_KG_INGEST": "true",
"TUNNEL_KNOWN_HOSTS": "~/.ssh/known_hosts",
"TUNNEL_MANAGER_HEALTH_AGGREGATE_S": "3600",
"TUNNEL_MANAGER_HEALTH_INGEST": "true",
"TUNNEL_MANAGER_HOSTS": "node-a,node-b,node-c,node-d",
"TUNNEL_MAX_THREADS": "6",
"TUNNEL_PARALLEL": "False",
"TUNNEL_REMOTE_PORT": "22"
}
}
}
}Runtime references require an alias-aware launcher such as Arbora. Other launchers must omit those entries and inject the resolved values through their own runtime secret boundary.
Streamable-HTTP Transport (networked / production)
{
"mcpServers": {
"tunnel-manager-mcp": {
"command": "uvx",
"args": [
"--from",
"tunnel-manager[mcp]",
"tunnel-manager-mcp",
"--transport",
"streamable-http",
"--port",
"8000"
],
"env": {
"TRANSPORT": "streamable-http",
"HOST": "127.0.0.1",
"PORT": "8000",
"MCP_TOOL_MODE": "intent",
"FILETOOL": "True",
"HOSTTOOL": "True",
"INGESTTOOL": "True",
"INVENTORYTOOL": "True",
"OPERATIONSTOOL": "True",
"REMOTETOOL": "True",
"SECURITYTOOL": "True",
"SYSTEMTOOL": "True",
"TUNNEL_IDENTITY_FILE": "~/.ssh/id_ed25519",
"TUNNEL_INVENTORY_GROUP": "all",
"TUNNEL_KG_INGEST": "true",
"TUNNEL_KNOWN_HOSTS": "~/.ssh/known_hosts",
"TUNNEL_MANAGER_HEALTH_AGGREGATE_S": "3600",
"TUNNEL_MANAGER_HEALTH_INGEST": "true",
"TUNNEL_MANAGER_HOSTS": "node-a,node-b,node-c,node-d",
"TUNNEL_MAX_THREADS": "6",
"TUNNEL_PARALLEL": "False",
"TUNNEL_REMOTE_PORT": "22"
}
}
}
}Alternatively, connect to a pre-deployed Streamable-HTTP instance by url:
{
"mcpServers": {
"tunnel-manager-mcp": {
"url": "http://localhost:8000/tunnel-manager-mcp/mcp"
}
}
}Run a reviewed container image as a least-privilege stdio child (no listener or published port):
docker run -i --rm \
--read-only \
--cap-drop=ALL \
--security-opt=no-new-privileges \
--pids-limit=256 \
--tmpfs /tmp:rw,noexec,nosuid,nodev,size=64m \
-e TRANSPORT=stdio \
-e MCP_TOOL_MODE=intent \
-e FILETOOL=True \
-e HOSTTOOL=True \
-e INGESTTOOL=True \
-e INVENTORYTOOL=True \
-e OPERATIONSTOOL=True \
-e REMOTETOOL=True \
-e SECURITYTOOL=True \
-e SYSTEMTOOL=True \
-e TUNNEL_IDENTITY_FILE=~/.ssh/id_ed25519 \
-e TUNNEL_INVENTORY_GROUP=all \
-e TUNNEL_KG_INGEST=true \
-e TUNNEL_KNOWN_HOSTS=~/.ssh/known_hosts \
-e TUNNEL_MANAGER_HEALTH_AGGREGATE_S=3600 \
-e TUNNEL_MANAGER_HEALTH_INGEST=true \
-e TUNNEL_MANAGER_HOSTS=node-a,node-b,node-c,node-d \
-e TUNNEL_MAX_THREADS=6 \
-e TUNNEL_PARALLEL=False \
-e TUNNEL_REMOTE_PORT=22 \
registry.example.invalid/tunnel-manager@sha256:<digest> tunnel-manager-mcpFor containerized network HTTP, supply an authenticated TLS ingress (or
direct server TLS), exact MCP_ALLOWED_HOSTS, and an exact trusted-proxy
CIDR policy through the operator-owned deployment profile. The generator
does not emit an unauthenticated non-loopback listener.
Identity and host entitlements
Over stdio, and over HTTP started with --auth-type none (for example behind
arbora), every caller is the trusted local actor and reaches every inventory
alias. With auth configured, a caller reaches only the aliases its roles or
groups grant (ssh:<alias>, ssh:* or admin). A refusal names its cause:
anonymous caller, unauthenticated, no tenant, or not entitled to ssh:<alias>.
See scion-sdk's connector servers: caller identity.
Auto-generated from the code-read env surface (MCP_TOOL_MODE + package vars) — do not edit.
Additional Deployment Options
tunnel-manager can run as a local stdio process or container, or behind a remote
network boundary. The
Deployment guide carries
the detailed transport contract.
Local container — launch a reviewed immutable image as a least-privilege stdio child with no listener or published port.
Remote URL — connect through an operator-supplied authenticated HTTPS ingress. Keep its URL, outbound identity references, trust profile, and exact
MCP_ALLOWED_HOSTSinAgentConfig.
Inventory
tunnel-manager works from a single shared YAML inventory that maps short host
aliases (e.g. edge-node) to their SSH connection details. Every ecosystem surface reads
the same file — the HostManager API, the tunnel-manager CLI, the MCP server,
container-manager-mcp (its cm_* host aliases), and the ssh-bootstrap skill — so
the operator define the operator's fleet once.
Location —
~/.config/scion-sdk/inventory.yml(the only location). Override withTUNNEL_INVENTORY.Manage it with the
inventorysubcommand:tunnel-manager inventory init # write a commented inventory.yml template (--force to overwrite) tunnel-manager inventory doctor # validate hosts/groups tunnel-manager inventory show # print the resolved path + host/group summary
Full schema, every host field, the copy-paste template, and override options live in the Inventory guide.
Environment Variables
Package environment variables
Variable | Example | Description |
|
| |
|
| |
|
| options: stdio, streamable-http, sse |
|
| |
|
| |
| secret-injected | |
| secret-injected | |
|
| |
|
| options: none, embedded, remote |
|
| |
|
| |
|
| |
|
| |
|
| |
| — | default remote host (e.g. 198.51.100.10) |
|
| default SSH port |
| — | default SSH username |
| — | env://, vault://, secret://, or sqlite:// reference |
|
| independently verified server host keys |
| — | path to an SSH certificate file |
| — | SSH ProxyCommand for jump-host/bastion connections |
| — | path to the inventory file (defaults to XDG config path) |
|
| inventory host group to target |
|
| run host operations in parallel |
|
| max worker threads when TUNNEL_PARALLEL=True |
|
| |
|
| |
|
| |
|
| |
|
| |
| — | base config dir (defaults to ~/.config) for inventory resolution |
|
| Grouped condensed-surface toggles, one per register__tools registrar. |
|
| |
|
| |
|
| |
|
| |
|
| |
|
| |
|
| KG-ingest tools (list the SSH inventory into medulla) |
|
| default-on best-effort inventory ingest on |
|
| default-on best-effort network-signal trend ingestion |
|
| window (s) over which samples distill to ONE :HealthTrend node/host/signal |
|
| comma-separated inventory aliases to probe/derive over (default: full inventory) |
| — | best-effort webhook for network-anomaly notifications |
Inherited scion-sdk variables (apply to every connector)
Variable | Example | Description |
|
| Tool surface: |
| — | Comma-separated tool allow-list |
| — | Comma-separated tool deny-list |
| — | Comma-separated tag allow-list |
| — | Comma-separated tag deny-list |
| — | Outbound MCP child auth: |
| — | OIDC client id (service-account auth) |
|
| Runtime secret reference for the OIDC service account |
| — | HTTP Basic username ( |
|
| Runtime secret reference for HTTP Basic auth ( |
|
| URL of the MCP server the agent connects to |
|
| LLM provider for the agent |
|
| Model id for the agent |
|
| Serve the AG-UI web interface |
44 package + 14 inherited variable(s). Auto-generated from .env.example + the shared scion-sdk set — do not edit.
Every variable the server reads, grouped by purpose. See .env.example
for a copy-paste starting point.
SSH connection & credentials
Variable | Description | Default |
| Path to the SSH private key |
|
| SSH username | — |
|
| — |
| Independently checked SSH server-key trust store |
|
| Path to an SSH certificate | — |
| Default remote host | — |
| Default remote SSH port |
|
| SSH | — |
Inventory & parallelism
Variable | Description | Default |
| Path to the shared inventory ( |
|
| Default inventory host group | — |
| Run bulk operations in parallel | — |
| Max concurrent SSH worker threads | — |
| Base config dir used to resolve the inventory |
|
MCP server / transport
Variable | Description | Default |
|
|
|
| Bind host (HTTP transports) |
|
| Bind port (HTTP transports) |
|
| Tool surface: |
|
| Comma-separated tool allow/deny list | — |
| Comma-separated tag allow/deny list | — |
| Verbose logging |
|
| Unbuffered stdout (recommended in containers) |
|
Tool toggles
Each action-routed tool can be disabled individually via its toggle env var (set to false).
The full list is in the Available MCP Tools table above
(HOSTTOOL, REMOTETOOL, INVENTORYTOOL, OPERATIONSTOOL,
SYSTEMTOOL, FILETOOL, SECURITYTOOL).
Telemetry & governance
Variable | Description | Default |
| Enable OpenTelemetry export |
|
| OTLP collector endpoint | — |
| OTLP auth keys | — |
| OTLP protocol (e.g. | — |
| Authorization mode: |
|
| Embedded policy file |
|
| Remote Eunomia server URL | — |
Agent runtime (full [agent] runtime only)
Variable | Description | Default |
| URL of the MCP server the agent connects to |
|
| LLM provider (e.g. |
|
| Model id (e.g. |
|
| Serve the AG-UI web interface |
|
Agent
This repository features a fully integrated Pydantic AI Graph Agent. It communicates over the Agent Control Protocol (ACP) and interacts smoothly with the Agent Web UI (AG-UI) and Terminal interface.
Running the Agent CLI
To start the interactive command-line agent:
# Set credentials
export TUNNEL_IDENTITY_FILE="your_value"
export DEBUG="your_value"
export PYTHONUNBUFFERED="your_value"
# Run the agent server
tunnel-manager-agent --provider openai --model-id gpt-4oDocker Compose Orchestration
The following docker/agent.compose.yml configures the Agent, Web UI, and Terminal Interface together:
version: '3.8'
services:
tunnel-manager-mcp:
image: example/tunnel-manager:mcp
container_name: tunnel-manager-mcp
hostname: tunnel-manager-mcp
restart: always
env_file:
- ../.env
environment:
- PYTHONUNBUFFERED=1
- HOST=0.0.0.0
- PORT=8000
- TRANSPORT=streamable-http
ports:
- "8000:8000"
healthcheck:
test: ["CMD", "python3", "-c", "import urllib.request; urllib.request.urlopen('http://localhost:8000/health')"]
interval: 30s
timeout: 10s
retries: 3
start_period: 10s
logging:
driver: json-file
options:
max-size: "10m"
max-file: "3"
tunnel-manager-agent:
image: example/tunnel-manager@sha256:<digest>
container_name: tunnel-manager-agent
hostname: tunnel-manager-agent
restart: always
depends_on:
- tunnel-manager-mcp
env_file:
- ../.env
command: [ "tunnel-manager-agent" ]
environment:
- PYTHONUNBUFFERED=1
- HOST=0.0.0.0
- PORT=9002
- MCP_URL=http://tunnel-manager-mcp:8000/mcp
- PROVIDER=${PROVIDER:-openai}
- MODEL_ID=${MODEL_ID:-gpt-4o}
- ENABLE_WEB_UI=True
- ENABLE_OTEL=True
ports:
- "9002:9002"
healthcheck:
test: ["CMD", "python3", "-c", "import urllib.request; urllib.request.urlopen('http://localhost:9002/health')"]
interval: 30s
timeout: 10s
retries: 3
start_period: 10s
logging:
driver: json-file
options:
max-size: "10m"
max-file: "3"
Detailed graph node architecture explanations, custom skill configurations, and agentic trace guides are available in docs/deployment.md.
Security & Governance
Built directly upon the enterprise-ready scion-sdk core, standard security parameters are fully supported:
Access Control & Policy Enforcement
Eunomia Policies: Fine-grained, policy-driven tool authorization. Supports
none, localembedded(mcp_policies.json), or centralizedremotemodes.OIDC Token Delegation: Compliant with RFC 8693 token exchange for flowing authenticating user credentials from Web UI / ACP → Agent → MCP.
Scoped Credentials: Execution context runs restricted to the specific caller identity.
Runtime Security Grid
Feature | Feature | Enablement |
Tool Guard | Sensitivity inspection with human-in-the-loop validation | Enabled by default |
Prompt Injection Defense | Input scanning, repetition monitoring, and recursive loop blocks | Enabled by default |
Context Safety Guard | Stuck-loop detectors and contextual overflow preemptive alerts | Enabled by default |
Installation
Pick the extra that matches what the operator want to run:
Extra | Installs | Use when |
| Connector-focused MCP server ( | The operator only run the MCP server (smallest install / image) |
| Agent runtime ( | The operator run the integrated agent |
| Everything ( | Development / both surfaces |
# Connector-focused MCP server (includes the shared graph engine)
uv pip install "tunnel-manager[mcp]"
# Agent runtime (adds model orchestration to the shared graph engine)
uv pip install "tunnel-manager[agent]"
# Everything (development)
uv pip install "tunnel-manager[all]" # or: python -m pip install "tunnel-manager[all]"Container images (:mcp vs :agent)
One multi-stage docker/Dockerfile builds two right-sized images, selected by --target:
Image tag | Build target | Contents | Entrypoint |
|
|
|
|
|
|
|
|
docker build --target mcp -t example/tunnel-manager:mcp docker/ # connector-focused MCP server
docker build --target agent -t example/tunnel-manager:agent-local docker/ # agent runtimedocker/mcp.compose.yml runs the connector-focused :mcp server; docker/agent.compose.yml runs the
agent (immutable agent digest) with a co-located :mcp sidecar.
Knowledge-graph database (medulla)
Both [mcp] and [agent] carry the medulla engine through the required
Meristem core dependency (medulla[full]). The [mcp] extra keeps
the server connector-focused; [agent] also enables model orchestration. Local
deployments can use the bundled engine. For production or shared state, run
medulla as a dedicated database service and configure the runtime to use it.
Deployment recipes (single-node + Raft HA), connection configuration, and architecture
diagrams are documented in the
medulla deployment guide.
Documentation
The complete documentation is published as the official documentation site and is the recommended reference for installation, deployment, and day-to-day operation.
Page | Contents |
pip, source, extras, prebuilt Docker image | |
the shared | |
run the MCP and agent servers, Compose, Caddy + Technitium, env config | |
the MCP tools, the | |
ecosystem role, distributed SSH swarm scaling, MCP configuration | |
certificate, proxy and cross-OS connection model | |
concept registry ( |
AGENTS.md is the canonical contributor/agent guidance.
Maintainers
Maintained by the project contributor team. Package metadata intentionally uses a role address rather than personal identity.
Contribute
Contributions are welcome! Please ensure code quality by running local checks before submitting pull requests:
Format code using
ruff format .Lint code using
ruff check .Validate type-safety with
mypy .Run test suites using
pytest
Deploy with scion-sdk-deployment
Provision this package with the consolidated scion-sdk-deployment
workflow. It selects an installed-package, editable-source, or immutable-container
path; records only runtime secret and TLS-profile references in AgentConfig; and
runs doctor, registration, policy, observability, and rollback gates. Ask your agent
to "deploy tunnel-manager with scion-sdk-deployment".
Install mode | Command |
Installed package |
|
Editable source |
|
Immutable container | deploy |
The repository embeds no deployment profile, credential value, certificate path, or
environment-specific endpoint. Supply those at runtime through AgentConfig and the
configured secret provider.
Governed capability contract
This package ships a compact canonical skill surface with specialist procedures
kept as referenced workflows. The current MCP tools, skill metadata,
connector_manifest.yml, ontology, mappings, shapes, fixtures, migrations,
tool-schema fingerprints, and certification metadata form one versioned
capability contract. Validate them together; do not rely on stale tool names or
historical per-task skill wrappers.
Runtime endpoints, credentials, certificate trust, tenant identity, retention, and observability policy are deployment inputs and are never packaged values. See Configuration, trust, and privacy before enabling a network transport, connector ingestion, Arbora delegation, or trace export.
Available Tools
41 toolstm_file_backupBackupC
Backup (tm_files). Advanced file operations on remote hosts.
Inputs: mode, group, host1, host2, +20 more. Returns: object
tm_file_content_searchContent SearchCRead-onlyIdempotent
Content search (tm_files). Advanced file operations on remote hosts.
Inputs: mode, group, host1, host2, +20 more. Returns: object
tm_file_diff_compareDiff CompareCRead-onlyIdempotent
Diff compare (tm_files). Advanced file operations on remote hosts.
Inputs: mode, group, host1, host2, +20 more. Returns: object
tm_file_recursive_opsRecursive OpsC
Recursive ops (tm_files). Advanced file operations on remote hosts.
Inputs: mode, group, host1, host2, +20 more. Returns: object
tm_file_watchWatchC
Watch (tm_files). Advanced file operations on remote hosts.
Inputs: mode, group, host1, host2, +20 more. Returns: object
tm_inventory_configure_key_authConfigure Key AuthC
Configure key auth (tm_inventory). Bulk inventory operations against YAML host groups.
Inputs: cfg, cmd, key, host, +12 more. Returns: object
tm_inventory_copy_ssh_configCopy Ssh ConfigC
Copy ssh config (tm_inventory). Bulk inventory operations against YAML host groups.
Inputs: cfg, cmd, key, host, +12 more. Returns: object
tm_inventory_mesh_bootstrapMesh BootstrapC
Mesh bootstrap (tm_inventory). Bulk inventory operations against YAML host groups.
Inputs: cfg, cmd, key, host, +12 more. Returns: object
tm_inventory_receive_fileReceive FileC
Receive file (tm_inventory). Bulk inventory operations against YAML host groups.
Inputs: cfg, cmd, key, host, +12 more. Returns: object
tm_inventory_rotate_keyRotate KeyCDestructiveIdempotent
Rotate key (tm_inventory). Bulk inventory operations against YAML host groups.
Inputs: cfg, cmd, key, host, +12 more. Returns: object
tm_inventory_run_commandRun CommandC
Run command (tm_inventory). Bulk inventory operations against YAML host groups.
Inputs: cfg, cmd, key, host, +12 more. Returns: object
tm_inventory_send_fileSend FileC
Send file (tm_inventory). Bulk inventory operations against YAML host groups.
Inputs: cfg, cmd, key, host, +12 more. Returns: object
tm_operation_cancelCancelCDestructiveIdempotent
Cancel (tm_operations). Operation lifecycle and session management.
Inputs: confirm, details, total_steps, operation_id, +1 more. Returns: object
tm_operation_get_metricsGet MetricsCRead-onlyIdempotent
Get metrics (tm_operations). Operation lifecycle and session management.
Inputs: confirm, details, total_steps, operation_id, +1 more. Returns: object
tm_operation_get_progressGet ProgressCRead-onlyIdempotent
Get progress (tm_operations). Operation lifecycle and session management.
Inputs: confirm, details, total_steps, operation_id, +1 more. Returns: object
tm_operation_list_sessionsList SessionsCRead-onlyIdempotent
List sessions (tm_operations). Operation lifecycle and session management.
Inputs: confirm, details, total_steps, operation_id, +1 more. Returns: object
tm_operation_startStartC
Start (tm_operations). Operation lifecycle and session management.
Inputs: confirm, details, total_steps, operation_id, +1 more. Returns: object
tm_remote_check_sshCheck SshCRead-onlyIdempotent
Check ssh (tm_remote). Single-host SSH operations with shared connection params.
Inputs: cfg, cmd, key, host, +15 more. Returns: object
tm_remote_copy_ssh_configCopy Ssh ConfigC
Copy ssh config (tm_remote). Single-host SSH operations with shared connection params.
Inputs: cfg, cmd, key, host, +15 more. Returns: object
tm_remote_receive_fileReceive FileC
Receive file (tm_remote). Single-host SSH operations with shared connection params.
Inputs: cfg, cmd, key, host, +15 more. Returns: object
tm_remote_remove_host_keyRemove Host KeyCDestructiveIdempotent
Remove host key (tm_remote). Single-host SSH operations with shared connection params.
Inputs: cfg, cmd, key, host, +15 more. Returns: object
tm_remote_rotate_keyRotate KeyCDestructiveIdempotent
Rotate key (tm_remote). Single-host SSH operations with shared connection params.
Inputs: cfg, cmd, key, host, +15 more. Returns: object
tm_remote_run_commandRun CommandC
Run command (tm_remote). Single-host SSH operations with shared connection params.
Inputs: cfg, cmd, key, host, +15 more. Returns: object
tm_remote_send_fileSend FileC
Send file (tm_remote). Single-host SSH operations with shared connection params.
Inputs: cfg, cmd, key, host, +15 more. Returns: object
tm_remote_setup_passwordlessSetup PasswordlessC
Setup passwordless (tm_remote). Single-host SSH operations with shared connection params.
Inputs: cfg, cmd, key, host, +15 more. Returns: object
tm_remote_test_key_authTest Key AuthCRead-onlyIdempotent
Test key auth (tm_remote). Single-host SSH operations with shared connection params.
Inputs: cfg, cmd, key, host, +15 more. Returns: object
tm_security_access_control_auditAccess Control AuditCRead-onlyIdempotent
Access control audit (tm_security). Security scanning and compliance.
Inputs: remote_host (required), scope, standard, username, +3 more. Returns: object
tm_security_compliance_checkCompliance CheckCRead-onlyIdempotent
Compliance check (tm_security). Security scanning and compliance.
Inputs: remote_host (required), scope, standard, username, +3 more. Returns: object
tm_security_security_auditSecurity AuditCRead-onlyIdempotent
Security audit (tm_security). Security scanning and compliance.
Inputs: remote_host (required), scope, standard, username, +3 more. Returns: object
tm_security_vulnerability_scanVulnerability ScanCRead-onlyIdempotent
Vulnerability scan (tm_security). Security scanning and compliance.
Inputs: remote_host (required), scope, standard, username, +3 more. Returns: object
tm_system_analyze_logsAnalyze LogsCRead-onlyIdempotent
Analyze logs (tm_system). Remote system intelligence via SSH.
Inputs: remote_host (required), patterns, username, log_paths, +2 more. Returns: object
tm_system_discover_servicesDiscover ServicesCRead-onlyIdempotent
Discover services (tm_system). Remote system intelligence via SSH.
Inputs: remote_host (required), patterns, username, log_paths, +2 more. Returns: object
tm_system_get_infoGet InfoCRead-onlyIdempotent
Get info (tm_system). Remote system intelligence via SSH.
Inputs: remote_host (required), patterns, username, log_paths, +2 more. Returns: object
tm_system_network_topologyNetwork TopologyC
Network topology (tm_system). Remote system intelligence via SSH.
Inputs: remote_host (required), patterns, username, log_paths, +2 more. Returns: object
tunnel_ingest_hostsIngest Hosts to Knowledge GraphBRead-onlyIdempotent
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.
Inputs: group. Returns: object
tunnel_manager_add_hostAdd hostD
Invoke the add_host operation.
Inputs: user (required), alias (required), hostname (required), port, +6 more.
tunnel_manager_get_hostGet hostARead-onlyIdempotent
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.
Inputs: alias (required).
tunnel_manager_list_hostsList hostsARead-onlyIdempotent
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.
Inputs: no named parameters.
tunnel_manager_load_inventoryLoad inventoryC
Invoke the load_inventory operation.
Inputs: no named parameters.
tunnel_manager_remove_hostRemove hostDDestructive
Invoke the remove_host operation.
Inputs: alias (required), confirm.
tunnel_manager_save_inventorySave inventoryC
Invoke the save_inventory operation.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
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.
Maintenance
Related MCP Connectors
SSH client, server management and one remote MCP URL for your machines, with human approvals.
One MCP server for all your MCP servers: code mode, per-tool permissions, approvals and audit.
Related MCP Servers
- AlicenseBqualityCmaintenanceA server that enables secure interaction with remote SSH hosts through standardized MCP interface, providing functions like listing hosts, executing commands, and transferring files using native SSH tools.7558 npm105MIT
- AlicenseNot gradedqualityDmaintenanceMCP server for SSH remote execution, file transfer, and file editing with automatic backup/trash and ~/.ssh/config integration.117 npm1MIT
- AlicenseAqualityDmaintenanceMCP server for managing remote servers via SSH, enabling command execution, file transfer, rsync, tunnels, health checks, backups, and database operations.171MIT
- AlicenseNot gradedqualityCmaintenanceMCP server providing safe, persistent SSH sessions to remote machines with multi-hop ProxyJump tunneling, SFTP file transfer, and stored host profiles.524 npmMIT