Developer-tools MCP server

Filesystem MCP

Version history of discovered tools, schemas, and declared agent authority.

View watchlist

DistributionDistribution: npm
Package@modelcontextprotocol/server-filesystem
Latest analyzed version2.3.0
Current tool count16
Latest analysisNov 12, 2026
Package source

OBSERVED INTERFACE

Capability surface

Modelara’s observed declarations are shown separately from its derived effect classifications.

8 releases analyzed2026.7.4 → 2.3.0Latest: 2.3.0
  • read10
  • write3
  • destructive3
  • unknown0

Unknown means Valyd could not determine the capability's effect confidently from the declared interface and static evidence. It is not treated as safe.

Package
@modelcontextprotocol/server-filesystem@2.3.0
Registry
npm
Published
Nov 11, 2026
Integrity
sha512-dnwDFqYi2Q3VbFDnVOUme4+81CzwHBj3OKeYEgZ6UkBp7rWSm5OKiidemgIF0kkt5AyAi6mHsqx0cfTZBP1DJQ==
Analyzer
modelara v0.1.8 · policy not recorded
Repository
https://github.com/modelcontextprotocol/servers

16 capabilities

CapabilityTypeDerived effectFirst observed in Valyd coverageLast changed
append_filefilesystem:tool:append_file
Observed interface and hashes

Append text to the end of a file, creating the file if it does not exist. The existing content is never changed or replaced. The text is appended exactly as given, with no newline added before or after it, so end it with a newline if the next append should start on a new line. Only works within allowed directories.

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "content": {
      "description": "Text to append, exactly as given. No newline is added: end it with \\n if the next append should start on a new line.",
      "type": "string"
    },
    "path": {
      "description": "The file to append to; it is created if it does not exist. Absolute, or relative to an allowed directory; it must resolve inside the allowed directories.",
      "type": "string"
    }
  },
  "required": [
    "path",
    "content"
  ],
  "type": "object"
}
sha256:dfb2612f67e20ee969612361aebafc6188b57715d23c7ef28df9dd97163b2a81

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "content": {
      "type": "string"
    }
  },
  "required": [
    "content"
  ],
  "type": "object"
}
sha256:84cbd0929311050bebb3fa7329607e92ae7e0453e111b0b38580127bdc8652e0

Description hash: sha256:a648b55a5fa794180ee3690ac89ad9f729faf3e95125beb83feebd7d59f7ae55

Interface hash: sha256:673380d1b4574afdaebd305553f2fb62de48ba5e228690d547b880ea6a725e5a

Other observed Modelara metadata
{
  "id": "mcp:secure-filesystem-server/append_file",
  "title": "Append File",
  "source": {
    "type": "mcp",
    "server": "secure-filesystem-server",
    "operation": "append_file"
  },
  "declared": {
    "read_only": "false",
    "destructive": "false",
    "idempotent": "false",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "false",
    "retry_safe": "false"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:313a9f8db04f19ea08a1b0f0324781fd3b84772d49c35baf863dbe65e333de13"
}
toolwrite2.2.02.3.0
copy_filefilesystem:tool:copy_file
Observed interface and hashes

Copy a file to a new location, without reading its content into the conversation. Copies one regular file, keeping its permissions and modification time; directories are not copied. If the destination exists, the operation will fail: it never overwrites. Both source and destination must be within allowed directories.

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "destination": {
      "description": "Where to create the copy; nothing may exist there yet",
      "type": "string"
    },
    "source": {
      "description": "The file to copy",
      "type": "string"
    }
  },
  "required": [
    "source",
    "destination"
  ],
  "type": "object"
}
sha256:dc96dfc27fc29634960f47667477118b1fa3bd25e9378173d1e2807d08721594

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "content": {
      "type": "string"
    }
  },
  "required": [
    "content"
  ],
  "type": "object"
}
sha256:84cbd0929311050bebb3fa7329607e92ae7e0453e111b0b38580127bdc8652e0

