Summary Automate Uploadcare file management including listing, storing, inspecting, downloading, and organizing file groups through natural language commands
Uploadcare Automation
Automate Uploadcare file handling workflows -- list project files, permanently store uploads, retrieve file metadata, get download URLs, and manage file groups -- all through natural language.
Toolkit docs: composio.dev/toolkits/uploadcare
Setup
Add the Rube MCP server to your environment: https://rube.app/mcp
Connect your Uploadcare account when prompted (API key auth via Composio)
Start issuing natural language commands for Uploadcare automation
Core Workflows
1. List Project Files
Browse uploaded files in your Uploadcare project with filtering, sorting, and pagination.
Tool: UPLOADCARE_LIST_FILES
Key parameters:
stored -- filter by storage status: "true" for stored, "false" for unstoredremoved -- filter by removal status: "true" for removed, "false" for activeordering -- sort by datetime_uploaded (ascending) or -datetime_uploaded (descending)limit -- files per page, 1-1000 (default 100)offset -- zero-based pagination offsetfrom_date -- ISO 8601 timestamp to filter files uploaded after this dateto_date -- ISO 8601 timestamp to filter files uploaded before this dateinclude -- set to "total" to include total file count in response
Example prompt:
"List the 50 most recently uploaded stored files in my Uploadcare project"
2. Store a File Permanently
Mark an uploaded file as permanently stored. By default, Uploadcare files are temporary and will be deleted after 24 hours unless stored.
Tool: UPLOADCARE_STORE_FILE
uuid -- UUID of the file to store (required); must be in 8-4-4-4-12 hex format (e.g., 3e55317b-23d1-4f35-9b4c-b9accb7b53f4)
Always store files after upload to prevent automatic deletion.
"Permanently store the file with UUID 3e55317b-23d1-4f35-9b4c-b9accb7b53f4"
3. Get File Metadata Retrieve detailed information about a specific file including size, MIME type, CDN URL, image dimensions, and more.
Tool: UPLOADCARE_GET_FILE_INFO
uuid -- the UUID of the file to inspect (required); format: 8-4-4-4-12 hex Returns: filename, size, MIME type, CDN URL, upload date, storage status, image info (dimensions, color mode), and more.
"Get the metadata and dimensions for file 3e0923f2-e05a-4b37-9f0d-343b981c9d70"
4. Get a Temporary Download URL Retrieve a temporary direct download link for a specific file.
Tool: UPLOADCARE_GET_FILE_DOWNLOAD_URL
file_id -- the unique file identifier (required) Returns a time-limited URL that can be used for direct file download.
"Get a download link for file 3e0923f2-e05a-4b37-9f0d-343b981c9d70"
5. Browse File Groups List file groups in your project. Groups are collections of files uploaded together.
Tool: UPLOADCARE_LIST_GROUPS
limit -- groups per page, 1-1000 (default 20)offset -- zero-based pagination offset (default 0)ordering -- sort by datetime_created (ascending) or -datetime_created (descending)
"List my 10 most recent file groups"
6. File Lifecycle Workflow Combine tools for end-to-end file management:
Upload : Files are uploaded via Uploadcare's upload API or widget (outside this toolkit)Store : UPLOADCARE_STORE_FILE -- mark files as permanent to prevent auto-deletionInspect : UPLOADCARE_GET_FILE_INFO -- verify metadata, check dimensions and MIME typeShare : UPLOADCARE_GET_FILE_DOWNLOAD_URL -- generate a temporary download linkBrowse : UPLOADCARE_LIST_FILES -- audit all files with status and date filtersGroups : UPLOADCARE_LIST_GROUPS -- review batch uploads
"Store file abc-123, then get its metadata and a download link"
Known Pitfalls Pitfall Details Auto-deletion of unstored files Uploaded files are temporary by default and deleted after 24 hours -- always call UPLOADCARE_STORE_FILE to persist them UUID format strict File UUIDs must be in exact 8-4-4-4-12 hex format (e.g., 3e55317b-23d1-4f35-9b4c-b9accb7b53f4); invalid formats will be rejected Filter values are strings The stored and removed parameters accept string values "true" or "false", not booleans Temporary download URLs URLs from UPLOADCARE_GET_FILE_DOWNLOAD_URL are time-limited and will expire Pagination is offset-based Use offset + limit for pagination; there are no cursor-based pagination tokens No upload tool File uploads happen through Uploadcare's upload API or widget, not through this toolkit -- these tools manage already-uploaded files
Quick Reference Action Tool Slug Key Params List files UPLOADCARE_LIST_FILESstored, ordering, limit, offsetStore file UPLOADCARE_STORE_FILEuuidGet file info UPLOADCARE_GET_FILE_INFOuuidGet download URL UPLOADCARE_GET_FILE_DOWNLOAD_URLfile_idList groups UPLOADCARE_LIST_GROUPSlimit, offset, ordering
