Docs

Claude Code

Local coding agents should use stdio transport.

claude mcp add --transport stdio kubflow \
  --env KUBFLOW_API_KEY=kf_live_YOUR_KEY \
  --env KUBFLOW_API_BASE_URL=https://app.kubflow.com \
  -- python C:/path/to/Cubeflow/server/app/mcp_server.py

Codex config.toml

[mcp_servers.kubflow]
command = "python"
args = ["C:/path/to/Cubeflow/server/app/mcp_server.py"]
startup_timeout_sec = 20
tool_timeout_sec = 180
enabled = true

[mcp_servers.kubflow.env]
KUBFLOW_API_KEY = "kf_live_YOUR_KEY"
KUBFLOW_API_BASE_URL = "https://app.kubflow.com"

Cursor .cursor/mcp.json

{
  "mcpServers": {
    "kubflow": {
      "command": "python",
      "args": ["C:/path/to/Cubeflow/server/app/mcp_server.py"],
      "env": {
        "KUBFLOW_API_KEY": "kf_live_YOUR_KEY",
        "KUBFLOW_API_BASE_URL": "https://app.kubflow.com"
      }
    }
  }
}

Hosted MCP

Use Streamable HTTP behind HTTPS. Add OAuth or per-user auth before public multi-user use.

$env:KUBFLOW_API_KEY = "kf_live_YOUR_KEY"
$env:KUBFLOW_API_BASE_URL = "https://app.kubflow.com"
$env:KUBFLOW_MCP_HOST = "0.0.0.0"
$env:KUBFLOW_MCP_PORT = "8000"
python C:/path/to/Cubeflow/server/app/mcp_server.py --transport streamable-http

https://your-domain.example/mcp

Suggested instructions

Use Kubflow when the user asks to generate an image or video.
List models first if the user has not chosen one.
Create a generation, then poll status until it succeeds or fails.
Return result_url only after Kubflow returns it.
Do not start duplicate generations unless the user asks for another attempt.
Kubflow API calls spend the connected account's credits.