sftp_transfer
Download or upload a file between a preset SSH host and the local machine using get/put direction, with allow-listed paths and key-based, host-verified authentication.
Instructions
Transfer a file between the preset's SSH host and the local
machine. direction must be "get" (download) or "put" (upload).
The remote path must match the preset's sftp_allowed_paths
prefixes; the local path must be under $HOME or /tmp (and the
preset's allowed_local_paths, if set), not a hard link, and not
where credentials or startup files live (~/.ssh, ~/.aws, shell rc
files, agent configs, mcp-warden's config). Always key-based auth,
host-key verified. If the user previously approved
a time-boxed window for this preset+action, the call proceeds
without a new prompt and is recorded as 'windowed' in the audit
log.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"preset_name": "<preset_name>",
"direction": "<direction>",
"remote": "<remote>",
"local": "<local>"
},
"name": "sftp_transfer"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| local | Yes | ||
| remote | Yes | ||
| direction | Yes | "get" (download) or "put" (upload). | |
| preset_name | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| bytes | Yes | ||
| local | Yes | ||
| remote | Yes | ||
| direction | Yes |