MCP server · Claude Code · Cursor · Codex · VS Code

Run `/check` before you publish.

UploadCheck is an MCP server your AI runs on a finished export. It returns one verdict — PASS, WATCH, or BLOCK — with timestamped evidence, then hands your agent the exact spans to fix. Wire it once; catch the frozen frame, the dead air, the loudness spike before it ships, not after.

Install the MCP server See a sample PASS / WATCH / BLOCK report → Read the MCP docs →

Free /check needs no account and no API key — paste the prompt below. Add a key only for paid AI gates.

One command your agent already knows how to run

UploadCheck adds a media-QC server named uploadcheck to your workspace. Your AI calls it like any other tool — no new app to open, no export to drag anywhere.

Quality checks, timestamped

The free tier runs 35 automated checks on the final file: frozen frames, dead air, loudness, caption safe-area, format, and more. Every flag comes back with a timestamp, so your agent knows exactly where the problem is.

A verdict, not a vibe

Every run returns PASS, WATCH, or BLOCK. Your agent routes on it: PASS ships, BLOCK stops the upload, WATCH gets a human look. A real verdict, measured off the actual file and timestamped — not a guess from a model that never opened the export.

A repair loop, not a report

UploadCheck hands back the flagged spans and marks which ones your agent can fix in place. Your agent fixes those, reruns, and only calls the media upload-ready once the BLOCK verdict is clear.

The fastest way: paste one prompt

Not a developer? Don't touch a config file. Copy the prompt below, paste it into Claude Code, Cursor, or any AI chat, and it sets up /check for you — no account, no API key, free. Then just say /check and drop in your video.

Paste into your AI — free, no account

Loading the setup prompt…

Prefer to wire the MCP server by hand? (developer setup)

Pick your workspace. Each tab has the exact block to paste — command, package or path, and the two environment variables.

Package: @drantoniou/uploadcheck-mcp · Base URL: https://api.uploadcheck.app · Add UPLOADCHECK_API_KEY only for paid runs.

Add the server to your Claude MCP config. It pulls the package with npx and registers uploadcheck as a tool.

Add to your Claude MCP config

{
  "mcpServers": {
    "uploadcheck": {
      "command": "npx",
      "args": ["-y", "@drantoniou/uploadcheck-mcp"],
      "env": {
        "UPLOADCHECK_API_BASE_URL": "https://api.uploadcheck.app",
        "UPLOADCHECK_API_KEY": "<workspace_api_key>"
      }
    }
  }
}

Restart the workspace and /check is available. Type it on any local export.

Add the server to .cursor/mcp.json. Cursor pulls the package with npx on reload and exposes the uploadcheck tools to your agent.

Add to .cursor/mcp.json

{
  "mcpServers": {
    "uploadcheck": {
      "command": "npx",
      "args": ["-y", "@drantoniou/uploadcheck-mcp"],
      "env": {
        "UPLOADCHECK_API_BASE_URL": "https://api.uploadcheck.app",
        "UPLOADCHECK_API_KEY": "<workspace_api_key>"
      }
    }
  }
}

Reload Cursor, then ask your agent to check an export.

Add the server to ~/.codex/config.toml. This registers a local UploadCheck runner — point command at your checkout's run-uploadcheck-mcp.sh. Codex loads it on start and can call uploadcheck mid-task.

Add to ~/.codex/config.toml

[mcp_servers.uploadcheck]
command = "/absolute/path/to/uploadcheck/mcp-server/run-uploadcheck-mcp.sh"
args = []
startup_timeout_sec = 60

[mcp_servers.uploadcheck.env]
UPLOADCHECK_API_BASE_URL = "https://api.uploadcheck.app"
UPLOADCHECK_API_KEY = "<workspace_api_key>"

Swap the placeholder path for your local checkout. startup_timeout_sec is pre-set to 60 so the server has time to boot on the first run.

Any MCP-capable VS Code setup runs the same generic stdio server. Point your MCP extension at the npx command below.

Generic stdio server

{
  "command": "npx",
  "args": ["-y", "@drantoniou/uploadcheck-mcp"],
  "env": {
    "UPLOADCHECK_API_BASE_URL": "https://api.uploadcheck.app",
    "UPLOADCHECK_API_KEY": "<workspace_api_key>"
  }
}

Same package, same two environment variables, any MCP client.

Prefer a local checkout or GitHub clone? Both are supported on every client — see the full agent install guide, or read the machine-readable matrix at /mcp-install.json.

What you get free, and where paid starts

The free /check path needs no account and no API key — paste the prompt above and go. Free gives you the 40+ quality checks and 200 checked minutes a month: enough to check every export as you finish it. Sign up with an email (no card) when you want the dashboard and scan history. Batching a week of clips at once? That's the upgrade trigger — a paid workspace key lifts the hourly cap and turns on the AI gates: garbled-speech detection, on-screen continuity, and narration match, where a trained model actually watches and listens, then hands your agent a fix list.

Free /check = no account, no card, no key, 40+ checks, 200 checked minutes a month.
Paid = workspace key, no hourly cap, AI gates on.

Start free — email, no card → Compare plans →

Talk to it like you talk to your agent

Once uploadcheck is wired, these are the kinds of things you type. Your AI translates them into the right tool calls.

/check this export before I upload it

Show me every flag over WATCH and where it is on the timeline.

Fix the dead-air gaps it flagged as fixable, then rerun the check.

Don't let me publish until the BLOCK verdict is clear.

The verdict is PASS / WATCH / BLOCK plus timestamped flags. Your agent decides what to fix; you decide what ships.

Make `/check` the reflex, not the afterthought

Drop one line into your AGENTS.md, CLAUDE.md, or .cursorrules so your agent runs UploadCheck before every media upload — without being asked.

Pin to your agent rules file

Before uploading or publishing any video or audio, run UploadCheck (/check) on the final
export and resolve any BLOCK verdict first. See https://uploadcheck.app/SKILL.md

Now "make me a video and post it" ends with a clean export instead of a broken one.

Wire it once. A broken export never gets past your agent.

Install the uploadcheck MCP server, pin the rule, and your agent gates every export before it ships.

Install the MCP server See a sample report →

Run /check before you publish.