Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| ssh_ping | Health check. |
| ssh_list_hosts | List configured hosts. |
| ssh_describe_host | Return host definition in JSON. |
| ssh_plan | Show what would be executed and if policy allows. |
| ssh_run | Execute SSH command with policy, network checks, progress, timeout, and cancellation. |
| ssh_run_on_tag | Execute SSH command on all hosts with a tag (with network checks). |
| ssh_cancel | Request cancellation for a running task. |
| ssh_reload_config | Reload configuration files. |
| ssh_run_async | Start SSH command asynchronously (SEP-1686 compliant). Returns immediately with task_id for polling. Use ssh_get_task_status
and ssh_get_task_result to monitor and retrieve results. |
| ssh_get_task_status | Get current status of an async task (SEP-1686 compliant). Returns task state, progress, elapsed time, and output summary. |
| ssh_get_task_result | Get final result of completed task (SEP-1686 compliant). Returns complete output, exit code, and execution metadata. |
| ssh_get_task_output | Get recent output lines from running or completed task. Enhanced beyond SEP-1686: enables streaming output visibility. |
| ssh_cancel_async_task | Cancel a running async task. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| ssh_orchestrator_usage | Explain how to safely use the SSH orchestration tools. This is exposed as a prompt template to MCP clients. |
| ssh_policy_denied_guidance | How the LLM should respond when a command is denied by policy. |
| ssh_network_denied_guidance | How the LLM should respond when network policy denies a host. |
| ssh_missing_host_guidance | What to do when a host alias doesn't exist in servers.yml. |
| ssh_missing_credentials_guidance | How to handle missing or incomplete credentials entries. |
| ssh_config_change_workflow | Global rules for suggesting config changes (servers, credentials, policy). |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| resource_hosts | Sanitized inventory of all configured host aliases. |