UnrealUGC

Crea anuncios de video UGC con IA, herramientas para creadores, estimaciones de costos y generación de video.

Documentación

Servidor MCP de UnrealUGC

El servidor oficial del Model Context Protocol para UnrealUGC. Proporciona a los asistentes compatibles con MCP once herramientas tipadas para explorar creadores y modelos, estimar el costo en créditos y generar anuncios de video UGC con IA.

Este repositorio contiene únicamente el adaptador MCP público. La aplicación UnrealUGC y su backend permanecen privados.

Requisitos previos

Node.js 20 o superior
Una clave API de UnrealUGC desde Panel → Configuración → Claves API

Las claves API comienzan con usk_live_ y deben almacenarse en la configuración de entorno de tu cliente MCP, nunca en un repositorio.

Configuración local con stdio

No necesitas instalar el paquete globalmente. Los clientes MCP pueden iniciarlo con npx.

Claude Desktop

Añade este servidor a tu configuración de Claude Desktop:

{
  "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 y otros clientes MCP con stdio usan el mismo comando y la misma variable de entorno.

Configuración alojada con Streamable HTTP

Los clientes que admiten MCP remoto pueden conectarse sin ejecutar un proceso local:

URL: https://unrealugc.com/api/mcp
Authorization: Bearer usk_live_...

Consulta la guía de configuración de MCP para instrucciones específicas por cliente.

Herramientas

Herramienta	Propósito
`get_me`	Confirmar la cuenta, el plan y el saldo asociados a una clave API
`get_credits`	Leer la suscripción y los grupos de créditos comprados
`list_models`	Explorar los modelos de video disponibles y sus capacidades
`list_creators`	Explorar creadores de stock y avatares personalizados
`list_voices`	Explorar voces de stock y personalizadas
`list_projects`	Encontrar proyectos de productos y campañas
`create_project`	Crear un proyecto para generaciones relacionadas
`list_videos`	Explorar el historial de generaciones con filtros y paginación
`get_video`	Consultar una generación y recuperar su URL de salida
`estimate_video_cost`	Estimar créditos a partir del guion antes de gastar
`generate_video`	Iniciar una generación de video asíncrona

generate_video admite voces nativas o seleccionadas, clips de reacción/b-roll silenciosos, direcciones visuales por escena y generación de múltiples clips en paralelo o secuencial.

Flujo de generación

Llama a list_models y list_creators.
Llama a estimate_video_cost con el guion propuesto.
Revisa get_credits si el presupuesto es importante.
Llama a generate_video.
Consulta get_video aproximadamente cada 15 segundos, o usa los webhooks de UnrealUGC para eventos de finalización.

Variables de entorno

Variable	Requerida	Predeterminada
`UNREALUGC_API_KEY`	Sí	—
`UNREALUGC_BASE_URL`	No	`https://unrealugc.com`
`UNREALUGC_REQUEST_TIMEOUT_MS`	No	`30000`

UNREALUGC_BASE_URL está destinada a entornos de desarrollo y pruebas de UnrealUGC.

Desarrollo

npm ci
npm run check
npm pack --dry-run

Consulta CONTRIBUTING.md antes de abrir una solicitud de extracción. Los informes de seguridad deben seguir SECURITY.md.