Description hash: sha256:4cefc449367e65bc5a553b87f551d22df4e9a37edadb3caf5990631c6425e54f

Interface hash: sha256:bc6b70190798aff499fc9e6be26469987f9c7e96c7b4550f85be1dd7ac1f1d6d

Other observed Modelara metadata
{
  "id": "mcp:secure-filesystem-server/copy_file",
  "title": "Copy File",
  "source": {
    "type": "mcp",
    "server": "secure-filesystem-server",
    "operation": "copy_file"
  },
  "declared": {
    "read_only": "false",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:8344300e46804c5780de927f2cc7164ffacb9495c857be6ea1ce7400b8a85cc4"
}
toolwrite2.2.02.2.0
create_directoryfilesystem:tool:create_directory
Observed interface and hashes

Create a new directory or ensure a directory exists. Can create multiple nested directories in one operation. If the directory already exists, this operation will succeed silently. Perfect for setting up directory structures for projects or ensuring required paths exist. Only works within allowed directories.

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "path": {
      "description": "The directory to create, with any missing parents; an existing directory is left as is. Absolute, or relative to an allowed directory; it must resolve inside the allowed directories.",
      "type": "string"
    }
  },
  "required": [
    "path"
  ],
  "type": "object"
}
sha256:9f8c28b8a0256072f3e86f3cf6d3772f9657fd317327d995713784c640598cd4

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "content": {
      "type": "string"
    }
  },
  "required": [
    "content"
  ],
  "type": "object"
}
sha256:84cbd0929311050bebb3fa7329607e92ae7e0453e111b0b38580127bdc8652e0

Description hash: sha256:b00c69bdb301ed4d44392ecf3a1af712c3a99619691a017b2af5a38f487101d8

Interface hash: sha256:7c0d49ce9f4b95e0176e14fffbcded299b770cefe679891340bbad85ef2722be

Other observed Modelara metadata
{
  "id": "mcp:secure-filesystem-server/create_directory",
  "title": "Create Directory",
  "source": {
    "type": "mcp",
    "server": "secure-filesystem-server",
    "operation": "create_directory"
  },
  "declared": {
    "read_only": "false",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:a56c5cf950aa87afcc7c0bba8c9be1be6b9ee3af6da0ecf386bd20d4c09d383e"
}
toolwrite2026.7.42.3.0
directory_treefilesystem:tool:directory_tree
Observed interface and hashes

Get a recursive tree view of files and directories as a JSON structure. Each entry includes 'name', 'type' (file/directory), and 'children' for directories. Files have no children array, while directories always have a children array (which may be empty), except at the last level when 'depth' limits the tree: those directories are not read and have no children array. The output is formatted with 2-space indentation for readability. Only works within allowed directories.

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "depth": {
      "description": "How many levels to descend: 1 lists only the entries directly in path. Directories at the last level have no children array. Omit for the whole tree.",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "type": "integer"
    },
    "excludePatterns": {
      "default": [],
      "description": "Patterns for entries to leave out, with their contents, matched against each entry's path relative to path. A pattern with no '*' matches that name at any depth ('node_modules' leaves out every node_modules directory); a pattern with '*' is a glob matched as written, and one ending in '/**' also leaves out the directory it names.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "path": {
      "description": "The directory at the root of the tree. Absolute, or relative to an allowed directory; it must resolve inside the allowed directories.",
      "type": "string"
    }
  },
  "required": [
    "path"
  ],
  "type": "object"
}
sha256:24d81d3ab67bc73cb96c61477916d46b50c0bf6400f2f1b7211c285b3d65b2d6

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "content": {
      "type": "string"
    }
  },
  "required": [
    "content"
  ],
  "type": "object"
}
sha256:84cbd0929311050bebb3fa7329607e92ae7e0453e111b0b38580127bdc8652e0

Description hash: sha256:ffa154092742f568fd921f3619dc34df5d8c894a56cc45010eeb782b24c8a69e

