AI Video Generation MCP Server

What is the VidFlux video MCP server?

The Model Context Protocol (MCP) is the open standard AI assistants use to call external tools. VidFlux MCP is a hosted endpoint that gives your assistant video generation tools: start a text-to-video, image-to-video or motion-control job, check its progress and get the finished MP4. The assistant writes the prompt, chooses the model, length and aspect ratio, waits for the render and hands you the file without you leaving the chat or the editor.

Behind the endpoint runs the same pipeline as the vidflux.ai video generator, so model versions, prices and refunds are identical and every task also appears in your account history.

Supported AI video models

Pass the model id in the model argument. Credits are for the default settings; longer, higher-resolution or audio-enabled videos cost more, and dry_run returns the exact price for any settings.

Image models for keyframes and thumbnails

Create or edit start frames, product shots and thumbnails, then animate them with any image-to-video model above.

Quick start: connect in 3 steps

1. Sign in to VidFlux and create a key in Settings → API & MCP. New accounts get free trial credits.
2. Add the server to your AI client with one of the configurations below.
3. Ask for a video, for example: “Make a 5-second 9:16 video of latte art being poured in slow motion with Seedance 2 and save it to ./assets”.

MCP client configuration

Replace vf_your_api_key with your key. For clients that read environment variables, keep the key in VIDFLUX_API_KEY instead of the config file.

Claude Code

claude mcp add --transport http vidflux https://vidflux.ai/api/mcp \
  --header "Authorization: Bearer vf_your_api_key"

# verify
claude mcp list

Claude Desktop

Claude Desktop connects to remote servers with API-key headers through mcp-remote (requires Node.js). Edit claude_desktop_config.json and restart Claude:

{
  "mcpServers": {
    "vidflux": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://vidflux.ai/api/mcp",
        "--header", "Authorization: Bearer vf_your_api_key"
      ]
    }
  }
}

Cursor

Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project):

{
  "mcpServers": {
    "vidflux": {
      "url": "https://vidflux.ai/api/mcp",
      "headers": { "Authorization": "Bearer vf_your_api_key" }
    }
  }
}

OpenAI Codex CLI

export VIDFLUX_API_KEY=vf_your_api_key
codex mcp add vidflux --url https://vidflux.ai/api/mcp \
  --bearer-token-env-var VIDFLUX_API_KEY

VS Code (GitHub Copilot agent mode)

Add to .vscode/mcp.json:

{
  "servers": {
    "vidflux": {
      "type": "http",
      "url": "https://vidflux.ai/api/mcp",
      "headers": { "Authorization": "Bearer vf_your_api_key" }
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "vidflux": {
      "serverUrl": "https://vidflux.ai/api/mcp",
      "headers": { "Authorization": "Bearer vf_your_api_key" }
    }
  }
}

Cline, Roo Code and other clients

Any client that supports Streamable HTTP servers with custom headers works with the same URL and header. Clients that only support stdio can use the mcp-remote command shown for Claude Desktop.

MCP tools

Video generation is asynchronous. A typical agent run looks like this:

list_models            → seedance-2 (9:16, audio)
generate_video {model: "seedance-2", prompt: "...", aspect_ratio: "9:16",
                duration: 5, dry_run: true}
                       → {"credits_required": 425, "sufficient": true}
generate_video {...same arguments without dry_run}
                       → {"id": "3f1c9e0a-...", "status": "processing"}
get_task {task_id: "3f1c9e0a-..."}   (every 15 s)
                       → {"status": "completed", "video_url": "https://...mp4"}

Pricing: pay-as-you-go credits

• Connecting the server and calling list_models, get_task or get_credits is free.
• Each video costs the same credits as on vidflux.ai (see the tables above). Credit packs start at 500 credits for $4.98, larger packs cost less per credit, and purchased credits never expire.
• dry_run: true validates the arguments and returns the exact price and whether your balance covers it, without generating anything.
• Failed or rejected tasks are refunded automatically.

See credit packs and plans

What you can build with it

VidFlux MCP vs. provider APIs vs. self-hosted MCP servers

Troubleshooting

The server is connected but no video tools appear

Restart the client or reload MCP servers and make sure Agent mode is on (Cursor, VS Code). In Claude Code run /mcp to see the tool list.

401 Unauthorized or “Missing or invalid API key”

The header must be exactly Authorization: Bearer vf_…. Check that the key was not revoked and that no extra quotes or spaces were copied.

402 INSUFFICIENT_CREDITS

Your balance is lower than the price returned by dry_run. Top up credits or choose a shorter, lower-resolution or cheaper model.

A video stays in processing for a long time

Most videos finish in 1 to 5 minutes; long Seedance 2.5 or 4K Gemini Omni jobs can take longer. Keep polling get_task. If a task fails, the error is returned and the credits are refunded.

spawn npx ENOENT in Claude Desktop

mcp-remote needs Node.js 18 or later. Install Node.js or use the full path to npx in the command field.

Reference images are rejected

image_urls must be public HTTPS links to JPG, PNG or WebP files. Local file paths and private links cannot be fetched.

FAQ