Cloudinary Asset Management MCP Server: Setup for Claude, Cursor and Other Apps

• Uploads an image, video or file to your library

  Uploads a file from a web address or from your computer (paths must start with file://) into your Cloudinary library. Cloudinary then records its size, format and colors so you can search on them.

  Try: “Upload file:///Users/me/photo.jpg to Cloudinary as hero-image.”

  Write · upload-asset

• Creates an image from a text prompt

  Starts an AI image generation from a text description and returns a task you can check later. It uses your Cloudinary account.

  Try: “Generate an image of a red bicycle on a white background.”

  Write · generate-image

• Edits or combines images with a prompt

  Takes one or more existing images plus a text prompt and starts an AI edit or merge. The result arrives as a task you can check.

  Try: “Combine these two product photos into one banner image.”

  Write · generate-image-from-images

• Checks on an image generation task

  Looks up the status and result of an earlier image generation.

  Try: “Is my last image generation finished?”

  Network · get-generation-task

• Finds assets with a search query

  Searches your library with a Lucene-like query over names, folders, tags, custom fields, format, size, dimensions and dates. Returns the matching assets and their details.

  Try: “Find all images tagged product uploaded in the last 7 days.”

  Network · search-assets

• Finds images that look similar

  Finds images in your library that look like a given image URL, an existing asset, or a text description.

  Try: “Find images in my library that look like a sunset over water.”

  Network · visual-search-assets

• Lists image assets

  Returns image assets from your library, page by page.

  Try: “List my 20 most recent images.”

  Network · list-images

• Lists video assets

  Returns video assets from your library, page by page.

  Try: “Show me all video assets in the marketing folder.”

  Network · list-videos

• Lists raw files

  Returns non-image, non-video files such as PDFs or text files stored in your library.

  Try: “List the raw files in my library.”

  Network · list-files

• Lists tags in use

  Returns the tags currently applied to assets of a given type.

  Try: “Which tags do I use on images?”

  Network · list-tags

• Shows one asset in full

  Returns the full record for one asset, looked up by its asset ID.

  Try: “Show me details for asset with ID abc123.”

  Network · get-asset-details

• Downloads a backup copy of an asset

  Downloads a backup copy of an asset. It is marked read-only in the source.

  Try: “Download the backup copy of asset abc123.”

  Network · download-asset-backup

• Changes an asset's details

  Updates one asset's metadata, tags and other attributes, looked up by its asset ID.

  Try: “Update asset abc123 and set its description to Summer hero banner.”

  Write · asset-update

• Renames an asset

  Changes an asset's public ID, which is the name in its URL, and can update other details at the same time.

  Try: “Rename asset hero-image to homepage-hero.”

  Write · asset-rename

• Adds, removes or replaces tags

  Adds, removes or replaces tags on many assets at once. The source marks it as destructive because replacing tags overwrites what was there.

  Try: “Add the tags featured and homepage to these five assets.”

  Write · manage-asset-tags

• Sets structured metadata on many assets

  Sets structured metadata field values on many assets in one call.

  Try: “Set the metadata field season to summer on all assets in this folder.”

  Write · manage-asset-metadata

• Adds or clears context on many assets

  Adds or clears key-value context (such as an alt text or caption) on many assets at once.

  Try: “Add the caption Spring sale to these assets.”

  Write · manage-asset-context

• Links related assets together

  Marks other assets as related to one asset, by asset ID.

  Try: “Mark asset b as related to asset a.”

  Write · create-asset-relations

• Removes links between assets

  Removes the related-asset links from an asset, by asset ID.

  Try: “Remove the relation between asset a and asset b.”

  Delete · delete-asset-relations

• Deletes transformed copies of assets

  Deletes derived resources, which are the transformed versions made from an original. The original stays.

  Try: “Delete the derived versions of hero-image.”

  Delete · delete-derived-assets

• Deletes an asset for good

  Deletes an asset by its asset ID. It needs the admin scope.

  Try: “Delete the asset with ID abc123.”

  Delete · delete-asset

• Builds a ZIP of assets

  Creates a downloadable ZIP or similar archive that holds the assets you pick, for example by tag.

  Try: “Generate a ZIP archive of all images with the tag export-ready.”

  Write · generate-archive

• Creates a folder

  Creates a new, empty folder in your media library.

  Try: “Create a folder called summer-2024-products.”

  Write · create-folder

• Finds folders

  Searches folders by name or path with a search expression.

  Try: “Find folders whose name starts with marketing.”

  Network · search-folders

• Renames or moves a folder

  Renames a folder or moves it, along with every asset inside, to a new place in the library.

  Try: “Move the folder drafts into archive.”

  Write · move-folder

• Deletes a folder

  Deletes an existing folder from your media library.

  Try: “Delete the empty folder old-campaign.”

  Delete · delete-folder

• Shows account usage

  Returns usage numbers for your account: storage, credits, bandwidth, requests, asset count and add-ons. It needs the admin scope.

  Try: “Show my Cloudinary account usage statistics.”

  Network · get-usage-details

• Loads the transformation guide

  Fetches Cloudinary's transformation rules from its official docs so the assistant uses real parameters. The description tells the assistant to call it once before any transformation.

  Try: “Show me the Cloudinary transformation reference.”

  Network · get-tx-reference

• Creates transformed copies of an asset

  Creates derived versions of an existing asset, such as resized, cropped or sharpened copies, using a transformation string. It saves real new assets in your account.

  Try: “Transform asset hero-image with c_fill,w_800,h_600/e_sharpen.”

  Write · transform-asset

Watch out for

• It can delete assets and folders

  delete-asset, delete-folder, delete-derived-assets and delete-asset-relations are all included. Start with the read-only option, or tell the assistant to ask before any delete. github.com

• Bulk tools change many assets at once

  The tag, metadata and context tools take lists of assets. Replacing tags overwrites the old ones, so check the list before you approve. github.com

• Upload can read files from your computer

  Upload accepts file:// paths to local files and sends them to your Cloudinary account. Only point it at files you mean to publish. github.com

• Your API secret sits in the client config

  The secret is stored in plain text in the config file or command. Keep the file private and rotate the key if it leaks. github.com