developer-tools Static interface comparison
Filesystem MCP
2026.8.31 2.0.0
14 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
- 14Modified tools
- 0Input-schema changes
- 14Output-schema changes
- 0Declared authority changes
14 tools with recorded changes
create_directoryModifiedWhat changed
- create_directory — Schema change: input schema keywords changed: $schema "http://json-schema… → "https://json-schem… (metadata only; properties unchanged).
- create_directory — Output schema: schema keywords changed: $schema "http://json-schema… → "https://json-schem… (metadata only; properties unchanged).
Why it could matter
- Calls or consumers built for the earlier schema may need to change.
- Code or prompts that read this tool’s results may receive a different shape.
What to verify
- Validate representative existing tool calls against the new argument schema.
- Check consumers of this tool’s output against the new schema.
- Declared effect
- write → write
Input schema
Property Previous (2026.8.31) Current (2.0.0) Change (schema root)object object - Changed: $schema
$schema: "http://json-schema.org/draft-07/schema#" → "https://json-schema.org/draft/2020-12/schema"1 unchanged entry
path
Output schema
Property Previous (2026.8.31) Current (2.0.0) Change (schema root)object, additionalProperties=false object, additionalProperties=false - Changed: $schema
$schema: "http://json-schema.org/draft-07/schema#" → "https://json-schema.org/draft/2020-12/schema"1 unchanged entry
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 schema keywords changed: $schema "http://json-schema… → "https://json-schem… (metadata only; properties unchanged).
- directory_tree — Output schema: schema keywords changed: $schema "http://json-schema… → "https://json-schem… (metadata only; properties unchanged).
Why it could matter
- Calls or consumers built for the earlier schema may need to change.
- Code or prompts that read this tool’s results may receive a different shape.
What to verify
- Validate representative existing tool calls against the new argument schema.
- Check consumers of this tool’s output against the new schema.
- Declared effect
- read → read
Input schema
Property Previous (2026.8.31) Current (2.0.0) Change (schema root)object object - Changed: $schema
$schema: "http://json-schema.org/draft-07/schema#" → "https://json-schema.org/draft/2020-12/schema"3 unchanged entries
excludePatternsexcludePatterns › [items]path
Output schema
Property Previous (2026.8.31) Current (2.0.0) Change (schema root)object, additionalProperties=false object, additionalProperties=false - Changed: $schema
$schema: "http://json-schema.org/draft-07/schema#" → "https://json-schema.org/draft/2020-12/schema"1 unchanged entry
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 schema keywords changed: $schema "http://json-schema… → "https://json-schem… (metadata only; properties unchanged).
- edit_file — Output schema: schema keywords changed: $schema "http://json-schema… → "https://json-schem… (metadata only; properties unchanged).
Why it could matter
- Calls or consumers built for the earlier schema may need to change.
- Code or prompts that read this tool’s results may receive a different shape.
What to verify
- Validate representative existing tool calls against the new argument schema.
- Check consumers of this tool’s output against the new schema.
- Declared effect
- write → write
Input schema
Property Previous (2026.8.31) Current (2.0.0) Change (schema root)object object - Changed: $schema
$schema: "http://json-schema.org/draft-07/schema#" → "https://json-schema.org/draft/2020-12/schema"6 unchanged entries
dryRuneditsedits › [items]edits › [items] › newTextedits › [items] › oldTextpath
Output schema
Property Previous (2026.8.31) Current (2.0.0) Change (schema root)object, additionalProperties=false object, additionalProperties=false - Changed: $schema
$schema: "http://json-schema.org/draft-07/schema#" → "https://json-schema.org/draft/2020-12/schema"1 unchanged entry
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 schema keywords changed: $schema "http://json-schema… → "https://json-schem… (metadata only; properties unchanged).
- get_file_info — Output schema: schema keywords changed: $schema "http://json-schema… → "https://json-schem… (metadata only; properties unchanged).
Why it could matter
- Calls or consumers built for the earlier schema may need to change.
- Code or prompts that read this tool’s results may receive a different shape.
What to verify
- Validate representative existing tool calls against the new argument schema.
- Check consumers of this tool’s output against the new schema.
- Declared effect
- read → read
Input schema
Property Previous (2026.8.31) Current (2.0.0) Change (schema root)object object - Changed: $schema
$schema: "http://json-schema.org/draft-07/schema#" → "https://json-schema.org/draft/2020-12/schema"1 unchanged entry
path
Output schema
Property Previous (2026.8.31) Current (2.0.0) Change (schema root)object, additionalProperties=false object, additionalProperties=false - Changed: $schema
$schema: "http://json-schema.org/draft-07/schema#" → "https://json-schema.org/draft/2020-12/schema"1 unchanged entry
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_allowed_directoriesModifiedWhat changed
- list_allowed_directories — Schema change: input schema keywords changed: $schema "http://json-schema… → "https://json-schem… (metadata only; properties unchanged).
- list_allowed_directories — Output schema: schema keywords changed: $schema "http://json-schema… → "https://json-schem… (metadata only; properties unchanged).
Why it could matter
- Calls or consumers built for the earlier schema may need to change.
- Code or prompts that read this tool’s results may receive a different shape.
What to verify
- Validate representative existing tool calls against the new argument schema.
- Check consumers of this tool’s output against the new schema.
- Declared effect
- read → read
Input schema
Property Previous (2026.8.31) Current (2.0.0) Change (schema root)object object - Changed: $schema
$schema: "http://json-schema.org/draft-07/schema#" → "https://json-schema.org/draft/2020-12/schema"Output schema
Property Previous (2026.8.31) Current (2.0.0) Change (schema root)object, additionalProperties=false object, additionalProperties=false - Changed: $schema
$schema: "http://json-schema.org/draft-07/schema#" → "https://json-schema.org/draft/2020-12/schema"1 unchanged entry
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 schema keywords changed: $schema "http://json-schema… → "https://json-schem… (metadata only; properties unchanged).
- list_directory — Output schema: schema keywords changed: $schema "http://json-schema… → "https://json-schem… (metadata only; properties unchanged).
Why it could matter
- Calls or consumers built for the earlier schema may need to change.
- Code or prompts that read this tool’s results may receive a different shape.
What to verify
- Validate representative existing tool calls against the new argument schema.
- Check consumers of this tool’s output against the new schema.
- Declared effect
- read → read
Input schema
Property Previous (2026.8.31) Current (2.0.0) Change (schema root)object object - Changed: $schema
$schema: "http://json-schema.org/draft-07/schema#" → "https://json-schema.org/draft/2020-12/schema"1 unchanged entry
path
Output schema
Property Previous (2026.8.31) Current (2.0.0) Change (schema root)object, additionalProperties=false object, additionalProperties=false - Changed: $schema
$schema: "http://json-schema.org/draft-07/schema#" → "https://json-schema.org/draft/2020-12/schema"1 unchanged entry
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 schema keywords changed: $schema "http://json-schema… → "https://json-schem… (metadata only; properties unchanged).
- list_directory_with_sizes — Output schema: schema keywords changed: $schema "http://json-schema… → "https://json-schem… (metadata only; properties unchanged).
Why it could matter
- Calls or consumers built for the earlier schema may need to change.
- Code or prompts that read this tool’s results may receive a different shape.
What to verify
- Validate representative existing tool calls against the new argument schema.
- Check consumers of this tool’s output against the new schema.
- Declared effect
- read → read
Input schema
Property Previous (2026.8.31) Current (2.0.0) Change (schema root)object object - Changed: $schema
$schema: "http://json-schema.org/draft-07/schema#" → "https://json-schema.org/draft/2020-12/schema"2 unchanged entries
pathsortBy
Output schema
Property Previous (2026.8.31) Current (2.0.0) Change (schema root)object, additionalProperties=false object, additionalProperties=false - Changed: $schema
$schema: "http://json-schema.org/draft-07/schema#" → "https://json-schema.org/draft/2020-12/schema"1 unchanged entry
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 schema keywords changed: $schema "http://json-schema… → "https://json-schem… (metadata only; properties unchanged).
- move_file — Output schema: schema keywords changed: $schema "http://json-schema… → "https://json-schem… (metadata only; properties unchanged).
Why it could matter
- Calls or consumers built for the earlier schema may need to change.
- Code or prompts that read this tool’s results may receive a different shape.
What to verify
- Validate representative existing tool calls against the new argument schema.
- Check consumers of this tool’s output against the new schema.
- Declared effect
- write → write
Input schema
Property Previous (2026.8.31) Current (2.0.0) Change (schema root)object object - Changed: $schema
$schema: "http://json-schema.org/draft-07/schema#" → "https://json-schema.org/draft/2020-12/schema"2 unchanged entries
destinationsource
Output schema
Property Previous (2026.8.31) Current (2.0.0) Change (schema root)object, additionalProperties=false object, additionalProperties=false - Changed: $schema
$schema: "http://json-schema.org/draft-07/schema#" → "https://json-schema.org/draft/2020-12/schema"1 unchanged entry
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 schema keywords changed: $schema "http://json-schema… → "https://json-schem… (metadata only; properties unchanged).
- read_file — Output schema: schema keywords changed: $schema "http://json-schema… → "https://json-schem… (metadata only; properties unchanged).
Why it could matter
- Calls or consumers built for the earlier schema may need to change.
- Code or prompts that read this tool’s results may receive a different shape.
What to verify
- Validate representative existing tool calls against the new argument schema.
- Check consumers of this tool’s output against the new schema.
- Declared effect
- read → read
Input schema
Property Previous (2026.8.31) Current (2.0.0) Change (schema root)object object - Changed: $schema
$schema: "http://json-schema.org/draft-07/schema#" → "https://json-schema.org/draft/2020-12/schema"3 unchanged entries
headpathtail
Output schema
Property Previous (2026.8.31) Current (2.0.0) Change (schema root)object, additionalProperties=false object, additionalProperties=false - Changed: $schema
$schema: "http://json-schema.org/draft-07/schema#" → "https://json-schema.org/draft/2020-12/schema"1 unchanged entry
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 schema keywords changed: $schema "http://json-schema… → "https://json-schem… (metadata only; properties unchanged).
- read_media_file — Output schema: schema keywords changed: $schema "http://json-schema… → "https://json-schem… (metadata only; properties unchanged).
Why it could matter
- Calls or consumers built for the earlier schema may need to change.
- Code or prompts that read this tool’s results may receive a different shape.
What to verify
- Validate representative existing tool calls against the new argument schema.
- Check consumers of this tool’s output against the new schema.
- Declared effect
- read → read
Input schema
Property Previous (2026.8.31) Current (2.0.0) Change (schema root)object object - Changed: $schema
$schema: "http://json-schema.org/draft-07/schema#" → "https://json-schema.org/draft/2020-12/schema"1 unchanged entry
path
Output schema
Property Previous (2026.8.31) Current (2.0.0) Change (schema root)object, additionalProperties=false object, additionalProperties=false - Changed: $schema
$schema: "http://json-schema.org/draft-07/schema#" → "https://json-schema.org/draft/2020-12/schema"2 unchanged entries
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_multiple_filesModifiedWhat changed
- read_multiple_files — Schema change: input schema keywords changed: $schema "http://json-schema… → "https://json-schem… (metadata only; properties unchanged).
- read_multiple_files — Output schema: schema keywords changed: $schema "http://json-schema… → "https://json-schem… (metadata only; properties unchanged).
Why it could matter
- Calls or consumers built for the earlier schema may need to change.
- Code or prompts that read this tool’s results may receive a different shape.
What to verify
- Validate representative existing tool calls against the new argument schema.
- Check consumers of this tool’s output against the new schema.
- Declared effect
- read → read
Input schema
Property Previous (2026.8.31) Current (2.0.0) Change (schema root)object object - Changed: $schema
$schema: "http://json-schema.org/draft-07/schema#" → "https://json-schema.org/draft/2020-12/schema"2 unchanged entries
pathspaths › [items]
Output schema
Property Previous (2026.8.31) Current (2.0.0) Change (schema root)object, additionalProperties=false object, additionalProperties=false - Changed: $schema
$schema: "http://json-schema.org/draft-07/schema#" → "https://json-schema.org/draft/2020-12/schema"1 unchanged entry
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_text_fileModifiedWhat changed
- read_text_file — Schema change: input schema keywords changed: $schema "http://json-schema… → "https://json-schem… (metadata only; properties unchanged).
- read_text_file — Output schema: schema keywords changed: $schema "http://json-schema… → "https://json-schem… (metadata only; properties unchanged).
Why it could matter
- Calls or consumers built for the earlier schema may need to change.
- Code or prompts that read this tool’s results may receive a different shape.
What to verify
- Validate representative existing tool calls against the new argument schema.
- Check consumers of this tool’s output against the new schema.
- Declared effect
- read → read
Input schema
Property Previous (2026.8.31) Current (2.0.0) Change (schema root)object object - Changed: $schema
$schema: "http://json-schema.org/draft-07/schema#" → "https://json-schema.org/draft/2020-12/schema"3 unchanged entries
headpathtail
Output schema
Property Previous (2026.8.31) Current (2.0.0) Change (schema root)object, additionalProperties=false object, additionalProperties=false - Changed: $schema
$schema: "http://json-schema.org/draft-07/schema#" → "https://json-schema.org/draft/2020-12/schema"1 unchanged entry
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 schema keywords changed: $schema "http://json-schema… → "https://json-schem… (metadata only; properties unchanged).
- search_files — Output schema: schema keywords changed: $schema "http://json-schema… → "https://json-schem… (metadata only; properties unchanged).
Why it could matter
- Calls or consumers built for the earlier schema may need to change.
- Code or prompts that read this tool’s results may receive a different shape.
What to verify
- Validate representative existing tool calls against the new argument schema.
- Check consumers of this tool’s output against the new schema.
- Declared effect
- read → read
Input schema
Property Previous (2026.8.31) Current (2.0.0) Change (schema root)object object - Changed: $schema
$schema: "http://json-schema.org/draft-07/schema#" → "https://json-schema.org/draft/2020-12/schema"4 unchanged entries
excludePatternsexcludePatterns › [items]pathpattern
Output schema
Property Previous (2026.8.31) Current (2.0.0) Change (schema root)object, additionalProperties=false object, additionalProperties=false - Changed: $schema
$schema: "http://json-schema.org/draft-07/schema#" → "https://json-schema.org/draft/2020-12/schema"1 unchanged entry
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 schema keywords changed: $schema "http://json-schema… → "https://json-schem… (metadata only; properties unchanged).
- write_file — Output schema: schema keywords changed: $schema "http://json-schema… → "https://json-schem… (metadata only; properties unchanged).
Why it could matter
- Calls or consumers built for the earlier schema may need to change.
- Code or prompts that read this tool’s results may receive a different shape.
What to verify
- Validate representative existing tool calls against the new argument schema.
- Check consumers of this tool’s output against the new schema.
- Declared effect
- write → write
Input schema
Property Previous (2026.8.31) Current (2.0.0) Change (schema root)object object - Changed: $schema
$schema: "http://json-schema.org/draft-07/schema#" → "https://json-schema.org/draft/2020-12/schema"2 unchanged entries
contentpath
Output schema
Property Previous (2026.8.31) Current (2.0.0) Change (schema root)object, additionalProperties=false object, additionalProperties=false - Changed: $schema
$schema: "http://json-schema.org/draft-07/schema#" → "https://json-schema.org/draft/2020-12/schema"1 unchanged entry
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.
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.8.31~2.0.0The published comparison identifier.- Analyzer
modelara v0.1.7Policy version not recorded.Analyzed Nov 2, 2026, 5:16 PM UTC.- Distribution
npm- Previous release
@modelcontextprotocol/server-filesystem@2026.8.3114 tools · published by the registry Aug 31, 2026, 8:25 PM UTCArtifact integritysha512-kKaFkyAh6oipvc9+EAbJ552JafnMnOq5nzmzWkp1jJdBhTAAGpmIpWihUG1+rfNhmEFM98gUZDdCHCDD4v6a7Q==Interface fingerprintsha256:e88c4a3129d74121ba31040692c94425f51ea94f18c7d7f3f71db32a3f9c5883Exact interface snapshot (JSON)- Current release
@modelcontextprotocol/server-filesystem@2.0.014 tools · published by the registry Oct 19, 2026, 6:49 AM UTCArtifact integritysha512-JT+bt9wrNIMqhGvOr49vEE9NpbkBxdjQxyLVqh3lYHsB2zGgbzePmDOGrm1glBT1DPR5YvkM6h/NXztWSRhywg==Interface fingerprintsha256:180d970f0a9a0a9dde12c00875effe998edf163c88cda3c5d7f8aeac0852d409Exact 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
14 findingscreate_directoryREVIEWChangedShow details
input schema keywords changed: $schema "http://json-schema… → "https://json-schem… (metadata only; properties unchanged)output schema keywords changed: $schema "http://json-schema… → "https://json-schem… (metadata only; properties unchanged)
directory_treeREVIEWChangedShow details
input schema keywords changed: $schema "http://json-schema… → "https://json-schem… (metadata only; properties unchanged)output schema keywords changed: $schema "http://json-schema… → "https://json-schem… (metadata only; properties unchanged)
edit_fileREVIEWChangedShow details
input schema keywords changed: $schema "http://json-schema… → "https://json-schem… (metadata only; properties unchanged)output schema keywords changed: $schema "http://json-schema… → "https://json-schem… (metadata only; properties unchanged)
get_file_infoREVIEWChangedShow details
input schema keywords changed: $schema "http://json-schema… → "https://json-schem… (metadata only; properties unchanged)output schema keywords changed: $schema "http://json-schema… → "https://json-schem… (metadata only; properties unchanged)
list_allowed_directoriesREVIEWChangedShow details
input schema keywords changed: $schema "http://json-schema… → "https://json-schem… (metadata only; properties unchanged)output schema keywords changed: $schema "http://json-schema… → "https://json-schem… (metadata only; properties unchanged)
list_directoryREVIEWChangedShow details
input schema keywords changed: $schema "http://json-schema… → "https://json-schem… (metadata only; properties unchanged)output schema keywords changed: $schema "http://json-schema… → "https://json-schem… (metadata only; properties unchanged)
list_directory_with_sizesREVIEWChangedShow details
input schema keywords changed: $schema "http://json-schema… → "https://json-schem… (metadata only; properties unchanged)output schema keywords changed: $schema "http://json-schema… → "https://json-schem… (metadata only; properties unchanged)
move_fileREVIEWChangedShow details
input schema keywords changed: $schema "http://json-schema… → "https://json-schem… (metadata only; properties unchanged)output schema keywords changed: $schema "http://json-schema… → "https://json-schem… (metadata only; properties unchanged)
read_fileREVIEWChangedShow details
input schema keywords changed: $schema "http://json-schema… → "https://json-schem… (metadata only; properties unchanged)output schema keywords changed: $schema "http://json-schema… → "https://json-schem… (metadata only; properties unchanged)
read_media_fileREVIEWChangedShow details
input schema keywords changed: $schema "http://json-schema… → "https://json-schem… (metadata only; properties unchanged)output schema keywords changed: $schema "http://json-schema… → "https://json-schem… (metadata only; properties unchanged)
read_multiple_filesREVIEWChangedShow details
input schema keywords changed: $schema "http://json-schema… → "https://json-schem… (metadata only; properties unchanged)output schema keywords changed: $schema "http://json-schema… → "https://json-schem… (metadata only; properties unchanged)
read_text_fileREVIEWChangedShow details
input schema keywords changed: $schema "http://json-schema… → "https://json-schem… (metadata only; properties unchanged)output schema keywords changed: $schema "http://json-schema… → "https://json-schem… (metadata only; properties unchanged)
search_filesREVIEWChangedShow details
input schema keywords changed: $schema "http://json-schema… → "https://json-schem… (metadata only; properties unchanged)output schema keywords changed: $schema "http://json-schema… → "https://json-schem… (metadata only; properties unchanged)
write_fileREVIEWChangedShow details
input schema keywords changed: $schema "http://json-schema… → "https://json-schem… (metadata only; properties unchanged)output schema keywords changed: $schema "http://json-schema… → "https://json-schem… (metadata only; properties 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.