developer-tools Static interface comparison

Filesystem MCP

2.2.0 2.3.0

REVIEWPending human review

13 schema changes require review.No new authority detected.

View the upgrade review as Markdown

A shareable summary of this comparison for an issue, pull request or ticket. Select the text and copy it.

Tools16 → 16
Added0
Removed0
Schema changes13
Input schema changes13
Output schema changes0
Unclassified schema changes0
Description changes2
New write authority0
New destructive authority0
New unknown authority0
AnalysisREVIEW

INTERFACE DIFF

What changed, tool by tool

Classification from the recorded findings · definitions from the published snapshots

13 tools with recorded changes

  1. append_fileModifiedSchemaREVIEW

    What changed

    • append_file — Schema change: input property path changed: +description="The file to append….

    Why it could matter

    • Calls or consumers built for the earlier schema may need to change.

    What to verify

    • Validate representative existing tool calls against the new argument schema.
    Declared effect
    write → write

    Input schema

    PropertyPrevious (2.2.0)Current (2.3.0)Change
    pathstringrequiredstringrequired
    • Description changed
    2 unchanged entries
    • (schema root)
    • content

    Output schema

    Output schema unchanged.

    2 unchanged entries
    • (schema root)
    • content
    Exact JSON from the published snapshots

    Loads the exact recorded definitions of this tool from both releases. The full snapshots are linked under Evidence and provenance.

    Link to this tool
  2. create_directoryModifiedSchemaREVIEW

    What changed

    • create_directory — Schema change: input property path changed: +description="The directory to c….

    Why it could matter

    • Calls or consumers built for the earlier schema may need to change.

    What to verify

    • Validate representative existing tool calls against the new argument schema.
    Declared effect
    write → write

    Input schema

    PropertyPrevious (2.2.0)Current (2.3.0)Change
    pathstringrequiredstringrequired
    • Description changed
    1 unchanged entry
    • (schema root)

    Output schema

    Output schema unchanged.

    2 unchanged entries
    • (schema root)
    • content
    Exact JSON from the published snapshots

    Loads the exact recorded definitions of this tool from both releases. The full snapshots are linked under Evidence and provenance.

    Link to this tool
  3. directory_treeModifiedSchemaREVIEW

    What changed

    • directory_tree — Schema change: input property excludePatterns changed: +description="Patterns for entri….
    • directory_tree — Schema change: input property path changed: +description="The directory at t….

    Why it could matter

    • Calls or consumers built for the earlier schema may need to change.

    What to verify

    • Validate representative existing tool calls against the new argument schema.
    Declared effect
    read → read

    Input schema

    PropertyPrevious (2.2.0)Current (2.3.0)Change
    excludePatternsarray, default (0)optionalarray, default (0)optional
    • Description changed
    pathstringrequiredstringrequired
    • Description changed
    3 unchanged entries
    • (schema root)
    • depth
    • excludePatterns › [items]

    Output schema

    Output schema unchanged.

    2 unchanged entries
    • (schema root)
    • content
    Exact JSON from the published snapshots

    Loads the exact recorded definitions of this tool from both releases. The full snapshots are linked under Evidence and provenance.

    Link to this tool
  4. edit_fileModifiedSchemaREVIEW

    What changed

    • edit_file — Schema change: input property edits changed: +description="The replacements t….
    • edit_file — Schema change: input property path changed: +description="The text file to e….

    Why it could matter

    • Calls or consumers built for the earlier schema may need to change.

    What to verify

    • Validate representative existing tool calls against the new argument schema.
    Declared effect
    write → write

    Input schema

    PropertyPrevious (2.2.0)Current (2.3.0)Change
    editsarrayrequiredarrayrequired
    • Description changed
    pathstringrequiredstringrequired
    • Description changed
    5 unchanged entries
    • (schema root)
    • dryRun
    • edits › [items]
    • edits › [items] › newText
    • edits › [items] › oldText

    Output schema

    Output schema unchanged.

    2 unchanged entries
    • (schema root)
    • content
    Exact JSON from the published snapshots

    Loads the exact recorded definitions of this tool from both releases. The full snapshots are linked under Evidence and provenance.

    Link to this tool
  5. get_file_infoModifiedSchemaREVIEW

    What changed

    • get_file_info — Schema change: input property path changed: +description="The file or direct….

    Why it could matter

    • Calls or consumers built for the earlier schema may need to change.

    What to verify

    • Validate representative existing tool calls against the new argument schema.
    Declared effect
    read → read

    Input schema

    PropertyPrevious (2.2.0)Current (2.3.0)Change
    pathstringrequiredstringrequired
    • Description changed
    1 unchanged entry
    • (schema root)

    Output schema

    Output schema unchanged.

    2 unchanged entries
    • (schema root)
    • content
    Exact JSON from the published snapshots

    Loads the exact recorded definitions of this tool from both releases. The full snapshots are linked under Evidence and provenance.

    Link to this tool
  6. list_directoryModifiedSchemaDescriptionREVIEWINFO

    What changed

    • list_directory — Schema change: input property path changed: +description="The directory to l….
    • list_directory: description changed.

    Why it could matter

    • Calls or consumers built for the earlier schema may need to change.
    • Models choose and call tools partly from their descriptions.

    What to verify

    • Validate representative existing tool calls against the new argument schema.
    • Spot-check that agents still select this tool as intended.
    Declared effect
    read → read
    Description
    PreviousGet a detailed listing of all files and directories in a specified path. Results clearly distinguish between files and directories with [FILE] and [DIR] prefixes. This tool is essential for understanding directory structure and finding specific files within a directory. Only works within allowed directories.
    CurrentList 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

    PropertyPrevious (2.2.0)Current (2.3.0)Change
    pathstringrequiredstringrequired
    • Description changed
    1 unchanged entry
    • (schema root)

    Output schema

    Output schema unchanged.

    2 unchanged entries
    • (schema root)
    • content
    Exact JSON from the published snapshots

    Loads the exact recorded definitions of this tool from both releases. The full snapshots are linked under Evidence and provenance.

    Link to this tool
  7. list_directory_with_sizesModifiedSchemaDescriptionREVIEWINFO

    What changed

    • list_directory_with_sizes — Schema change: input property path changed: +description="The directory to l….
    • list_directory_with_sizes: description changed.

    Why it could matter

    • Calls or consumers built for the earlier schema may need to change.
    • Models choose and call tools partly from their descriptions.

    What to verify

    • Validate representative existing tool calls against the new argument schema.
    • Spot-check that agents still select this tool as intended.
    Declared effect
    read → read
    Description
    PreviousGet a detailed listing of all files and directories in a specified path, including sizes. Results clearly distinguish between files and directories with [FILE] and [DIR] prefixes. This tool is useful for understanding directory structure and finding specific files within a directory. Only works within allowed directories.
    CurrentList 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

    PropertyPrevious (2.2.0)Current (2.3.0)Change
    pathstringrequiredstringrequired
    • Description changed
    2 unchanged entries
    • (schema root)
    • sortBy

    Output schema

    Output schema unchanged.

    2 unchanged entries
    • (schema root)
    • content
    Exact JSON from the published snapshots

    Loads the exact recorded definitions of this tool from both releases. The full snapshots are linked under Evidence and provenance.

    Link to this tool
  8. move_fileModifiedSchemaREVIEW

    What changed

    • move_file — Schema change: input property destination changed: +description="Its new path, incl….
    • move_file — Schema change: input property source changed: +description="The file or direct….

    Why it could matter

    • Calls or consumers built for the earlier schema may need to change.

    What to verify

    • Validate representative existing tool calls against the new argument schema.
    Declared effect
    write → write

    Input schema

    PropertyPrevious (2.2.0)Current (2.3.0)Change
    destinationstringrequiredstringrequired
    • Description changed
    sourcestringrequiredstringrequired
    • Description changed
    1 unchanged entry
    • (schema root)

    Output schema

    Output schema unchanged.

    2 unchanged entries
    • (schema root)
    • content
    Exact JSON from the published snapshots

    Loads the exact recorded definitions of this tool from both releases. The full snapshots are linked under Evidence and provenance.

    Link to this tool
  9. read_fileModifiedSchemaREVIEW

    What changed

    • read_file — Schema change: input property path changed: +description="The file to read a….

    Why it could matter

    • Calls or consumers built for the earlier schema may need to change.

    What to verify

    • Validate representative existing tool calls against the new argument schema.
    Declared effect
    read → read

    Input schema

    PropertyPrevious (2.2.0)Current (2.3.0)Change
    pathstringrequiredstringrequired
    • Description changed
    3 unchanged entries
    • (schema root)
    • head
    • tail

    Output schema

    Output schema unchanged.

    2 unchanged entries
    • (schema root)
    • content
    Exact JSON from the published snapshots

    Loads the exact recorded definitions of this tool from both releases. The full snapshots are linked under Evidence and provenance.

    Link to this tool
  10. read_media_fileModifiedSchemaREVIEW

    What changed

    • read_media_file — Schema change: input property path changed: +description="The image, audio o….

    Why it could matter

    • Calls or consumers built for the earlier schema may need to change.

    What to verify

    • Validate representative existing tool calls against the new argument schema.
    Declared effect
    read → read

    Input schema

    PropertyPrevious (2.2.0)Current (2.3.0)Change
    pathstringrequiredstringrequired
    • Description changed
    1 unchanged entry
    • (schema root)

    Output schema

    Output schema unchanged.

    3 unchanged entries
    • (schema root)
    • content
    • content › [items]
    Exact JSON from the published snapshots

    Loads the exact recorded definitions of this tool from both releases. The full snapshots are linked under Evidence and provenance.

    Link to this tool
  11. read_text_fileModifiedSchemaREVIEW

    What changed

    • read_text_file — Schema change: input property path changed: +description="The file to read a….

    Why it could matter

    • Calls or consumers built for the earlier schema may need to change.

    What to verify

    • Validate representative existing tool calls against the new argument schema.
    Declared effect
    read → read

    Input schema

    PropertyPrevious (2.2.0)Current (2.3.0)Change
    pathstringrequiredstringrequired
    • Description changed
    3 unchanged entries
    • (schema root)
    • head
    • tail

    Output schema

    Output schema unchanged.

    2 unchanged entries
    • (schema root)
    • content
    Exact JSON from the published snapshots

    Loads the exact recorded definitions of this tool from both releases. The full snapshots are linked under Evidence and provenance.

    Link to this tool
  12. search_filesModifiedSchemaREVIEW

    What changed

    • search_files — Schema change: input property excludePatterns changed: +description="Patterns for entri….
    • search_files — Schema change: input property path changed: +description="The directory to s….
    • search_files — Schema change: input property pattern changed: +description="Glob matched again….

    Why it could matter

    • Calls or consumers built for the earlier schema may need to change.

    What to verify

    • Validate representative existing tool calls against the new argument schema.
    Declared effect
    read → read

    Input schema

    PropertyPrevious (2.2.0)Current (2.3.0)Change
    excludePatternsarray, default (0)optionalarray, default (0)optional
    • Description changed
    pathstringrequiredstringrequired
    • Description changed
    patternstringrequiredstringrequired
    • Description changed
    2 unchanged entries
    • (schema root)
    • excludePatterns › [items]

    Output schema

    Output schema unchanged.

    2 unchanged entries
    • (schema root)
    • content
    Exact JSON from the published snapshots

    Loads the exact recorded definitions of this tool from both releases. The full snapshots are linked under Evidence and provenance.

    Link to this tool
  13. write_fileModifiedSchemaREVIEW

    What changed

    • write_file — Schema change: input property content changed: +description="The complete text ….
    • write_file — Schema change: input property path changed: +description="The file to create….

    Why it could matter

    • Calls or consumers built for the earlier schema may need to change.

    What to verify

    • Validate representative existing tool calls against the new argument schema.
    Declared effect
    write → write

    Input schema

    PropertyPrevious (2.2.0)Current (2.3.0)Change
    contentstringrequiredstringrequired
    • Description changed
    pathstringrequiredstringrequired
    • Description changed
    1 unchanged entry
    • (schema root)

    Output schema

    Output schema unchanged.

    2 unchanged entries
    • (schema root)
    • content
    Exact JSON from the published snapshots

    Loads the exact recorded definitions of this tool from both releases. The full snapshots are linked under Evidence and provenance.

    Link to this tool
