Schema | Sympathy-MCP

Server Configuration

Describes the environment variables required to run the server.

Name	Required	Description	Default
No arguments

Capabilities

Features and capabilities supported by this server

Capability	Details
`tools`	{ "listChanged": false }
`prompts`	{ "listChanged": false }
`resources`	{ "subscribe": false, "listChanged": false }
`experimental`	{}

Tools

Functions exposed to the LLM to take actions

Name	Description
vm_exec	Execute a command on a remote host via SSH. Runs the command via `sh -c` so shell features (pipes, redirects, etc.) work as expected. Captures both stdout and stderr. Args: vm: Name of the host (as configured in hosts.toml). command: Shell command to execute. workdir: Working directory on the remote host (default: /). timeout: Maximum seconds to wait (default: 120). Returns: Command output with stdout, stderr, and exit code.
vm_file_read	Read a file from a remote host via SSH. `Args: vm: Name of the host (as configured in hosts.toml). path: Absolute path to the file on the remote host. Returns: File contents as a string, or an error message.`
vm_file_write	Write content to a file on a remote host via SSH. `Handles arbitrary content safely by piping through SSH stdin. Args: vm: Name of the host (as configured in hosts.toml). path: Absolute path where the file should be written. content: The content to write to the file. Returns: Success confirmation or error message.`
vm_file_push	Push a file from the local host to a remote host via SCP. `Args: vm: Name of the host (as configured in hosts.toml). local_path: Path to the file on the local host. remote_path: Absolute destination path on the remote host. Returns: Success confirmation or error message.`
vm_file_pull	Pull a file from a remote host to the local host via SCP. `Args: vm: Name of the host (as configured in hosts.toml). remote_path: Absolute path to the file on the remote host. local_path: Destination path on the local host. Returns: Success confirmation or error message.`
vm_snapshot	Create a snapshot of a VM/container (Incus). `Args: vm: Name of the VM or container. name: Name for the snapshot (alphanumeric, hyphens, underscores). Returns: Success confirmation or error message.`
vm_restore	Restore a VM/container to a named snapshot (Incus). `Args: vm: Name of the VM or container. snapshot: Name of the snapshot to restore. Returns: Success confirmation or error message.`
vm_status	Get the status of a VM/container (Incus). `Returns state (running/stopped), IP address, resource usage, and available snapshots. Args: vm: Name of the VM or container. Returns: Formatted status information or error message.`
vm_list	List all available VMs and containers with their status (Incus). `Returns: Formatted list of all instances, or a message if none exist.`

Prompts

Interactive templates invoked by user choice

Name	Description
No prompts

Resources

Contextual data attached and managed by the client

Name	Description
No resources

Sympathy-MCP

Server Configuration

Capabilities

Tools

Prompts

Resources

Latest Blog Posts

MCP directory API