Tools

Video-Tools erfordern ein OAuth-Bearer-Token auf /api/v1/mcp/app. Docs-Tools sind öffentlich auf /api/v1/mcp. npx fluos mcp-info gibt die Docs-Server-Card aus; npx fluos mcp-info --app gibt die kostenpflichtige Card aus (FLUOS_API_TOKEN erforderlich).

Video-MCP

JSON-RPC per POST an https://www.fluos.io/api/v1/mcp/app.

Workspace und Projekt

Tool	Erforderliche Argumente	Zweck
`list_workspaces`	—	Workspaces, auf die der Aufrufer Zugriff hat
`list_projects`	`workspaceId`	Projekte in einem Workspace
`create_project`	`workspaceId`	Legt ein Projekt und seinen Standard-Chat an (`name` optional)
`list_templates`	`workspaceId`	Im Workspace gespeicherte Vorlagen (deine und die mit ihm geteilten). Übergib eine als `templateId` an `create_video`
`list_brand_kits`	`workspaceId`	Die Brand-Kits des Workspace (Palette, Schriften, Tonalität) und die Fluos-Design-Presets. Übergib eines als `brandKitId` oder `designSystem` an `create_video`

Assets

Tool	Erforderliche Argumente	Zweck
`list_assets`	`workspaceId`	Assets der Bibliothek. Optional `kind`: `image` \| `video` \| `document`
`upload_asset`	`workspaceId`	Öffnet einen Upload. Hosts mit MCP-Apps-Unterstützung zeigen einen Inline-Uploader; das Ergebnis enthält außerdem `uploadPageUrl`, einen eine Stunde gültigen Link, den der Nutzer öffnet, um aus seinem Browser hochzuladen. Clients, die HTTP-Anfragen senden können, können stattdessen die rohen Datei-Bytes als Request-Body per `POST` an `uploadUrl` senden, mit `Content-Type` auf den MIME-Typ der Datei gesetzt (kein Multipart-Formular, kein JSON-Wrapper, kein Auth-Header; eine Datei pro URL), `storageId` aus der JSON-Antwort lesen und dann erneut mit `storageId`, `filename`, `mediaType` und `size` aufrufen

Sende keine rohen Video-Bytes im JSON-RPC-Body.

Aufträge

Tool	Erforderliche Argumente	Zweck
`create_video`	`brief`	Startet einen generate-, edit-, compose- oder mix-Auftrag. Antwortet sofort mit `jobId`. Ohne `projectId` legt Fluos ein Projekt für das Video an (in `workspaceId`, sonst in deinem ersten kostenpflichtigen Workspace)
`wait_for_job`	`jobId`	Wartet, bis sich der Auftrag ändert: antwortet, wenn sich sein Status ändert oder die Live-Vorschau erscheint, oder nach `timeoutSeconds` (Standard 45, max. 50). Gleiches Ergebnis wie `get_status`
`get_status`	`jobId`	Prüft den Auftrag einmal: `queued` \| `running` \| `awaiting_credits` \| `ready` \| `failed` \| `cancelled`, mit aktuellem Schritt, Fortschritt und dem, was als Nächstes zu tun ist
`revise_video`	`jobId`, `instruction`	Ändert ein Video: ein neuer Auftrag aus dem neuesten, im selben Projekt und Chat. Nutze es für jede Änderung oder jeden neuen Versuch. Optional `assetIds` (ersetzt die Assets des Videos, z. B. neues Footage), `recipe` und `vocabulary`
`list_jobs`	`projectId`	Letzte Aufträge. Optional `limit`
`cancel_job`	`jobId`	Bricht einen wartenden, laufenden oder `awaiting_credits`-Auftrag ab

create_video akzeptiert außerdem:

