Hack Club CDN

Upload to the CDN from your terminal and your agents

A thin gateway on top of cdn.hackclub.com that adds managed uploads, auto-delete policies, a CLI, and an MCP server.

Heads up: CDN files are public by URL. Anyone with the link can view them. Don't upload secrets.

Install the CLI

brew install hackclub/tap/hc-cdn

Log in

hc-cdn login

This starts a device-code flow. Open https://zrl-hccdn.k.hackclub.dev/device, enter the code shown by the CLI, and paste your Hack Club CDN API key.

Upload

hc-cdn upload ./photo.jpg
hc-cdn upload ./photo.jpg --delete-after 7d
hc-cdn upload - --filename note.txt < note.txt
hc-cdn upload ./photos/
hc-cdn upload --url https://example.com/photo.jpg --delete-after 30d

Manage

hc-cdn list
hc-cdn expire <upload-id> --after 14d
hc-cdn expire <upload-id> --remove
hc-cdn delete <upload-id>
hc-cdn whoami
hc-cdn logout

Connect an MCP client

Point your MCP client at:

https://zrl-hccdn.k.hackclub.dev/mcp

The server speaks OAuth 2.1 with PKCE. During authorization you'll paste your Hack Club CDN API key once. Local file uploads use hc_cdn_create_upload_session, the returned one-time upload URL, then hc_cdn_finalize_upload. URL uploads use hc_cdn_upload. Other tools: hc_cdn_set_expiration, hc_cdn_delete, hc_cdn_list.

Only files uploaded through this app are managed here. Files uploaded directly to cdn.hackclub.com, Slack, etc. are not tracked.