upload-asset
Uploads media assets (images, videos, raw files) to your Cloudinary product environment
Uploads media assets (images, videos, raw files) to your Cloudinary product environment. The file is securely stored
in the cloud with backup and revision history. Cloudinary automatically analyzes and saves important data about each
asset, such as format, size, resolution, and prominent colors, which is indexed to enable searching on those attributes.
Supports uploading from:
- Local file paths (SDKs/MCP server only). For MCP server path MUST start with file://
- Remote HTTP/HTTPS URLs
- Base64 Data URIs (max ~60 MB)
- Private storage buckets (S3 or Google Storage)
- FTP addresses
The uploaded asset is immediately available for transformation and delivery upon successful upload.
Transform media files using transformation syntax in delivery URLs, which creates derived files accessible immediately without re-uploading the original.
asset-rename
Updates an existing asset's identifier (public ID) and optionally other metadata in your Cloudinary account
generate-archive
Creates an archive (ZIP or TGZ file) that contains a set of assets from your product environment.
Creates a downloadable ZIP or other archive format containing the specified resources.
download-asset-backup
Download a backup copy of an asset
delete-asset
Delete asset by asset-id
Deletes an asset using its asset ID. This endpoint replaces the legacy /resources/by_asset_id endpoint.
Returns the deletion status and asset folder information when folder decoupling is enabled.
list-images
Get image assets
Retrieves a list of image assets. Results can be filtered by various criteria like tags, moderation status, prefix, or specific public IDs.
list-videos
Get video assets
Retrieves a list of video assets. Results can be filtered by various criteria like tags, moderation status, prefix, or specific public IDs.
list-files
Get raw assets
Retrieves a list of raw assets. Results can be filtered by various criteria like tags, moderation status, prefix, or specific public IDs.
get-asset-details
Get resource by asset ID
Returns the details of a single resource specified by its asset ID.
asset-update
Updates an existing asset's metadata, tags, and other attributes using its asset ID
Updates one or more attributes of a specified resource (asset) by its asset ID. This enables you to update details of an asset by its unique and immutable identifier, regardless of public ID, display name, asset folder, resource type or deliver type. Note that you can also update many attributes of an existing asset using the explicit method, which is not rate-limited.
list-tags
Retrieves a list of tags currently applied to assets in your Cloudinary account
Retrieves a comprehensive list of all tags that exist in your product environment for assets of the specified type.
[Cloudinary Admin API documentation](https://cloudinary.com/documentation/admin_api)
delete-derived-assets
Delete derived resources
Deletes derived resources by derived resource ID
get-usage-details
Retrieves comprehensive usage metrics and account statistics
A report on the status of product environment usage, including storage, credits, bandwidth, requests, number of resources, and add-on usage. No date parameter needed to get current usage statistics.
create-asset-relations
Add related assets by asset ID
Relates an asset to other assets by their asset IDs, an immutable identifier, regardless of public ID, display name, asset folder, resource type or deliver type. This is a bidirectional process, meaning that the asset will also be added as a related_asset to all the other assets specified. The relation is also a one to many relationship, where the asset is related to all the assets specified, but those assets aren't also related to each other.
delete-asset-relations
Delete asset relations by asset ID
Unrelates the asset from other assets, specified by their asset IDs, an immutable identifier, regardless of public ID, display name, asset folder, resource type or deliver type. This is a bidirectional process, meaning that the asset will also be removed as a related_asset from all the other assets specified.
move-folder
Renames or moves an entire folder (along with all assets it contains) to a new location
Renames or moves an entire folder (along with all assets it contains) to a new location within your Cloudinary media library.
create-folder
Creates a new empty folder in your Cloudinary media library
Creates a new folder at the specified path
delete-folder
Deletes an existing folder from your media library
Deletes a folder and all assets within it.
search-folders
Searches for folders whose attributes match a given expression
Lists the folders that match the specified search expression. Limited to 2000 results. If no parameters are passed, returns the 50 most recently created folders in descending order of creation time.
search-assets
Provides a powerful query interface to filter and retrieve assets and their details
Returns a list of resources matching the specified search criteria.
Uses Lucene-like query language to search by descriptive attributes (public_id, filename, folder, tags, context), file details (resource_type, format, bytes, width, height), embedded data (image_metadata), and analyzed data (face_count, colors, quality_score). Supports aggregate counts and complex Boolean expressions.
Examples: tags:shirt AND uploaded_at>1d, resource_type:image AND bytes>1mb, folder:products OR context.category:electronics
visual-search-assets
Finds images in your asset library based on visual similarity or content
Returns a list of resources that are visually similar to a specified image. You can provide the source image for comparison in one of three ways:
- Provide a URL of an image
- Specify the public ID or asset ID of an existing image
- Provide a textual description
get-tx-reference
Get Cloudinary transformation rules documentation from official docs
🚨 WHEN TO USE:
- MANDATORY before creating, modifying, or discussing Cloudinary transformations
- REQUIRED when user asks for image/video effects, resizing, cropping, filters, etc.
- NOT needed for simple asset management (upload, list, delete, etc.)
- ⚠️ CALL ONLY ONCE per session - documentation doesn't change, reuse the knowledge
🚨 STRICT REQUIREMENTS (when transformations are involved):
- MUST call this tool BEFORE any transformation-related task (but only once)
- MUST read and understand the returned documentation
- DO NOT attempt transformations without consulting this reference
- DO NOT make up transformation parameters
- DO NOT guess syntax - only use documented parameters
- DO NOT call this tool multiple times - the docs are static, remember them
This tool returns the complete, authoritative Cloudinary transformation reference that contains all valid parameters, syntax rules, and best practices.
transform-asset
Generate derived transformations for existing assets using Cloudinary's explicit API with eager transformations
⚠️ CRITICAL PREREQUISITES:
1. MUST call get-tx-reference tool first
2. MUST validate transformation syntax against official docs
3. MUST use only documented parameters from the reference
4. MUST follow proper URL component structure (slashes between components, commas within)
📋 VALIDATION CHECKLIST:
- ✅ Called get-tx-reference tool
- ✅ Verified all parameters exist in official docs
- ✅ Used correct syntax (e.g., f_auto/q_auto not f_auto,q_auto)
- ✅ Applied proper component chaining rules
- ✅ Included crop mode when using width/height
This tool creates actual derived assets on Cloudinary using the explicit API.