UploadThing integration
UploadThing is a file upload service designed specifically for Next.js and modern web applications. Provides simple file uploads with automatic CDN delivery, file type validation, size limits, image optimization, and webhook notifications. Features include presigned URLs, direct uploads to S3-compatible storage, React components, and seamless integration with popular frameworks like Next.js, SvelteKit, and Solid.
Say what should happen.
The workflow builds itself.
Common UploadThing use cases
- large file uploads
- v7 direct uploads
- correcting file names
- direct client uploads
- removing unused files
- managing uploaded files
- client-side file uploads
- monitoring storage usage
- tracking upload failures
- saving upload callback data
What you can do with UploadThing
Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.
Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.
File, 6 operations
delete_filesDelete filesPOSTMarks UploadThing files for deletion by file key or custom ID.list_filesList filesPOSTLists files uploaded to your UploadThing application. Returns file metadata including IDs, custom IDs, keys, names, status, sizes, and upload timestamps.prepare_file_uploadsPrepare file uploadsPOSTRequests presigned UploadThing upload instructions for file metadata.rename_filesRename filesPOSTRenames uploaded files in UploadThing by file key or custom ID. Updates display names while preserving file keys and CDN URLs.request_file_accessRequest file accessPOSTGenerates a short-lived signed URL to access a private UploadThing file. Required for files stored with private ACL.update_aclUpdate aclPOSTUpdates the access control list for UploadThing files. Switch files between public-read (accessible by URL) and private (requires signed URL) access.
Upload, 5 operations
complete_multipart_uploadComplete multipart uploadPOSTCompletes a multipart UploadThing upload and makes the file available for download.mark_upload_failedMark upload failedPOSTReports a failed upload to UploadThing for analytics tracking and resource cleanup. Call when client-side upload encounters errors.poll_uploadPoll uploadGETPolls an UploadThing upload by file key until it is still working or done.prepare_upload_v7Prepare upload v7POSTPrepares a v7 UploadThing upload and returns the file key and upload URL.request_presigned_urlRequest presigned urlPOSTGenerates presigned URLs for direct client-side uploads to UploadThing. Enables secure uploads without proxying through your server.
Callback, 2 operations
get_server_callbackGet server callbackGETGets server callback completion status for an UploadThing upload.set_server_callbackSet server callbackPOSTSets server callback data for an UploadThing upload.
Application, 1 operation
get_app_infoGet app infoPOSTRetrieves UploadThing application information including app ID and default ACL settings.
Usage, 1 operation
get_usage_infoGet usage infoPOSTRetrieves usage statistics for your UploadThing account including total bytes, app bytes, uploaded file count, and byte limit.
Use UploadThing from Claude Code, Cursor or Codex
Connect UploadThing in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its UploadThing operations become tools the client can call, next to every other integration you connected.
claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"
[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"{
"mcpServers": {
"livecontext": {
"type": "http",
"url": "https://livecontext.ai/mcp",
"headers": {
"X-API-Key": "YOUR_API_KEY"
}
}
}
}How to connect UploadThing
- Create your workspace
Sign up free. Nothing to install.
- Connect UploadThing once
Add your UploadThing connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
- Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.
UploadThing integration FAQ
What can you do with the UploadThing integration?
LiveContext exposes 15 operations on UploadThing, covering file, upload, callback and application. Common uses include large file uploads, v7 direct uploads and correcting file names.