Interface hash: sha256:f59e7196690b1dcfdc308a270c6a981d6520963999dd8816c235a785f3da5290

Other observed Modelara metadata
{
  "id": "mcp:secure-filesystem-server/directory_tree",
  "title": "Directory Tree",
  "source": {
    "type": "mcp",
    "server": "secure-filesystem-server",
    "operation": "directory_tree"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:3a6f87f23af397d10514ae9c9986a93cf9917638038eed2584dd1ee12a540d79"
}
toolread2026.7.42.3.0
edit_filefilesystem:tool:edit_file
Observed interface and hashes

Make line-based edits to a text file. Edits apply in order, each to the result of the ones before it, and each replaces the first match of its oldText with newText. oldText must match the file's text exactly, except that line endings (LF or CRLF) never matter and, when there is no exact match, a run of whole lines matches if each line is equal once leading and trailing whitespace is ignored (newText then takes the file's indentation). Whitespace inside a line must match. If any edit has no match, nothing is written and the error shows the closest lines of the file, numbered, to copy oldText from. Returns a git-style diff showing the changes made. Only works within allowed directories.

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "dryRun": {
      "default": false,
      "description": "Preview changes using git-style diff format",
      "type": "boolean"
    },
    "edits": {
      "description": "The replacements to make, applied in order, each to the result of the ones before it. If any one has no match, none is written.",
      "items": {
        "properties": {
          "newText": {
            "description": "Text to replace with",
            "type": "string"
          },
          "oldText": {
            "description": "Text to search for - must match exactly",
            "type": "string"
          }
        },
        "required": [
          "oldText",
          "newText"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "path": {
      "description": "The text file to edit. Absolute, or relative to an allowed directory; it must resolve inside the allowed directories.",
      "type": "string"
    }
  },
  "required": [
    "path",
    "edits"
  ],
  "type": "object"
}
sha256:354b0adabf8e54de321072b5611ff03ae94e6330a83aed6babcc65f9e16574b2

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "content": {
      "type": "string"
    }
  },
  "required": [
    "content"
  ],
  "type": "object"
}
sha256:84cbd0929311050bebb3fa7329607e92ae7e0453e111b0b38580127bdc8652e0

Description hash: sha256:5f90fef2fd95358725988ede0a496cab1fff1c3622bd8eb49bb768a415f561f1

Interface hash: sha256:b19e820e11b198949d3b55a74b648dfaef85a623fb7db8e4e3c72a498321d495

Other observed Modelara metadata
{
  "id": "mcp:secure-filesystem-server/edit_file",
  "title": "Edit File",
  "source": {
    "type": "mcp",
    "server": "secure-filesystem-server",
    "operation": "edit_file"
  },
  "declared": {
    "read_only": "false",
    "destructive": "true",
    "idempotent": "false",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "false",
    "retry_safe": "false"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:d58f57932378bb86b0c690a1dc2b574f67c6b07693862a910f2a965b2e67a812"
}
tooldestructive2026.7.42.3.0
get_file_infofilesystem:tool:get_file_info
Observed interface and hashes

Retrieve detailed metadata about a file or directory. Returns comprehensive information including size, creation time, last modified time, permissions, type and hard-link count. This tool is perfect for understanding file characteristics without reading the actual content. Only works within allowed directories.

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "path": {
      "description": "The file or directory to describe. Absolute, or relative to an allowed directory; it must resolve inside the allowed directories.",
      "type": "string"
    }
  },
  "required": [
    "path"
  ],
  "type": "object"
}
sha256:1e9c2b3e5d2eb84d56a5bd1616c1c357b2e2a4e244df31031a9fd3b13a486a1e

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "content": {
      "type": "string"
    }
  },
  "required": [
    "content"
  ],
  "type": "object"
}
sha256:84cbd0929311050bebb3fa7329607e92ae7e0453e111b0b38580127bdc8652e0

