AI Agents
Referencia de herramientas MCP
Las herramientas que expone el servidor MCP de SimpliGen a los agentes de IA, y la API de Control local que hay detrás.
SimpliGen incluye un servidor MCP (@simpligen/mcp) que conecta un agente de IA a la aplicación SimpliGen en ejecución a través de una conexión autenticada por token local. El agente llama a herramientas MCP; el servidor las reenvía a la API de Control local de la aplicación. Consulta Conectar un agente para configurar esto.
Herramientas
| Herramienta | Qué hace |
|---|---|
list_capabilities | Enumera cada preset con el que el agente puede generar (imagen o vídeo), sus entradas y opciones, si está listo localmente, y elegibilidad en la nube y costo de crédito. |
get_status | Informa del estado del motor, si la nube está conectada, el saldo de créditos, el proyecto activo, y el bloque de capacidad characters (bandera habilitada, recuentos de presets instalados para base/edit/i2v, y enhancePresets, el número de presets de ampliación instalados). |
start_engine | Inicia el motor local si no está ya en ejecución. Devuelve el estado del motor; cuando un arranque en frío supera la duración de la llamada, engineStarting es verdadero y get_status informa cuándo está activo. No hace nada si el motor ya se ejecuta, y nunca instala uno faltante (conector 0.3.0 o más nuevo). |
stop_engine | Detiene el motor local y libera su VRAM. La generación en la nube no se ve afectada (conector 0.3.0 o más nuevo). |
restart_engine | Reinicia el motor local, después de instalar o eliminar un nodo personalizado, o cuando está atascado (conector 0.3.0 o más nuevo). |
list_projects | Enumera proyectos (los contenedores que contienen generaciones). |
create_project | Crea un nuevo proyecto. |
upload_file | Carga una imagen o vídeo local y obtiene un identificador para pasar a generate. |
list_loras | Enumera los LoRAs de usuario instalados (nombre, modelo base, palabras activadoras) para que puedas pasarlos a generate. |
generate | Inicia una generación de imagen o vídeo. Elige local, cloud, o auto. Opcionalmente pasa loras: [{ name, weight }] (motor local, presets donde inputs.supportsLoras es verdadero; usa list_loras para nombres) y un negativePrompt (términos adicionales, añadidos después del negativo predeterminado del preset; en ejecuciones en la nube se utiliza el predeterminado del preset tal cual). options toma los campos nombrados (steps, cfg, seed, resolution, aspectRatio, durationSeconds) y cualquier Control Avanzado que declare el preset bajo list_capabilities → options.controls, como unlock, shift o high_steps, como clave de nivel superior (conector 0.2.0 o más nuevo). Devuelve un id de trabajo. |
get_prompt_guide | Lee la guía de prompt para un preset (presetId) antes de escribir su prompt: cómo el modelo lee un prompt, estructura, longitud, redacción de cámara y movimiento, negativos, redacción de personajes y ejemplos. La respuesta lleva family, generic (verdadero cuando no existe una guía específica del modelo) y el text de la guía. Conector 0.6.0 o más nuevo; generate le dice a los agentes que lo llamen primero. |
get_job | Obtiene el estado y resultado de un trabajo, incluyendo la ruta de salida una vez que se completa. |
wait_for_result | Espera hasta que un trabajo se completa, falla o agota el tiempo. |
list_jobs | Enumera trabajos de generación recientes. |
cancel_job | Cancela un trabajo en cola o en ejecución. |
prepare_preset | Comienza a descargar los modelos de un preset local para que esté listo para ejecutarse. |
get_result_image | Devuelve la imagen de un trabajo completado en línea para verla. Los resultados de vídeo devuelven una ruta de archivo. |
list_recipe_blocks | Enumera los bloques de construcción para crear una receta: puntos de entrada (crear imagen o vídeo, editar imagen, ampliar) y cada preset utilizable como paso, cada uno con su contrato de puerto (entradas que necesita, lo que produce, en qué puntos de entrada encaja). |
compose_recipe | Crea una nueva receta a partir de una especificación de alto nivel (pasos ordenados fijados a presets, más cualquier entrada) y guárdala como borrador. SimpliGen conecta automáticamente los puertos, la cadena de medios paso a paso, e una entrada de prompt por paso, luego valida. Devuelve el id de receta más validación. |
validate_recipe | Ejecuta en prueba una especificación de receta (o una configuración sin procesar) sin guardar, y obtiene errores precisos para corregir antes de componer. |
list_recipes | Enumera los borradores de receta guardados en este dispositivo. |
get_recipe | Obtiene una receta guardada y su configuración completa por id. |
publish_recipe | Envía una receta guardada al Creator Marketplace (en cola para revisión humana). Necesita una cuenta conectada; publica de forma gratuita a menos que se establezca un precio de token único. |
run_recipe | Ejecuta una receta instalada (las de UGC Studio y Product Studio, o un borrador) con sus entradas rellenas. Una entrada de sujeto toma un id de carácter o producto, las entradas de medios toman identificadores de carga, las entradas de texto y opción toman valores simples. Mismo pipeline que hacer clic en Generar en el studio. Devuelve un id de ejecución. |
get_recipe_run | Estado de una ejecución de receta: estado general, cada paso con su estado y resultado, y la ruta del resultado final una vez hecho. |
wait_for_recipe_run | Bloquea hasta que una ejecución de receta se completa (o pasa un tiempo de espera) y devuelve la ejecución final. |
list_recipe_runs | Ejecuciones recientes de una receta con su estado y resultados. |
cancel_recipe_run | Detiene una receta en ejecución. No comienzan más pasos; un paso en local en vuelo se interrumpe. |
list_subjects | Cada sujeto que una entrada de sujeto de receta puede tomar: caracteres y productos, con sus ids. |
list_products | Los productos guardados en este dispositivo. |
create_product | Guarda un producto a partir de una foto cargada (nombre, descripción, categoría) para que Product Studio y recetas UGC puedan usarlo. Devuelve el id de producto. |
remove_product | Elimina un producto y su foto. |
list_characters | Enumera todos los caracteres activos en Character Studio. |
get_character | Obtiene los detalles e imágenes de un solo carácter por id. |
list_character_features | Enumera todas las características de identidad (tono de piel, cabello, etc.) y sus opciones, para usar al crear un carácter por descripción. |
list_character_presets | Enumera presets instalados disponibles para cada rol de carácter: generación de retrato base, edición de identidad, animación imagen a vídeo, y mejora (ampliación). Cada preset de mejora incluye un array supportedScales. |
create_character | Crea un nuevo carácter. Soporta tres caminos: describir (generar un retrato base a partir de selecciones de características), cargar (usar tu propia imagen como base), y visión-recrear (características descritas por agente a partir de una foto de usuario). En modo generar, la herramienta realiza encuestas internamente hasta que el retrato base esté listo y devuelve el objeto de carácter listo. En modo carga, el carácter está listo inmediatamente. |
generate_character_image | Genera una imagen de escena para un carácter existente por prompt. Acepta un presetId opcional para seleccionar qué preset de edición de identidad usar para esta llamada. Devuelve uno o más ids de trabajo para encuestar vía wait_for_result. |
generate_character_video | Genera un clip de vídeo animado para un carácter existente. Acepta opcionales framePresetId (preset de edición de identidad para el paso de fotograma) y videoPresetId (preset i2v para el paso de animación). Devuelve ids de trabajo para los pasos de fotograma y animación. |
generate_character_frame | Genera un fotograma único estático para un carácter sin animarlo. Útil cuando deseas revisar o mejorar el fotograma antes de animarlo. Acepta un presetId opcional. Devuelve { jobIds: [...] }; usa jobIds[0] como el id de trabajo de fotograma. |
animate_character | Anima un carácter desde un fotograma completado o cualquier trabajo de imagen completado. Pasa jobId (un id de trabajo de cualquier generación completada) o un filePath (ruta absoluta local de imagen). Acepta un videoPresetId opcional. Devuelve un id de trabajo de vídeo. |
set_character_preset | Establece un preset predeterminado pegajoso por carácter para generación de imagen (imagePresetId) y/o generación de vídeo (videoPresetId). Pasa null para borrar un predeterminado. Las llamadas posteriores a generate_character_image y generate_character_video usan estos predeterminados a menos que se anulen por llamada. |
enhance_character_media | Amplia o mejora una imagen o vídeo de carácter. La fuente puede ser un trabajo completado (jobId), un archivo cargado (identificador de filePath), o el retrato base del carácter (target: 'base'). Acepta scale (factor de ampliación), keepResolution (ampliar luego redimensionar de vuelta a dimensiones de fuente para un resultado más nítido del mismo tamaño), y applyAsBase (reemplazar el retrato base del carácter con el resultado ampliado). Devuelve un id de trabajo. |
regenerate_character_base | Re-genera el retrato base para un carácter existente en su lugar, opcionalmente cambiando a un preset base diferente o actualizando la identidad. No se crea ningún carácter nuevo. Realiza encuestas internamente, acepta automáticamente la nueva base, y devuelve el objeto de carácter listo. El agente no necesita encuestar un id de trabajo después. |
remove_character | Elimina permanentemente un carácter y sus datos asociados. |
list_films | Enumera las películas de Video Studio de un proyecto (conector 0.5.0 o más nuevo, al igual que todas las herramientas de película a continuación). |
create_film | Crea una película vacía: forma, resolución, dónde se renderiza, presets por tipo de toma. Responde su línea de tiempo. |
get_film | Lee la línea de tiempo de una película: tempo, reparto, cada clip con su número, inicio y duración en segundos y barras, tomas y estado de toma, las pistas, marcadores y rango de exportación. |
update_film_settings | Cambia la forma, resolución, dónde se renderiza, presets, Sujeto y estilo, y el reparto y ubicación que hereda cada clip. |
add_track | Coloca un archivo de audio cargado en la línea de tiempo: canto, música, diálogos o efectos. |
move_track | Mueve el audio de una pista, silenciala, o establece su volumen. |
detect_tempo | Establece el tempo de la película y las líneas de barra a partir de su canción. Después de esto, los tiempos pueden darse en barras. |
add_clip | Añade un clip vacío en un momento, para una duración. |
update_clip | Escribe un clip en un paso: tomas (prompt, duración, línea hablada o cantada, quién la dice, encuadre), reparto, ubicación, cómo comienza (fresco o continúa del clip anterior; none y frame también se aceptan, como fresco y continúa), qué pistas escucha, preset. |
move_clip | Mueve un clip a un nuevo inicio u otra pista de vídeo. |
trim_clip | Cambia la duración de un clip, o dónde comienza dentro de su toma. |
remove_clip | Elimina un clip. |
apply_film_plan | Distribuye un borrador completo en un paso: clips en las barras con sus tomas, reparto y enlaces. Cada problema vuelve a la vez; nada cambia a menos que todo sea válido. |
set_fades | Desvanece un clip o una pista dentro y fuera. |
add_marker | Coloca un marcador nombrado en la regla. |
set_export_range | Exporta solo parte de la película, o toda ella. |
render_clips | Renderiza los clips que lo necesiten, o los nombrados. Responde de una vez con qué comenzó, qué se retiene, y el costo en la nube. |
wait_for_renders | Espera hasta que ningún clip se está renderizando y responde la línea de tiempo. |
list_takes | Enumera las tomas de un clip. |
use_take | Convierte una de las tomas de un clip en la que muestra. |
export_film | Cose la película en un vídeo con su música y responde la ruta del archivo. |
list_locations | Enumera las ubicaciones de la Biblioteca. |
create_location | Guarda una ubicación a partir de una imagen cargada o un trabajo de imagen completado. |
Con la película abierta en Video Studio, cada cambio que hace un agente aparece de inmediato y se deshace con Ctrl+Z. Consulta Un agente hace un videoclip musical para un recorrido completo.
Cómo se conecta
El agente ejecuta el servidor MCP con npx -y @simpligen/mcp sobre stdio. El servidor se autentica en la aplicación con un token de emparejamiento (SIMPLIGEN_TOKEN) y encuentra el puerto local de la aplicación automáticamente. La aplicación SimpliGen debe estar en ejecución. Crea un token en Configuración, en la sección "Conectar un agente".
¿Construyendo una integración personalizada?
Las herramientas MCP reenvían a una API de Control HTTP local que puedes llamar directamente desde cualquier lenguaje. Consulta la referencia de API de Control.
Límites de gasto
Cada token puede llevar un límite de gasto. Un límite vacío significa uso ilimitado en la nube, 0 significa solo generación local, y un número positivo limita el gasto en la nube a ese número de créditos. La generación local siempre está permitida y nunca cuenta contra el límite.
Un agente crea un videoclip
Dale a un agente de IA una canción y un elenco, y observa cómo construye un videoclip en el Video Studio, clip a clip, en tiempo real.
Referencia de la API de Control
La API HTTP local que SimpliGen expone en tu máquina, para construir integraciones personalizadas y ejecutar generaciones sin interfaz gráfica.