Strumenti
Ogni strumento del MCP video e del MCP della documentazione di Fluos, con gli argomenti obbligatori.
Gli strumenti video richiedono un token Bearer OAuth su /api/v1/mcp/app. Gli strumenti della documentazione sono pubblici su /api/v1/mcp. npx fluos mcp-info stampa la scheda del server della documentazione; npx fluos mcp-info --app stampa quella del server a pagamento (serve FLUOS_API_TOKEN).
MCP video
POST JSON-RPC a https://www.fluos.io/api/v1/mcp/app.
Spazio di lavoro e progetto
| Strumento | Argomenti obbligatori | Scopo |
|---|---|---|
list_workspaces | — | Spazi di lavoro a cui il chiamante ha accesso |
list_projects | workspaceId | Progetti di uno spazio di lavoro |
create_project | workspaceId | Crea un progetto e la sua chat predefinita (name facoltativo) |
list_templates | workspaceId | Modelli salvati nello spazio di lavoro (i tuoi e quelli condivisi con esso). Passane uno come templateId a create_video |
list_brand_kits | workspaceId | I brand kit dello spazio di lavoro (palette, font, tono di voce) e i preset di design di Fluos. Passane uno come brandKitId o designSystem a create_video |
Elementi
| Strumento | Argomenti obbligatori | Scopo |
|---|---|---|
list_assets | workspaceId | Elementi della libreria. kind facoltativo: image | video | document |
upload_asset | workspaceId | Apre un caricamento. Gli host compatibili con MCP Apps mostrano un caricatore integrato; il risultato contiene anche uploadPageUrl, un link valido un’ora che l’utente apre per caricare dal browser. I client in grado di inviare richieste HTTP possono invece inviare i byte grezzi del file come corpo di una richiesta POST a uploadUrl con Content-Type uguale al tipo MIME del file (niente form multipart, niente wrapper JSON, niente header di autenticazione; un file per URL), leggere storageId dalla risposta JSON, poi richiamare con storageId, filename, mediaType e size |
Non inviare byte video grezzi nel corpo JSON-RPC.
Job
| Strumento | Argomenti obbligatori | Scopo |
|---|---|---|
create_video | brief | Avvia un job generate, edit, compose o mix. Risponde subito con jobId. Senza projectId, Fluos crea un progetto per il video (in workspaceId, altrimenti nel tuo primo spazio di lavoro a pagamento) |
wait_for_job | jobId | Attende che il job cambi: risponde quando il suo stato cambia o compare l’anteprima live, oppure dopo timeoutSeconds (45 per impostazione predefinita, 50 al massimo). Stesso risultato di get_status |
get_status | jobId | Controlla il job una volta: queued | running | awaiting_credits | ready | failed | cancelled, con il passaggio in corso, l’avanzamento e cosa fare dopo |
revise_video | jobId, instruction | Modifica un video: un nuovo job a partire dal più recente, nello stesso progetto e nella stessa chat. Da usare per ogni modifica o nuovo tentativo. assetIds (sostituisce le risorse del video, per esempio nuovi filmati), recipe e vocabulary facoltativi |
list_jobs | projectId | Job recenti. limit facoltativo |
cancel_job | jobId | Annulla un job in coda, in corso o in awaiting_credits |
create_video accetta anche:
recipe,assetIdseformat.templateId. Il video viene creato in un nuovo progetto copiato da quel modello: stessa struttura, stesso ritmo e stesse animazioni, con il contenuto del tuo brief, senza passaggio di storyboard.brandKitId,designSystemodesignMd(unDESIGN.mdinline usato solo per questo job). Se non ne indichi nessuno, vale il brand kit del progetto o quello predefinito dello spazio di lavoro.style_reference_url: un link YouTube o un file diretto.mp4,.movo.webmdi cui il video deve riprendere ritmo, tagli, tipografia e palette, senza mai copiarli. I link di Instagram, X e TikTok restituisconoUPLOAD_REQUIRED: carica invece il file conupload_asset.vocabulary: fino a 20 nomi pronunciati (brand, prodotto, persone) che i sottotitoli automatici devono scrivere esattamente, per esempio["Acme", "Jane Doe"]. Fluos viene sempre scritto correttamente. Lo accetta ancherevise_video.
Vedi Primo video e Ricette.
Scheda del job
Sugli host compatibili con MCP Apps (come Claude), create_video e revise_video mostrano una scheda del job in tempo reale nella conversazione. Segue il job da sola: i passaggi della creazione, cosa sta facendo Fluos, lo storyboard, l’anteprima live durante la creazione, poi il video finito con Download MP4, Download GIF, Open in Fluos e un campo per chiedere una modifica. Un job in pausa mostra un pulsante Add credits. Poiché la scheda si aggiorna da sola, l’assistente non ha bisogno di controllare lo stato perché tu veda l’avanzamento; chiama wait_for_job quando gli serve il risultato.
Job in pausa
awaiting_credits significa che la creazione ha esaurito i crediti ed è in pausa. Non è né terminata né fallita. get_status restituisce allora un oggetto pause con reason (credits_exhausted), topUpUrl ed expiresAt (millisecondi epoch). Dai topUpUrl all’utente. Quando aggiunge crediti, lo stesso job torna da solo a running: continua ad attendere con wait_for_job invece di creare un nuovo job. Se non arrivano crediti entro expiresAt, il job fallisce.
Fonti
Quando una versione viene salvata, get_status restituisce anche sources[]: ogni elemento del video con la sua fonte, la licenza, lo stato dei diritti (licensed, cc, user_attested, owned, generated o unverified), la riga di credito e dove compare.
Esportazione
| Strumento | Argomenti obbligatori | Scopo |
|---|---|---|
export_video | jobId | Mette in coda un rendering. format è facoltativo (mp4 per impostazione predefinita): mp4 | gif | webm | mov | png-sequence. Opzioni di esportazione advanced facoltative. require_licensed: true rifiuta l’esportazione finché una voce di sources[] è unverified |
get_export | exportId | Controlla finché il file non è pronto |
Le esportazioni pronte restituiscono un playbackUrl firmato. Gli host che supportano MCP Apps hanno anche un player integrato. Se il player non viene visualizzato, apri playbackUrl.
MCP della documentazione
POST JSON-RPC a https://www.fluos.io/api/v1/mcp. Senza accesso.
| Strumento | Argomenti | Scopo |
|---|---|---|
search_fluos_docs | q | Ricerca full-text nella documentazione di Fluos |
get_fluos_openapi | — | Restituisce /openapi.json |
get_fluos_llms_txt | — | Restituisce /llms.txt |
list_fluos_developer_resources | — | URL per sviluppatori di Fluos indirizzabili per nome |
Configurazione ed esempi curl: MCP della documentazione.