Lists the folders this server may work in. Relative paths in other tools resolve against the first root; absolute paths are accepted inside any listed root.

Lists files and folders. Paths can be relative to the server's root folder. Supports recursive traversal.

Renders a compact tree of folders and files with box-drawing characters. Much less noisy than a recursive list_directory. Skips node_modules, .git, .mcp and other service folders by default; limits depth and total entries.

Reads a text file. An optional line range can be specified (1-based). Large files are truncated.

Returns an image file so you can actually see it (screenshots, design mockups, diagrams). Supports PNG, JPEG, GIF and WebP. The file must be at most 4.8 MB. For text files use read_file.

Writes text to a file. Creates missing parent folders. By default overwrites an existing file and keeps a backup (restorable via undo_last_change).

Appends text to the end of a file, creating it if needed.

Replaces an exact occurrence of old_string with new_string and shows a diff. If old_string occurs more than once, set replace_all=true explicitly. A backup is saved before editing (undo_last_change).

Applies several replacements to one file atomically: if any fragment is not found, the file is left unchanged. Returns a combined diff. A backup is saved before editing.

Creates a folder (including all missing parents by default).

Moves or renames a file or folder.

Copies a file or folder (folders recursively).

Packs files and folders into a ZIP archive. Each source keeps its own name at the top level of the archive; subfolders are included recursively. Symbolic links are skipped. UTF-8 file names are stored correctly. Set overwrite=true to replace an existing archive.

Extracts a ZIP archive into a folder, creating missing parent folders. Stored and deflated entries with UTF-8 names are supported (ZIP64 and encrypted archives are not). Paths that would escape the destination are rejected. By default nothing is overwritten.

Deletes a file or folder. By default the item goes to the trash (/app/.mcp/trash) and can be restored via restore_path or undo_last_change. A non-empty folder can only be deleted with recursive=true. The root folder cannot be deleted.

Returns the type, size and modification time of an item.

Finds files by glob (*.js, src/**/*.ts, config*) or a substring in the name. Service folders (node_modules, .git, .mcp) are skipped.

Searches for a string or regular expression inside text files and returns file:line: text. Binary and large files are skipped.

Replaces every occurrence of a string (or regular expression) across text files, with a backup of each changed file and a single undo step. Skips binary and very large files, node_modules, .git and .mcp by default. Use dry_run=true to preview the changes first.

Lists deleted files and folders that can be restored.

Restores a file or folder from the trash to its original location. Get the id from list_trash or from the delete_path response.

Reverts the last change made by the server: restores a file from its backup, removes a created file, or brings back a deleted item from the trash. Multiple steps can be undone in a row.