Herramientas y recursos de MCP

Esta referencia se genera automáticamente a partir del servidor MCP en ejecución.

Flujo de trabajo

Los agentes de IA deben seguir este flujo de trabajo para ejecutar pipelines:

1. list_pipelines — descubre los pipelines disponibles
2. get_pipeline_schema — obtén el esquema de entrada del pipeline elegido
3. request_upload — sube los archivos necesarios (imágenes, vídeos, audio)
4. run_pipeline — ejecuta el pipeline con la entrada requerida
5. get_pipeline_run_status — comprueba el resultado (o espera las notificaciones en tiempo real)

Consejo

Tras llamar a run_pipeline, el servidor se suscribe automáticamente a las actualizaciones de estado. Tu asistente recibirá notifications/pipeline/status a medida que el pipeline avanza por pending → running → completed (o failed).

---

Herramientas

list_pipelines

Lista todos los pipelines de vídeo/imagen con IA disponibles. Devuelve el nombre, el slug, la descripción, la categoría, el coste en créditos y los proveedores requeridos de cada pipeline activo.

Parámetros: Ninguno

---

get_pipeline_schema

Obtiene el esquema de entrada de un pipeline concreto. Devuelve el JSON Schema que describe los campos de entrada requeridos y opcionales. Úsalo antes de ejecutar un pipeline para saber qué entradas se necesitan.

Parámetros:

Nombre	Tipo	Requerido	Descripción
pipeline_slug	string	Sí	El identificador de slug del pipeline (p. ej. ‘image-generator’, ‘video-generator’)

---

run_pipeline

Ejecuta un pipeline de IA por slug con la entrada indicada. Usa list_pipelines para descubrir los pipelines disponibles y get_pipeline_schema para ver las entradas requeridas. Devuelve un ID de ejecución para hacer el seguimiento del estado.

Parámetros:

Nombre	Tipo	Requerido	Descripción
input	object	Sí	Los campos de entrada del pipeline como un objeto JSON. Usa get_pipeline_schema para ver los campos requeridos de cada pipeline.
pipeline_slug	string	Sí	El identificador de slug del pipeline que se va a ejecutar (p. ej. ‘image-generator’, ‘video-generator’)

---

get_pipeline_run_status

Comprueba el estado de la ejecución de un pipeline. Devuelve el estado (pending/running/completed/failed), los datos de salida, los mensajes de error, las marcas de tiempo y las URL de los activos generados.

Parámetros:

Nombre	Tipo	Requerido	Descripción
run_id	string	Sí	El ID de ejecución del pipeline devuelto por run_pipeline

---

request_upload

Solicita una URL de subida a S3 prefirmada para un archivo. Úsalo para las entradas de pipeline que requieren URL de archivos (p. ej. imágenes, vídeos, audio).

Flujo de subida en dos pasos:

1. Llama a esta herramienta con filename y content_type para obtener una URL de subida prefirmada y la URL final del activo
2. Haz un PUT del contenido del archivo a la upload_url (prefirmada, caduca en 5 minutos)
3. Usa la asset_url como valor de entrada al ejecutar un pipeline

Tipos de contenido admitidos: image/* (máx. 10MB), video/* (máx. 50MB), audio/* (máx. 20MB)

Parámetros:

Nombre	Tipo	Requerido	Descripción
content_type	string	Sí	Tipo MIME del archivo (p. ej. ‘image/jpeg’, ‘image/png’, ‘video/mp4’, ‘audio/mpeg’)
filename	string	Sí	Nombre del archivo que se va a subir (p. ej. ‘photo.jpg’, ‘video.mp4’)

---

---

Recursos

billing://balance

Saldo de créditos

Tu saldo de créditos actual, incluidos los créditos disponibles y reservados.

Tipo MIME: application/json

---

billing://history

Historial de créditos

Tu historial de transacciones de créditos, que muestra compras, uso y reembolsos.

Tipo MIME: application/json

---

assets://list

Listar activos

Lista tus activos generados (imágenes, vídeos, audio). Todos los activos de las ejecuciones de pipelines.

Tipo MIME: application/json

---

assets://get/{asset_id}

Obtener activo

Obtiene los detalles de un activo concreto por ID, incluidos los metadatos y la URL de descarga.

Tipo MIME: application/json

---

assets://list/{type}

Listar activos por tipo

Lista tus activos generados filtrados por tipo (image, video, audio).

Tipo MIME: application/json

---

---

Notificaciones en tiempo real

Cuando ejecutas un pipeline, el servidor MCP se suscribe automáticamente a las actualizaciones de estado. Las notificaciones usan el método notifications/pipeline/status:

{
  "method": "notifications/pipeline/status",
  "params": {
    "run_id": "uuid",
    "status": "completed",
    "pipeline_name": "Pipeline Name",
    "pipeline_slug": "pipeline-slug",
    "assets": [
      {
        "id": "uuid",
        "url": "https://s3.pipe2.ai/assets/...",
        "type": "image"
      }
    ]
  }
}

Valores de estado: pending, running, completed, failed, cancelled