Description hash: sha256:8958a324587f5180e9b492c92d93647aea1e4c51bd6e7971f7488c5983284e82

Interface hash: sha256:3116833b133b353c1f36979539890d00e28321b95f40a6809a3df0254f887a44

Other observed Modelara metadata
{
  "id": "mcp:secure-filesystem-server/get_file_info",
  "title": "Get File Info",
  "source": {
    "type": "mcp",
    "server": "secure-filesystem-server",
    "operation": "get_file_info"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:e472af4dc5dbb98202f02a7c36f8587a28454c9807848d7733a5417863bb6bdf"
}
toolread2026.7.42.3.0
list_allowed_directoriesfilesystem:tool:list_allowed_directories
Observed interface and hashes

Returns the list of directories that this server is allowed to access. Subdirectories within these allowed directories are also accessible. Use this to understand which directories and their nested paths are available before trying to access files.

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {},
  "type": "object"
}
sha256:e1097cff90b6f86e9ecdf741b342bcf4f2770598982ab4e2c24d5d3278636bac

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "content": {
      "type": "string"
    }
  },
  "required": [
    "content"
  ],
  "type": "object"
}
sha256:84cbd0929311050bebb3fa7329607e92ae7e0453e111b0b38580127bdc8652e0

Description hash: sha256:0d1e36ff15a23277eb4f0c4a386d016b078f1017bb6fe55ade6c4e8cf458e2e2

Interface hash: sha256:dc73cf03fc4337188082c0966ff76cc1a3bcd159ece2d930634352823a0cc33f

Other observed Modelara metadata
{
  "id": "mcp:secure-filesystem-server/list_allowed_directories",
  "title": "List Allowed Directories",
  "source": {
    "type": "mcp",
    "server": "secure-filesystem-server",
    "operation": "list_allowed_directories"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:f15ef8f0358f9223d6d090586a19ac0a9ee5b856088e56ee1805dcd70ad16405"
}
toolread2026.7.42.2.0
list_directoryfilesystem:tool:list_directory
Observed interface and hashes

List the files and directories directly inside a path, each marked [FILE] or [DIR]. Use it to see what a directory contains; when you also need each entry's size or want entries sorted by size, use list_directory_with_sizes instead, and for a recursive view use directory_tree. Returns one line per entry. Only works within allowed directories.

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "path": {
      "description": "The directory to list. Absolute, or relative to an allowed directory; it must resolve inside the allowed directories.",
      "type": "string"
    }
  },
  "required": [
    "path"
  ],
  "type": "object"
}
sha256:12be48a2a1e8f3070ca41818ebe5d2224b49726e846ebb9b46ffda33266f35f4

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "content": {
      "type": "string"
    }
  },
  "required": [
    "content"
  ],
  "type": "object"
}
sha256:84cbd0929311050bebb3fa7329607e92ae7e0453e111b0b38580127bdc8652e0

Description hash: sha256:452b695c91e0c4bd69fdbe29882b1a1b007dfd8f9deb42fef076623ad803460d

Interface hash: sha256:ad9612326bcce44bb37ed596f557fe43d315d8879aea3fb9b8ceb53da27815cc

Other observed Modelara metadata
{
  "id": "mcp:secure-filesystem-server/list_directory",
  "title": "List Directory",
  "source": {
    "type": "mcp",
    "server": "secure-filesystem-server",
    "operation": "list_directory"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:4f145eaabdcc4a41ddf3a8be6299aff62dc840dd76ff2a6a523e62794f5c7940"
}
toolread2026.7.42.3.0
list_directory_with_sizesfilesystem:tool:list_directory_with_sizes
Observed interface and hashes

List the files and directories directly inside a path with each file's size, marked [FILE] or [DIR], sorted by name or by size, largest first (sortBy). Use it when sizes matter, such as finding the largest files; for names only, use list_directory, which returns less text. Returns one line per entry, followed by the totals. Only works within allowed directories.

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "path": {
      "description": "The directory to list. Absolute, or relative to an allowed directory; it must resolve inside the allowed directories.",
      "type": "string"
    },
    "sortBy": {
      "default": "name",
      "description": "Sort entries by name or size",
      "enum": [
        "name",
        "size"
      ],
      "type": "string"
    }
  },
  "required": [
    "path"
  ],
  "type": "object"
}
sha256:669cd5bf74fd0f20dafe1e34542e0201cb45fe823f0c7a886aaac2e7fb0f089f

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "content": {
      "type": "string"
    }
  },
  "required": [
    "content"
  ],
  "type": "object"
}
sha256:84cbd0929311050bebb3fa7329607e92ae7e0453e111b0b38580127bdc8652e0

