Luw.ai

[Luw.ai]

Official Luw.ai MCP server

AI interior, exterior and landscape design, photoreal rendering, image editing, video and 3D,
inside Claude, Cursor, VS Code, Windsurf, Codex and any other MCP client.

[npm] [CI] [MIT]

[Add to Cursor]   [Install in VS Code]   [Add to Claude Desktop]

You:     Redesign ~/Desktop/living-room.jpg in Japandi style, give me 2 options.Claude:  ⟶ luw_interior_design  ✓ 2 designs in 21s   [shows both images]You:     Love the first one. Make the sofa green velvet, then turn it into a fly-through video.Claude:  ⟶ luw_edit_image ⟶ luw_generate_video   ✓

Quick start

1. Get an API key at app.luw.ai/dashboard/api. New accounts get free credits.

2. Add Luw.ai to your client. Pick one:

claude mcp add luw --scope user --env LUW_API_KEY=YOUR_LUW_API_KEY -- npx -y @luw-ai/mcp

claude mcp add --transport http luw https://mcp.luw.ai/mcp --header "Authorization: Bearer YOUR_LUW_API_KEY"

{  "mcpServers": {    "luw": {      "command": "npx",      "args": ["-y", "@luw-ai/mcp"],      "env": { "LUW_API_KEY": "YOUR_LUW_API_KEY" }    }  }}

{  "mcpServers": {    "luw": {      "command": "npx",      "args": ["-y", "@luw-ai/mcp"],      "env": { "LUW_API_KEY": "YOUR_LUW_API_KEY" }    }  }}

{  "inputs": [{ "type": "promptString", "id": "luw_api_key", "description": "Luw.ai API key", "password": true }],  "servers": {    "luw": {      "command": "npx",      "args": ["-y", "@luw-ai/mcp"],      "env": { "LUW_API_KEY": "${input:luw_api_key}" }    }  }}

{  "mcpServers": {    "luw": {      "command": "npx",      "args": ["-y", "@luw-ai/mcp"],      "env": { "LUW_API_KEY": "YOUR_LUW_API_KEY" }    }  }}

codex mcp add luw --env LUW_API_KEY=YOUR_LUW_API_KEY -- npx -y @luw-ai/mcp

[mcp_servers.luw]command = "npx"args = ["-y", "@luw-ai/mcp"]env = { LUW_API_KEY = "YOUR_LUW_API_KEY" }

{  "mcpServers": {    "luw": {      "command": "npx",      "args": ["-y", "@luw-ai/mcp"],      "env": { "LUW_API_KEY": "YOUR_LUW_API_KEY" }    }  }}

{  "mcpServers": {    "luw": {      "url": "https://mcp.luw.ai/mcp",      "headers": { "Authorization": "Bearer YOUR_LUW_API_KEY" }    }  }}

Windows: if npx isn't found, use "command": "cmd", "args": ["/c", "npx", "-y", "@luw-ai/mcp"]. Requires Node.js 18 or later. The Claude Desktop extension bundles everything it needs.

What you can ask

• "Redesign this bedroom (~/Downloads/bedroom.jpg) as Mid-Century Modern, 3 variations."
• "This listing photo is an empty room. Stage it as a cozy Scandinavian living room."
• "Render my sketch plan-sketch.png as a photoreal modern villa at golden hour."
• "Change the floor in this kitchen to herringbone oak." (segments the floor, then swaps the material)
• "Remove all the furniture from this room."
• "Put this chair photo on a terrazzo floor in a sunlit gallery for an ad."
• "Turn this render into a drone fly-through video."
• "Make a 3D model of this armchair from these 3 photos."
• "Seamless blue zellige tile texture, 1024px."
• "Ask ArchiGPT how to improve the feng shui of this floor plan."

Built-in prompts show up as slash commands or prompt templates in your client: redesign_room, stage_empty_room, sketch_to_render, product_shot.

Tools

Every generation uses your Luw.ai credits. Variations are billed one generation each.

How it works

• Local files just work. Any image argument accepts an https:// URL, a local path (~/Desktop/room.jpg), or a data: URI. Local files are uploaded to Luw.ai storage as temporary files (deleted after 12 hours) and cached for the session, so repeated edits don't upload the same file again.
• You see the results. Finished images are embedded in the tool result, so Claude and other clients show them inline. Set LUW_OUTPUT_DIR to also save every result to disk.
• Long jobs don't time out. A call waits up to 50 seconds and streams progress to clients that show it. If a job like a video takes longer, the tool returns a processing_url and the assistant collects it with luw_get_result, without generating (or paying) twice.
• Never billed twice. Every generation request carries an Idempotency-Key, so if a network error forces a retry, Luw.ai returns the original job instead of charging again.
• Masks are handled for you. luw_segment returns masks as URLs, so "change the floor" becomes segment ⟶ magic wand with no manual masking.
• Fast startup. The package is one bundled file with zero dependencies, so npx downloads a single ~260 KB package and starts right away.

Configuration

Self-hosting the remote server

The same package serves the hosted Streamable HTTP endpoint:

npx -y @luw-ai/mcp --http --port 8080 --host 0.0.0.0   # MCP at /mcp, health at /health

docker build -t luw-mcp . && docker run -p 8080:8080 luw-mcp

It's stateless and holds no secrets. Each request brings its own key in Authorization: Bearer …, X-Luw-Api-Key, or ?api_key=. It deploys to Vercel as-is (vercel.json is included), and a Procfile is included for Heroku. See docs/maintainers.md for deployment and release steps.

Development

npm cinpm test               # unit and protocol tests (no network)npm run build          # bundles dist/cli.jsnpm run inspector      # try every tool in the MCP InspectorLUW_API_KEY=... npm run smoke            # live checks against the real API (free)LUW_API_KEY=... npm run smoke -- --paid  # plus one real generation (1 credit)npm run mcpb           # build/luw.mcpb, the Claude Desktop extension

Support

• API reference: luw-ai.gitbook.io/api
• Issues: GitHub Issues
• Email: [email protected]

MIT © Luvi Technologies, Inc.