3 tools with no recorded change
  • copy_file
  • list_allowed_directories
  • read_multiple_files

Evidence and provenance

Static findings
REVIEW from Modelara’s automated analysis of the two declared interfaces. A policy outcome, not a security rating or a runtime test.
Human review
Pending human review. No reviewer decision is recorded for this comparison.
Published evidence
Part of Valyd’s published data generation listed in valyd-data-source.json. Published records are not rewritten.
Show provenance and exact files
Comparison
filesystem/2.2.0~2.3.0The published comparison identifier.
Analyzer
modelara v0.1.8Policy version not recorded.Analyzed Nov 12, 2026, 12:57 AM UTC.
Distribution
npm
Previous release
@modelcontextprotocol/server-filesystem@2.2.016 tools · published by the registry Nov 4, 2026, 9:36 PM UTCArtifact integritysha512-mNLj/qhV+P4kj1qP8VzgQ2fjSmWcKDQ3Q+KpZEA+WahCDWHw5zJBRQUNSPZ6Ai2/ZGGUjzNzsFpz958a1+4T9A==Interface fingerprintsha256:28daa4cf473cea0b961f4339affca39603a55e75474254fae65e6ac2431c2020Exact interface snapshot (JSON)
Current release
@modelcontextprotocol/server-filesystem@2.3.016 tools · published by the registry Nov 11, 2026, 7:10 AM UTCArtifact integritysha512-dnwDFqYi2Q3VbFDnVOUme4+81CzwHBj3OKeYEgZ6UkBp7rWSm5OKiidemgIF0kkt5AyAi6mHsqx0cfTZBP1DJQ==Interface fingerprintsha256:b6e3a06216491e21fc3f9d121580807ef58ce7410b28d420b95d046684474949Exact interface snapshot (JSON)