Description hash: sha256:44efead0a1d30712f04af24442e45ae25e12bc1bab55cddca6380c71d3d45310

Interface hash: sha256:a2aa0d493a1390b7906c96cd6f08e25dc313f616a20af4981b07a11592ce6cfb

Other observed Modelara metadata
{
  "id": "mcp:secure-filesystem-server/list_directory_with_sizes",
  "title": "List Directory with Sizes",
  "source": {
    "type": "mcp",
    "server": "secure-filesystem-server",
    "operation": "list_directory_with_sizes"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:9a76216f0f4f00d7e51d8d4e07ee361f07ab239d60c41157c3b662916759a0a1"
}
toolread2026.7.42.3.0
move_filefilesystem:tool:move_file
Observed interface and hashes

Move or rename files and directories. Can move files between directories and rename them in a single operation. If the destination exists, the operation will fail. Works across different directories and can be used for simple renaming within the same directory. Both source and destination must be within allowed directories.

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "destination": {
      "description": "Its new path, including the name; nothing may exist there yet. Absolute, or relative to an allowed directory; it must resolve inside the allowed directories.",
      "type": "string"
    },
    "source": {
      "description": "The file or directory to move or rename. Absolute, or relative to an allowed directory; it must resolve inside the allowed directories.",
      "type": "string"
    }
  },
  "required": [
    "source",
    "destination"
  ],
  "type": "object"
}
sha256:535bc072c8c44c33adc32602f4700c23ad389c8905875eb3bb3fc2315f5fdf27

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "content": {
      "type": "string"
    }
  },
  "required": [
    "content"
  ],
  "type": "object"
}
sha256:84cbd0929311050bebb3fa7329607e92ae7e0453e111b0b38580127bdc8652e0

Description hash: sha256:6c36ad2549aac0c82a543e2b689b77acceb7b3b71a2bce64263f65703e59cdfa

Interface hash: sha256:578164ab81ffff1be19737e018c53ab1b9db2e07c8dd21c31feea32019c891ca

Other observed Modelara metadata
{
  "id": "mcp:secure-filesystem-server/move_file",
  "title": "Move File",
  "source": {
    "type": "mcp",
    "server": "secure-filesystem-server",
    "operation": "move_file"
  },
  "declared": {
    "read_only": "false",
    "destructive": "true",
    "idempotent": "false",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "false",
    "retry_safe": "false"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:0495ff4c01e87f44b477e3758803ec1c1c58bd066e8483dada395e70ead34f74"
}
tooldestructive2026.7.42.3.0
read_filefilesystem:tool:read_file
Observed interface and hashes

Read the complete contents of a file as text. DEPRECATED: Use read_text_file instead.

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "head": {
      "description": "If provided, returns only the first N lines of the file",
      "maximum": 9007199254740991,
      "minimum": 0,
      "type": "integer"
    },
    "path": {
      "description": "The file to read as text. Absolute, or relative to an allowed directory; it must resolve inside the allowed directories.",
      "type": "string"
    },
    "tail": {
      "description": "If provided, returns only the last N lines of the file",
      "maximum": 9007199254740991,
      "minimum": 0,
      "type": "integer"
    }
  },
  "required": [
    "path"
  ],
  "type": "object"
}
sha256:ca851c3af8f02bdc6333951d1678bb039ff6d4309ffdb01dc35c8b912d6dcab9

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "content": {
      "type": "string"
    }
  },
  "required": [
    "content"
  ],
  "type": "object"
}
sha256:84cbd0929311050bebb3fa7329607e92ae7e0453e111b0b38580127bdc8652e0

