Process multiple files asynchronously with progress updates. **When to use 'tool_process_files':** 1. You want to read and process a batch of files in sequence while reporting progress. **Parameters**: - files: List[str] A list of file paths. - ctx: Context The FastMCP context for logging and progress updates. **Behavior**: - Reads each file, logs how many characters were read, or logs an error. - Reports incremental progress for each file. Returns: - A summary of the results for each file.

List the contents of a directory, optionally recursively. **When to use 'tool_list_files':** 1. You want a simple directory listing with type info ([DIR], [FILE]). 2. You can optionally traverse subdirectories with `recursive=True`. **Parameters**: - directory_path: str (default=None) The path of the directory to list. If None, uses current working directory. - recursive: bool (default=False) Whether to recurse into subdirectories. **Error Handling**: - Returns an error if the path is not a directory. - If an exception arises, returns the error message. Returns: - A newline-separated list of entries, each prefixed with [FILE] or [DIR].

Read a file (text or image) from disk, optionally returning metadata. **When to use 'tool_read_file':** 1. You need to retrieve file contents as plain text or base64 (for images). 2. You might also want metadata like MIME type. **Parameters**: - file_path: str Path to the file to read. - return_metadata: bool (default=False) If True, returns a dict with content, mime_type, is_image. **Error Handling**: - Returns a string with the error if something fails.

Overwrite a file's content with new text. **When to use 'tool_write_file':** 1. You want to replace a file entirely with new content. **Parameters**: - file_path: str Target file path. - content: str New text content to write. **Error Handling**: - Returns error messages on I/O failure.