# MCP Filesystem Server (@modelcontextprotocol/server-filesystem) - AgentBreakWatch Reference

> TL;DR Verdict: MCP Filesystem Server (`@modelcontextprotocol/server-filesystem`) is currently at v2.0.0 on NPM (published 2026-10-19), with a 90-day Stability Score of 78/100 (B) and HIGH schema drift risk across 3 releases in the last 90 days. Major v2.0.0 release enforces roots protocol capabilities, tightens symlink path traversal validation, and updates edit_file dryRun diff schema.

## Live Telemetry Metadata
- Canonical Page: https://agentbreakwatch.vercel.app/p/mcp-server-filesystem
- Category Hub: https://agentbreakwatch.vercel.app/c/official-reference (Official Reference MCP Servers Stability & Migration Index)
- Package Name: `@modelcontextprotocol/server-filesystem`
- Registry: NPM (https://www.npmjs.com/package/@modelcontextprotocol/server-filesystem)
- GitHub Repository: https://github.com/modelcontextprotocol/servers
- Vendor: Model Context Protocol
- Latest Live Version: v2.0.0
- Published Date: 2026-10-19T06:49:57.471Z
- 90-Day Release Count: 3
- Direct Dependencies: 5
- License: SEE LICENSE IN LICENSE
- Stability Score: 78/100 (Grade B)
- Schema Drift Risk: HIGH
- Recommended Exact Pin Command: `npx -y @modelcontextprotocol/server-filesystem@2.0.0`
- Watched Symbols / MCP Tools: read_text_file, read_multiple_files, edit_file, list_allowed_directories
- Snapshot Timestamp: 2026-10-24T12:11:27.697Z

## Breaking Change & Schema Drift Summary
Major v2.0.0 release enforces roots protocol capabilities, tightens symlink path traversal validation, and updates edit_file dryRun diff schema.

## Migration Diff: Before (Deprecated / Unpinned Pattern)
```
// tools/call: read_file (legacy alias)
{ "name": "read_file", "arguments": { "path": "/workspace/app.ts" } }
```

## Migration Diff: After (Verified v2.0.0 Pattern)
```
// tools/call: read_text_file (v2.0.0+)
{ "name": "read_text_file", "arguments": { "path": "/workspace/app.ts", "head": 200 } }
```

## Recent Verified Releases
- v2.0.0 (published 2026-10-19) [LATEST]
- v1.0.0 (published 2026-10-11)
- v2026.8.31 (published 2026-08-31)
- v2026.7.10 (published 2026-07-10)
- v2026.7.4 (published 2026-07-04)
- v2026.1.14 (published 2026-01-14)