UnrealUGC

Crie anúncios em vídeo UGC com IA, com ferramentas para criadores, estimativas de custo e geração de vídeos.

Documentação

Servidor MCP UnrealUGC

O servidor oficial do Model Context Protocol para UnrealUGC. Ele oferece aos assistentes compatíveis com MCP onze ferramentas tipadas para navegar por criadores e modelos, estimar custo de créditos e gerar anúncios em vídeo de UGC com IA.

Este repositório contém apenas o adaptador MCP público. O aplicativo UnrealUGC e o backend permanecem privados.

Pré-requisitos

Node.js 20 ou mais recente
Uma chave de API UnrealUGC em Painel → Configurações → Chaves de API

As chaves de API começam com usk_live_ e devem ser armazenadas nas configurações de ambiente do seu cliente MCP, nunca commitadas em um repositório.

Configuração local via stdio

Você não precisa instalar o pacote globalmente. Clientes MCP podem iniciá-lo com npx.

Claude Desktop

Adicione este servidor à sua configuração do 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 e outros clientes MCP via stdio usam o mesmo comando e variável de ambiente.

Configuração hospedada via Streamable HTTP

Clientes que suportam MCP remoto podem se conectar sem executar um processo local:

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

Consulte o guia de configuração do MCP para instruções específicas por cliente.

Ferramentas

Ferramenta	Finalidade
`get_me`	Confirmar a conta, o plano e o saldo associados a uma chave de API
`get_credits`	Ler assinatura e pools de créditos comprados
`list_models`	Navegar pelos modelos de vídeo disponíveis e suas capacidades
`list_creators`	Navegar por criadores de estoque e avatares personalizados
`list_voices`	Navegar por vozes de estoque e personalizadas
`list_projects`	Encontrar projetos de produtos e campanhas
`create_project`	Criar um projeto para gerações relacionadas
`list_videos`	Navegar pelo histórico de gerações com filtros e paginação
`get_video`	Consultar uma geração e recuperar a URL de saída
`estimate_video_cost`	Estimar créditos a partir do roteiro antes de gastar
`generate_video`	Iniciar uma geração de vídeo assíncrona

generate_video suporta vozes nativas ou selecionadas, clipes de reação/b-roll silenciosos, direções visuais por cena e geração de múltiplos clipes em paralelo ou sequencial.

Fluxo de geração

Chame list_models e list_creators.
Chame estimate_video_cost com o roteiro proposto.
Verifique get_credits se o orçamento for relevante.
Chame generate_video.
Consulte get_video a cada 15 segundos aproximadamente, ou use webhooks do UnrealUGC para eventos de conclusão.

Variáveis de ambiente

Variável	Obrigatória	Padrão
`UNREALUGC_API_KEY`	Sim	—
`UNREALUGC_BASE_URL`	Não	`https://unrealugc.com`
`UNREALUGC_REQUEST_TIMEOUT_MS`	Não	`30000`

UNREALUGC_BASE_URL é destinada a ambientes de desenvolvimento e staging do UnrealUGC.

Desenvolvimento

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

Consulte CONTRIBUTING.md antes de abrir um pull request. Relatos de segurança devem seguir SECURITY.md.