Description hash: sha256:62c0132210078b450a79100b6d50a59da1c3226d3f00bfab9297348a95a39c12

Interface hash: sha256:5df77cb1a89d9abaa9ad032984122504e1859c5e7f051c2e6f314fa1cd02072b

Other observed Modelara metadata
{
  "id": "mcp:secure-filesystem-server/read_file",
  "title": "Read File (Deprecated)",
  "source": {
    "type": "mcp",
    "server": "secure-filesystem-server",
    "operation": "read_file"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:7887b132665bf2b7df36f67fe0f4281c0dc75b6565a79c712968a64280749a78"
}
toolread2026.7.42.3.0
read_media_filefilesystem:tool:read_media_file
Observed interface and hashes

Read a file and return it as a base64-encoded content block with its MIME type. Image and audio files are returned as image/audio content; any other file type is returned as an embedded resource. Only works within allowed directories.

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "path": {
      "description": "The image, audio or other file to read as base64. Absolute, or relative to an allowed directory; it must resolve inside the allowed directories.",
      "type": "string"
    }
  },
  "required": [
    "path"
  ],
  "type": "object"
}
sha256:9c11ffcdf0c32ede665a65007498d51fbe02cd26d05a0b44371a7c5437355ceb

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "content": {
      "items": {
        "anyOf": [
          {
            "additionalProperties": false,
            "properties": {
              "data": {
                "type": "string"
              },
              "mimeType": {
                "type": "string"
              },
              "type": {
                "enum": [
                  "image",
                  "audio"
                ],
                "type": "string"
              }
            },
            "required": [
              "type",
              "data",
              "mimeType"
            ],
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "resource": {
                "additionalProperties": false,
                "properties": {
                  "blob": {
                    "type": "string"
                  },
                  "mimeType": {
                    "type": "string"
                  },
                  "uri": {
                    "type": "string"
                  }
                },
                "required": [
                  "uri",
                  "blob"
                ],
                "type": "object"
              },
              "type": {
                "const": "resource",
                "type": "string"
              }
            },
            "required": [
              "type",
              "resource"
            ],
            "type": "object"
          }
        ]
      },
      "type": "array"
    }
  },
  "required": [
    "content"
  ],
  "type": "object"
}
sha256:d7c8e289efa67fae306d7068f533e4af95f96ad108d8fe7bbd36cdfe48ef0d93

Description hash: sha256:58c1fb5255ac8be4fdb71d697ccda7abbc16a57e7de44943ed23058cd9565b06

Interface hash: sha256:173e7d2b564852f4df0bf4205f5bb76236245ccfddec26cbd07e6d453f7af809

Other observed Modelara metadata
{
  "id": "mcp:secure-filesystem-server/read_media_file",
  "title": "Read Media File",
  "source": {
    "type": "mcp",
    "server": "secure-filesystem-server",
    "operation": "read_media_file"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:a5c3a5f95292111ac6b247a4fbd5e89c57b93fcf62183fc41dfbf74bc14daf9b"
}
toolread2026.7.42.3.0
read_multiple_filesfilesystem:tool:read_multiple_files
Observed interface and hashes

Read the contents of multiple files simultaneously. This is more efficient than reading files one by one when you need to analyze or compare multiple files. Each file's content is returned with its path as a reference. Failed reads for individual files won't stop the entire operation. Only works within allowed directories.

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "paths": {
      "description": "Array of file paths to read. Each path must be a string pointing to a valid file within allowed directories.",
      "items": {
        "type": "string"
      },
      "minItems": 1,
      "type": "array"
    }
  },
  "required": [
    "paths"
  ],
  "type": "object"
}
sha256:f8dded77d791cb47d42ff53a25857c90e1db0653e884a5171021dff993a5ac78

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "content": {
      "type": "string"
    }
  },
  "required": [
    "content"
  ],
  "type": "object"
}
sha256:84cbd0929311050bebb3fa7329607e92ae7e0453e111b0b38580127bdc8652e0

