AI Agents
Referencia de herramientas MCP
Las herramientas que expone el servidor MCP de SimpliGen a agentes de IA, y la API de Control local detrás de ellas.
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 local autenticada con token. 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 video), sus entradas y opciones, si está listo localmente, y la elegibilidad en la nube y el costo de créditos. |
get_status | Reporta el estado del motor, si la nube está conectada, el saldo de créditos, el proyecto activo, y el bloque de capacidad characters (bandera habilitada, conteos de presets instalados para base/edit/i2v, y enhancePresets, el número de presets de aumento instalados). |
start_engine | Inicia el motor local si no está en ejecución. Devuelve el estado del motor; cuando un arranque en frío dura más que la llamada, engineStarting es verdadero y get_status reporta cuándo está listo. No hace nada si el motor ya está en ejecución, 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 quitar 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 video local y obtiene un identificador para pasar a generate. |
list_loras | Enumera las LoRAs de usuario instaladas (nombre, modelo base, palabras clave) para que puedas pasarlas a generate. |
generate | Inicia una generación de imagen o video. Elige local, cloud, o auto. Opcionalmente pasa loras: [{ name, weight }] (motor local, presets donde inputs.supportsLoras es verdadero; usa list_loras para nombres) y una negativePrompt. 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_job | Obtiene el estado y resultado de un trabajo, incluida la ruta de salida una vez que se completa. |
wait_for_result | Espera hasta que un trabajo se complete, falle o agote el tiempo. |
list_jobs | Enumera trabajos de generación recientes. |
cancel_job | Cancela un trabajo en cola o en ejecución. |
prepare_preset | Inicia la descarga de 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 video devuelven una ruta de archivo. |
list_recipe_blocks | Enumera los bloques de construcción para crear una receta: puntos de entrada (crear imagen o video, editar imagen, aumentar) 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 fijos a presets, más cualquier entrada) y guárdala como borrador. SimpliGen conecta automáticamente los puertos, la cadena de medios paso a paso, y una entrada de prompt por paso, luego valida. Devuelve el id de la receta más validación. |
validate_recipe | Prueba seca una especificación de receta (o una configuración sin procesar) sin guardar, y obtén errores precisos para corregir antes de componer. |
list_recipes | Enumera los borradores de recetas 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 Marketplace de Creadores (en cola para revisión humana). Necesita una cuenta conectada; publica gratis a menos que se establezca un precio de token único. |
run_recipe | Ejecuta una receta instalada (las que están en UGC Studio y Product Studio, o un borrador) con sus entradas completas. Una entrada de asunto toma un id de carácter o producto, las entradas de medios toman identificadores de carga, las entradas de texto y elección toman valores simples. Mismo pipeline que hacer clic en Generar en el estudio. 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 complete (o pase 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 vuelo local se interrumpe. |
list_subjects | Cada asunto que una entrada de asunto 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 del 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 los presets instalados disponibles para cada rol de carácter: generación de retrato base, edición de identidad, animación de imagen a video, y mejora (aumento). 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 (usa tu propia imagen como base), y vision-recreate (características descritas por agente a partir de una foto del usuario). En modo generar, la herramienta sondea 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 trabajos para sondear vía wait_for_result. |
generate_character_video | Genera un clip de video animado para un carácter existente. Acepta framePresetId opcional (preset de edición de identidad para el paso del fotograma) y videoPresetId (preset i2v para el paso de animación). Devuelve ids de trabajos para el paso del fotograma y el paso de animación. |
generate_character_frame | Genera un único fotograma fijo para un carácter sin animarlo. Útil cuando quieres revisar o mejorar el fotograma antes de animarlo. Acepta un presetId opcional. Devuelve { jobIds: [...] }; usa jobIds[0] como el id del trabajo del fotograma. |
animate_character | Anima un carácter a partir de un fotograma completado o cualquier trabajo de imagen completado. Pasa jobId (un id de trabajo de cualquier generación completada) o una filePath (ruta absoluta local de imagen). Acepta un videoPresetId opcional. Devuelve un id de trabajo de video. |
set_character_preset | Establece un preset predeterminado pegajoso por carácter para generación de imagen (imagePresetId) y/o generación de video (videoPresetId). Pasa null para limpiar 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 | Aumenta o mejora una imagen o video de carácter. La fuente puede ser un trabajo completado (jobId), un archivo cargado (identificador de ruta filePath), o el retrato base del carácter (target: 'base'). Acepta scale (factor de aumento), keepResolution (aumentar luego redimensionar de vuelta a dimensiones de origen para un resultado más nítido del mismo tamaño), y applyAsBase (reemplazar el retrato base del carácter con el resultado aumentado). 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 un nuevo carácter. Sondea internamente, acepta automáticamente la nueva base, y devuelve el objeto de carácter listo. El agente no necesita sondear un id de trabajo después. |
remove_character | Elimina permanentemente un carácter y sus datos asociados. |
Cómo se conecta
El agente ejecuta el servidor MCP con npx -y @simpligen/mcp sobre stdio. El servidor se autentica a 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. Genera un token en Configuración, en la sección "Conectar un agente".
¿Estás 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.