UnrealUGC — Claude Code MCP server: what it does, how to install
Connects UnrealUGC video generation tools to coding assistants. It handles actor discovery, script cost estimates, and automated ad creation.
claude mcp add mcp -e UNREALUGC_API_KEY=<UNREALUGC_API_KEY> -- npx -y @unrealugc/mcpWhat UnrealUGC does
This MCP server links your development environment with UnrealUGC to produce video ads without leaving the editor. Assistants can inspect avatar rosters, choose spoken voices, and organize marketing projects.
The typical workflow starts by estimating credit usage for a prepared script before committing budget. Render jobs run asynchronously. The server allows your agent to poll for task progress and retrieve the final download link.
Local stdio execution strictly requires Node.js 20 and a valid UNREALUGC_API_KEY token.
What it helps with
- calculate credit expenses for video scripts prior to rendering
- trigger automated UGC video ad creation with virtual presenters
- fetch catalogs of stock avatars and synthesized voices
- track generation job status and retrieve rendered video download links
Example prompts for the agent
- Check my UnrealUGC credit balance and list available female creators for a software ad.
- Estimate the cost for this draft script and launch the video generation once confirmed.
- Fetch the status and file URL for the latest video job in UnrealUGC.
How to install UnrealUGC
1Platform CLI
claude mcp add mcp -e UNREALUGC_API_KEY=<UNREALUGC_API_KEY> -- npx -y @unrealugc/mcpReplace <…> with your own values
2Platform CLI: remote server
claude mcp add --transport http unrealugc https://unrealugc.com/api/mcp1Platform CLI: remote server
codex mcp add unrealugc --url https://unrealugc.com/api/mcp2Platform CLI
codex mcp add unrealugc --env UNREALUGC_API_KEY=<UNREALUGC_API_KEY> -- npx -y @unrealugc/mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"unrealugc": {
"url": "https://unrealugc.com/api/mcp"
}
}
}{
"mcpServers": {
"unrealugc": {
"command": "npx",
"args": [
"-y",
"@unrealugc/mcp"
],
"env": {
"UNREALUGC_API_KEY": "<UNREALUGC_API_KEY>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"unrealugc": {
"type": "http",
"url": "https://unrealugc.com/api/mcp"
}
}
}{
"servers": {
"unrealugc": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@unrealugc/mcp"
],
"env": {
"UNREALUGC_API_KEY": "<UNREALUGC_API_KEY>"
}
}
}
}Replace <…> with your own values
1Platform CLI: remote server
gemini mcp add -t http unrealugc https://unrealugc.com/api/mcp2Platform CLI
gemini mcp add -e UNREALUGC_API_KEY=<UNREALUGC_API_KEY> unrealugc npx -y @unrealugc/mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about UnrealUGC
How to install UnrealUGC in Claude Code?
Run claude mcp add --env UNREALUGC_API_KEY=<UNREALUGC_API_KEY> --transport stdio unrealugc -- npx -y @unrealugc/mcp for stdio mode. To connect over HTTP, use claude mcp add --transport http unrealugc https://unrealugc.com/api/mcp.
What capabilities does UnrealUGC provide?
It exposes tools for browsing avatars, previewing voice options, checking balances, and requesting async ad rendering directly through the agent.
What credentials are required to use this server?
You must provide an API key prefixed with usk_live_ from your UnrealUGC settings. Running via npx also requires Node.js 20 or higher.