Description hash: sha256:4b2d33d6afc3ec97d82cf1fd20551f380897146b51bf7af60d778cd1e192f9e5

Interface hash: sha256:6c3a6a5667e0ac865baaad4ba6da45c771ad8be35a1895802065cc7650eff4a8

Other observed Modelara metadata
{
  "id": "mcp:secure-filesystem-server/read_multiple_files",
  "title": "Read Multiple Files",
  "source": {
    "type": "mcp",
    "server": "secure-filesystem-server",
    "operation": "read_multiple_files"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:047052e1b14193701f1c6183a898c2eb24b11b2432570ca619b925a47fa11c87"
}
toolread2026.7.42.2.0
read_text_filefilesystem:tool:read_text_file
Observed interface and hashes

Read the complete contents of a file from the file system as text. Handles various text encodings and provides detailed error messages if the file cannot be read. Use this tool when you need to examine the contents of a single file. Use the 'head' parameter to read only the first N lines of a file, or the 'tail' parameter to read only the last N lines of a file. Operates on the file as text regardless of extension. Only works within allowed directories.

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "head": {
      "description": "If provided, returns only the first N lines of the file",
      "maximum": 9007199254740991,
      "minimum": 0,
      "type": "integer"
    },
    "path": {
      "description": "The file to read as text. Absolute, or relative to an allowed directory; it must resolve inside the allowed directories.",
      "type": "string"
    },
    "tail": {
      "description": "If provided, returns only the last N lines of the file",
      "maximum": 9007199254740991,
      "minimum": 0,
      "type": "integer"
    }
  },
  "required": [
    "path"
  ],
  "type": "object"
}
sha256:ca851c3af8f02bdc6333951d1678bb039ff6d4309ffdb01dc35c8b912d6dcab9

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "content": {
      "type": "string"
    }
  },
  "required": [
    "content"
  ],
  "type": "object"
}
sha256:84cbd0929311050bebb3fa7329607e92ae7e0453e111b0b38580127bdc8652e0

Description hash: sha256:872959d162416985ed007df64aac82c4d834f2f1f87e3e2b380b339ad4b6150a

Interface hash: sha256:1102424dc53fad80541891778a8bf55b2c17ad229b83ff6679b23ce3b5705f78

Other observed Modelara metadata
{
  "id": "mcp:secure-filesystem-server/read_text_file",
  "title": "Read Text File",
  "source": {
    "type": "mcp",
    "server": "secure-filesystem-server",
    "operation": "read_text_file"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:8c7f920b7c28ce1a6cc7b6511805905908b8f45a4a86620ba0191320822f4761"
}
toolread2026.7.42.3.0
search_filesfilesystem:tool:search_files
Observed interface and hashes

Find files and directories by NAME, not by content: this tool never reads or searches inside files. It walks the tree under 'path' and matches a glob pattern against each entry's path relative to 'path' (case-sensitive). Use '*.ext' to match entries directly under 'path', and '**/*.ext' or '**/name' to match at any depth. Returns full paths to all matching items. Great for finding files when you don't know their exact location. Only searches within allowed directories.

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "excludePatterns": {
      "default": [],
      "description": "Patterns for entries to leave out, with their contents, matched against each entry's path relative to path. A pattern with no '*' matches that name at any depth ('node_modules' leaves out every node_modules directory); a pattern with '*' is a glob matched as written, and one ending in '/**' also leaves out the directory it names.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "path": {
      "description": "The directory to search under. Absolute, or relative to an allowed directory; it must resolve inside the allowed directories.",
      "type": "string"
    },
    "pattern": {
      "description": "Glob matched against each entry's path relative to path, never its content: '*.ts' matches directly under path, '**/*.ts' at any depth.",
      "type": "string"
    }
  },
  "required": [
    "path",
    "pattern"
  ],
  "type": "object"
}
sha256:0020519b538bd8e3a8c7bd27cd3f1264d8c0bf8e5a0e2a867f47093578788c2e

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "content": {
      "type": "string"
    }
  },
  "required": [
    "content"
  ],
  "type": "object"
}
sha256:84cbd0929311050bebb3fa7329607e92ae7e0453e111b0b38580127bdc8652e0

