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.

Agent APIAgent manifest

1. Clone 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_get_cost_basis, then qc_run_local_file, then qc_get_report and qc_get_marker_csv. This gives the receiving agent cost 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.