Intelligent Tools
What Changed?
Section titled “What Changed?”In v3.x, there were 6 separate intelligent tools. In v4.0.0, their logic is embedded into the primary tools:
| v3 Tool (removed) | v4 Replacement | Notes |
|---|---|---|
intelligent_read | mcp_read | Auto-selects direct/chunked based on size |
intelligent_write | mcp_write | Auto-selects direct/streaming based on size |
intelligent_edit | mcp_edit | Auto-selects direct/smart-edit based on size |
recovery_edit | mcp_edit | Recovery logic built into intelligent edit |
get_optimization_suggestion | analyze_operation with operation: "optimize" | Unified analysis tool |
analyze_file | analyze_operation with operation: "file" | Unified analysis tool |
How Auto-Optimization Works
Section titled “How Auto-Optimization Works”Every mcp_* tool now automatically:
- Detects file size before operating
- Selects strategy — direct I/O for small files, streaming for large files
- Reports progress for long operations
- Handles errors with recovery fallbacks
Size Thresholds
Section titled “Size Thresholds”| File Size | Strategy |
|---|---|
| < 100 KB | Direct I/O (fastest) |
| 100 KB – 500 KB | Streaming I/O |
| 500 KB – 5 MB | Chunked processing |
| > 5 MB | Special handling with progress |
You don’t need to think about which tool to use — just use read_file, write_file, or edit_file and the server handles the rest.
See Also
Section titled “See Also”- Core Tools — Complete API reference for all 16 tools
- Migration from v3 — Full migration guide