Establish or switch the active connection to a specific remote server profile defined in your .ftpconfig (e.g., 'production', 'staging'). This is the first step before performing any remote operations.

Execute a pre-defined deployment preset from .ftpconfig. This typically maps a specific local folder to a remote target with pre-configured exclusion rules.

List all available deployment presets from .ftpconfig

List files and directories in a remote path. Use 'limit' and 'offset' for pagination when dealing with directories containing hundreds of files to avoid context overflow.

Read the source text of a remote file. CRITICAL: For large files, use 'startLine' and 'endLine' to extract specific chunks and prevent hitting the LLM context limit.

Apply a Unified Diff patch to a remote file. RECOMMENDED: Use this instead of ftp_put_contents for updating existing files to minimize bandwidth and ensure atomic-like updates. For new files, use ftp_put_contents.

Introspect the remote directory to identify technical environments (e.g., Node.js, PHP, Python) and read dependency manifests. Use this to gain architectural context of a new codebase.

Write raw text directly to a remote destination. Best for creating NEW files. For modifying existing files, prefer ftp_patch_file.

Retrieve comprehensive metadata for a remote property, including size, modification timestamps, and UNIX permissions.

Check for the existence of a file or folder without performing heavy file operations. Use this for conditional logic workflows.

Generate a complete recursive directory map. Use this to visualize project structure, but be cautious with 'maxDepth' in very large remote repositories to avoid excessive network payload.

Advanced remote file search. Supports finding files by name (wildcards), extension, or content regex (grep-like). Use this to find specific code patterns across the remote workspace.

Directly duplicate a file on the remote server without downloading and re-uploading. CRITICAL: Only supported on SFTP connections.

Upload a collection of local files to remote destinations in a single operation. HIGHLY RECOMMENDED for multiple files to minimize connection handshaking overhead and drastically improve performance.

Download a selection of remote files to local destinations. HIGHLY RECOMMENDED for bulk downloads to leverage stable socket persistence.

Deploy entire project folders using smart synchronization. Analyzes local and remote directory trees and only transfers files that have changed in size or modification date. Automatically respects .gitignore and .ftpignore.

Query the remote server for available disk space. CRITICAL: Only available on SFTP connections.

Standard single-file transport to the remote server. For bulk transfers, favor ftp_batch_upload.

Standard single-file transport from the remote server. For bulk downloads, favor ftp_batch_download.

Permanently remove a file from the remote server. Use with caution.

Create a new directory structure on the remote server. Supports nested creation (mkdir -p).

Delete a directory from the remote server.

Change remote file permissions. CRITICAL: Only supported on SFTP connections.

Move or rename files and directories on the remote server.

Undo a previous file mutation by restoring it from a system-generated snapshot. This provides safety during complex refactoring tasks.

Expose all recent mutations currently stored in the system's SnapshotManager. Essential for planning rollbacks.

Scan the remote server to determine supported filesystem features (e.g., chmod availability, symlink support, disk space querying). Helpful for troubleshooting capabilities.

Retrieve internal performance metrics, including average latency, connection pool health, and total processed bytes.