Back to Browse

UnrealUGC MCP MCP Server

by UnrealUGC Support
Marketing & SocialLow Risk8.2Remote
Free

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

8.2
Low Risk8.2Low Risk

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 Found in Source Code

Found by scanning the linked source code. This listing connects to a hosted endpoint, so none of this runs on your machine: it describes what the server software does where it is hosted.

env_vars

Applies to the server that hosts this plugin, not to your machine.

HTTP Network Access

Connects to external APIs or services over the internet.

What You'll Need

Set these up before or after installing:

Create an API key in Dashboard → Settings → API Keys. Keys start with usk_live_.Required

Environment variable: UNREALUGC_API_KEY

Sign up free

How to Connect

Remote Plugin

No local installation needed. Your AI client connects to the remote endpoint directly.

Add this to your MCP configuration to connect:

{
  "mcpServers": {
    "unrealugc-mcp": {
      "url": "https://unrealugc.com/api/mcp"
    }
  }
}

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 GitHub

From the project's GitHub README.

UnrealUGC MCP Server

npm CI

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

ToolPurpose
get_meConfirm the account, plan, and balance behind an API key
get_creditsRead subscription and purchased credit pools
list_modelsBrowse available video models and capabilities
list_creatorsBrowse stock creators and custom avatars
list_voicesBrowse stock and custom voices
list_projectsFind product and campaign projects
create_projectCreate a project for related generations
list_videosBrowse generation history with filters and pagination
get_videoPoll a generation and retrieve its output URL
estimate_video_costEstimate credits from the script before spending
generate_videoStart 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

  1. Call list_models and list_creators.
  2. Call estimate_video_cost 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

VariableRequiredDefault
UNREALUGC_API_KEYYes—
UNREALUGC_BASE_URLNohttps://unrealugc.com
UNREALUGC_REQUEST_TIMEOUT_MSNo30000

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!