Outils et ressources MCP

Cette référence est générée automatiquement à partir du serveur MCP en cours d’exécution.

Workflow

Les agents IA devraient suivre ce workflow pour exécuter des pipelines :

1. list_pipelines — découvrez les pipelines disponibles
2. get_pipeline_schema — obtenez le schéma d’entrée du pipeline choisi
3. request_upload — importez tout fichier requis (images, vidéos, audio)
4. run_pipeline — exécutez le pipeline avec l’entrée requise
5. get_pipeline_run_status — vérifiez le résultat (ou attendez les notifications en temps réel)

Astuce

Après l’appel à run_pipeline, le serveur s’abonne automatiquement aux mises à jour d’état. Votre assistant recevra notifications/pipeline/status à mesure que le pipeline progresse de pending → running → completed (ou failed).

---

Outils

list_pipelines

Liste tous les pipelines vidéo/image IA disponibles. Renvoie le nom, le slug, la description, la catégorie, le coût en crédits et les fournisseurs requis pour chaque pipeline actif.

Paramètres : aucun

---

get_pipeline_schema

Obtient le schéma d’entrée d’un pipeline spécifique. Renvoie le JSON Schema décrivant les champs d’entrée requis et optionnels. Utilisez-le avant d’exécuter un pipeline pour comprendre quelles entrées sont nécessaires.

Paramètres :

Nom	Type	Requis	Description
pipeline_slug	string	Oui	L’identifiant slug du pipeline (par ex. ‘image-generator’, ‘video-generator’)

---

run_pipeline

Exécute un pipeline IA par slug avec l’entrée fournie. Utilisez list_pipelines pour découvrir les pipelines disponibles et get_pipeline_schema pour voir les entrées requises. Renvoie un ID d’exécution pour le suivi de l’état.

Paramètres :

Nom	Type	Requis	Description
input	object	Oui	Champs d’entrée du pipeline sous forme d’objet JSON. Utilisez get_pipeline_schema pour voir les champs requis de chaque pipeline.
pipeline_slug	string	Oui	L’identifiant slug du pipeline à exécuter (par ex. ‘image-generator’, ‘video-generator’)

---

get_pipeline_run_status

Vérifie l’état d’une exécution de pipeline. Renvoie l’état (pending/running/completed/failed), les données de sortie, les messages d’erreur, les horodatages et les URL des ressources générées.

Paramètres :

Nom	Type	Requis	Description
run_id	string	Oui	L’ID d’exécution du pipeline renvoyé par run_pipeline

---

request_upload

Demande une URL S3 présignée pour importer un fichier. Utilisez-la pour les entrées de pipeline qui requièrent des URL de fichiers (par ex. images, vidéos, audio).

Flux d’import en deux étapes :

1. Appelez cet outil avec filename et content_type pour obtenir une URL d’import présignée et une URL de ressource finale
2. Envoyez le contenu du fichier en PUT vers l’upload_url (présignée, expire dans 5 minutes)
3. Utilisez l’asset_url comme valeur d’entrée lors de l’exécution d’un pipeline

Types de contenu pris en charge : image/* (10 Mo max), video/* (50 Mo max), audio/* (20 Mo max)

Paramètres :

Nom	Type	Requis	Description
content_type	string	Oui	Type MIME du fichier (par ex. ‘image/jpeg’, ‘image/png’, ‘video/mp4’, ‘audio/mpeg’)
filename	string	Oui	Nom du fichier à importer (par ex. ‘photo.jpg’, ‘video.mp4’)

---

---

Ressources

billing://balance

Solde de crédits

Votre solde de crédits actuel, incluant les crédits disponibles et réservés.

Type MIME : application/json

---

billing://history

Historique des crédits

Votre historique de transactions de crédits, affichant les achats, l’utilisation et les remboursements.

Type MIME : application/json

---

assets://list

Lister les ressources

Liste vos ressources générées (images, vidéos, audio). Toutes les ressources issues des exécutions de pipelines.

Type MIME : application/json

---

assets://get/{asset_id}

Obtenir une ressource

Obtient les détails d’une ressource spécifique par ID, y compris ses métadonnées et son URL de téléchargement.

Type MIME : application/json

---

assets://list/{type}

Lister les ressources par type

Liste vos ressources générées filtrées par type (image, video, audio).

Type MIME : application/json

---

---

Notifications en temps réel

Lorsque vous exécutez un pipeline, le serveur MCP s’abonne automatiquement aux mises à jour d’état. Les notifications utilisent la méthode 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"
      }
    ]
  }
}

Valeurs d’état : pending, running, completed, failed, cancelled