MCP reference

Install command for public agent workspaces:

npx -y @drantoniou/uploadcheck-mcp

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

qc_estimate_cost

Estimate checked minutes and effective gates before an agent uploads or runs media.

Inputs

minutes, duration_seconds, checks, plan_id, ai_review_seconds, cost_guardrail

Outputs

margin_safe, effective_checks, removed_checks, cost_estimate, action

qc_run_video

Start a full-timeline UploadCheck run from Claude, Codex, or another agent workspace.

Inputs

youtube_url, upload_id, signed_url, video_base64, audio_base64, data_url, manifest_url, transcript_url, watchlist_url, expected_script_url, chunk_sidecars_url, callback_url

Outputs

job_id, verdict, status_url, report_url, minutes_metered, media_ingress, sidecar_ingress, cost_estimate

qc_run_local_file

Read a local media file from an agent workspace and send it through Render inline or signed upload.

Inputs

file_path, checks, manifest_path, transcript_path, watchlist_path, expected_script_path, sidecar_dir, plan_id, cost_guardrail

Outputs

job_id, verdict, status_url, report_url, minutes_metered, media_ingress, cost_estimate

qc_get_job

Poll status, stage, progress, current verdict, and minutes for an active job.

Inputs

job_id

Outputs

status, stage, progress_pct, verdict, minutes_metered, media_ingress

qc_get_report

Retrieve a finished UploadCheck report with evidence-grounded timestamp flags.

Inputs

job_id

Outputs

verdict, flags, timestamps, transcript_evidence, share_url

qc_get_events

Retrieve lifecycle events so an agent can cite exactly which QC stages ran.

Inputs

job_id

Outputs

events, event_type, created_at

qc_get_artifacts

List report artifacts and editor handoff files for a QC run.

Inputs

job_id

Outputs

artifacts, artifact_type, url

qc_get_marker_csv

Download the CSV marker export for an editor handoff.

Inputs

job_id

Outputs

csv

qc_create_upload_url

Create a signed upload URL so agents can send local files without handling QC storage directly.

Inputs

filename, content_type, size_bytes

Outputs

upload_id, signed_put_url, expires_at, put_then_run_qc_with_upload_id