MeltFlex AI

MeltFlex AI Skills

[](./LICENSE) [](./VERSION) [](#skills) [](https://www.meltflexai.com)

AI agent skills for photorealistic interior design via MeltFlex AI — restyle rooms, place real furniture, virtually stage, and re-theme spaces from a single photo. Works with Claude Code, Hermes, Cursor, Codex, and other AI agents that load Markdown-based skills or speak MCP.

Each user authenticates with their own MeltFlex API key; every generation is billed to their account credits. The skills call the public MeltFlex API directly, so there's nothing extra to install.

Install

Pick one. Each method sets up the skills for your agent.

npx skills — recommended, cross-agent

npx skills add MeltFlexDevs/skills

GitHub CLI (v2.90+)

gh skill install MeltFlexDevs/skills

Claude Code marketplace

Inside Claude Code:

/plugin marketplace add MeltFlexDevs/skills
/plugin install meltflex@meltflex

Setup script

Universal fallback:

git clone --depth 1 https://github.com/MeltFlexDevs/skills.git
cd skills
./setup

More options in [INSTALL.md](./INSTALL.md). Agent-driven install (paste into your agent): [INSTALLFORAGENTS.md](./INSTALLFORAGENTS.md).

Authenticate

You need an active subscription (any paid plan) — without one the key won't work. After subscribing at , open account settings → API Key under Profile, then Generate API Key (shown once — copy it):

Then expose it:

export MELTFLEX_API_KEY="mf_sk_xxxxxxxxxxxx"

Use with Hermes

Hermes (Nous Research) speaks MCP, so it runs MeltFlex through the meltflex-mcp server.

From the catalog (once merged into the Hermes catalog):

hermes mcp install meltflex

Manually — sign in once, then add the server to ~/.hermes/config.yaml:

npx -y meltflex-mcp auth login

mcp_servers:
  meltflex:
    command: npx
    args: ["-y", "meltflex-mcp"]

Start hermes chat (or run /reload-mcp in a session) to load the generate_interior and check_credits tools. Full guide: .

Skills

| Skill | Invoke | Description | |-------|--------|-------------| | meltflex-design | /meltflex:design | Restyle, redesign, declutter, virtually stage, or re-theme a room, facade, or garden from a photo. 8 modes (restyle, virtual staging, declutter, exterior, garden, wall texture, floor restyle, seasonal). | | meltflex-furniture | /meltflex:furniture | Place specific real furniture/decor products into a room photo, matching their exact colors, materials, and proportions (up to 10 reference items). |

Both skills are self-contained: a room photo in, a photorealistic redesign out, 10 credits per generation (auto-refunded on failure).

Modes

meltflex-design — 8 modes, each the same endpoint with a mode-tuned prompt:

| Mode | What it's for | |------|---------------| | restyle | Change a room's style or theme | | virtual_staging | Furnish an empty room | | declutter | Clean up / depersonalize a space | | exterior | Building facade / house exterior | | garden | Landscaping and outdoor design | | wall_texture | Change wall material or finish | | floor_restyle | Change the flooring | | seasonal | Time-of-day / seasonal / lighting variation |

Quick Reference

| What you want | Skill | Note | |---------------|-------|------| | Restyle a room from a photo | meltflex-design | Pick a mode, write a specific prompt | | Furnish an empty room | meltflex-design | virtual_staging mode | | Place a specific sofa/bed/table | meltflex-furniture | Pass product images as references | | Redesign a house exterior or garden | meltflex-design | exterior / garden mode | | Swap flooring or wall finish | meltflex-design | floor_restyle / wall_texture | | Check credit balance | — | meltflex credits (CLI) or the MCP check_credits tool |

Going further

• API docs:
• CLI: — meltflex generate from your terminal
• MCP server: — npx -y meltflex-mcp
• Cookbook: [COOKBOOK.md](./COOKBOOK.md)

Security

The skills never contain a key. Each user supplies their own mf_sk_ key via MELTFLEX_API_KEY; generations spend that user's own credits. Credits, auth, and rate limits are all enforced server-side. Never commit your key — revoke it anytime in settings.

License

MIT — see [LICENSE](./LICENSE). Contributions welcome — see [CONTRIBUTING.md](./CONTRIBUTING.md).

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: MeltFlexDevs
• Source: MeltFlexDevs/skills
• License: MIT
• Homepage: https://www.meltflexai.com/mcp

Install and usage instructions live in the source repository linked above.