{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_ejj52nxzk9ca","handle":"mcp-ssh-multi","url":"https://wellknown.network/agents/mcp-ssh-multi","links":{"self":"https://wellknown.network/agents/mcp-ssh-multi/record.json","html":"https://wellknown.network/agents/mcp-ssh-multi","markdown":"https://wellknown.network/agents/mcp-ssh-multi/record.md","api":"https://wellknown.network/api/v1/agents/mcp-ssh-multi","status":"https://wellknown.network/api/v1/agents/mcp-ssh-multi/status","claim":"https://wellknown.network/agents/mcp-ssh-multi/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mcp-ssh-multi/claim.json","badge":"https://wellknown.network/agents/mcp-ssh-multi/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mcp-ssh-multi/history","tools":"https://wellknown.network/api/v1/agents/mcp-ssh-multi/tools"},"ard":{"identifier":"urn:air::server:mcp-ssh-multi","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mcp-ssh-multi","summary":"MCP SSH Multi - Multi-server SSH access through MCP","description":"# mcp-ssh-multi\n\nMCP server for managing multiple SSH servers through AI assistants. Provides 11 tools for remote command execution, file operations, and system monitoring.\n\n**Current version: 0.4.0**\n\n## Features\n\n- **Multi-server management** — Configure and manage multiple SSH servers from a single YAML file\n- **Connection pooling** — Automatic connection reuse with per-server locks and retry on stale connections\n- **Bounded command output** — Streams stdout/stderr with a configurable combined memory limit\n- **Timeout cleanup** — Terminates timed-out remote processes and explicitly closes their SSH channels\n- **11 MCP tools** — Execute commands, transfer files, read/write files, tail logs, list processes\n- **Two transports** — stdio (for local MCP clients) and streamable-http (for web/remote)\n- **Cloudflare Tunnel compatible** — Deploy behind a tunnel for remote access\n- **MCP tool annotations** — Hints for destructive, read-only, idempotent, and open-world operations\n- **MCP resources** — `ssh://servers` resource for listing configured servers\n- **Pagination** — Directory listings support `limit`/`offset` for large directories\n- **Input validation** — Path and filter sanitization to prevent command injection\n- **Structured errors** — Consistent error responses with codes, messages, and suggestions\n\n## Installation\n\n### Using uv (recommended)\n\n```bash\nuv tool install mcp-ssh-multi\n```\n\n### Using pip\n\n```bash\npip install mcp-ssh-multi\n```\n\n### Using uvx (one-shot)\n\n```bash\nuvx --from mcp-ssh-multi ssh-mcp\n```\n\n### From source\n\n```bash\ngit clone https://github.com/gilberth/mcp-ssh-multi.git\ncd mcp-ssh-multi\nuv sync\n```\n\n## Configuration\n\n### 1. SSH Servers (ssh_servers.yaml)\n\nCreate a `ssh_servers.yaml` file with your server definitions:\n\n```yaml\nservers:\n  proxmox:\n    host: 192.168.1.100\n    port: 22\n    username: root\n    key_file: ~/.ssh/id_rsa\n    description: \"Proxmox VE hypervisor\"\n\n  truenas:\n    host: 192.168.1.101\n    port: 22\n    username: root\n    pass…","publisher":{"name":"Gilberth","url":null},"homepage":"https://github.com/gilberth/mcp-ssh-multi","repository":"https://github.com/gilberth/mcp-ssh-multi/issues","version":"0.4.0","license":"MIT","protocols":["mcp"],"tags":["mcp","ssh","ai","automation","server-management"],"pricing":null,"endpoints":[{"url":"pypi:mcp-ssh-multi","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"dev.filesystem","name":"Filesystem","confidence":1,"provenance":"derived"},{"slug":"dev.monitoring","name":"Monitoring & Observability","confidence":0.802,"provenance":"derived"},{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"},{"slug":"dev.ci-cd","name":"CI/CD & Deploy","confidence":0.733,"provenance":"derived"}],"categories":["dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"mcp-ssh-multi","registry":"pypi","observedAt":"2026-11-03T16:26:00.860Z","publishedAt":"2026-08-11T04:45:52.477671Z","latestVersion":"0.4.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mcp-ssh-multi","url":"https://pypi.org/project/mcp-ssh-multi/","firstSeenAt":"2026-09-10T04:23:18.646Z","fetchedAt":"2026-11-03T16:24:28.409Z","normalizedAt":"2026-11-03T16:24:28.409Z"}]},"firstSeenAt":"2026-09-10T04:23:18.646Z","updatedAt":"2026-11-03T16:26:00.860Z"}