Kubflow

MCP

API documentation ↗

Create images and videos from your AI agent

Connect Kubflow to Claude Code, Cursor, Codex or any local MCP client. Your agent picks a model, shows you the price, and generates with your Kubflow credits.

Get your API keySet up in 3 steps
Available on Growth and higher plans.
Example session

Make a studio photo of my orange water bottle on warm stone.

  1. kubflow_list_modelsSuggests an image model and shows its credit price
  2. kubflow_generate_and_waitGenerates once you approve
  3. Image ready, with a link to the result

Set up in 3 steps

  1. Choose your agent

  2. Paste this into Claude Code

    It walks you through installing the connector and adding your API key.

    Setup message for Claude Code
    Connect Kubflow to Claude Code using this guide:
https://kubflow.com/mcp/setup.md

Follow the steps for my operating system and keep my existing MCP settings. Help me add my API key locally, without sharing it in chat. Verify my balance and available models without spending credits.

    Your API key stays in your local configuration.

    Prefer to set it up yourself?
    Install uv

    It manages the connector and its dependencies. Skip this if you already have uv.

    Install command
    curl -LsSf https://astral.sh/uv/install.sh | sh

    Restart your terminal after installing. Other install options

    Add your API key

    Create a key in Settings → API Access. Replace kf_live_YOUR_KEY with your API key, then run this command. It works in PowerShell, macOS Terminal, and Linux shells.

    Run in your terminal
    claude mcp add --scope user --env KUBFLOW_API_KEY=kf_live_YOUR_KEY --transport stdio kubflow -- uv run --no-project --script https://kubflow.com/mcp/kubflow-mcp.py

    Keep the key in your local configuration, outside shared repositories.

  3. Check the connection

    Start a new Claude Code session and run /mcp. Check that kubflow is connected, then send the message below.

    Connection check
    Check my Kubflow credit balance and list the available image and video models. Do not generate anything yet.

    This check doesn't spend credits. The first connection may take a minute while dependencies install.

Try these first

Paste one into your agent once it's connected. Each prompt asks for your approval before it spends credits.

Product photography

A product's best angle.

Use Kubflow to create a studio product photo of a matte orange water bottle on warm stone, soft side lighting, square composition. First suggest an available image model and show its listed credit pricing. Wait for my approval before generating.

Video generation

Your next opening shot.

Use Kubflow to create a cinematic video of ocean waves at sunrise with a slow camera push. First list suitable video models, supported durations, and their credit pricing. Wait for my approval, then generate and return the finished video URL.

Image variations

One idea. A new direction.

Help me create a new visual direction from a reference image using Kubflow. Ask me for a publicly accessible image URL, find a model that supports image references, and show its pricing. Wait for my approval before creating a variation.

Good to know

Which agents and tools are supported?

Claude Code, Cursor, Codex, and other agents that run local MCP servers. Your agent can check credits, list models, generate images and videos, and retrieve results.

Claude web and ChatGPT remote connectors aren't available yet. This page is a setup guide, not a hosted MCP endpoint. Audio, text generation, and saved workflow editing aren't included.

How do credits work?

Generations use your existing Kubflow credits at the selected model's rates. Ask your agent to show the pricing before it generates. Checking your balance and listing models doesn't spend generation credits.

Having trouble connecting?

Restart your agent after installing uv. Run uv --version to check it's installed. If the app can't find it, use the full path from which uv on macOS/Linux or (Get-Command uv).Source in PowerShell as the command in your config.

For a slow first connection, run this once, then reconnect:

Prepare the connector
uv run --no-project --script https://kubflow.com/mcp/kubflow-mcp.py --help

For a key error, replace KUBFLOW_API_KEY in your local config and restart. For a plan or credit error, check your plan and balance in Settings.

If a generation times out, ask your agent to check the existing generation ID. Starting again may spend credits twice.

How do I disconnect?

Remove kubflow from your agent's MCP settings and revoke its API key in Kubflow Settings. To update the connector, restart your agent. You can also download the source and run it from a local path.