• expression -- search filter (e.g., name:sample AND path:events)
• max_results -- 1-500 results (default 50)
• sort_by -- list of sort objects (e.g., [{"created_at": "desc"}])
• next_cursor -- pagination cursor

Example prompt:

"Create a folder called 'marketing/campaigns/spring-2026' in Cloudinary"

2. Configure Upload Presets

Define centralized upload behavior including target folder, allowed formats, transformations, tags, and overwrite rules.

Tool: CLOUDINARY_CREATE_UPLOAD_PRESET

Key parameters:

• name -- preset name (auto-generated if omitted)
• folder -- target folder path for uploads (e.g., samples/)
• allowed_formats -- comma-separated list (e.g., jpg,png,webp)
• tags -- comma-separated tags to apply (e.g., marketing,thumbnail)
• transformation -- incoming transformation (e.g., c_limit,w_500)
• eager -- eager transformations to generate on upload (e.g., c_fill,g_face,h_150,w_150)
• unsigned -- allow unsigned uploads (true/false)
• overwrite -- overwrite existing assets with same public_id (cannot be true when unsigned=true)
• resource_type -- image, video, or raw (default image)
• unique_filename -- append random suffix to avoid collisions (default true)
• use_filename -- use original filename (default false)
• moderation -- moderation type: manual, webpurify, aws_rek, etc.
• auto_tagging -- confidence threshold 0.0-1.0 for AI auto-tagging
• notification_url -- webhook URL for upload notifications

Example prompt:

"Create an upload preset called 'product-images' that only allows JPG and PNG, stores in 'products/' folder, and auto-tags with 0.7 confidence"

3. Look Up Asset Details

Retrieve full details for a specific asset by its public ID, including metadata, derived assets, and related resources.

Tool: CLOUDINARY_GET_RESOURCE_BY_PUBLIC_ID

Key parameters:

• public_id -- the asset's public ID (required)
• resource_type -- image, video, or raw (required)
• type -- delivery type: upload, private, authenticated, fetch, etc. (required)
• colors -- include color histogram and predominant colors
• faces -- include detected face coordinates
• media_metadata -- include IPTC, XMP, and detailed metadata
• quality_analysis -- include quality analysis scores
• phash -- include perceptual hash for similarity detection
• versions -- include backed-up versions
• related -- include related assets
• max_results -- max derived/related assets to return (1-500)

Example prompt:

"Get full details for the image 'products/hero-banner' including color analysis and quality scores"

4. Manage Transformations and Derived Assets

List existing transformations, apply eager transformations to uploaded assets, and clean up derived resources.

Tools:

• CLOUDINARY_GET_TRANSFORMATIONS -- list all named and unnamed transformations

…