How do I install UnrealUGC?

Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does UnrealUGC need an API key?

The publisher lists these environment variables: UNREALUGC_API_KEY.

What transport does UnrealUGC use?

UnrealUGC is reached over HTTP.

When was UnrealUGC last checked?

Last checked 2026-11-08. Generate and manage AI UGC video ads through eleven typed MCP tools

UnrealUGC MCP server

Power your agent

Add this server

The publisher's own URL. Not a PlugMCP endpoint.

Add to Cursor Add in Claude Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Server URL

https://unrealugc.com/api/mcp

Credentials from the publisher

UNREALUGC_API_KEY — UnrealUGC API key created in Dashboard Settings

The Claude button above opens Claude with the name and URL filled in. You still confirm it there.

shClaude Code

1claude mcp add --transport http com.unrealugc-mcp https://unrealugc.com/api/mcp

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "com.unrealugc-mcp": {4      "command": "npx",5      "args": [6        "-y",7        "mcp-remote",8        "https://unrealugc.com/api/mcp"9      ]10    }11  }12}

claude_desktop_config.json

Remote · HTTPPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Remote

Transport: http
Version: 1.0.0
API key

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

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_models and list_creators.
Call estimate_video_cost with the proposed script.
Check get_credits if budget matters.
Call generate_video.
Poll get_video about 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.

UnrealUGC

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install UnrealUGC?

Does UnrealUGC need an API key?

What transport does UnrealUGC use?

When was UnrealUGC last checked?

Documentation

UnrealUGC MCP Server

Prerequisites

Local stdio setup

Claude Desktop

Claude Code

Codex

Hosted Streamable HTTP setup

Tools

Generation flow

Environment variables

Development

Links

License