# Cloudinary MCP for AI Agents MCP

> Cloudinary manages your entire media library directly through conversation. This MCP lets you track usage, audit transformations, and manipulate images or videos—all without opening the web dashboard. You get full control over asset resources from any AI agent.

## Overview
- **Category:** image-video
- **Price:** Free
- **Tags:** media-optimization, digital-asset-management, image-transformation, video-processing, cdn, asset-tracking

## Description

Managing digital assets often means clicking through complex dashboards just to check a quota or find an old file. With this Cloudinary MCP, you take that process out of the console and into your chat interface. Your AI client connects directly to your cloud storage, giving you full control over every image, video, and transformation.

You can ask your agent things like, “What was my bandwidth usage last month?” or “List all high-resolution product shots tagged ‘summer’”. It retrieves the data immediately. If an asset is wrong, you can even permanently delete it using a simple command. Because this MCP connects through Vinkius, you get reliable access to Cloudinary's entire suite of media logistics tools right where you already work.

## Tools

### delete_media_resource
Permanently removes a selected media file from the cloud library.

### get_media_resource_details
Fetches specific data points for any single media asset, like its format and public ID.

### list_upload_presets
Provides a list of all standardized upload templates configured within your account.

### get_cloudinary_usage_report
Retrieves the current usage status and quota reports for storage, bandwidth, and transformations.

### list_media_resources
Generates a comprehensive list of all images and videos currently stored in your cloud account.

### list_media_tags
Shows every tag you have applied across your entire media collection.

### list_media_transformations
Lists all named and dynamic rules used to resize or modify assets.

### search_media_library
Finds specific media resources by running advanced search expressions against your entire library.

## Prompt Examples

**Prompt:** 
```
Show me the usage report for storage and bandwidth.
```

**Response:** 
```
**Cloudinary Usage Report**

*   **Storage Used:** 1.2 GB (Total Limit: 5 GB)
*   **Bandwidth Used:** 850 GB (Usage Trend: Stable)
*   **Transformations Run:** 4,500 times last month.

You're currently at 24% storage capacity, which is healthy. The bandwidth usage suggests a slight uptick in video delivery.
```

**Prompt:** 
```
List all assets tagged 'Q3 Marketing'.
```

**Response:** 
```
**Found 7 Assets for Q3 Marketing**

| Asset ID | Type | Tags | Status |
| :--- | :--- | :--- | :--- |
| `prod-01` | Image | marketing, hero | Active |
| `banner-v2` | Image | marketing, banner | Needs Review |
| `video-q3` | Video | marketing | Ready to Use |

Would you like the secure URL for any of these?
```

**Prompt:** 
```
What are my available upload presets?
```

**Response:** 
```
**Configured Upload Presets:**

The following standardized upload templates are active:

1.  `product-standard`: Optimized for e-commerce listings (JPG, WebP).
2.  `social-square`: 1:1 ratio, high compression for Instagram.
3.  `video-hero-trailer`: High bitrate MP4 optimized for landing pages.
```

## Capabilities

### Audit overall usage and quotas
Retrieve core reports detailing how much storage, bandwidth, or transformation capacity you have consumed.

### Inventory and locate media assets
List all existing images and videos in your cloud library, or perform detailed searches using complex filtering expressions.

### Manage metadata and organization
View tags, folders, and transformation definitions used across the entire collection of assets.

### Process and delete resources
Permanently remove unwanted media files or get detailed information on any specific asset you locate.

## Use Cases

### Inventorying assets after a campaign
A content manager needs to know all high-resolution images used in the 'Summer Sale' line. They ask their agent, and it uses `list_media_resources` combined with tags to return a list of every relevant asset ID.

### Auditing usage before year-end billing
An ops team lead asks the agent for the current cloud storage quota. The MCP calls `get_cloudinary_usage_report`, showing them exactly how much bandwidth and transformation capacity remains, preventing unexpected overages.

### Finding a specific video asset
A marketing team member can't remember the name of an old product demo. They ask their agent to `search_media_library` for 'Product Demo MP4 2022', and it returns the correct, secure URL immediately.

### Cleaning up unused media
A developer finds several outdated placeholder images. They instruct the agent to `list_media_resources` to find them, confirming their public IDs, before executing `delete_media_resource` for cleanup.

## Benefits

- Stop jumping between tabs. You can monitor your entire media library and organize assets using natural language through this MCP.
- Get immediate visibility into costs by accessing the core usage report (Storage, Bandwidth, Transformations) directly from your chat.
- Need to find an old asset? Use advanced searching via `search_media_library` to locate specific files instantly without remembering complex IDs.
- Maintain clean records by reviewing all tags and folders using `list_media_tags`, ensuring assets are properly categorized before deployment.
- If a file is obsolete, you can permanently remove it with the `delete_media_resource` tool. This prevents clutter and unnecessary costs.
- Developers get to audit asset transformations and verify delivery URLs for any resource without ever opening the main dashboard.

## How It Works

The bottom line is that you treat your media library like a searchable database inside your chat window.

1. Subscribe to this MCP, providing your Cloudinary API Key, Secret, and Cloud Name.
2. Connect your preferred AI client (like Claude or Cursor) through Vinkius. The client authenticates using the provided credentials.
3. Ask your agent natural language questions—for example, 'Show me all assets tagged marketing'—and the MCP executes the necessary calls to retrieve results.

## Frequently Asked Questions

**How does the Cloudinary MCP help me manage media assets?**
It brings your entire cloud media library into natural conversation. You can ask questions about usage, search for specific files by tag or type, and even get direct links to the assets without logging into the dashboard.

**Can I check my storage quota using Cloudinary MCP?**
Yes. The MCP retrieves a detailed report on your current usage across storage, bandwidth, and transformations. This lets you monitor your quotas instantly to avoid unexpected overages.

**What if I need to delete an old asset? Can the Cloudinary MCP do that?**
Absolutely. You can use the agent to locate the specific media resource and then permanently delete it, keeping your library clean and preventing unnecessary billing charges.

**Is this better than just browsing the Cloudinary website?**
It is faster because you don't have to navigate menus. You simply ask your agent what you need—for example, 'Show me all videos uploaded last week'—and it delivers a clean list right away.

**Does Cloudinary MCP help developers test asset URLs?**
Yes. Developers can get detailed information on any resource, confirming its public ID and secure URL directly from the chat. This saves time auditing transformations without opening development tools.