add_tag_to_files
ChatGPTAdd a label (tag) to one or more files.
bulk_move_files
ChatGPTMove multiple files to a different folder within the same workspace.
bulk_restore_files
ChatGPTRestore files that were previously moved to trash.
bulk_trash_files
ChatGPTMove multiple files to trash at once. Files can be restored later.
copy_tags_to_workspace
ChatGPTCopy all tags from one workspace to another. Tags that already exist in the destination (matched by name) are skipped.
create_collection
ChatGPTCreate a collection (album/group) of files. Collections allow organizing related files across different folders.
create_document
ChatGPTCreate a new document/note in Razuna. Documents are rich text (HTML/Markdown) knowledge objects stored alongside media files. They are indexed for search and AI retrieval. Use this to store meeting notes, research, project documentation, or any knowledge content. You can specify the workspace by ID or by name — if you provide a name, the tool will automatically resolve it to the correct workspace ID.
create_folder
ChatGPTCreate a new folder in a workspace. Can be created at the root level or inside an existing folder.
create_note
ChatGPTCreate a new note in Razuna. Notes are rich text (HTML/Markdown) knowledge objects stored alongside media files. They are indexed for search and AI retrieval. Use this to store meeting notes, research, project documentation, or any knowledge content. You can specify the workspace by ID or by name — if you provide a name, the tool will automatically resolve it to the correct workspace ID.
create_share_link
ChatGPTCreate a shareable link for a file. The link can be public or password-protected.
create_tag
ChatGPTCreate a new tag in a workspace. Tags are used to categorize and label files.
delete_document
ChatGPTDelete (move to trash) a document by its ID.
delete_file
ChatGPTMove a file to trash. The file can be restored later.
delete_note
ChatGPTDelete (move to trash) a note by its ID.
delete_tag
ChatGPTDelete a tag. This will also remove the tag from all files that have it.
empty_trash
ChatGPTPermanently delete all files in the trash for a workspace. This action cannot be undone.
find_similar_images
ChatGPTFind visually similar images based on a reference image. Uses AI-powered visual similarity (CLIP embeddings) to find images with similar content, style, or composition.
get_custom_fields
ChatGPTGet the custom fields schema/template defined for a workspace. Custom fields allow storing additional structured metadata.
get_file
ChatGPTGet detailed metadata about a specific file, including geographic location, AI metadata, name, description, keywords, labels, custom fields, saved image download formats, size, dimensions, and timestamps.
get_file_ai_metadata
ChatGPTRetrieve previously stored AI-detected attributes, extracted text, keywords, and description for one file. Does not run a new AI analysis or modify the file.
get_file_custom_fields
ChatGPTGet the custom field values set for a specific file.
get_file_usage_stats
ChatGPTGet file usage and engagement statistics such as download counts, view counts, search trends, and aggregate geography/browser/OS analytics.
get_folder
ChatGPTGet folder metadata and file counts.
get_folder_tree
ChatGPTGet the hierarchical folder structure for a workspace. Can optionally start from a specific folder to get only a subtree.
get_tag
ChatGPTGet detailed information about a specific tag by its ID.
get_workspace
ChatGPTGet workspace metadata and asset statistics.
list_documents
ChatGPTList documents in a workspace. Supports filtering by folder, document type, and text search. You can specify the workspace by ID or by name.
list_folder_files
ChatGPTList files in a specific folder with pagination. Returns file names, types, sizes, and IDs.
list_notes
ChatGPTList notes in a workspace. Supports filtering by folder, document type, and text search. You can specify the workspace by ID or by name.
list_tags
ChatGPTList all tags in a workspace. Tags are used to categorize and label files. Returns tag names, colors, and IDs.
list_workspaces
ChatGPTList Razuna workspaces only when the user explicitly asks to see, compare, choose, or switch workspaces. Do not use this before ordinary asset searches; search_files already defaults to the configured workspace.
move_file
ChatGPTMove a file to a different folder within the same workspace.
move_files_to_workspace
ChatGPTMove one or more files to a different workspace. Optionally map tags by name to the destination workspace.
read_document
ChatGPTRead the full content of a document by its ID. Returns the title, content (HTML), plain text, and metadata.
read_note
ChatGPTRead the full content of a note by its ID. Returns the title, content (HTML), plain text, and metadata.
remove_tag_from_file
ChatGPTRemove a label (tag) from a single file.
save_image_format
ChatGPTSave a reusable image download format recipe for an image file. This stores conversion settings only; converted bytes are generated on download.
save_url
ChatGPTSave a URL as a file in Razuna. Fetches the URL server-side, extracts page content (title, description, OG metadata, body text), generates a screenshot thumbnail, and saves it as a file record. The full page text is stored for search indexing. You can specify the workspace by ID or by name.
search_documents
ChatGPTSearch documents using natural language across all accessible workspaces. Uses the full AI search pipeline with semantic/vector search powered by Typesense embeddings. Supports conversation follow-ups via conversation_id.
search_files
ChatGPTSearch Razuna assets in the configured/default workspace. Use this directly for normal asset requests such as latest uploads, images, videos, PDFs, logos, cars, products, and visual or semantic searches. Do not call list_workspaces first unless the user explicitly asks to choose or list workspaces.
search_notes
ChatGPTSearch notes using natural language across all accessible workspaces. Uses the full AI search pipeline with semantic/vector search powered by Typesense embeddings. Supports conversation follow-ups via conversation_id.
set_file_custom_fields
ChatGPTSet values for the specified custom fields on one file according to its workspace schema. Overwrites existing values for supplied fields; empty values may clear them according to the field type. Omitted fields remain unchanged.
suggest_document_tags
ChatGPTSuggest existing document tags for a given input. Uses normalization, plural stemming, and fuzzy matching to prevent duplicate tags. Call this BEFORE adding tags to check if a similar tag already exists (e.g., "apples" matches "apple", "help monks" matches "helpmonks").
suggest_note_tags
ChatGPTSuggest existing note tags for a given input. Uses normalization, plural stemming, and fuzzy matching to prevent duplicate tags. Call this BEFORE adding tags to check if a similar tag already exists (e.g., "apples" matches "apple", "help monks" matches "helpmonks").
transform_image
ChatGPTGet an authenticated URL for a resized or converted image. The URL does not expose credentials or make the asset public.
update_document
ChatGPTUpdate an existing document. You can update the title, content, folder, or labels. Supplied fields replace existing values, including the full content and label/tag arrays. Omitted fields remain unchanged.
update_file_metadata
ChatGPTReplace the supplied file metadata fields, overwriting existing values, including name, description, keywords/tags, labels, custom ID, and XMP copyright/license fields: copyright_status, copyright_notice, copyright_info_url, usage_terms. Legacy license_* aliases are also accepted.
update_folder
ChatGPTRename a folder, move it under a new parent, or change its color. Use this to fix typos in folder names or reorganize the folder tree without opening the web UI.
update_note
ChatGPTUpdate an existing note. You can update the title, content, folder, or labels. Supplied fields replace existing values, including the full content and label/tag arrays. Omitted fields remain unchanged.
update_tag
ChatGPTUpdate a tag's name, color, or parent.
upload_file
ChatGPTUpload a file to a specific Razuna folder. ChatGPT can provide the file object directly; other MCP clients may provide a server-accessible file_path.