# MeltFlex AI

> AI interior design — restyle rooms, place furniture, and virtually stage spaces from a photo.

- **Type:** MCP server
- **Install:** `agentstack add mcp-meltflexdevs-skills`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [MeltFlexDevs](https://agentstack.voostack.com/s/meltflexdevs)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.2.1
- **License:** MIT
- **Upstream author:** [MeltFlexDevs](https://github.com/MeltFlexDevs)
- **Source:** https://github.com/MeltFlexDevs/skills
- **Website:** https://www.meltflexai.com/mcp

## Install

```sh
agentstack add mcp-meltflexdevs-skills
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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](https://www.meltflexai.com/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
```bash
npx skills add MeltFlexDevs/skills
```

### GitHub CLI (v2.90+)
```bash
gh skill install MeltFlexDevs/skills
```

### Claude Code marketplace
Inside Claude Code:
```
/plugin marketplace add MeltFlexDevs/skills
/plugin install meltflex@meltflex
```

### Setup script
Universal fallback:
```bash
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): [INSTALL_FOR_AGENTS.md](./INSTALL_FOR_AGENTS.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:

```bash
export MELTFLEX_API_KEY="mf_sk_xxxxxxxxxxxx"
```

##  Use with Hermes

[Hermes](https://hermes-agent.nousresearch.com) (Nous Research) speaks MCP, so it runs MeltFlex through the [`meltflex-mcp`](https://www.meltflexai.com/mcp) server.

**From the catalog** (once merged into the Hermes catalog):
```bash
hermes mcp install meltflex
```

**Manually** — sign in once, then add the server to `~/.hermes/config.yaml`:
```bash
npx -y meltflex-mcp auth login
```
```yaml
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](https://www.meltflexai.com/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](https://github.com/MeltFlexDevs)
- **Source:** [MeltFlexDevs/skills](https://github.com/MeltFlexDevs/skills)
- **License:** MIT
- **Homepage:** https://www.meltflexai.com/mcp

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

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.2.1 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.2.1** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-meltflexdevs-skills
- Seller: https://agentstack.voostack.com/s/meltflexdevs
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.