# Cloudinary MCP MCP > Cloudinary manages your entire media library inside an AI agent conversation. It lets you list every asset, track usage quotas for storage and bandwidth, run advanced searches across millions of files, and even permanently delete unwanted images or videos—all without logging into the dashboard. ## Overview - **Category:** image-video - **Price:** Free - **Tags:** media-optimization, digital-asset-management, image-transformation, video-processing, cdn, asset-tracking ## Description Managing a digital asset library usually means jumping between dashboards to check file versions, track who used what resource, and calculate costs. This MCP changes that. You connect your Cloudinary account and take full control of every image, video, and asset you own directly through your AI agent's chat interface. Need to know if you’re close to hitting bandwidth limits? Ask the agent for a usage report. Want to find all product shots tagged 'spring-24'? The agent runs the advanced search instantly. If marketing needs high-res assets right now, you can list every resource and get its secure URL without leaving your workflow. Because this MCP handles so much data movement—from querying asset metadata to calculating usage totals—you'll have full visibility into everything through Vinkius AI Analytics. You always know exactly which resources are being accessed and how the budget is tracking. It’s a centralized way to treat your media library like just another source of truth. ## Tools ### delete_media_resource Permanently removes an image or video from the cloud storage. ### get_cloudinary_usage_report Retrieves current usage statistics for your total storage, bandwidth, and transformations. ### get_media_resource_details Provides specific metadata about a single asset, like its format or original size. ### list_media_resources Lists every media resource in the cloud for an inventory check. ### list_media_tags Retrieves a list of all tags currently applied to assets in your library. ### list_media_transformations Shows the names and types of transformations available for your media assets. ### list_upload_presets Lists all configured rules or presets used when uploading new content. ### search_media_library Finds resources using complex text expressions, filtering the library precisely. ## Prompt Examples **Prompt:** ``` List all images in my Cloudinary library. ``` **Response:** ``` Retrieving your images... I found 5 items including 'product-hero-1', 'banner-winter-sale', and 'logo-white'. Would you like the secure URL for any of these? ``` **Prompt:** ``` What is my current Cloudinary storage usage? ``` **Response:** ``` Checking your usage report... You are currently using 1.2GB of storage across 450 resources. This is approximately 12% of your plan's total capacity. ``` **Prompt:** ``` Search for all MP4 videos uploaded in the last 24 hours. ``` **Response:** ``` Searching media library... I found 2 MP4 videos uploaded since yesterday: 'demo-tutorial-v2' and 'customer-interview-final'. Would you like to see their metadata? ``` ## Capabilities ### Check usage and quotas Get a report detailing current storage consumption, bandwidth used, and transformation quota limits. ### Search the full asset library Find specific images or videos using complex search expressions across all stored resources. ### List all assets Retrieve a complete list of every media resource, including their public IDs and secure URLs. ### Manage asset metadata Fetch detailed information about any single resource, like its original format or creation date. ### Control tags and presets List all the tags or configured upload rules currently applied across your library. ### Remove assets permanently Delete a media resource from Cloudinary entirely, making it unrecoverable. ## Use Cases ### The campaign kickoff check A marketing manager needs 20 high-res logos for a new site. Instead of browsing folders, they ask the agent to `search_media_library` for 'logo' and filter by format. The agent returns the secure URLs immediately. ### The cost audit An ops engineer needs to know if last month’s video campaign caused a bandwidth spike. They ask the agent to `get_cloudinary_usage_report`, getting instant data on consumption and quotas without running manual reports. ### The cleanup crew A content team finds 50 old, low-res assets nobody uses anymore. They ask the agent to `list_media_resources` to identify them, then run `delete_media_resource` on the specific IDs. ### The developer verification A backend developer needs to know if a specific asset ID exists and what its original dimensions were. They use `get_media_resource_details` to get metadata, confirming file integrity before writing code. ## Benefits - Stop guessing about asset existence. Use `list_media_resources` to get a full inventory list, or run `search_media_library` for precise results based on keywords or types. - Control costs immediately. Run `get_cloudinary_usage_report` to see your current usage of storage and bandwidth without opening the billing dashboard. - Audit transformations instantly. Use `list_media_transformations` to verify what image sizes are available, knowing exactly how they were generated. - Maintain cleanliness. If you spot old, unused content, use `delete_media_resource` directly through your chat interface instead of manually finding it in the UI. - Plan uploads correctly. Check `list_upload_presets` to ensure new assets are ingested using the right formatting rules every time. - Get deep file knowledge. Use `get_media_resource_details` on a specific ID to retrieve its exact metadata, helping developers verify delivery URLs. ## How It Works The bottom line is you manage complex media operations by simply asking questions in natural language, without needing to navigate web dashboards. 1. Subscribe to this MCP and provide your Cloudinary API Key, Secret, and Cloud Name. 2. Connect the credentials; they pass through a zero-trust proxy, meaning your keys never sit on a disk. 3. Start talking to your AI agent. You ask it for asset data or usage reports, and it executes the necessary actions. ## Frequently Asked Questions **How do I use the list_media_resources tool in Cloudinary?** You ask your agent to 'list all media resources.' The agent calls `list_media_resources` and returns a full inventory, including public IDs. This is useful for building an asset manifest. **Can I check my bandwidth usage using get_cloudinary_usage_report?** Yes. The agent runs `get_cloudinary_usage_report` and gives you the current status of your storage, bandwidth, and transformation quotas in one summary. **How does search_media_library work with tags?** You combine them in a single prompt. For example, 'search media for assets tagged 'sale' that are also video format.' The agent uses `search_media_library` to filter precisely. **What is the difference between list_media_resources and search_media_library?** Listing everything (`list_media_resources`) gives you a raw count. Searching (`search_media_library`) lets you apply filters like date, type, or specific keywords to narrow down millions of results. **If I want to delete an asset, do I use the delete_media_resource tool?** Yes. You simply ask your agent to 'delete the resource with ID X.' It executes `delete_media_resource` and permanently removes it from the cloud. **How do I use the list_media_transformations tool to see available image formats?** It pulls a complete catalog of all named and dynamic transformations. This lets your agent know exactly what processing parameters it can apply when optimizing an asset's delivery URL. **Can I use list_upload_presets to check my configured upload settings?** Yes, this tool shows all presets set up for ingesting media. This is key for making sure your agent always adds new assets using the right metadata and naming conventions. **What information does get_media_resource_details provide about a specific asset?** It retrieves deep, comprehensive data points tied to one media resource ID. You can confirm its exact public IDs, formats, and secure URLs without sifting through massive listing results.