The integrity value or digest identifies the exact artifact that was inspected; it does not show that the package is safe. The interface fingerprint identifies the declared tools and schemas Modelara recorded for that release.

MODELARA ANALYSIS OUTPUT

Interface findings

Analyzed with Modelara v0.1.8 · Nov 12, 2026

Requires review

13 findings
  • append_fileREVIEWChanged

    Input schema changed

    Show details
    • input property path changed: +description="The file to append…
    Authority
    WRITEWRITE
    Authority unchanged
  • create_directoryREVIEWChanged

    Input schema changed

    Show details
    • input property path changed: +description="The directory to c…
    Authority
    WRITEWRITE
    Authority unchanged
  • directory_treeREVIEWChanged

    Input schema changed

    Show details
    • input property excludePatterns changed: +description="Patterns for entri…
    • input property path changed: +description="The directory at t…
    Authority
    READREAD
    Authority unchanged
  • edit_fileREVIEWChanged

    Input schema changed

    Show details
    • input property edits changed: +description="The replacements t…
    • input property path changed: +description="The text file to e…
    Authority
    DESTRUCTIVEDESTRUCTIVE
    Authority unchanged
  • get_file_infoREVIEWChanged

    Input schema changed

    Show details
    • input property path changed: +description="The file or direct…
    Authority
    READREAD
    Authority unchanged
  • list_directoryREVIEWChanged

    Input schema changed

    Show details
    • input property path changed: +description="The directory to l…
    Authority
    READREAD
    Authority unchanged
  • list_directory_with_sizesREVIEWChanged

    Input schema changed

    Show details
    • input property path changed: +description="The directory to l…
    Authority
    READREAD
    Authority unchanged
  • move_fileREVIEWChanged

    Input schema changed

    Show details
    • input property destination changed: +description="Its new path, incl…
    • input property source changed: +description="The file or direct…
    Authority
    DESTRUCTIVEDESTRUCTIVE
    Authority unchanged
  • read_fileREVIEWChanged

    Input schema changed

    Show details
    • input property path changed: +description="The file to read a…
    Authority
    READREAD
    Authority unchanged
  • read_media_fileREVIEWChanged

    Input schema changed

    Show details
    • input property path changed: +description="The image, audio o…
    Authority
    READREAD
    Authority unchanged
  • read_text_fileREVIEWChanged

    Input schema changed

    Show details
    • input property path changed: +description="The file to read a…
    Authority
    READREAD
    Authority unchanged
  • search_filesREVIEWChanged

    Input schema changed

    Show details
    • input property excludePatterns changed: +description="Patterns for entri…
    • input property path changed: +description="The directory to s…
    • input property pattern changed: +description="Glob matched again…
    Authority
    READREAD
    Authority unchanged
  • write_fileREVIEWChanged

    Input schema changed

    Show details
    • input property content changed: +description="The complete text …
    • input property path changed: +description="The file to create…
    Authority
    DESTRUCTIVEDESTRUCTIVE
    Authority unchanged

Informational

2 findings
  • list_directoryINFOChanged

    Description changed

    Authority
    READREAD
    Authority unchanged
  • list_directory_with_sizesINFOChanged

    Description changed

    Authority
    READREAD
    Authority unchanged
What do these results mean?
PASS
No policy-significant interface change detected.
REVIEW
Interface changes require inspection.
FAIL
A policy-significant change was detected.
INVALID
The comparison could not be evaluated reliably.
← Back to Filesystem MCP release history