# UnrealUGC

Connects UnrealUGC video generation tools to coding assistants. It handles actor discovery, script cost estimates, and automated ad creation.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: UnrealUGC
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/UnrealUGC/mcp
- Updated: 2026-08-18
- HTML: https://affpapa.org/en/nevibecode/mcp/unrealugc

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://unrealugc.com/api/mcp`
- Environment variables: `UNREALUGC_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI**
```bash
claude mcp add mcp -e UNREALUGC_API_KEY=<UNREALUGC_API_KEY> -- npx -y @unrealugc/mcp
```
Replace <…> with your own values

2. **Platform CLI: remote server**
```bash
claude mcp add --transport http unrealugc https://unrealugc.com/api/mcp
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add unrealugc --url https://unrealugc.com/api/mcp
```

2. **Platform CLI**
```bash
codex mcp add unrealugc --env UNREALUGC_API_KEY=<UNREALUGC_API_KEY> -- npx -y @unrealugc/mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "unrealugc": {
            "url": "https://unrealugc.com/api/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "unrealugc": {
            "command": "npx",
            "args": [
                "-y",
                "@unrealugc/mcp"
            ],
            "env": {
                "UNREALUGC_API_KEY": "<UNREALUGC_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "unrealugc": {
            "type": "http",
            "url": "https://unrealugc.com/api/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "unrealugc": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@unrealugc/mcp"
            ],
            "env": {
                "UNREALUGC_API_KEY": "<UNREALUGC_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http unrealugc https://unrealugc.com/api/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e UNREALUGC_API_KEY=<UNREALUGC_API_KEY> unrealugc npx -y @unrealugc/mcp
```
Replace <…> with your own values

## When to use it
- 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
- 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.

## Similar
- [ugc-ads](https://affpapa.org/en/nevibecode/skills/ugc-ads.md) — skill · 1800 installs
- [Tegas AI](https://affpapa.org/en/nevibecode/mcp/tegas-ai.md) — MCP server
- [UGC Fans](https://affpapa.org/en/nevibecode/mcp/ugc-fans.md) — MCP server
- [ai-avatar-video](https://affpapa.org/en/nevibecode/skills/ai-avatar-video.md) — skill · 860700 installs
- [ugc-ad-scripts](https://affpapa.org/en/nevibecode/skills/ugc-ad-scripts.md) — skill · 19400 installs
- [video](https://affpapa.org/en/nevibecode/skills/video.md) — skill · 86500 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md