developer-tools Static interface comparison
Filesystem MCP
2.2.0 2.3.0
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.
INTERFACE DIFF
What changed, tool by tool
- 0Added tools
- 0Removed tools
- 13Modified tools
- 13Input-schema changes
- 0Output-schema changes
- 0Declared authority changes
13 tools with recorded changes
append_fileModifiedWhat 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
Property Previous (2.2.0) Current (2.3.0) Change pathstringrequired stringrequired - Description changed
2 unchanged entries
(schema root)content
Output schema
Output schema unchanged.
2 unchanged entries
(schema root)content
Link to this toolExact 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.
create_directoryModifiedWhat 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
Property Previous (2.2.0) Current (2.3.0) Change pathstringrequired stringrequired - Description changed
1 unchanged entry
(schema root)
Output schema
Output schema unchanged.
2 unchanged entries
(schema root)content
Link to this toolExact 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.
directory_treeModifiedWhat 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
Property Previous (2.2.0) Current (2.3.0) Change excludePatternsarray, default (0)optional array, default (0)optional - Description changed
pathstringrequired stringrequired - Description changed
3 unchanged entries
(schema root)depthexcludePatterns › [items]
Output schema
Output schema unchanged.
2 unchanged entries
(schema root)content
Link to this toolExact 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.
edit_fileModifiedWhat 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
Property Previous (2.2.0) Current (2.3.0) Change editsarrayrequired arrayrequired - Description changed
pathstringrequired stringrequired - Description changed
5 unchanged entries
(schema root)dryRunedits › [items]edits › [items] › newTextedits › [items] › oldText
Output schema
Output schema unchanged.
2 unchanged entries
(schema root)content
Link to this toolExact 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.
get_file_infoModifiedWhat 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
Property Previous (2.2.0) Current (2.3.0) Change pathstringrequired stringrequired - Description changed
1 unchanged entry
(schema root)
Output schema
Output schema unchanged.
2 unchanged entries
(schema root)content
Link to this toolExact 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.
list_directoryModifiedWhat 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
Property Previous (2.2.0) Current (2.3.0) Change pathstringrequired stringrequired - Description changed
1 unchanged entry
(schema root)
Output schema
Output schema unchanged.
2 unchanged entries
(schema root)content
Link to this toolExact 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.
list_directory_with_sizesModifiedWhat 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
Property Previous (2.2.0) Current (2.3.0) Change pathstringrequired stringrequired - Description changed
2 unchanged entries
(schema root)sortBy
Output schema
Output schema unchanged.
2 unchanged entries
(schema root)content
Link to this toolExact 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.
move_fileModifiedWhat 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
Property Previous (2.2.0) Current (2.3.0) Change destinationstringrequired stringrequired - Description changed
sourcestringrequired stringrequired - Description changed
1 unchanged entry
(schema root)
Output schema
Output schema unchanged.
2 unchanged entries
(schema root)content
Link to this toolExact 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.
read_fileModifiedWhat 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
Property Previous (2.2.0) Current (2.3.0) Change pathstringrequired stringrequired - Description changed
3 unchanged entries
(schema root)headtail
Output schema
Output schema unchanged.
2 unchanged entries
(schema root)content
Link to this toolExact 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.
read_media_fileModifiedWhat 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
Property Previous (2.2.0) Current (2.3.0) Change pathstringrequired stringrequired - Description changed
1 unchanged entry
(schema root)
Output schema
Output schema unchanged.
3 unchanged entries
(schema root)contentcontent › [items]
Link to this toolExact 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.
read_text_fileModifiedWhat 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
Property Previous (2.2.0) Current (2.3.0) Change pathstringrequired stringrequired - Description changed
3 unchanged entries
(schema root)headtail
Output schema
Output schema unchanged.
2 unchanged entries
(schema root)content
Link to this toolExact 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.
search_filesModifiedWhat 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
Property Previous (2.2.0) Current (2.3.0) Change excludePatternsarray, default (0)optional array, default (0)optional - Description changed
pathstringrequired stringrequired - Description changed
patternstringrequired stringrequired - Description changed
2 unchanged entries
(schema root)excludePatterns › [items]
Output schema
Output schema unchanged.
2 unchanged entries
(schema root)content
Link to this toolExact 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.
write_fileModifiedWhat 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
Property Previous (2.2.0) Current (2.3.0) Change contentstringrequired stringrequired - Description changed
pathstringrequired stringrequired - Description changed
1 unchanged entry
(schema root)
Output schema
Output schema unchanged.
2 unchanged entries
(schema root)content
Link to this toolExact 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.
No tools match these filters.
3 tools with no recorded change
copy_filelist_allowed_directoriesread_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)- Comparison record
- Exact comparison record (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
Requires review
13 findingsappend_fileREVIEWChangedShow details
input property path changed: +description="The file to append…
create_directoryREVIEWChangedShow details
input property path changed: +description="The directory to c…
directory_treeREVIEWChangedShow details
input property excludePatterns changed: +description="Patterns for entri…input property path changed: +description="The directory at t…
edit_fileREVIEWChangedShow details
input property edits changed: +description="The replacements t…input property path changed: +description="The text file to e…
get_file_infoREVIEWChangedShow details
input property path changed: +description="The file or direct…
list_directoryREVIEWChangedShow details
input property path changed: +description="The directory to l…
list_directory_with_sizesREVIEWChangedShow details
input property path changed: +description="The directory to l…
move_fileREVIEWChangedShow details
input property destination changed: +description="Its new path, incl…input property source changed: +description="The file or direct…
read_fileREVIEWChangedShow details
input property path changed: +description="The file to read a…
read_media_fileREVIEWChangedShow details
input property path changed: +description="The image, audio o…
read_text_fileREVIEWChangedShow details
input property path changed: +description="The file to read a…
search_filesREVIEWChangedShow 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…
write_fileREVIEWChangedShow details
input property content changed: +description="The complete text …input property path changed: +description="The file to create…
Informational
2 findingslist_directoryINFOChangedlist_directory_with_sizesINFOChanged
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.