MCP-Tools & -Ressourcen

Diese Referenz wird automatisch generiert aus dem laufenden MCP-Server.

Workflow

KI-Agenten sollten diesem Workflow folgen, um Pipelines auszuführen:

1. list_pipelines — verfügbare Pipelines entdecken
2. get_pipeline_schema — das Eingabeschema der gewählten Pipeline abrufen
3. request_upload — alle benötigten Dateien hochladen (Bilder, Videos, Audio)
4. run_pipeline — die Pipeline mit der erforderlichen Eingabe ausführen
5. get_pipeline_run_status — das Ergebnis prüfen (oder auf Echtzeit-Benachrichtigungen warten)

Tipp

Nach dem Aufruf von run_pipeline abonniert der Server automatisch Statusaktualisierungen. Dein Assistent erhält notifications/pipeline/status, während die Pipeline von pending → running → completed (oder failed) fortschreitet.

---

Tools

list_pipelines

Listet alle verfügbaren KI-Video-/Bild-Pipelines auf. Gibt für jede aktive Pipeline Name, Slug, Beschreibung, Kategorie, Credit-Kosten und erforderliche Provider zurück.

Parameter: Keine

---

get_pipeline_schema

Ruft das Eingabeschema für eine bestimmte Pipeline ab. Gibt das JSON-Schema zurück, das erforderliche und optionale Eingabefelder beschreibt. Nutze dies vor dem Ausführen einer Pipeline, um zu verstehen, welche Eingaben benötigt werden.

Parameter:

Name	Typ	Erforderlich	Beschreibung
pipeline_slug	string	Ja	Die Slug-Kennung der Pipeline (z. B. ‘image-generator’, ‘video-generator’)

---

run_pipeline

Führt eine KI-Pipeline anhand des Slugs mit der angegebenen Eingabe aus. Nutze list_pipelines, um verfügbare Pipelines zu entdecken, und get_pipeline_schema, um die erforderlichen Eingaben zu sehen. Gibt eine Lauf-ID zur Statusverfolgung zurück.

Parameter:

Name	Typ	Erforderlich	Beschreibung
input	object	Ja	Pipeline-Eingabefelder als JSON-Objekt. Nutze get_pipeline_schema, um die erforderlichen Felder jeder Pipeline zu sehen.
pipeline_slug	string	Ja	Die Slug-Kennung der auszuführenden Pipeline (z. B. ‘image-generator’, ‘video-generator’)

---

get_pipeline_run_status

Prüft den Status eines Pipeline-Laufs. Gibt Status (pending/running/completed/failed), Ausgabedaten, Fehlermeldungen, Zeitstempel und URLs der generierten Assets zurück.

Parameter:

Name	Typ	Erforderlich	Beschreibung
run_id	string	Ja	Die von run_pipeline zurückgegebene Pipeline-Lauf-ID

---

request_upload

Fordert eine vorsignierte S3-Upload-URL für eine Datei an. Nutze dies für Pipeline-Eingaben, die Datei-URLs erfordern (z. B. Bilder, Videos, Audio).

Zweistufiger Upload-Ablauf:

1. Rufe dieses Tool mit filename und content_type auf, um eine vorsignierte Upload-URL und die finale Asset-URL zu erhalten
2. Sende den Dateiinhalt per PUT an die upload_url (vorsigniert, läuft in 5 Minuten ab)
3. Verwende die asset_url als Eingabewert beim Ausführen einer Pipeline

Unterstützte Content-Types: image/* (max. 10 MB), video/* (max. 50 MB), audio/* (max. 20 MB)

Parameter:

Name	Typ	Erforderlich	Beschreibung
content_type	string	Ja	MIME-Typ der Datei (z. B. ‘image/jpeg’, ‘image/png’, ‘video/mp4’, ‘audio/mpeg’)
filename	string	Ja	Name der hochzuladenden Datei (z. B. ‘photo.jpg’, ‘video.mp4’)

---

---

Ressourcen

billing://balance

Credit-Guthaben

Dein aktuelles Credit-Guthaben, einschließlich verfügbarer und reservierter Credits.

MIME-Typ: application/json

---

billing://history

Credit-Verlauf

Dein Credit-Transaktionsverlauf mit Käufen, Nutzung und Erstattungen.

MIME-Typ: application/json

---

assets://list

Assets auflisten

Listet deine generierten Assets auf (Bilder, Videos, Audio). Alle Assets aus Pipeline-Läufen.

MIME-Typ: application/json

---

assets://get/{asset_id}

Asset abrufen

Ruft die Details eines bestimmten Assets anhand der ID ab, einschließlich Metadaten und Download-URL.

MIME-Typ: application/json

---

assets://list/{type}

Assets nach Typ auflisten

Listet deine generierten Assets gefiltert nach Typ auf (image, video, audio).

MIME-Typ: application/json

---

---

Echtzeit-Benachrichtigungen

Wenn du eine Pipeline ausführst, abonniert der MCP-Server automatisch Statusaktualisierungen. Benachrichtigungen verwenden die Methode 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"
      }
    ]
  }
}

Statuswerte: pending, running, completed, failed, cancelled