Kubflow

MCP

API documentation ↗

Create images, videos and audio from your AI agent

Connect Kubflow to Claude, ChatGPT, Cursor, Codex or any MCP app. Sign in with your Kubflow account, with nothing to install. Your agent picks a model, shows you the price, and generates with your Kubflow credits.

Add to ClaudeChatGPT, Cursor and more
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
  2. kubflow_get_modelWrites the prompt by Kubflow's guide for that model
  3. kubflow_get_priceShows the exact credit price
  4. kubflow_generate_and_waitGenerates once you approve
  5. Image ready, with a link to the result

Set up in 3 steps

  1. Choose your app

  2. Add Kubflow to Claude

    Add to Claude

    Opens Claude with Kubflow filled in. Choose Continue, then sign in to Kubflow and allow access.

    Or add it by hand
    1. In Claude, open Settings → Connectors and choose Add custom connector.
    2. Name it Kubflow, paste this URL and choose Add.
    Connector URL
    https://kubflow.ai/api/mcp

    Choose Connect, sign in to Kubflow and allow access. The connector works in Claude on the web, desktop and mobile.

    You sign in on kubflow.ai. Claude never sees your password.

    On Team and Enterprise plans, an Owner adds custom connectors in Organization settings first.

    Upload files from your computer? Use the local connector

    The local connector runs on your computer and adds one tool: uploading reference images, videos and audio from your files. It signs in with an API key instead.

    Let your agent set it up
    Setup message for Claude
    Set up the local Kubflow connector in Claude using this guide:
https://kubflow.ai/mcp/setup.md

Follow the "Local connector" 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.
    Or install uv

    It runs 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. Merge the kubflow entry into mcpServers, replace kf_live_YOUR_KEY and restart Claude Desktop. If it can't find uv, replace "uv" with the full path from `which uv` (macOS) or `(Get-Command uv).Source` (Windows).

    Claude Desktop → Settings → Developer → Edit Config (claude_desktop_config.json)
    {
  "mcpServers": {
    "kubflow": {
      "command": "uv",
      "args": [
        "run",
        "--no-project",
        "--script",
        "https://kubflow.ai/mcp/kubflow-mcp.py"
      ],
      "env": {
        "KUBFLOW_API_KEY": "kf_live_YOUR_KEY"
      }
    }
  }
}

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

  3. Check the connection

    Start a new chat, make sure Kubflow is turned on in the tools menu, and send the message below.

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

    This check doesn't spend credits.

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.

Music and voice

A sound for your brand.

Use Kubflow to make a 30-second upbeat instrumental jingle for a coffee shop opening. First list the audio models and their credit pricing. Wait for my approval before generating, then return the audio link.

Good to know

Which apps and tools are supported?

Claude on the web, desktop and mobile, ChatGPT with Developer mode, Claude Code, Cursor, Codex, and any app that connects to remote MCP servers at https://kubflow.ai/api/mcp.

Your agent can check credits, list models, generate images, videos, music, voiceovers and sound effects, and fetch the results. References such as a product photo need a public link. To upload files from your computer, use the local connector. Text generation and editing saved workflows aren't included.

How do credits work?

Every generation is charged to the Kubflow account you connected, at the model's usual price, the same as generating in Kubflow. Checking your balance and listing models is free. Ask your agent to show the price before it generates.

If you've added your own Kie.ai key in Settings, generations use that key instead of your credits.

Having trouble connecting?

Check that your plan is Growth or higher, then remove Kubflow from your app and add it again. If the sign-in page shows a different Kubflow account, choose Switch account there.

If a generation takes longer than your app waits, ask your agent to check the same generation ID. Starting again may spend credits twice.

For the local connector: restart your agent after installing uv and run uv --version to check it. If the app can't find uv, use the full path from which uv on macOS/Linux or (Get-Command uv).Source in PowerShell. For a slow first start, run this once, then reconnect:

Prepare the local connector
uv run --no-project --script https://kubflow.ai/mcp/kubflow-mcp.py --help
How do I disconnect?

Remove Kubflow from your app's connectors. To cut off access everywhere, revoke its key in Settings → API Access. Each app you connect appears there as its own key, such as "Claude connector".