Uploadcare Automation
This skill automates file handling workflows within Uploadcare, a file storage and delivery platform. It allows users to list files, store uploads permanentl.
Install
npx promptshop add UploadcareDetails
What This Skill Does
This skill automates file handling workflows within Uploadcare, a file storage and delivery platform. It allows users to list files, store uploads permanently, retrieve metadata, get download URLs, and manage file groups through natural language commands. It is designed for Uploadcare users seeking to streamline their file management processes.
When to Use
List project files with filtersStore uploaded files permanentlyRetrieve file metadataGet download URLs for filesManage file groupsAutomate file organization
Key Features
Lists project files with filtering and sortingStores files permanently to prevent deletionRetrieves detailed file metadataGenerates download URLs for filesManages file groupsUses natural language commands
Manual Installation
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 unstored removed -- filter by removal status: "true" for removed, "false" for active ordering -- sort by datetime_uploaded (ascending) or -datetime_uploaded (descending) limit -- files per page, 1-1000 (default 100) offset -- zero-based pagination offset from_date -- ISO 8601 timestamp to filter files uploaded after this date to_date -- ISO 8601 timestamp to filter files uploaded before this date include -- 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
Key parameters: 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.
Example prompt:
"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
Key parameters: 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.
Example prompt:
"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
Key parameters: file_id -- the unique file identifier (required)
Returns a time-limited URL that can be used for direct file download.
Example prompt:
"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
Key parameters: 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)
Example prompt:
"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-deletion Inspect: UPLOADCARE_GET_FILE_INFO -- verify metadata, check dimensions and MIME type Share: UPLOADCARE_GET_FILE_DOWNLOAD_URL -- generate a temporary download link Browse: UPLOADCARE_LIST_FILES -- audit all files with status and date filters Groups: UPLOADCARE_LIST_GROUPS -- review batch uploads
Example prompt:
"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_FILES | stored, ordering, limit, offset |
| Store file | UPLOADCARE_STORE_FILE | uuid |
| Get file info | UPLOADCARE_GET_FILE_INFO | uuid |
| Get download URL | UPLOADCARE_GET_FILE_DOWNLOAD_URL | file_id |
| List groups | UPLOADCARE_LIST_GROUPS | limit, offset, ordering |
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
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 unstored removed -- filter by removal status: "true" for removed, "false" for active ordering -- sort by datetime_uploaded (ascending) or -datetime_uploaded (descending) limit -- files per page, 1-1000 (default 100) offset -- zero-based pagination offset from_date -- ISO 8601 timestamp to filter files uploaded after this date to_date -- ISO 8601 timestamp to filter files uploaded before this date include -- 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
Key parameters: 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.
Example prompt:
"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
Key parameters: uuid -- the UUID of the file to inspect (required); format: 8-4-4-4-12 hex
Returns: filename, size,