UnrealUGC MCP¶
Create and manage AI UGC video ads through eleven typed MCP tools: browse available video models, creators and voices, estimate credit cost before spending, start asynchronous generations and poll for completed output. Ships as local stdio (npx -y @unrealugc/mcp) and hosted Streamable HTTP (unrealugc.com/api/mcp), MIT-licensed, with the same API key for both transports.
Server type: stdio via npm or hosted Streamable HTTP
Auth: UNREALUGC_API_KEY (usk_live_...)
Install: npx -y @unrealugc/mcp
Remote endpoint: https://unrealugc.com/api/mcp
Tools: 11 (models, creators, voices, projects, videos, credits, generation)
License: MIT
Category: Marketing / AI video ads
Built by: UnrealUGC (unrealugc.com) — registry com.unrealugc/mcp
Why This Matters for Operators¶
UGC-style ads convert, but shooting them is the bottleneck: finding creators, briefing, filming, editing, iterating. UnrealUGC moves the whole loop into an agent: pick a creator persona, pick a voice, estimate what the generation costs in credits before spending anything, then generate asynchronously and poll for the finished video. Eleven tools cover the entire workflow, so the agent can run "make three ad variations across three creators and tell me which performs best" as one job instead of a production calendar.
Cost-before-spend is the operator-friendly detail. estimate_video_cost prices a generation before it starts, and get_credits answers "how many 15-second videos can I make this month" — credit discipline built into the tool surface rather than discovered on the invoice.
Tools & Capabilities¶
| Tool | What it does |
|---|---|
get_me / get_credits |
Account info and credit balance |
list_models |
Available video models (includes Seedance 2.0 and Kling-class models) |
list_creators |
Stock and custom creator personas |
list_voices |
Stock and custom voices |
list_projects / create_project |
Project organization |
list_videos / get_video |
Prior generations and status |
estimate_video_cost |
Credit estimate before generating |
generate_video |
Start an asynchronous generation |
Tools self-describe via tools/list with full JSON Schema inputs.
Installation¶
Stdio (Claude Code):
claude mcp add unrealugc \
--env UNREALUGC_API_KEY=usk_live_... \
-- npx -y @unrealugc/mcp
Generic JSON config:
{
"mcpServers": {
"unrealugc": {
"command": "npx",
"args": ["-y", "@unrealugc/mcp"],
"env": {
"UNREALUGC_API_KEY": "usk_live_..."
}
}
}
}
Hosted HTTP for remote MCP clients: register https://unrealugc.com/api/mcp and pass the same API key as a Bearer token.
Configuration¶
| Variable | Required | Default | Description |
|---|---|---|---|
UNREALUGC_API_KEY |
yes | — | API key from unrealugc.com/dashboard/settings/api-keys |
UNREALUGC_BASE_URL |
no | https://unrealugc.com |
Override for self-hosting |
Business Relevance¶
- DTC brands produce UGC-style ad variants without a creator shoot per variation
- Growth operators A/B test creator personas and scripts at credit cost instead of agency day rates
- Agencies run client ad production as agent jobs with per-job cost estimates up front
- Lean teams cover "we need video ads" with one API key instead of a production pipeline
Integration with CorpusIQ¶
CorpusIQ's 40+ connectors measure what ads earn — spend, revenue, conversions across Google, Meta and storefronts. UnrealUGC produces the creative that enters those funnels. The composed loop: UnrealUGC generates and polls ad variants from an agent, the agent publishes them through the existing social stack, and CorpusIQ's ad and analytics connectors attribute results — creative production and performance measurement in one session, no spreadsheet handoff between tools.
Limitations¶
- New listing (repo and service launched Aug 18, 2026); no public pricing beyond credit-based billing
- Asynchronous generation means polling — long videos need the agent to check back rather than blocking
- Creator and voice libraries are stock-first; custom creators may be a higher plan tier
- Eleven tools cover the core loop, but no editing or caption tooling — post-production stays outside the MCP surface