MeltFlex MCP
Generate interiors from any AI agent
Connect your agent
Pick your MCP client:
Add the MeltFlex server with one command:
claude mcp add meltflex -- npx -y meltflex-mcpThen sign in with your API key:
npx -y meltflex-mcp auth mf_sk_xxxxxxxxxxxxYou can also authenticate the CLI directly: meltflex auth mf_sk_….
Where to find your API key
You need an active subscription (any paid plan). Once subscribed, open your account settings and click API Key under Profile:
Then click Generate API Key. The key is shown only once — copy it immediately.
Then just ask in chat — e.g. “Here's my living room /Users/me/room.jpg — redesign it in warm minimalist style.”
Overview
Connect MeltFlex to your workflow and redesign rooms directly from your prompts. The MeltFlex MCP server exposes generation as tools any agent can call.
Each user connects their own MeltFlex account; every generation is billed to that account's credits. The server is a thin client over the MeltFlex API.
What you can build
Furniture placement is the flagship, but generate_interior is prompt-driven — so the one tool covers the whole MeltFlex suite. Your agent just varies the request (and attaches a reference image for material or product swaps).
| Use case | Example ask in chat |
|---|---|
| Interior design | “Redesign this room in warm Scandinavian style with light oak floors” |
| Layout boost | “Rearrange the furniture in this room into a more open, functional layout” |
| Exterior design | “Restyle this facade in modern farmhouse style; keep the structure” |
| Garden design | “Turn this yard into a low-maintenance Mediterranean garden” |
| Walls texture (+ reference) | “Change the walls to micro-cement; keep everything else” |
| Floor restyle (+ reference) | “Replace the floor with this oak sample; keep everything else” |
| Stairs · doors · windows | “Restyle just the staircase / doors / windows; keep the rest” |
| Kitchen · bathroom | “Redesign this kitchen (or bathroom); keep the footprint and plumbing” |
| Photo to render | “Turn this 3D draft into a photorealistic interior photo” |
Structure (walls, windows, flooring, fixtures) is preserved by default, so for surface and fixture swaps just tell the agent what to change and what to keep. Two more tools go beyond stills: generate_video (cinematic walkthroughs) and floorplan_to_3d (2D floorplan → GLB model).
Tools
| Tool | Description | 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 — see What you can build). 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), optional 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 |
Configuration
| Variable | Default | Purpose |
|---|---|---|
MELTFLEX_API_KEY | — | API key (mf_sk_…). Overrides the saved config file. |
MELTFLEX_BASE_URL | https://www.meltflexai.com | Override for staging or self-host. |
FAQ
Do I need an API key?
Yes. Each user authenticates with their own MeltFlex API key (any active subscription). Generate one in account settings, then pass it via the MELTFLEX_API_KEY env block or meltflex auth.
Whose credits are used?
Your own. The server runs under your account and every generation is billed to your account credits — 10 per image.
Is it safe?
The MCP layer adds no new attack surface: anything it can do is already doable with a request to the same API using the same key. Credit limits, refunds and rate limits all live server-side.
My client isn't listed — can I still use it?
Any client that speaks the Model Context Protocol works. Use the standard command / args / env config shown above.
Where do generated images go?
The generate_interior tool saves the result to disk and returns the file path. Pass output_path to control the location.
