Herramientas
Cada herramienta de Fluos Vídeo y Docs MCP, con los argumentos necesarios.
Las herramientas de vídeo requieren un token OAuth de bearer de Clerk en /api/v1/mcp/app. Las herramientas de docs son públicas en /api/v1/mcp. npx fluos mcp-info imprime la tarjeta del servidor de docs; npx fluos mcp-info --app imprime la tarjeta de pago (requiere FLUOS_API_TOKEN).
MCP de Vídeo
POST JSON-RPC a https://www.fluos.io/api/v1/mcp/app.
Espacio de trabajo y proyecto
| Herramienta | Args requeridos | Propósito |
|---|---|---|
list_workspaces | — | Espacios de trabajo que el usuario puede acceder |
list_projects | workspaceId | Proyectos en un espacio de trabajo |
create_project | workspaceId | Crea un proyecto y su chat por defecto (name opcional) |
Activos
| Herramienta | Args requeridos | Propósito |
|---|---|---|
list_assets | workspaceId | Activos de la biblioteca. Opcional kind: image | video | document |
upload_asset | workspaceId | Subida en dos pasos. La primera llamada devuelve uploadUrl. POST los bytes, luego llama de nuevo con storageId. Opcional filename, mediaType, size |
No envíes bytes de vídeo crudos en el cuerpo JSON-RPC.
Trabajos
| Herramienta | Args requeridos | Propósito |
|---|---|---|
create_video | projectId, brief | Inicia una tarea de generación, edición, composición o mezcla. Retorna inmediatamente con jobId |
get_status | jobId | Consulta hasta que aparezca queued | running | ready | failed | cancelled |
revise_video | jobId, instruction | Nueva tarea a partir de una existente. Opcional recipe |
list_jobs | projectId | Tareas recientes. Opcional limit |
cancel_job | jobId | Cancela una tarea en cola o en ejecución |
create_video también acepta recipe, assetIds y format. Consulta el primer vídeo y las recetas.
Exportar
| Herramienta | Argumentos requeridos | Propósito |
|---|---|---|
export_video | jobId | Colocar en cola la renderización de un mp4 o gif (format opcional, por defecto mp4) |
get_export | exportId | Consultar hasta que el archivo esté listo |
Las exportaciones listas devuelven un playbackUrl firmado. Los hosts que admiten aplicaciones MCP también obtienen un reproductor en línea. Si el reproductor no renderiza, abre playbackUrl.
Docs MCP
POST JSON-RPC a https://www.fluos.io/api/v1/mcp. Sin inicio de sesión.
| Herramienta | Args | Propósito |
|---|---|---|
search_fluos_docs | q | Búsqueda de texto completo en la documentación de Fluos |
get_fluos_openapi | — | Devolver /openapi.json |
get_fluos_llms_txt | — | Devolver /llms.txt |
list_fluos_developer_resources | — | URLs del desarrollador de Fluos identificables por nombre |
Ejemplos de configuración y curl: Docs MCP. Mapeo HTTP: Inspector.