developer-tools Static interface comparison
Filesystem MCP
2026.7.4 2026.7.10
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.
INTERFACE DIFF
What changed, tool by tool
- 0Added tools
- 0Removed tools
- 14Modified tools
- 0Input-schema changes
- 1Output-schema changes
- 0Declared authority changes
14 tools with recorded changes
create_directoryModifiedWhat 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
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: 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)excludePatternsexcludePatterns › [items]path
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: 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)dryRuneditsedits › [items]edits › [items] › newTextedits › [items] › oldTextpath
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: 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
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: 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
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: 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
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: 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)pathsortBy
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: 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)destinationsource
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: 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)headpathtail
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 — 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
Property Previous (2026.7.4) Current (2026.7.10) Change content › [items]object, additionalProperties=false anyOf (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] › datastringrequired not present - Removed
content › [items] › mimeTypestringrequired not present - Removed
content › [items] › typestring, enum (3)required not present - Removed
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_multiple_filesModifiedWhat 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)pathspaths › [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.
read_text_fileModifiedWhat 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)headpathtail
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: 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)excludePatternsexcludePatterns › [items]pathpattern
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: 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)contentpath
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.
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)- 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
1 findingread_media_fileREVIEWChangedShow details
output property content changed: items {"additionalPropert… → {"anyOf":[{"additio…
Informational
15 findingsread_media_fileINFOChangedcreate_directoryINFOChangedShow details
declared open_world: unknown → false
directory_treeINFOChangedShow details
declared open_world: unknown → false
edit_fileINFOChangedShow details
declared open_world: unknown → false
get_file_infoINFOChangedShow details
declared open_world: unknown → false
list_allowed_directoriesINFOChangedShow details
declared open_world: unknown → false
list_directoryINFOChangedShow details
declared open_world: unknown → false
list_directory_with_sizesINFOChangedShow details
declared open_world: unknown → false
move_fileINFOChangedShow details
declared open_world: unknown → false
read_fileINFOChangedShow details
declared open_world: unknown → false
read_media_fileINFOChangedShow details
declared open_world: unknown → false
read_multiple_filesINFOChangedShow details
declared open_world: unknown → false
read_text_fileINFOChangedShow details
declared open_world: unknown → false
search_filesINFOChangedShow details
declared open_world: unknown → false
write_fileINFOChangedShow details
declared open_world: unknown → false
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.