# Uploadcare MCP for AI Agents AI Agent Connect > Uploadcare MCP lets you manage your entire media infrastructure through your AI agent. You can upload, retrieve, organize, and delete files securely. It handles everything from listing assets to batch deleting large amounts of data, making it easy to manage your CDN media without leaving your current workspace. ## Overview - **Category:** developer-tools - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_RS376pYDviRvb1vXMkcu1WIGTbWPcfxL77nDCRw1/ai-agent-connect - **Tags:** file-upload, cdn, media-processing, asset-management, cloud-infrastructure, image-optimization ## Description Managing media assets usually feels like a chore involving constant tab switching and manual dashboard navigation. This Connector changes that by letting your AI agent handle the heavy lifting of your file infrastructure. Instead of hunting for specific CDN URLs or manually marking files for permanent storage, you can just ask your agent to do it for you. You'll be able to check your project's storage and bandwidth usage in real time or move files to external targets like S3 buckets using plain language. It's a huge time saver for anyone who needs to keep their media organized without the friction of a traditional UI. Since Vinkius hosts this Connector, you can connect it to your existing setup and get your agent up to speed on your specific asset management rules immediately. ## Tools ### batch_delete_files Permanently removes multiple files in a single action. This is perfect for clearing out large amounts of test data. ### batch_store_files Marks a group of temporary files as permanently stored. Use this to secure multiple assets at once. ### copy_file Copies an existing file to a local or remote storage target. This helps move files to S3 or other providers. ### delete_file Permanently removes a specific file and all its variants. Use this for precision cleanup of single assets. ### get_file_details Retrieves technical metadata like dimensions and URLs for a file. It's the fastest way to get asset specs. ### get_group_details Gets information about a specific file group. Use this to inspect the contents of a specific collection. ### get_project_info Retrieves project-level metadata and usage statistics. Use this to monitor your bandwidth and storage. ### list_files Lists all files in your project. It supports pagination so you can browse through your entire library. ### list_file_groups Lists all immutable file collections in your project. Use this to see how your assets are organized. ### store_file Marks a specific temporary file as permanently stored. Use this to move a single asset into permanent storage. ## Prompt Examples **Prompt:** ``` How much of our storage quota have we used this month? ``` **Response:** ``` Based on your project info, you've used **15.2 GB** of storage and **230 GB** of bandwidth. You're currently at **85%** of your plan limit. Would you like me to list your largest files to see what we can clear out? ``` **Prompt:** ``` Get me the CDN URL and dimensions for the image with ID 9cd83... ``` **Response:** ``` I found that asset for you. It's a `hero-banner.jpg` (image/jpeg) at **3840x2160** pixels. The public CDN URL is: `https://ucarecdn.com/9cd83.../` ``` **Prompt:** ``` Delete all these old test files: [list of IDs] ``` **Response:** ``` I've finished deleting those 4 assets and their variants. They're gone from your project, and your storage space has been updated. ✅ ``` ## Capabilities ### Batch delete files Permanently remove multiple files in one go to clear out storage. ### Copy files to remote storage Move existing assets to local or remote targets like S3. ### Retrieve file metadata Get specific details like dimensions and CDN URLs for any asset. ### Manage file groups List and inspect immutable collections of files. ### Monitor project usage Check real-time storage and bandwidth consumption. ### Mark files as permanent Transition temporary uploads to permanent storage. ## Use Cases ### Purging test data A developer wants to clear out hundreds of test images. They ask the agent to batch delete files with specific IDs to free up space. ### CDN URL retrieval A frontend dev needs a hero image URL. They ask the agent for the details of a specific file to get the production CDN link. ### S3 Migration A DevOps lead needs to move assets to a backup bucket. They tell the agent to copy specific files to their remote storage target. ### Storage Audit A product manager is worried about costs. They ask the agent to check the current bandwidth and storage usage for the project. ## Benefits - Stop manual deletions: Use batch_delete_files to clear out massive amounts of data in one command rather than clicking every single item. - Faster asset retrieval: Use get_file_details to grab CDN URLs and dimensions instantly without opening your browser. - Automated file transport: Use copy_file to move assets to S3 or other targets directly through your agent. - Real-time usage monitoring: Use get_project_info to keep an eye on storage and bandwidth limits while you work. - Organized collections: Use list_file_groups and get_group_details to keep your media assets structured and easy to find. - Simplified storage management: Use store_file and batch_store_files to manage your permanent storage states quickly. ## How It Works The bottom line is you get a voice-controlled control center for your entire media distribution platform. 1. Subscribe to the Connector and get your Public and Secret Keys from your Uploadcare project. 2. Input those keys into your AI client's configuration. 3. Start asking your agent to list assets, move files, or check your bandwidth limits. ## Frequently Asked Questions **Can I use the Uploadcare MCP to manage my CDN files?** Yes, this Connector lets you list, retrieve, and delete assets from your Uploadcare project using your AI agent. **How do I check my storage limits with Uploadcare?** You can just ask your agent to check your project info. It will pull your real-time storage and bandwidth usage directly from Uploadcare. **Can I move files to S3 using the Uploadcare MCP?** Yes, you can use the copy tool to move existing files to remote storage targets like S3 buckets. **Is it possible to delete multiple files at once?** You can use the batch delete tool to permanently remove a large group of files in a single command. **Does the Uploadcare MCP help with organizing my media?** Yes, it lets you list and inspect file groups so you can keep your assets organized in collections. **Can I get technical details for a specific file?** Your agent can pull dimensions, mime types, and CDN URLs for any specific file in your project. **How do I make temporary files permanent?** You can tell your agent to store a specific file or a batch of files to move them into permanent storage. **Can my AI agent batch delete unused Uploadcare files?** Yes! Provide your agent with the list of unused UUIDs or ask it to identify temporary incomplete uploads, and simply command it to `batch delete these assets`. The agent uses the `batch_delete_files` tool to permanently erase them from the CDN instantly, freeing up your project's storage. **How can I quickly check my current CDN bandwidth and storage usage?** Instead of digging through the web dashboard, ask your AI agent to `get project info`. It instantly fetches your Uploadcare project-level metadata, returning your precise storage usage (bytes), traffic bandwidth usage, and active file count. Perfect for quick billing audits. **Will my temporary UI uploads expire automatically?** By default, temporary files uploaded via your front-end will be wiped after 24 hours. To prevent this, you can ask your agent to `store this file ` or `batch store` a bunch of UUIDs. The agent communicates with Uploadcare to mark the files as permanently stored, saving them from the garbage collector.