uploadad

Command line interface and MCP server for upload.ad. Upload ad creatives, track upload jobs, manage the creative library and copy variants, launch and manage ads, and read performance from terminals, scripts, and CI pipelines, without writing any HTTP code.

Full documentation: upload.ad/docs/cli

Install

npm install -g uploadad

Or run it without installing:

npx uploadad --help

Requires Node 20.3 or newer.

Authentication

uploadad login

Opens upload.ad in your browser: sign in, approve the device, and you are done. The credential is stored in ~/.config/uploadad/config.json. CLI access requires a paid plan.

For headless environments, use an API key instead (create one in your workspace settings): run uploadad login --key ua_live_..., or set UPLOADAD_API_KEY and skip login entirely.

Credentials resolve in this order: the --api-key flag, then UPLOADAD_API_KEY, then the stored config file.

Usage

uploadad upload banner.png promo.mp4 --wait
uploadad jobs list
uploadad copy add --creative cr_... --text "New headline"
uploadad whoami

Every command accepts --json for machine-readable output. See the full command reference for uploads, jobs, copy, folders, webhooks, and the rest.

MCP server

The same package ships an MCP server over stdio, exposing the upload.ad tool catalog to MCP clients:

uploadad mcp

Point your client at that command once you have authenticated. A hosted server is also available at https://upload.ad/mcp if you would rather not install anything. See upload.ad/docs/mcp for client configuration.

License

MIT