ftp-deploy-mcp

List a remote directory

ftp_list

Read-onlyIdempotent

List the contents of a remote FTP directory, with directories shown first. Browse remote files and folders before deploying, using path, limit, and offset to page through entries.

Instructions

List the contents of a remote directory (relative to the server root). Directories are listed first.

Input Schema

Name	Required	Description
`path`	No	Remote directory, relative to the server root. Defaults to the root.
`limit`	No	Maximum entries to return (default 50, maximum 200).
`offset`	No	Zero-based entry offset (default 0).
`server`	No	Name of the configured server. Defaults to the configured default, or the sole server.

Output Schema

Name	Required	Description	Default
No arguments

Schema Changelog

Changes observed during successful MCP inspections.

Changed2 schema fields changedv0.3.2Oct 17, 2026

addedInput schema / properties / offset / maximum
```
Added value: +9007199254740991
```

changedOutput schema / oneOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "count": {
-        "minimum": 0,
-        "type": "integer"
-      },
-      "entries": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "modified_at": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "name": {
-              "type": "string"
-            },
-            "size_bytes": {
-              "minimum": 0,
-              "type": "number"
-            },
-            "type": {
-              "enum": [
-                "dir",
-                "file",
-                "link"
-              ],
-              "type": "string"
-            }
-          },
-          "required": [
-            "name",
-            "type",
-            "size_bytes",
-            "modified_at"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "has_more": {
-        "type": "boolean"
-      },
-      "limit": {
-        "maximum": 200,
-        "minimum": 1,
-        "type": "integer"
-      },
-      "next_offset": {
-        "anyOf": [
-          {
-            "minimum": 0,
-            "type": "integer"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "offset": {
-        "minimum": 0,
-        "type": "integer"
-      },
-      "path": {
-        "type": "string"
-      },
-      "security_warning": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "server": {
-        "type": "string"
-      },
-      "total": {
-        "minimum": 0,
-        "type": "integer"
-      }
-    },
-    "required": [
-      "server",
-      "path",
-      "total",
-      "count",
-      "offset",
-      "limit",
-      "has_more",
-      "next_offset",
-      "entries",
-      "security_warning"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "error": {
-        "additionalProperties": false,
-        "properties": {
-          "code": {
-            "enum": [
-              "CONFIG_REQUIRED",
-              "CONFIG_INVALID",
-              "SERVER_REQUIRED",
-              "SERVER_UNKNOWN",
-              "INVALID_ARGUMENT",
-              "READ_ONLY",
-              "TRANSPORT_POLICY",
-              "HOST_KEY_REJECTED",
-              "REMOTE_ROOT_REJECTED",
-              "PATH_REJECTED",
-              "NOT_FOUND",
-              "ALREADY_EXISTS",
-              "TRANSFER_LIMIT",
-              "TRANSFER_VERIFY",
-              "TARGET_CHANGED",
-              "CANCELLED",
-              "TIMEOUT",
-              "DEPLOY_PARTIAL",
-              "TRANSPORT_ERROR",
-              "OUTPUT_LIMIT",
-              "INTERNAL_ERROR",
-              "SCAN_LIMIT",
-              "CAPACITY_LIMIT"
-            ],
-            "type": "string"
-          },
-          "effects": {
-            "enum": [
-              "none",
-              "possible",
-              "confirmed"
-            ],
-            "type": "string"
-          },
-          "message": {
-            "type": "string"
-          },
-          "next_action": {
-            "enum": [
-              "fix_input",
-              "fix_config",
-              "select_server",
-              "inspect_target",
-              "retry",
-              "contact_operator",
-              "none"
-            ],
-            "type": "string"
-          },
-          "partial": {
-            "additionalProperties": false,
-            "properties": {
-              "completed_bytes": {
-                "maximum": 9007199254740991,
-                "minimum": 0,
-                "type": "integer"
-              },
-              "completed_files": {
-                "maximum": 9007199254740991,
-                "minimum": 0,
-                "type": "integer"
-              },
-              "failed_files": {
-                "maximum": 9007199254740991,
-                "minimum": 0,
-                "type": "integer"
-              },
-              "final": {
-                "type": "boolean"
-              },
-              "total_files": {
-                "maximum": 9007199254740991,
-                "minimum": 0,
-                "type": "integer"
-              }
-            },
-            "required": [
-              "completed_files",
-              "completed_bytes",
-              "failed_files",
-              "final"
-            ],
-            "type": "object"
-          },
-          "request_id": {
-            "format": "uuid",
-            "type": "string"
-          },
-          "retryable": {
-            "type": "boolean"
-          },
-          "schema_version": {
-            "const": 1,
-            "type": "number"
-          }
-        },
-        "required": [
-          "schema_version",
-          "code",
-          "message",
-          "retryable",
-          "request_id",
-          "next_action",
-          "effects"
-        ],
-        "type": "object"
-      }
-    },
-    "required": [
-      "error"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "count": {
+        "maximum": 9007199254740991,
+        "minimum": 0,
+        "type": "integer"
+      },
+      "entries": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "modified_at": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "name": {
+              "type": "string"
+            },
+            "size_bytes": {
+              "minimum": 0,
+              "type": "number"
+            },
+            "type": {
+              "enum": [
+                "dir",
+                "file",
+                "link"
+              ],
+              "type": "string"
+            }
+          },
+          "required": [
+            "name",
+            "type",
+            "size_bytes",
+            "modified_at"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "has_more": {
+        "type": "boolean"
+      },
+      "limit": {
+        "maximum": 200,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "next_offset": {
+        "anyOf": [
+          {
+            "maximum": 9007199254740991,
+            "minimum": 0,
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "offset": {
+        "maximum": 9007199254740991,
+        "minimum": 0,
+        "type": "integer"
+      },
+      "path": {
+        "type": "string"
+      },
+      "security_warning": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "server": {
+        "type": "string"
+      },
+      "total": {
+        "maximum": 9007199254740991,
+        "minimum": 0,
+        "type": "integer"
+      }
+    },
+    "required": [
+      "server",
+      "path",
+      "total",
+      "count",
+      "offset",
+      "limit",
+      "has_more",
+      "next_offset",
+      "entries",
+      "security_warning"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "error": {
+        "additionalProperties": false,
+        "properties": {
+          "code": {
+            "enum": [
+              "CONFIG_REQUIRED",
+              "CONFIG_INVALID",
+              "SERVER_REQUIRED",
+              "SERVER_UNKNOWN",
+              "INVALID_ARGUMENT",
+              "READ_ONLY",
+              "TRANSPORT_POLICY",
+              "HOST_KEY_REJECTED",
+              "REMOTE_ROOT_REJECTED",
+              "PATH_REJECTED",
+              "NOT_FOUND",
+              "ALREADY_EXISTS",
+              "TRANSFER_LIMIT",
+              "TRANSFER_VERIFY",
+              "TARGET_CHANGED",
+              "CANCELLED",
+              "TIMEOUT",
+              "DEPLOY_PARTIAL",
+              "TRANSPORT_ERROR",
+              "OUTPUT_LIMIT",
+              "INTERNAL_ERROR",
+              "SCAN_LIMIT",
+              "CAPACITY_LIMIT"
+            ],
+            "type": "string"
+          },
+          "effects": {
+            "enum": [
+              "none",
+              "possible",
+              "confirmed"
+            ],
+            "type": "string"
+          },
+          "message": {
+            "type": "string"
+          },
+          "next_action": {
+            "enum": [
+              "fix_input",
+              "fix_config",
+              "select_server",
+              "inspect_target",
+              "retry",
+              "contact_operator",
+              "none"
+            ],
+            "type": "string"
+          },
+          "partial": {
+            "additionalProperties": false,
+            "properties": {
+              "completed_bytes": {
+                "maximum": 9007199254740991,
+                "minimum": 0,
+                "type": "integer"
+              },
+              "completed_files": {
+                "maximum": 9007199254740991,
+                "minimum": 0,
+                "type": "integer"
+              },
+              "failed_files": {
+                "maximum": 9007199254740991,
+                "minimum": 0,
+                "type": "integer"
+              },
+              "final": {
+                "type": "boolean"
+              },
+              "total_files": {
+                "maximum": 9007199254740991,
+                "minimum": 0,
+                "type": "integer"
+              }
+            },
+            "required": [
+              "completed_files",
+              "completed_bytes",
+              "failed_files",
+              "final"
+            ],
+            "type": "object"
+          },
+          "request_id": {
+            "format": "uuid",
+            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+            "type": "string"
+          },
+          "retryable": {
+            "type": "boolean"
+          },
+          "schema_version": {
+            "const": 1,
+            "type": "number"
+          }
+        },
+        "required": [
+          "schema_version",
+          "code",
+          "message",
+          "retryable",
+          "request_id",
+          "next_action",
+          "effects"
+        ],
+        "type": "object"
+      }
+    },
+    "required": [
+      "error"
+    ],
+    "type": "object"
+  }
+]

Changed3 schema fields changedv0.2.0Sep 9, 2026

addedInput schema / properties / limit

Added value: +{
+  "description": "Maximum entries to return (default 50, maximum 200).",
+  "maximum": 200,
+  "minimum": 1,
+  "type": "integer"
+}

addedInput schema / properties / offset

Added value: +{
+  "description": "Zero-based entry offset (default 0).",
+  "minimum": 0,
+  "type": "integer"
+}

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "oneOf": [
+    {
+      "additionalProperties": false,
+      "properties": {
+        "count": {
+          "minimum": 0,
+          "type": "integer"
+        },
+        "entries": {
+          "items": {
+            "additionalProperties": false,
+            "properties": {
+              "modified_at": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "name": {
+                "type": "string"
+              },
+              "size_bytes": {
+                "minimum": 0,
+                "type": "number"
+              },
+              "type": {
+                "enum": [
+                  "dir",
+                  "file",
+                  "link"
+                ],
+                "type": "string"
+              }
+            },
+            "required": [
+              "name",
+              "type",
+              "size_bytes",
+              "modified_at"
+            ],
+            "type": "object"
+          },
+          "type": "array"
+        },
+        "has_more": {
+          "type": "boolean"
+        },
+        "limit": {
+          "maximum": 200,
+          "minimum": 1,
+          "type": "integer"
+        },
+        "next_offset": {
+          "anyOf": [
+            {
+              "minimum": 0,
+              "type": "integer"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "offset": {
+          "minimum": 0,
+          "type": "integer"
+        },
+        "path": {
+          "type": "string"
+        },
+        "security_warning": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "server": {
+          "type": "string"
+        },
+        "total": {
+          "minimum": 0,
+          "type": "integer"
+        }
+      },
+      "required": [
+        "server",
+        "path",
+        "total",
+        "count",
+        "offset",
+        "limit",
+        "has_more",
+        "next_offset",
+        "entries",
+        "security_warning"
+      ],
+      "type": "object"
+    },
+    {
+      "additionalProperties": false,
+      "properties": {
+        "error": {
+          "additionalProperties": false,
+          "properties": {
+            "code": {
+              "enum": [
+                "CONFIG_REQUIRED",
+                "CONFIG_INVALID",
+                "SERVER_REQUIRED",
+                "SERVER_UNKNOWN",
+                "INVALID_ARGUMENT",
+                "READ_ONLY",
+                "TRANSPORT_POLICY",
+                "HOST_KEY_REJECTED",
+                "REMOTE_ROOT_REJECTED",
+                "PATH_REJECTED",
+                "NOT_FOUND",
+                "ALREADY_EXISTS",
+                "TRANSFER_LIMIT",
+                "TRANSFER_VERIFY",
+                "TARGET_CHANGED",
+                "CANCELLED",
+                "TIMEOUT",
+                "DEPLOY_PARTIAL",
+                "TRANSPORT_ERROR",
+                "OUTPUT_LIMIT",
+                "INTERNAL_ERROR",
+                "SCAN_LIMIT",
+                "CAPACITY_LIMIT"
+              ],
+              "type": "string"
+            },
+            "effects": {
+              "enum": [
+                "none",
+                "possible",
+                "confirmed"
+              ],
+              "type": "string"
+            },
+            "message": {
+              "type": "string"
+            },
+            "next_action": {
+              "enum": [
+                "fix_input",
+                "fix_config",
+                "select_server",
+                "inspect_target",
+                "retry",
+                "contact_operator",
+                "none"
+              ],
+              "type": "string"
+            },
+            "partial": {
+              "additionalProperties": false,
+              "properties": {
+                "completed_bytes": {
+                  "maximum": 9007199254740991,
+                  "minimum": 0,
+                  "type": "integer"
+                },
+                "completed_files": {
+                  "maximum": 9007199254740991,
+                  "minimum": 0,
+                  "type": "integer"
+                },
+                "failed_files": {
+                  "maximum": 9007199254740991,
+                  "minimum": 0,
+                  "type": "integer"
+                },
+                "final": {
+                  "type": "boolean"
+                },
+                "total_files": {
+                  "maximum": 9007199254740991,
+                  "minimum": 0,
+                  "type": "integer"
+                }
+              },
+              "required": [
+                "completed_files",
+                "completed_bytes",
+                "failed_files",
+                "final"
+              ],
+              "type": "object"
+            },
+            "request_id": {
+              "format": "uuid",
+              "type": "string"
+            },
+            "retryable": {
+              "type": "boolean"
+            },
+            "schema_version": {
+              "const": 1,
+              "type": "number"
+            }
+          },
+          "required": [
+            "schema_version",
+            "code",
+            "message",
+            "retryable",
+            "request_id",
+            "next_action",
+            "effects"
+          ],
+          "type": "object"
+        }
+      },
+      "required": [
+        "error"
+      ],
+      "type": "object"
+    }
+  ],
+  "type": "object"
+}

First observedv0.1.0Jul 22, 2026

TDQS

B3.4/5.0

Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint, idempotentHint, openWorldHint, and destructiveHint=false, so the safety profile is covered. The description adds one genuinely useful behavioral detail beyond that — directories are returned first — but says nothing about pagination or truncation behavior.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two short sentences, zero filler, with the scope qualifier ("relative to the server root") front-loaded in the first sentence and the ordering behavior isolated in the second. Every sentence earns its place.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With an output schema present and full schema coverage, the description does not need to explain return values or parameters, and annotations carry the safety profile. It is nearly complete; the only minor gap is any hint about how pagination interacts with large directory listings.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so all four parameters (path, limit, offset, server) are already documented in the schema with defaults and bounds. The description adds no parameter-level meaning beyond that, so the baseline 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description gives a specific verb and resource ("List the contents of a remote directory") and scopes it relative to the server root, which separates it from ftp_list_servers in practice. It does not explicitly name a sibling or state what it is not, so it stops short of a 5.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

There is no when-to-use or when-not-to-use guidance and no alternatives named. An agent gets no signal about choosing ftp_list over ftp_read or ftp_list_servers, nor about paginating large directories with limit/offset.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Deploy Server