English Français العربية

UnrealUGC

السجل الرسمي التسويق والمبيعات

Generate and manage AI UGC video ads through eleven typed MCP tools

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http unrealugc 'https://unrealugc.com/api/mcp' --header 'Authorization: <Bearer followed by an UnrealUGC API key>'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "unrealugc": {
            "type": "http",
            "url": "https://unrealugc.com/api/mcp",
            "headers": {
                "Authorization": "<Bearer followed by an UnrealUGC API key>"
            }
        }
    }
}
NPM package @unrealugc/mcp
Claude Code 
claude mcp add unrealugc -e 'UNREALUGC_API_KEY=<your unrealugc_api_key>' -- npx -y @unrealugc/mcp@1.0.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "unrealugc": {
            "command": "npx",
            "args": [
                "-y",
                "@unrealugc/mcp@1.0.0"
            ],
            "env": {
                "UNREALUGC_API_KEY": "<your unrealugc_api_key>"
            }
        }
    }
}

متغيرات البيئة

  • UNREALUGC_API_KEY إلزامي سري UnrealUGC API key created in Dashboard Settings

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. UnrealUGC MCP Server
  2. Prerequisites
  3. Local stdio setup
  4. Hosted Streamable HTTP setup
  5. Tools
  6. Generation flow
  7. Environment variables
  8. Development
  9. Links
  10. License

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

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.

License

MIT © Next MVP Solutions LLC

الأسئلة الشائعة

ما هو UnrealUGC؟

Generate and manage AI UGC video ads through eleven typed MCP tools

كيف أثبّت UnrealUGC؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http unrealugc 'https://unrealugc.com/api/mcp' --header 'Authorization: <Bearer followed by an UnrealUGC API key>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج UnrealUGC إلى مفتاح API؟

نعم. يتطلب UNREALUGC_API_KEY, Authorization، وتضبطها في إعداداته.

هل UnrealUGC مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون UnrealUGC؟

ينشره UnrealUGC. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.