UnrealUGC MCP MCP Server
Create AI UGC video ads from Claude, Cursor, and other MCP clients
About
UnrealUGC MCP connects AI assistants to the UnrealUGC video ad platform. Create UGC video projects, browse actors and voices, generate scripts, monitor rendering, and manage finished video ads through 11 focused tools. It supports local stdio via npm and a hosted Streamable HTTP endpoint. An UnrealUGC API key is required.
Security Report
This is a well-structured MCP server for the UnrealUGC video generation API with strong authentication, input validation, and error handling. The codebase properly handles API credentials, implements comprehensive schema validation using Zod, and avoids dangerous patterns. Minor code quality observations exist but do not materially impact security. Package verification found 1 issue.
7 files analyzed · 4 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
What You'll Need
Set these up before or after installing:
Environment variable: UNREALUGC_API_KEY
Sign up freeHow to Install & Connect
Available as Local & Remote
This plugin can run on your machine or connect to a hosted endpoint. during install.
Getting Started
Once installed, try these example prompts and explore these capabilities:
- 1Create a UGC video ad for my product using a suitable actor and voice
- 2List available UnrealUGC actors and voices
- 3Check the rendering status of my latest video project
- 4npx -y @unrealugc/mcp
Documentation
View on GitHubFrom the project's GitHub README.
UnrealUGC MCP Server
The official Model Context Protocol server for UnrealUGC. It gives MCP-compatible assistants eleven typed tools for browsing creators and models, estimating credit cost, and generating AI UGC video ads.
This repository contains only the public MCP adapter. The UnrealUGC application and backend remain private.
Prerequisites
- Node.js 20 or newer
- An UnrealUGC API key from Dashboard → Settings → API Keys
API keys start with usk_live_ and should be stored in your MCP client's environment settings,
never committed to a repository.
Local stdio setup
You do not need to install the package globally. MCP clients can launch it with npx.
Claude Desktop
Add this server to your Claude Desktop configuration:
{
"mcpServers": {
"unrealugc": {
"command": "npx",
"args": ["-y", "@unrealugc/mcp"],
"env": {
"UNREALUGC_API_KEY": "usk_live_..."
}
}
}
}
Claude Code
claude mcp add unrealugc --env UNREALUGC_API_KEY=usk_live_... -- npx -y @unrealugc/mcp
Codex
[mcp_servers.unrealugc]
command = "npx"
args = ["-y", "@unrealugc/mcp"]
[mcp_servers.unrealugc.env]
UNREALUGC_API_KEY = "usk_live_..."
Cursor, Windsurf, OpenClaw, and other stdio MCP clients use the same command and environment variable.
Hosted Streamable HTTP setup
Clients that support remote MCP can connect without running a local process:
URL: https://unrealugc.com/api/mcp
Authorization: Bearer usk_live_...
See the MCP setup guide for client-specific instructions.
Tools
| Tool | Purpose |
|---|---|
get_me | Confirm the account, plan, and balance behind an API key |
get_credits | Read subscription and purchased credit pools |
list_models | Browse available video models and capabilities |
list_creators | Browse stock creators and custom avatars |
list_voices | Browse stock and custom voices |
list_projects | Find product and campaign projects |
create_project | Create a project for related generations |
list_videos | Browse generation history with filters and pagination |
get_video | Poll a generation and retrieve its output URL |
estimate_video_cost | Estimate credits from the script before spending |
generate_video | Start an asynchronous video generation |
generate_video supports native or selected voices, silent reaction/b-roll clips, per-scene
visual directions, and parallel or sequential multi-clip generation.
Generation flow
- Call
list_modelsandlist_creators. - Call
estimate_video_costwith the proposed script. - Check
get_creditsif budget matters. - Call
generate_video. - Poll
get_videoabout every 15 seconds, or use UnrealUGC webhooks for completion events.
Environment variables
| Variable | Required | Default |
|---|---|---|
UNREALUGC_API_KEY | Yes | — |
UNREALUGC_BASE_URL | No | https://unrealugc.com |
UNREALUGC_REQUEST_TIMEOUT_MS | No | 30000 |
UNREALUGC_BASE_URL is intended for UnrealUGC development and staging environments.
Development
npm ci
npm run check
npm pack --dry-run
See CONTRIBUTING.md before opening a pull request. Security reports should follow SECURITY.md.
Links
License
MIT © Next MVP Solutions LLC
Reviews
No reviews yet
Be the first to review this server!
More Marketing & Social MCP Servers
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
MarkItDown
Freeby Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.
FinAgent
Freeby mcp-marketplace · Finance
Free stock data and market news for any MCP-compatible AI assistant.
Google Workspace MCP
Freeby Taylorwilsdon · Productivity
Control Gmail, Calendar, Docs, Sheets, Drive, and more from your AI