Keelstitch
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Keelstitch
An open-source tool from X3N LLC.
Approved SSH actions for agents and terminals. Keelstitch exposes named actions on machines you administer through a JSON CLI and a local MCP stdio server. It does not give the agent a remote shell, command arguments, or a way to choose its own SSH destination.
Preview: Not recommended for production or privileged accounts. See SECURITY.md for deployment boundaries and private reporting.
Quickstart
From the source checkout, install with uv tool install . (Python 3.11+). Or run directly with uv run keelstitch.
On your server, provision a dedicated least-privileged SSH account and a wrapper such as
/usr/local/libexec/keelstitch-health. Make the wrapper operator-owned; it should require no arguments and print only information you're comfortable sending to your agent. Authorize the dedicated client key. For a single action, restrict that key on the server with OpenSSH'srestrict,command="/usr/local/libexec/keelstitch-health"authorized_keys options.Create an operator-controlled
policy.json. Replace the placeholders with the server hostname, the server's verified public host key (not your client key), and the absolute path to the dedicated client private key. Obtain the host key over a trusted channel, not from the unverified connection that you're trying to establish. Use a dedicated key available non-interactively; no passwords, passphrase prompts, or SSH agent are used.
{
"targets": {
"staging": {
"host": "staging.example.com",
"username": "observer",
"port": 22,
"host_key": "ssh-ed25519 REPLACE_WITH_VERIFIED_HOST_PUBLIC_KEY",
"identity_file": "/absolute/path/to/keelstitch-client-key",
"actions": {
"health": {
"command": "/usr/local/libexec/keelstitch-health",
"description": "Report staging service health",
"timeout_seconds": 15,
"max_output_bytes": 16384
}
}
}
}
}Discover and call the action:
keelstitch --policy /absolute/path/policy.json list
keelstitch --policy /absolute/path/policy.json run staging healthBoth commands emit JSON. run returns ok, status, exit_code, stdout, and stderr; it exits zero only on successful remote completion (nonzero otherwise; CLI syntax errors use argparse's exit status 2).
MCP (stdio)
Point your client's stdio configuration at the installed executable. Use its absolute path if your client doesn't inherit your terminal's PATH:
{
"mcpServers": {
"keelstitch": {
"command": "/absolute/path/to/keelstitch",
"args": ["--policy", "/absolute/path/policy.json", "mcp"]
}
}
}list_actions()lists target/action aliases and descriptions, not endpoints or credential paths.run_action(target, action)returns the same result fields as the CLI. Checkokandstatus, rather than assuming a received MCP response means the action succeeded.
Related MCP server: AI Ops MCP
Trust boundary
Keelstitch is a capability interface, not a sandbox or production access broker. The operator owns the policy and identity file; the MCP caller must not be able to edit them or use the credential through another tool. In particular, handing a shell-capable agent the same OS permissions as the MCP process may defeat that separation. Enforce least privilege and command restrictions on the SSH server too. Actions can have side effects; descriptions do not enforce read-only behavior. Treat SSH output as untrusted data, not as instructions to the agent; it can contain secrets or adversarial text. Use a trusted MCP client and keep policies and credentials out of source control.
A policy is read at startup; restart the MCP server after changes. Actions are fixed absolute executable paths with no arguments. SSH config and agent discovery are disabled, and a host key mismatch is rejected. No PTY or interactive input is exposed. Defaults: 15 seconds end-to-end per admitted call, 16 KiB combined raw stdout/stderr. The MCP process admits one active run at a time. A timeout or output overflow closes the SSH connection and does not guarantee termination or rollback on the server. No actions are retried automatically.
Development
uv sync --locked
uv run --locked python -m unittest discover -s tests -v
uv buildTests use a loopback-only SSH fixture and generated keys. MIT licensed.
__ __ ____ _ _
\ \ / / |___ \ | \ | |
\ V / __) | | \| |
> < |__ < | . ' |
/ . \ ___) | | |\ |
/_/ \_\ |____/ |_| \_|Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
SSH client, server management and one remote MCP URL for your machines, with human approvals.
MCP server for mandates, delegation, policy-gated execution, credential grants, and audit.
Scoped, audited SSH exec, sessions, and SFTP on your saved servers without exposing credentials
Linux server administration over OAuth MCP: shell, Docker, systemd, files and monitoring.
Related MCP Servers
- FlicenseAqualityBmaintenanceCross-platform MCP server for policy-controlled command execution on Linux and Windows, with no SSH dependency.3-
- AlicenseNot gradedqualityCmaintenanceLocal SSH credential broker and stdio MCP server that enables AI clients to perform SSH and SFTP operations via stable server_id aliases without exposing passwords, private keys, or passphrases.1MIT
- AlicenseNot gradedqualityCmaintenanceProvides an MCP stdio interface for AI agents to propose tool calls that are validated against task policy, held for human approval when required, executed in a sandboxed Linux environment, and recorded in an audit log.MIT
- AlicenseNot gradedqualityAmaintenanceEnables AI agents to remotely execute shell commands and transfer files on SSH hosts, including jump-host tunneling, background tasks, resumable transfers, and optional approval of destructive commands, while SSH credentials remain in the local process. It runs over stdio or a streamable HTTP daemon and supports auditing, allow/deny lists, and multiple authentication methods.ISC