FLOW MCP · AGENT NATIVE

Bring your agent on set.

Any MCP-capable agent host can connect to Flow — create Series, prepare assets, review one exact Series video unit, recover the same durable job, and download active delivery. Discovery spends no points; standalone video runs from prepaid authority while Series video pauses once for review.

Create API key →Back to home

Copying config is setup, not proof of installation. An active key can generate within prepaid points; Series video pauses once on the exact script, assets, prompt and quote.

~/.config/agent/mcp.json

{
  "mcpServers": {
    "flow": {
      "type": "http",
      "url": "https://kthuan.cn/api/production/agent-tools/mcp",
      "bearer_token_env_var": "FLOW_API_KEY",
      "env_http_headers": {
        "X-Flow-MCP-Session-ID": "FLOW_MCP_SESSION_ID"
      }
    }
  }
}

✓ initialize · ✓ tools/list · 9 tools

Three steps in

3 CHECKS · NO SPEND

01ACCOUNT

Create or copy key

Open API Keys, create a Flow key, and copy the install config while the secret is visible.

02AGENT

Paste into your host

Add the config to any MCP-compatible agent host. Claude, Codex, IDE agents, and custom hosts are examples.

03READY

Restart & run tools/list

A working install means Flow validates the key and your agent can initialize MCP and list Flow tools.

The main path needs only three checks. Keep the rest for troubleshooting.

Advanced details

Same account key: MCP and advanced API access use Flow Keys that can be created and revoked from your account.

Media stays in Flow: Images, video clips, music, previews, and exports stay in the Flow project instead of disappearing into an agent chat.

Clear production steps: Whether work starts from an agent or from the workspace, Flow shows the plan before real generation or export starts.

SAFETY GATES

Flow holds the durable production truth

NO-SPEND SETUP

Install, discovery, and read checks do not call paid generation services.

SERIES REVIEW

Standalone video auto-executes within prepaid points. A Series video pauses once after real assets and the final prompt are ready.

WORKSPACE SCOPE

External agents can only access the account-owned Workspace and the exact durable jobs bound to the Flow key and session.

AGENT HOSTS

Any MCP host can join

These are examples, not the boundary. Use any MCP-compatible host that accepts a custom server config.

Claude

DESKTOP MCP CLIENT

Codex

AGENT CODING CLIENT

Hermes

AGENT PIPELINE

OpenCraw

IDE AGENT WORKSPACE

Windsurf

AI IDE

VS Code MCP

COMPATIBLE EXTENSIONS

TROUBLESHOOTING

Troubleshooting order

Use this order only when the three-step install path does not work.

01Create a Flow account
02Generate a Flow API key and session
03Set FLOW_API_KEY and FLOW_MCP_SESSION_ID in the host launch environment
04Run the Flow backend connection test
05Run initialize and tools/list and verify exactly 9 tools
06Use Workspace for Series review and Take promotion
07When a job is pending or outcome-unknown, poll that same GenerationJob

Your crew is ready.

Create API key →