ssh_upload

Upload files to a remote host over SSH with atomic writes.

6|Updated Apr 17, 2026
One-click install
npx skills add https://github.com/Nightreaver/python-ssh-mcp --skill ssh-upload
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ssh_upload
Source: https://github.com/Nightreaver/python-ssh-mcp/tree/main/skills/ssh-upload
Command: npx skills add https://github.com/Nightreaver/python-ssh-mcp --skill ssh-upload

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Simplifies file transfer tasks on SSH-connected hosts by enabling secure and atomic uploads, minimizing the risk of interrupted transfers.

Core Features & Use Cases

  • Secure Atomic Uploads: Transfer files securely over SSH connections using an atomic method, reducing the likelihood of interrupted uploads.
  • Variety of Payloads: Support for text, base64-encoded binaries, or direct streaming from a local file system path on the SSH host.
  • Use Case: When needing to deploy a new version of an application, the ssh_upload skill allows for seamless file uploads of both configuration files and large binary files, up to 2 GiB, to ensure the transfer is robust and the new files are available even in the event of connection loss.

Quick Start

To upload the latest configuration file for your app on host 'server01', use:

ssh_upload --host server01 --path /etc/config/latest-config.yaml --content_text '/path/to/config'

Frequently Asked Questions about ssh_upload

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I securely upload files over SSH to minimize disruption during network outages?

Securely uploading files over SSH atomically writes data to the remote host, ensuring the new file is fully available before replacing the old one to prevent partial transfers during network outages.

What is the maximum file size limit for SSH file transfers using base64 payloads?

The maximum file size limit for base64 payloads in SSH file transfers is 256 MiB. Files exceeding this limit are handled via direct streaming uploads from the local system to avoid context channel bottlenecks.

How do I atomically upload a configuration file to a remote SSH host?

To atomically upload a configuration file to a remote SSH host, provide the target server address, destination path, and local file path to securely transfer the text content and ensure the file updates without interruption.

Can I stream large binary files directly from my local system to a remote SSH host?

Yes, you can stream large binary files directly from your local system to a remote SSH host. This streaming upload method bypasses the 256 MiB limit and prevents context channel bottlenecks for files up to 2 GiB.

Why use an atomic write for remote SSH file uploads?

Using an atomic write for remote SSH file uploads minimizes disruption by ensuring the remote file remains intact if the connection drops, significantly reducing the risk of deploying interrupted or corrupted transfers.

Does SSH secure upload support both text and binary payloads?

Yes, SSH secure upload supports both text and binary payloads. Text payloads are transferred directly, while binary payloads are securely uploaded using base64 encoding up to a 256 MiB limit.