Strumenti e risorse MCP

Questo riferimento è generato automaticamente dal server MCP in esecuzione.

Flusso di lavoro

Gli agenti AI dovrebbero seguire questo flusso di lavoro per eseguire le pipeline:

1. list_pipelines — scopri le pipeline disponibili
2. get_pipeline_schema — ottieni lo schema di input della pipeline scelta
3. request_upload — carica gli eventuali file richiesti (immagini, video, audio)
4. run_pipeline — esegui la pipeline con l’input richiesto
5. get_pipeline_run_status — controlla il risultato (o attendi le notifiche in tempo reale)

Consiglio

Dopo aver chiamato run_pipeline, il server si sottoscrive automaticamente agli aggiornamenti di stato. Il tuo assistente riceverà notifications/pipeline/status man mano che la pipeline avanza da pending → running → completed (o failed).

---

Strumenti

list_pipelines

Elenca tutte le pipeline AI video/immagine disponibili. Restituisce nome, slug, descrizione, categoria, costo in crediti e provider richiesti per ogni pipeline attiva.

Parametri: Nessuno

---

get_pipeline_schema

Ottiene lo schema di input di una specifica pipeline. Restituisce il JSON Schema che descrive i campi di input obbligatori e facoltativi. Usalo prima di eseguire una pipeline per capire quali input sono necessari.

Parametri:

Nome	Tipo	Obbligatorio	Descrizione
pipeline_slug	string	Sì	L’identificatore slug della pipeline (es. ‘image-generator’, ‘video-generator’)

---

run_pipeline

Esegue una pipeline AI tramite slug con l’input fornito. Usa list_pipelines per scoprire le pipeline disponibili e get_pipeline_schema per vedere gli input richiesti. Restituisce un ID di esecuzione per monitorare lo stato.

Parametri:

Nome	Tipo	Obbligatorio	Descrizione
input	object	Sì	Campi di input della pipeline come oggetto JSON. Usa get_pipeline_schema per vedere i campi richiesti per ciascuna pipeline.
pipeline_slug	string	Sì	L’identificatore slug della pipeline da eseguire (es. ‘image-generator’, ‘video-generator’)

---

get_pipeline_run_status

Controlla lo stato di un’esecuzione della pipeline. Restituisce lo stato (pending/running/completed/failed), i dati di output, i messaggi di errore, le marche temporali e gli URL degli asset generati.

Parametri:

Nome	Tipo	Obbligatorio	Descrizione
run_id	string	Sì	L’ID di esecuzione della pipeline restituito da run_pipeline

---

request_upload

Richiede un URL di caricamento S3 pre-firmato per un file. Usalo per gli input delle pipeline che richiedono URL di file (es. immagini, video, audio).

Flusso di caricamento in due passaggi:

1. Chiama questo strumento con filename e content_type per ottenere un URL di caricamento pre-firmato e l’URL finale dell’asset
2. Esegui la PUT del contenuto del file su upload_url (pre-firmato, scade dopo 5 minuti)
3. Usa asset_url come valore di input quando esegui una pipeline

Tipi di contenuto supportati: image/* (max 10MB), video/* (max 50MB), audio/* (max 20MB)

Parametri:

Nome	Tipo	Obbligatorio	Descrizione
content_type	string	Sì	Tipo MIME del file (es. ‘image/jpeg’, ‘image/png’, ‘video/mp4’, ‘audio/mpeg’)
filename	string	Sì	Nome del file da caricare (es. ‘photo.jpg’, ‘video.mp4’)

---

---

Risorse

billing://balance

Saldo dei crediti

Il tuo saldo di crediti attuale, inclusi i crediti disponibili e riservati.

Tipo MIME: application/json

---

billing://history

Cronologia dei crediti

La cronologia delle transazioni dei tuoi crediti, con acquisti, utilizzi e rimborsi.

Tipo MIME: application/json

---

assets://list

Elenca gli asset

Elenca i tuoi asset generati (immagini, video, audio). Tutti gli asset delle esecuzioni delle pipeline.

Tipo MIME: application/json

---

assets://get/{asset_id}

Ottieni un asset

Ottieni i dettagli di uno specifico asset tramite ID, inclusi metadati e URL di download.

Tipo MIME: application/json

---

assets://list/{type}

Elenca gli asset per tipo

Elenca i tuoi asset generati filtrati per tipo (image, video, audio).

Tipo MIME: application/json

---

---

Notifiche in tempo reale

Quando esegui una pipeline, il server MCP si sottoscrive automaticamente agli aggiornamenti di stato. Le notifiche usano il metodo 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"
      }
    ]
  }
}

Valori di stato: pending, running, completed, failed, cancelled