Install UploadCheck for Agents

Quality check videos, podcasts, and clips before you upload.

Set up the uploadcheck MCP server so Claude Code, Codex, Cursor, or another agent can call UploadCheck, hand evidence to a second agent, and rerun after fixes.

Fastest start: paste a prompt into your agent

Skip the config files. Copy this prompt, paste it into Claude Code, Cursor, or any AI chat, and it sets up the free /check command for you — no account, no API key. For the paid MCP server with AI gates, use the manual setup below.

Paste into your AI — free, no account
Loading the setup prompt…

1. Prepare the MCP package

Current GitHub install

git clone https://github.com/ajantoniou/uploadcheck.git /absolute/path/to/uploadcheck
cd /absolute/path/to/uploadcheck/mcp-server
npm install

Environment

UPLOADCHECK_API_BASE_URL=https://api.uploadcheck.app
UPLOADCHECK_API_KEY=<workspace_api_key>

2. Configure an MCP client

Codex

Add this server to ~/.codex/config.toml.

[mcp_servers.uploadcheck]
command = "node"
args = ["/absolute/path/to/uploadcheck/mcp-server/index.mjs"]
startup_timeout_sec = 60

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

Claude Code or Claude Desktop

Add this server to the Claude MCP config JSON.

{
  "mcpServers": {
    "uploadcheck": {
      "command": "node",
      "args": ["/absolute/path/to/uploadcheck/mcp-server/index.mjs"],
      "env": {
        "UPLOADCHECK_API_BASE_URL": "https://api.uploadcheck.app",
        "UPLOADCHECK_API_KEY": "<workspace_api_key>"
      }
    }
  }
}

Cursor

Add the same server to .cursor/mcp.json.

{
  "mcpServers": {
    "uploadcheck": {
      "command": "node",
      "args": ["/absolute/path/to/uploadcheck/mcp-server/index.mjs"],
      "env": {
        "UPLOADCHECK_API_BASE_URL": "https://api.uploadcheck.app",
        "UPLOADCHECK_API_KEY": "<workspace_api_key>"
      }
    }
  }
}

3. Run agent-to-agent QC

First calls

Call qc_estimate_cost when needed, then qc_run_local_file, then qc_get_report and qc_get_marker_csv. This gives the receiving agent checked-minute context, verdict, timestamped evidence, and editor markers.

Repair loop

The first agent shows all BLOCK and WATCH flags, asks whether to fix now, applies reachable caption or source-file fixes, and reruns UploadCheck before claiming the media is upload-ready.