Uploadcare Automation

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

1. Add the Composio MCP server to your environment: http://localhost:8787/mcp
2. Connect your Uploadcare account when prompted (API key auth via Composio)
3. 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:

1. Upload: Files are uploaded via Uploadcare's upload API or widget (outside this toolkit)
2. Store: UPLOADCARE_STORE_FILE -- mark files as permanent to prevent auto-deletion
3. Inspect: UPLOADCARE_GET_FILE_INFO -- verify metadata, check dimensions and MIME type
4. Share: UPLOADCARE_GET_FILE_DOWNLOAD_URL -- generate a temporary download link
5. Browse: UPLOADCARE_LIST_FILES -- audit all files with status and date filters
6. Groups: UPLOADCARE_LIST_GROUPS -- review batch uploads

Example prompt:

"Store file abc-123, then get its metadata and a download link"

Known Pitfalls

Quick Reference

Powered by Composio