meltflex-mcp

MeltFlex AI as an MCP server + CLI — generate photorealistic interior and exterior redesigns directly from your AI agent (Claude Code, Cursor, Codex, and any MCP-compatible client). The prompt-driven redesign covers the whole MeltFlex suite (interiors, floors, walls, exteriors, gardens, kitchens, bathrooms, stairs, doors, windows, photo-to-render), plus cinematic video walkthroughs and 2D floorplan → 3D models.

Each user connects their own MeltFlex account; every generation is billed to that account's credits. The server is a thin client over the public MeltFlex API — it enforces nothing itself, so credits and access are always governed server-side.

Install & authenticate

# Sign in via your browser (recommended) — opens a tab, click "Authorize CLI"
npx -y meltflex-mcp auth login

# …or save an existing key manually (stored in ~/.meltflex/config.json, chmod 600)
npx -y meltflex-mcp auth mf_sk_xxxxxxxxxxxx
npx -y meltflex-mcp whoami

auth login opens https://www.meltflexai.com/cli/authorize, mints a key from your signed-in session, and hands it back to the CLI over loopback (the key never leaves your machine). Get a key manually at https://www.meltflexai.com/settings (any active subscription). Alternatively, skip auth and provide MELTFLEX_API_KEY via the client's env block (below).

Add to Claude Code

claude mcp add meltflex -- npx -y meltflex-mcp

…or add it to your MCP config (.mcp.json / client settings):

{
  "mcpServers": {
    "meltflex": {
      "command": "npx",
      "args": ["-y", "meltflex-mcp"],
      "env": { "MELTFLEX_API_KEY": "mf_sk_xxxxxxxxxxxx" }
    }
  }
}

Cursor / Codex / other MCP clients use the same command + args + env shape.

CLI commands

The same binary is a terminal CLI. Every generation is billed to your own account.

# Redesign a room (10 credits). `generate` is prompt-driven, so it covers the
# whole suite — floors, walls, exteriors, kitchens, etc. — just change --prompt.
meltflex generate -i ./room.jpg -p "Redesign in warm Scandinavian style" -o ./out.png

# Higher quality + the most detailed "pro" design level
meltflex generate -i ./room.jpg -p "Modern living room" -q 2K -l pro -o ./out.png

# Batch: 3 variations in one call (charged per image)
meltflex generate -i ./room.jpg -p "Japandi bedroom" -n 3 -o ./out.png

# Region edit: paint the area to change SOLID RED first, then --mask applies the
# prompt ONLY to the red-marked region and leaves the rest untouched.
meltflex generate -i ./room-red-marked.png -p "Put a green velvet armchair here" --mask -o ./edited.png

# Preview a specific material/product by passing it as a reference
meltflex generate -i ./room.jpg -r ./oak-floor.jpg -p "Replace the floor with this oak; keep everything else" -o ./floor.png

# Cinematic walkthrough video from a still (100 credits for 4s, 150 for 8s)
meltflex video -i ./render.jpg --duration 4 --aspect 16:9 -o ./walkthrough.mp4

# 2D floorplan → downloadable GLB 3D model (10 credits)
meltflex floorplan -i ./floorplan.png -o ./model.glb

# Balance and per-operation costs
meltflex credits

Run meltflex help for all flags.

Tools

| Tool | What it does | Cost | |------|--------------|------| | generate_interior | Restyle a room photo into a photorealistic redesign. Prompt-driven, so it covers the whole suite (interiors, floors, walls, exteriors, kitchens, and more). Inputs: prompt, image (path/URL/data-URL), optional reference_images, resolution (512/1K/2K), design_level (lite/quick/pro), mask (red-region edit), variations (1–3 batch), output_path. Saves each result to disk. | 10 cr/image (lite −2, pro +5) | | generate_video | Animate a still (a render or interior photo) into a cinematic walkthrough MP4 (Veo 3.1). Inputs: image, optional prompt, duration_seconds (4/8), aspect_ratio, output_path. Saves the MP4 to disk. | 100–150 credits | | floorplan_to_3d | Convert a 2D floorplan image into a downloadable GLB 3D model. Inputs: image, optional output_path. Saves the GLB to disk. | 10 credits | | check_credits | Report the account's credit balance and per-operation costs. | free |

Config / environment

| Variable | Default | Purpose | |----------|---------|---------| | MELTFLEX_API_KEY | — | API key (mf_sk_...). Overrides the config file. | | MELTFLEX_BASE_URL | https://www.meltflexai.com | Override for staging/self-host. |

Local development

npm install
npm run build
node dist/cli.js whoami          # sanity check the CLI
node dist/cli.js                 # run the MCP server on stdio

Architecture

your agent ──stdio/MCP──► meltflex-mcp ──HTTPS Bearer mf_sk_──► api.meltflexai.com
                                                                 /api/v1/generate
                                                                 /api/v1/video
                                                                 /api/v1/floorplan-to-3d
                                                                 /api/v1/credits

The MCP layer adds no new attack surface: anything it can do is already doable with a curl against the same API using the same key. Credit enforcement, refunds, and rate limits all live in the MeltFlex backend.