flow-mcp

Generates images and videos through SEOSONA Flow via a local MCP server.

5|2|Updated Jul 12, 2026
One-click install
npx skills add https://github.com/LongLeo287/seosona-flow --skill flow-mcp-longleo287
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: flow-mcp
Source: https://github.com/LongLeo287/seosona-flow/tree/main/.claude/skills/flow-mcp
Command: npx skills add https://github.com/LongLeo287/seosona-flow --skill flow-mcp-longleo287

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Driving AI image and video generation from outside the SEOSONA Flow Chrome extension normally requires manual prompting in the browser. This Skill lets an agent or the Video AI V2 pipeline call Flow through a local MCP server to generate visual assets programmatically, with idempotency, structured errors, and file export. ## Core Features & Use Cases - 20 MCP tools with FlowResult envelopes: discovery (list_capabilities, list_models, list_voices), generation (gen_image, gen_video, run_workflow), export (export_asset), control (health, cancel_job), and project/memory tools, each returning structured content validated by outputSchema. - Idempotent generation: pass a client_ref (e.g., scene id) so repeated calls return cached assets instead of consuming quota again, surviving server restarts. - Silent b-roll for V2 pipelines: generate videos without baked-in voice so the V2 pipeline can add TTS, captions, and muxing locally, with script.json contract validation between Flow and V2. - Use Case: A video production agent checks health, lists capabilities, generates one silent b-roll clip per scene with client_ref set to the scene id, exports each video to disk, then hands assets to the V2 pipeline for voiceover and editing. ## Quick Start Ask the agent to check Flow MCP health and list capabilities, then generate a silent b-roll video for a scene and export it to disk.

Frequently Asked Questions about flow-mcp

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate images and videos from an AI agent using MCP?▼

Connect to the local MCP server in mcp-local/server.mjs, call health and list_capabilities first, then use gen_image, gen_video, or run_workflow. Results return as FlowResult envelopes containing a FlowAsset array with URLs and metadata.

How do I avoid regenerating the same asset and wasting quota?▼

Pass a client_ref such as a scene id to any generation tool. Repeated calls with the same client_ref return the cached asset with idempotent_hit set to true, and the cache survives server restarts via the .cache directory.

Can I export generated videos to disk for editing?▼

Yes, call export_asset with the video_url and an optional file name and folder. Videos must be exported because their URLs require a Google session, while images are already returned as inline base64.

Why does generation fail with PROVIDER_NOT_LOGGED_IN or EXTENSION_BUSY?▼

PROVIDER_NOT_LOGGED_IN means the user must open and log into the provider tab, and EXTENSION_BUSY means another job is running. Do not retry blindly; follow the error_code guidance such as waiting, opening the project, or checking capabilities.

Does the Flow MCP server work without the Chrome extension connected?▼

No, the extension side panel must be open on a logged-in labs.google/fx tab because it acts as the executor. Without it, tools return a clear Extension not connected error, and callers should degrade gracefully.