uploadthing-mcp

MCP server for UploadThing, deployable as a Cloudflare Worker.

Connect any MCP-compatible AI assistant (Littlebird, Claude, Cursor, etc.) to your UploadThing account. Upload files from remote URLs, list your files, and delete them — all via natural language.

Why this exists

Most AI tools generate images and files at temporary URLs that expire. This MCP server lets your AI assistant permanently host those assets on UploadThing's CDN — so you can embed them in READMEs, docs, or anywhere else without worrying about broken links.

It runs as a Cloudflare Worker (serverless, always-on, free tier covers most personal use), and connects to any MCP client via a plain HTTPS URL — no local process required.

Related MCP server: Remote MCP Server for Cloudflare

⚠️ UploadThing API version notice

UploadThing ships breaking changes to their SDK fairly frequently. This project currently tracks uploadthing@^7.x.

If you hit errors after a fresh install or upgrade:

1. Check the UploadThing changelog

2. Check the open issues in this repo

3. Pin a specific working version in package.json if needed

PRs to update compatibility are very welcome.

Tools

Deploy

One-click (Cloudflare)

Click the Deploy to Cloudflare Workers button above. After deployment:

1. Go to Cloudflare Dashboard → Workers & Pages → your new uploadthing-mcp worker

2. Navigate to Settings → Variables & Secrets

3. Add a secret: UPLOADTHING_TOKEN = your UploadThing API token

4. Optionally add: AUTH_TOKEN = a bearer token of your choosing to protect the endpoint

Manual

Prerequisites: Node.js 22+, Wrangler CLI, an UploadThing account

git clone https://github.com/ppatel26/uploadthing-mcp
cd uploadthing-mcp
npm install

# Set your UploadThing token (Dashboard -> API Keys)
npx wrangler secret put UPLOADTHING_TOKEN

# Optional: protect your endpoint
npx wrangler secret put AUTH_TOKEN

npm run deploy

Your server will be live at:

https://uploadthing-mcp.<your-cf-subdomain>.workers.dev

Connect to your MCP client

Littlebird

Go to Settings → Integrations → Add MCP Server and paste your Worker URL.

Claude Desktop / Cursor

These clients use stdio transport and run MCP servers as local processes. For local use, see the original Toolbase-AI/uploadthing-mcp which inspired this project.

Other HTTP-based MCP clients

Point the client at your Worker URL. If AUTH_TOKEN is set, configure the client to send Authorization: Bearer <your-token> with each request.

Environment variables

Local development

# Create a .dev.vars file (gitignored) with your secrets
echo 'UPLOADTHING_TOKEN=sk_live_...' > .dev.vars

npm run dev
# Worker runs at http://localhost:8787

Credits

Inspired by Toolbase-AI/uploadthing-mcp, which implements the same idea as a local stdio server.

License

MIT