Cloudinary MCP: manage your media library from an AI app

How to connect Cloudinary to Claude, ChatGPT or Cursor

1. 1Click Connect Cloudinary free and sign in with your Cloudinary account.
2. 2Deleting assets by ID or by tag is permanent. Switch those tools off, and consider switching off trigger and metadata-field changes that affect your whole account.
3. 3Add ContextGate to your AI app as a connector or MCP server. The steps for each app are on the Works with page.
4. 4Ask Cursor to list the assets in your product-images folder and create an upload preset for it, then check Activity for each call.

Media tasks from Claude, ChatGPT or Cursor

• List the assets in a folder, or find assets by contextual metadata.
• Create folders, upload presets and upload mappings to keep new uploads organized.
• Review assets in a moderation queue.
• Add metadata fields or set up a webhook trigger for an event such as an upload.

No surprise deletions

• Switch off delete by asset ID, delete by tag and delete derived assets, and your AI app can't remove media.
• Set a policy to warn or block before a webhook trigger or metadata field is created.
• Activity records each change and deletion your AI apps make in Cloudinary.

What you get with Cloudinary and ContextGate

• Your AI apps can use CloudinaryClaude, Cursor, ChatGPT and other AI apps reach Cloudinary through the one ContextGate connection you add to them.
• You choose which tools they can useSwitch off any Cloudinary tool you don't want used. It's hidden from your AI apps and refused if called.
• Every call is checked and recordedYour policies check each call (for example, personal data is hidden and secrets are blocked), and Activity keeps a record of it.

ContextGate sees only the tool calls that go through it, not your AI app's built-in tools or your chats.

Cloudinary tools

Examples of what your AI apps can do in Cloudinary. You'll see the exact list of tools after you connect it.

• Create FolderTool to create a new asset folder. use when you need to organize assets into nested directories. use after confirming the folder path does not already exist.
• Create Metadata FieldTool to create a new metadata field definition. use when extending your metadata schema with new fields.
• Create TriggerTool to create a new webhook trigger for a specified event type. use after configuring your webhook endpoint and choosing the event type. example: "create a trigger for uploads to https://example.com/
• Create Upload MappingTool to create a new upload mapping folder and url template. use when you need to dynamically map external url prefixes to a cloudinary asset folder before uploading files.
• Create Upload PresetTool to create a new upload preset. use when defining centralized upload options (tags, formats, transformations, etc.) before asset uploads.
• Delete Derived ResourcesTool to delete derived assets. use when you need to remove specific derived assets by their ids. example: "delete derived assets with ids [id1, id2]".
• Delete Metadata Field Datasource EntriesTool to delete datasource entries for a specified metadata field. use when you need to soft-delete (inactivate) specific entries in a field's datasource. example prompt: "delete entries ['color1','col
• Delete FolderTool to delete an empty asset folder. use when the folder is confirmed empty and you need to remove it.
• Delete Metadata FieldTool to delete a metadata field by external id. use when you need to remove a metadata field that is no longer required.
• Delete Resources by Asset IDTool to delete resources by asset ids. use when you need to permanently remove specific resources by their immutable asset ids; irreversible.
• Delete Resources by TagsTool to delete cloudinary assets by tag. use when you need to remove all assets associated with a given tag.
• Delete TriggerTool to delete a trigger (webhook notification). use when you need to remove a trigger by its id after confirming the correct id.
• Get Adaptive Streaming ProfilesTool to list adaptive streaming profiles. use when retrieving built-in and custom adaptive streaming profiles for delivering video via hls or dash.
• Get product environment config detailsTool to get product environment config details. use when you need to fetch or verify environment configuration such as folder mode.
• Get Metadata Field By IDTool to get a single metadata field definition by external id. use after creating or updating a metadata field to fetch its full definition. example: "get metadata field definition for external id 'co
• Get Resource by Asset IDGet resource by asset id
• Get Resource by Public IDTool to get details of a single resource by public id. use when you need full asset, derived, and related info.
• Get Resources by Asset FolderTool to list assets stored directly in a specified folder. use when you need to view assets in a specific folder without including subfolder contents.
• Get Resources by ContextTool to retrieve assets with a specified contextual metadata key/value. use when filtering resources by context metadata.
• Get Resources in ModerationTool to retrieve assets in a moderation queue by status. use after moderation to process pending or reviewed assets.