UnrealUGC MCP server

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 usklive 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

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

1. Call listmodels and listcreators.
2. Call estimatevideocost with the proposed script.
3. Check get_credits if budget matters.
4. Call generate_video.
5. Poll get_video about every 15 seconds, or use UnrealUGC webhooks for completion events.

Environment variables

UNREALUGCBASEURL 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

• UnrealUGC MCP overview
• MCP documentation
• REST API documentation
• UnrealUGC dashboard

License

MIT © Next MVP Solutions LLC