UGC Pilot

UGC Pilot turns a short brief into creator-style video you can review, edit, and download. Claude and Codex can do the same work through the hosted MCP server at https://mcp.getugcpilot.com/mcp. Sign-in is OAuth, so you approve access in the browser instead of pasting an API key into the chat.

• Website
• MCP server
• Connect Claude
• Connect Codex
• MCP tools
• MCP URL: https://mcp.getugcpilot.com/mcp

See it in action

These are the same public videos embedded on UGC video generator examples.

YouTube

• https://www.youtube.com/shorts/2P1whMHDqi8
• https://www.youtube.com/watch?v=9bIweHdRdVw
• https://www.youtube.com/shorts/GDXJqTrVpIw

Instagram

• https://www.instagram.com/mira_handles/
• https://www.instagram.com/juliarose.daily/
• https://www.instagram.com/clara_iamm/
• https://www.instagram.com/reel/DePXM_Pg_Lv/
• https://www.instagram.com/reel/DeW8kYYN_lz/
• https://www.instagram.com/reel/DeqrNISlQ0Z/
• https://www.instagram.com/reel/De1snSfiDeK/
• https://www.instagram.com/reel/DeueoA-FcIT/

TikTok

• https://www.tiktok.com/@clara_iami/video/7698234106957548814
• https://www.tiktok.com/@clara_iamm/video/7698738756915907862
• https://www.tiktok.com/@clara_iamm/video/7699988037559700758
• https://www.tiktok.com/@clara_iamm/video/7699923510092631318
• https://www.tiktok.com/@clara_iamm/video/7699105939034574102

Articles & Community Posts

• https://dev.to/mrcool_9faf85434dd5e509ff/create-ai-ugc-videos-with-claude-and-codex-using-mcp-58fa
• https://medium.com/@chundusrisaiteja/how-saas-founders-are-creating-short-form-videos-without-hiring-ugc-creators-in-2026-a1985c67ec8f
• https://www.linkedin.com/feed/update/urn:li:activity:7520386970469019648/

Repository

This repository is the Next.js app for UGC Pilot. It generates reusable AI creator avatars for short-form UGC ad hooks.

Current Slice

The app uses Next.js API routes to create durable Supabase background_jobs rows and enqueue authenticated GCP Cloud Tasks. Cloud Run workers claim jobs from Supabase, checkpoint progress, and store durable outputs in Google Cloud Storage. Supabase remains the source of truth for job state and recovery.

The original foundation includes:

• Next.js App Router with TypeScript
• Tailwind CSS theme tokens for the warm creator-tool UI
• Base routes for dashboard, project setup, and avatar generation
• Supabase client dependency and public environment shape
• Project name set to UGC

Local Setup

npm install
npm run dev

Open http://localhost:3000/dashboard.

On Windows PowerShell environments that block npm.ps1, run:

cmd /c npm run dev

or use:

scripts\dev.cmd

Supabase

The project URL is configured as:

https://kltxwijhluawgveykfbt.supabase.co

Set NEXT_PUBLIC_SUPABASE_ANON_KEY in .env.local before calling Supabase from the browser. Do not store Supabase management tokens in app files.

Worker-Backed Generation

Set these server-side values in .env.local, then restart Next.js:

OPENAI_API_KEY=sk-...
SUPABASE_URL=...
SUPABASE_SERVICE_ROLE_KEY=...
GCP_PROJECT_ID=ugcsaas
GCP_REGION=us-central1
GCP_STORAGE_BUCKET=ugcsaas-media
GCP_CLOUD_TASKS_LOCATION=us-central1
GOOGLE_CLOUD_CREDENTIALS_JSON=...

Set the queue names and Cloud Run task URLs shown in .env.example. See infra/gcp/README.md for the service-account and Terraform setup.

Run both local processes:

npm run dev

Worker-backed debug routes enqueue durable jobs and poll background_jobs:

• POST /api/debug/test-generate-avatar
• GET /api/debug/avatar-run-status?jobId=...
• POST /api/debug/test-generate-hook-video
• GET /api/debug/hook-video-run-status?jobId=...