Description hash: sha256:0433e53825345fdf536ca7b27fa730dd2d17a38e6fd46a4f631caeffbb5c29b1

Interface hash: sha256:cd63791424053eaec108298184efbd0b28bf0155c076fe890a78aa0ae28d8bb2

Other observed Modelara metadata
{
  "id": "mcp:secure-filesystem-server/search_files",
  "title": "Search Files",
  "source": {
    "type": "mcp",
    "server": "secure-filesystem-server",
    "operation": "search_files"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:9ed4f9659b38050ba43ac6a688b11597bf9f489aafaa7d68b3b14e4d42c6ed88"
}
toolread2026.7.42.3.0
write_filefilesystem:tool:write_file
Observed interface and hashes

Create a new file or completely overwrite an existing file with new content. Use with caution as it will overwrite existing files without warning. Handles text content with proper encoding. Only works within allowed directories.

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "content": {
      "description": "The complete text the file will contain, replacing any it had",
      "type": "string"
    },
    "path": {
      "description": "The file to create, or to overwrite if it exists; its parent directory must exist. Absolute, or relative to an allowed directory; it must resolve inside the allowed directories.",
      "type": "string"
    }
  },
  "required": [
    "path",
    "content"
  ],
  "type": "object"
}
sha256:4270ce3c5ed4b455a7b20d0bb1957d2ec21891f0830d2787abf42d5d79b2801e

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "content": {
      "type": "string"
    }
  },
  "required": [
    "content"
  ],
  "type": "object"
}
sha256:84cbd0929311050bebb3fa7329607e92ae7e0453e111b0b38580127bdc8652e0

Description hash: sha256:b6ad81fca270c9e5575c6db5fcee71369d2ff4595a270bd5ef89b28791b65775

Interface hash: sha256:32d5a595aa2c2bec804b308326b5e5c4a3d3aa989f5690c8c42a3d15d7f10fd0

Other observed Modelara metadata
{
  "id": "mcp:secure-filesystem-server/write_file",
  "title": "Write File",
  "source": {
    "type": "mcp",
    "server": "secure-filesystem-server",
    "operation": "write_file"
  },
  "declared": {
    "read_only": "false",
    "destructive": "true",
    "idempotent": "true",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "unknown"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:6f1de9d3aec63aa9d737b48cac495ff7c3876e1f56090c8f0b511afe5358a0fe"
}
tooldestructive2026.7.42.3.0

STATIC COMPARISONS

Release history

7 release transitions
  1. 0 added0 removed13 schema0 write0 destructive0 unknown

    Nov 12, 2026· Pending human review

  2. 2 added0 removed3 schema2 write0 destructive0 unknown

    Nov 5, 2026· Pending human review

  3. 0 added0 removed0 schema0 write0 destructive0 unknown

    Nov 2, 2026· Automated static analysis

  4. 0 added0 removed0 schema0 write0 destructive0 unknown

    Nov 2, 2026· Automated static analysis

  5. 0 added0 removed14 schema0 write0 destructive0 unknown

    Nov 2, 2026· Pending human review

  6. 0 added0 removed0 schema0 write0 destructive0 unknown

    Nov 1, 2026· Automated static analysis

  7. 0 added0 removed1 schema0 write0 destructive0 unknown

    Nov 1, 2026· Pending human review