recipe, assetIds und format.
templateId. Das Video wird in einem neuen, von dieser Vorlage kopierten Projekt erstellt: gleiche Struktur, gleiches Tempo und gleiche Animationen, der Inhalt deines Briefings, kein Storyboard-Schritt.
brandKitId, designSystem oder designMd (ein Inline-DESIGN.md, das nur für diesen Auftrag verwendet wird). Ohne eines davon wird das Brand-Kit des Projekts oder der Standard des Workspace verwendet.
style_reference_url: ein YouTube-Link oder eine direkte .mp4-, .mov- oder .webm-Datei, deren Tempo, Schnitte, Typografie und Palette das Video adaptieren, aber nie kopieren soll. Links von Instagram, X und TikTok liefern UPLOAD_REQUIRED: Lade die Datei stattdessen mit upload_asset hoch.
vocabulary: bis zu 20 vom Sprecher gesagte Namen (Marke, Produkt, Personen), die automatische Untertitel genau so schreiben müssen, z. B. ["Acme", "Jane Doe"]. Fluos wird immer richtig geschrieben. revise_video akzeptiert es ebenfalls.

Siehe Erstes Video und Rezepte.

Auftragskarte

Auf Hosts mit MCP-Apps-Unterstützung (wie Claude) zeigen create_video und revise_video eine Live-Auftragskarte im Chat. Sie folgt dem Auftrag von selbst: die Erstellungsschritte, was Fluos gerade tut, das Storyboard, die Live-Vorschau während der Erstellung und dann das fertige Video mit Download MP4, Download GIF, Open in Fluos und einem Feld, um eine Änderung anzufragen. Ein pausierter Auftrag zeigt eine Schaltfläche Add credits. Da sich die Karte selbst aktualisiert, muss der Assistent nicht abfragen, damit du den Fortschritt siehst; er ruft wait_for_job auf, wenn er das Ergebnis braucht.

Pausierte Aufträge

awaiting_credits bedeutet, dass der Erstellung die Credits ausgegangen sind und sie pausiert ist. Sie ist weder abgeschlossen noch fehlgeschlagen. get_status liefert dann ein pause-Objekt mit reason (credits_exhausted), topUpUrl und expiresAt (Epoch-Millisekunden). Gib dem Nutzer topUpUrl. Sobald er Credits hinzufügt, geht derselbe Auftrag von selbst wieder auf running: Warte also weiter mit wait_for_job, statt einen neuen Auftrag anzulegen. Treffen bis expiresAt keine Credits ein, schlägt der Auftrag fehl.

Quellen

Sobald eine Version committet ist, liefert get_status auch sources[]: jedes Asset im Video mit Quelle, Lizenz, Rechtestatus (licensed, cc, user_attested, owned, generated oder unverified), Quellenangabe und der Stelle, an der es vorkommt.

Export

Tool	Erforderliche Argumente	Zweck
`export_video`	`jobId`	Stellt ein Rendering in die Warteschlange. `format` ist optional (Standard `mp4`): `mp4` \| `gif` \| `webm` \| `mov` \| `png-sequence`. Optionale `advanced`-Exportoptionen. `require_licensed: true` verweigert den Export, solange ein Eintrag in `sources[]` `unverified` ist
`get_export`	`exportId`	Abfragen, bis die Datei fertig ist

Fertige Exporte liefern eine signierte playbackUrl. Hosts mit MCP-Apps-Unterstützung bekommen außerdem einen Inline-Player. Wird der Player nicht angezeigt, öffne playbackUrl.

Docs-MCP

JSON-RPC per POST an https://www.fluos.io/api/v1/mcp. Keine Anmeldung.

Tool	Argumente	Zweck
`search_fluos_docs`	`q`	Volltextsuche in der Fluos-Dokumentation
`get_fluos_openapi`	—	Liefert `/openapi.json`
`get_fluos_llms_txt`	—	Liefert `/llms.txt`
`list_fluos_developer_resources`	—	Per Name adressierbare Fluos-Entwickler-URLs

Einrichtung und curl-Beispiele: Docs-MCP.

Auf dieser Seite