developer-tools Static interface comparison

Filesystem MCP

2026.7.4 2026.7.10

REVIEWPending human review

1 schema change requires 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.

Tools14 → 14
Added0
Removed0
Schema changes1
Input schema changes0
Output schema changes1
Unclassified schema changes0
Description changes1
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

14 tools with recorded changes

  1. create_directoryModifiedMetadataINFO

    What changed

    • create_directory: declared metadata changed (declared open_world: unknown → false).

    Why it could matter

    • Annotations such as idempotent or open-world hints can inform how clients treat a tool.

    What to verify

    • Confirm any client logic that relies on these annotations.
    Declared effect
    write → write

    Input schema

    Input schema unchanged.

    2 unchanged entries
    • (schema root)
    • path

    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. directory_treeModifiedMetadataINFO

    What changed

    • directory_tree: declared metadata changed (declared open_world: unknown → false).

    Why it could matter

    • Annotations such as idempotent or open-world hints can inform how clients treat a tool.

    What to verify

    • Confirm any client logic that relies on these annotations.
    Declared effect
    read → read

    Input schema

    Input schema unchanged.

    4 unchanged entries
    • (schema root)
    • excludePatterns
    • excludePatterns › [items]
    • path

    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. edit_fileModifiedMetadataINFO

    What changed

    • edit_file: declared metadata changed (declared open_world: unknown → false).

    Why it could matter

    • Annotations such as idempotent or open-world hints can inform how clients treat a tool.

    What to verify

    • Confirm any client logic that relies on these annotations.
    Declared effect
    write → write

    Input schema

    Input schema unchanged.

    7 unchanged entries
    • (schema root)
    • dryRun
    • edits
    • edits › [items]
    • edits › [items] › newText
    • edits › [items] › oldText
    • path

    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. get_file_infoModifiedMetadataINFO

    What changed

    • get_file_info: declared metadata changed (declared open_world: unknown → false).

    Why it could matter

    • Annotations such as idempotent or open-world hints can inform how clients treat a tool.

    What to verify

    • Confirm any client logic that relies on these annotations.
    Declared effect
    read → read

    Input schema

    Input schema unchanged.

    2 unchanged entries
    • (schema root)
    • path

    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. list_allowed_directoriesModifiedMetadataINFO

    What changed

    • list_allowed_directories: declared metadata changed (declared open_world: unknown → false).

    Why it could matter

    • Annotations such as idempotent or open-world hints can inform how clients treat a tool.

    What to verify

    • Confirm any client logic that relies on these annotations.
    Declared effect
    read → read

    Input schema

    Input schema unchanged.

    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_directoryModifiedMetadataINFO

    What changed

    • list_directory: declared metadata changed (declared open_world: unknown → false).

    Why it could matter

    • Annotations such as idempotent or open-world hints can inform how clients treat a tool.

    What to verify

    • Confirm any client logic that relies on these annotations.
    Declared effect
    read → read

    Input schema

    Input schema unchanged.

    2 unchanged entries
    • (schema root)
    • path

    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_sizesModifiedMetadataINFO

    What changed

    • list_directory_with_sizes: declared metadata changed (declared open_world: unknown → false).

    Why it could matter

    • Annotations such as idempotent or open-world hints can inform how clients treat a tool.

    What to verify

    • Confirm any client logic that relies on these annotations.
    Declared effect
    read → read

    Input schema

    Input schema unchanged.

    3 unchanged entries
    • (schema root)
    • path
    • 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_fileModifiedMetadataINFO

    What changed

    • move_file: declared metadata changed (declared open_world: unknown → false).

    Why it could matter

    • Annotations such as idempotent or open-world hints can inform how clients treat a tool.

    What to verify

    • Confirm any client logic that relies on these annotations.
    Declared effect
    write → write

    Input schema

    Input schema unchanged.

    3 unchanged entries
    • (schema root)
    • destination
    • source

    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_fileModifiedMetadataINFO

    What changed

    • read_file: declared metadata changed (declared open_world: unknown → false).

    Why it could matter

    • Annotations such as idempotent or open-world hints can inform how clients treat a tool.

    What to verify

    • Confirm any client logic that relies on these annotations.
    Declared effect
    read → read

    Input schema

    Input schema unchanged.

    4 unchanged entries
    • (schema root)
    • head
    • path
    • 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_fileModifiedSchemaDescriptionMetadataREVIEWINFO

    What changed

    • read_media_file — Output schema: property content changed: items {"additionalPropert… → {"anyOf":[{"additio….
    • read_media_file: description changed.
    • read_media_file: declared metadata changed (declared open_world: unknown → false).

    Why it could matter

    • Code or prompts that read this tool’s results may receive a different shape.
    • Models choose and call tools partly from their descriptions.
    • Annotations such as idempotent or open-world hints can inform how clients treat a tool.

    What to verify

    • Check consumers of this tool’s output against the new schema.
    • Spot-check that agents still select this tool as intended.
    • Confirm any client logic that relies on these annotations.
    Declared effect
    read → read
    Description
    PreviousRead an image or audio file. Returns the base64 encoded data and MIME type. Only works within allowed directories.
    CurrentRead 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

    Input schema unchanged.

    2 unchanged entries
    • (schema root)
    • path

    Output schema

    PropertyPrevious (2026.7.4)Current (2026.7.10)Change
    content › [items]object, additionalProperties=falseanyOf (2)
    • Constraint: additionalProperties
    • Changed: anyOf
    • Type changed

    additionalProperties: false → —

    anyOf: — → [{"additionalProperties":false,"properties":{"data":{"type":"string"},"mimeType":{"type":"string"},"type":{"enum":["image","audio"],"type":"string"}},"required":["type","data","mimeType"],"type":"object"},{"additionalProperties":false,"prop… (truncated: full value in the exact JSON)

    type: "object" → —

    content › [items] › datastringrequirednot present
    • Removed
    content › [items] › mimeTypestringrequirednot present
    • Removed
    content › [items] › typestring, enum (3)requirednot present
    • Removed
    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
  11. read_multiple_filesModifiedMetadataINFO

    What changed

    • read_multiple_files: declared metadata changed (declared open_world: unknown → false).

    Why it could matter

    • Annotations such as idempotent or open-world hints can inform how clients treat a tool.

    What to verify

    • Confirm any client logic that relies on these annotations.
    Declared effect
    read → read

    Input schema

    Input schema unchanged.

    3 unchanged entries
    • (schema root)
    • paths
    • paths › [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
  12. read_text_fileModifiedMetadataINFO

    What changed

    • read_text_file: declared metadata changed (declared open_world: unknown → false).

    Why it could matter

    • Annotations such as idempotent or open-world hints can inform how clients treat a tool.

    What to verify

    • Confirm any client logic that relies on these annotations.
    Declared effect
    read → read

    Input schema

    Input schema unchanged.

    4 unchanged entries
    • (schema root)
    • head
    • path
    • 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
  13. search_filesModifiedMetadataINFO

    What changed

    • search_files: declared metadata changed (declared open_world: unknown → false).

    Why it could matter

    • Annotations such as idempotent or open-world hints can inform how clients treat a tool.

    What to verify

    • Confirm any client logic that relies on these annotations.
    Declared effect
    read → read

    Input schema

    Input schema unchanged.

    5 unchanged entries
    • (schema root)
    • excludePatterns
    • excludePatterns › [items]
    • path
    • pattern

    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
  14. write_fileModifiedMetadataINFO

    What changed

    • write_file: declared metadata changed (declared open_world: unknown → false).

    Why it could matter

    • Annotations such as idempotent or open-world hints can inform how clients treat a tool.

    What to verify

    • Confirm any client logic that relies on these annotations.
    Declared effect
    write → write

    Input schema

    Input schema unchanged.

    3 unchanged entries
    • (schema root)
    • content
    • path

    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

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/2026.7.4~2026.7.10The published comparison identifier.
Analyzer
modelara v0.1.7Policy version not recorded.Analyzed Nov 1, 2026, 9:41 PM UTC.
Distribution
npm
Previous release
@modelcontextprotocol/server-filesystem@2026.7.414 tools · published by the registry Jul 4, 2026, 11:05 PM UTCArtifact integritysha512-JwEaH4dRRzwcNMwX8WJVCJyXfFxXjFKdgwHxjQhFLhi02kszgyyj611LV9puBLDO1IiDQSCjfKFSPaemegnvwg==Interface fingerprintsha256:79d45fc7cdc82af04dede55a74e2c129f56629725dacb03d6a7b3fcff78de129Exact interface snapshot (JSON)
Current release
@modelcontextprotocol/server-filesystem@2026.7.1014 tools · published by the registry Jul 10, 2026, 3:31 AM UTCArtifact integritysha512-Mmjg4anFBD5OzbPnGJOA0jPPN8645ERhQk38HQLpSenx1ox9bfdPkmAzUnNjeQtqQGFLtKe13J20RtLBmUKMZA==Interface fingerprintsha256:e88c4a3129d74121ba31040692c94425f51ea94f18c7d7f3f71db32a3f9c5883Exact 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.7 · Nov 1, 2026

Requires review

1 finding
  • read_media_fileREVIEWChanged

    Output schema changed

    Show details
    • output property content changed: items {"additionalPropert… → {"anyOf":[{"additio…
    Authority
    READREAD
    Authority unchanged

Informational

15 findings
  • read_media_fileINFOChanged

    Description changed

    Authority
    READREAD
    Authority unchanged
  • create_directoryINFOChanged

    Metadata changed

    Show details
    • declared open_world: unknown → false
    Authority
    WRITEWRITE
    Authority unchanged
  • directory_treeINFOChanged

    Metadata changed

    Show details
    • declared open_world: unknown → false
    Authority
    READREAD
    Authority unchanged
  • edit_fileINFOChanged

    Metadata changed

    Show details
    • declared open_world: unknown → false
    Authority
    DESTRUCTIVEDESTRUCTIVE
    Authority unchanged
  • get_file_infoINFOChanged

    Metadata changed

    Show details
    • declared open_world: unknown → false
    Authority
    READREAD
    Authority unchanged
  • list_allowed_directoriesINFOChanged

    Metadata changed

    Show details
    • declared open_world: unknown → false
    Authority
    READREAD
    Authority unchanged
  • list_directoryINFOChanged

    Metadata changed

    Show details
    • declared open_world: unknown → false
    Authority
    READREAD
    Authority unchanged
  • list_directory_with_sizesINFOChanged

    Metadata changed

    Show details
    • declared open_world: unknown → false
    Authority
    READREAD
    Authority unchanged
  • move_fileINFOChanged

    Metadata changed

    Show details
    • declared open_world: unknown → false
    Authority
    DESTRUCTIVEDESTRUCTIVE
    Authority unchanged
  • read_fileINFOChanged

    Metadata changed

    Show details
    • declared open_world: unknown → false
    Authority
    READREAD
    Authority unchanged
  • read_media_fileINFOChanged

    Metadata changed

    Show details
    • declared open_world: unknown → false
    Authority
    READREAD
    Authority unchanged
  • read_multiple_filesINFOChanged

    Metadata changed

    Show details
    • declared open_world: unknown → false
    Authority
    READREAD
    Authority unchanged
  • read_text_fileINFOChanged

    Metadata changed

    Show details
    • declared open_world: unknown → false
    Authority
    READREAD
    Authority unchanged
  • search_filesINFOChanged

    Metadata changed

    Show details
    • declared open_world: unknown → false
    Authority
    READREAD
    Authority unchanged
  • write_fileINFOChanged

    Metadata changed

    Show details
    • declared open_world: unknown → false
    Authority
    DESTRUCTIVEDESTRUCTIVE
    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