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](https://composio.dev/toolkits/uploadcare)

---

## Setup

1. Add the Rube MCP server to your environment: `https://rube.app/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

| 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` |

---

*Powered by [Composio](https://composio.dev)*