ssh_upload_directory

Upload a local directory and all its contents to a remote SSH server. This tool recursively transfers a local directory to the specified remote path, preserving the directory structure using SFTP protocol. Args: - host (string): SSH server hostname or IP address - port (number): SSH server port (...

Server SSH MCP Server lazyst/agent-ssh
Category Write
Risk class Medium
Parameters 00 required

What ssh_upload_directory does on SSH MCP Server

AI agents use ssh_upload_directory to create or update resources in SSH MCP Server — usually the action step of a workflow, after the agent has gathered context. Every call changes real data in your SSH MCP Server environment.

Why ssh_upload_directory needs a policy

This tool creates or modifies data on remote servers by uploading entire directory structures. While reversible (directories can be deleted), it allows mass file creation/modification with broad blast radius if an AI agent targets the wrong host or uploads malicious content.

From the tool's definition Tool description states it "Upload a local directory and all its contents to a remote SSH server" and "recursively transfers a local directory to the specified remote path". This is a write operation that creates/modifies data on a remote system.

Questions about ssh_upload_directory

What does the ssh_upload_directory tool do? +

Upload a local directory and all its contents to a remote SSH server. This tool recursively transfers a local directory to the specified remote path, preserving the directory structure using SFTP protocol. Args: - host (string): SSH server hostname or IP address - port (number): SSH server port (default: 22) - username (string): SSH username - password (string): SSH password (optional if privateKey is provided) - privateKey (string): Path to private key file or private key content (optional) - timeout (number): Connection timeout in milliseconds (default: 30000) - local_path (string): Local directory path to upload - remote_path (string): Destination path on the remote server - response_format (. It is categorised as a Write tool in the SSH MCP Server MCP Server, which means it can create or modify data. Consider rate limits to prevent runaway writes.

How do I enforce a policy on ssh_upload_directory? +

Register the SSH MCP Server MCP server in PolicyLayer and add a rule for ssh_upload_directory: allow, deny, rate-limit, or require approval. Point your MCP client at the PolicyLayer proxy URL and the rule is enforced on every call, before it reaches SSH MCP Server. Nothing to install.

What risk level is ssh_upload_directory? +

ssh_upload_directory is a Write tool with medium risk. Write tools should be rate-limited to prevent accidental bulk modifications.

Can I rate-limit ssh_upload_directory? +

Yes. Add a rate_limit block to the ssh_upload_directory rule in your PolicyLayer policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.

How do I block ssh_upload_directory completely? +

Set action: deny in the PolicyLayer policy for ssh_upload_directory. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.

What MCP server provides ssh_upload_directory? +

ssh_upload_directory is provided by the SSH MCP Server MCP server (lazyst/agent-ssh). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.

// LOOK UP ANOTHER SERVER

Every MCP server has a record like this.

Type a name, get the same breakdown: verified identity, auth posture, risk grade, capabilities, recommended policy.

Teams ship this data inside their own products. See what a licence covers →

// GET IN TOUCH

Have a question or want to learn more? Send us a message.

Message sent.

We'll get back to you soon.