Tools
Every Fluos Video MCP and Docs MCP tool, with required arguments.
Video tools require a Clerk OAuth bearer token on /api/v1/mcp/app. Docs tools are public on /api/v1/mcp. npx fluos mcp-info prints the docs server card; npx fluos mcp-info --app prints the paid card (FLUOS_API_TOKEN required).
Video MCP
POST JSON-RPC to https://www.fluos.io/api/v1/mcp/app.
Workspace and project
| Tool | Required args | Purpose |
|---|---|---|
list_workspaces | — | Workspaces the caller can access |
list_projects | workspaceId | Projects in a workspace |
create_project | workspaceId | Create a project and its default chat (name optional) |
Assets
| Tool | Required args | Purpose |
|---|---|---|
list_assets | workspaceId | Library assets. Optional kind: image | video | document |
upload_asset | workspaceId | Two-step upload. First call returns uploadUrl. POST the bytes, then call again with storageId. Optional filename, mediaType, size |
Do not send raw video bytes in the JSON-RPC body.
Jobs
| Tool | Required args | Purpose |
|---|---|---|
create_video | projectId, brief | Start a generate, edit, compose, or mix job. Returns immediately with jobId |
get_status | jobId | Poll until queued | running | ready | failed | cancelled |
revise_video | jobId, instruction | New job from an existing one. Optional recipe |
list_jobs | projectId | Recent jobs. Optional limit |
cancel_job | jobId | Cancel a queued or running job |
create_video also accepts recipe, assetIds, and format. See First video and Recipes.
Export
| Tool | Required args | Purpose |
|---|---|---|
export_video | jobId | Queue an mp4 or gif render (format optional, default mp4) |
get_export | exportId | Poll until the file is ready |
Ready exports return a signed playbackUrl. Hosts that support MCP Apps also get an inline player. If the player does not render, open playbackUrl.
Docs MCP
POST JSON-RPC to https://www.fluos.io/api/v1/mcp. No login.
| Tool | Args | Purpose |
|---|---|---|
search_fluos_docs | q | Full-text search over Fluos documentation |
get_fluos_openapi | — | Return /openapi.json |
get_fluos_llms_txt | — | Return /llms.txt |
list_fluos_developer_resources | — | Name-addressable Fluos developer URLs |