Official MCP server for creating and managing AI UGC video ads with eleven typed tools for creators, models, voices, projects, credit estimates, video generation, and completed outputs.
Quick Install
Automated & IDE SetupCopy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.
Not yet automatically verified
We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.
Manual Client & Custom JSON ConfigExpand JSON ▾
Install Config Generator
Choose your client
💡 Paste into ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
Documentation Overview
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:
Claude Code
Codex
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:
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
See CONTRIBUTING.md before opening a pull request. Security reports should follow SECURITY.md.
Links
License
MIT © Next MVP Solutions LLC
Related MCP Servers
Reviews
No reviews yet — be the first to share how this listing worked for you.
Frequently Asked Questions about UnrealUGC MCP Server
AllMCPs Directory Badge
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
Badge Style:
Live Dynamic SVG Preview
Markdown (GitHub README)
[](https://allmcps.com/mcp/unrealugc-mcp-server)HTML Embed
<a href="https://allmcps.com/mcp/unrealugc-mcp-server"><img src="https://allmcps.com/api/badge/unrealugc-mcp-server?style=directory" alt="UnrealUGC MCP Server on AllMCPs" /></a>