
Official Luw.ai MCP server: AI interior, exterior & landscape design, renders, video and 3D for
Official Luw.ai MCP server: AI interior, exterior & landscape design, renders, video and 3D for Claude, Cursor, VS Code and any MCP client.
·
AI interior, exterior and landscape design, photoreal rendering, image editing, video and 3D,
inside ChatGPT, Claude, Cursor, VS Code, Windsurf, Codex and any other MCP client.
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 ✓Add https://mcp.luw.ai/mcp to your client and sign in to Luw.ai. Nothing to install, no key to copy: signing in creates one for you. New accounts get free credits. To disconnect, delete that key on the API page.
Settings → Connectors → Add custom connector, paste https://mcp.luw.ai/mcp, then Connect and sign in to Luw.ai.
claude mcp add --transport http luw https://mcp.luw.ai/mcp --scope userThen type /mcp, pick luw and sign in.
Open Luw.ai in ChatGPT, add it and sign in to Luw.ai.
The Luw Studio tools aren't in ChatGPT's directory yet; add them yourself: Settings → Apps & Connectors → Advanced settings, turn on Developer mode, then Create: URL https://mcp.luw.ai/studio, authentication OAuth, and sign in.
Click Add to Cursor above, or add to ~/.cursor/mcp.json:
{
"mcpServers": {
"luw": { "url": "https://mcp.luw.ai/mcp" }
}
}Cursor shows Needs login next to luw; click it to sign in.
Click Install in VS Code above, or add to .vscode/mcp.json:
{
"servers": {
"luw": { "type": "http", "url": "https://mcp.luw.ai/mcp" }
}
}VS Code asks you to sign in the first time a tool runs.
| URL | https://mcp.luw.ai/mcp |
| Transport | Streamable HTTP |
| Auth | Sign in (MCP OAuth), or header Authorization: Bearer YOUR_LUW_API_KEY |
For a client that can't sign in, create a key at app.luw.ai/dashboard/api and send it as a header:
{
"mcpServers": {
"luw": {
"url": "https://mcp.luw.ai/mcp",
"headers": { "Authorization": "Bearer YOUR_LUW_API_KEY" }
}
}
}If it can neither sign in nor send headers, use https://mcp.luw.ai/mcp?api_key=YOUR_LUW_API_KEY. Anyone who has that URL can spend your credits, so keep it private.
The hosted server is stateless and stores nothing; your key goes straight to the Luw.ai API on each request. It can't read files from your computer, so give it image URLs, or use the local setup below.
The local server runs on your machine with npx, so it can read paths like ~/Desktop/room.jpg. It needs Node.js 18+ and an API key from app.luw.ai/dashboard/api.
claude mcp add luw --scope user --env LUW_API_KEY=YOUR_LUW_API_KEY -- npx -y @luw-ai/mcpOr install it as a plugin. Claude Code asks for your key and keeps it in secure storage:
claude plugin marketplace add Luvi-io/luw-mcp
claude plugin install luw@luw-aiOne click: download luw.mcpb, double-click it, paste your API key. No Node.js needed.
Or add this to claude_desktop_config.json (Settings → Developer → Edit Config):
{
"mcpServers": {
"luw": {
"command": "npx",
"args": ["-y", "@luw-ai/mcp"],
"env": { "LUW_API_KEY": "YOUR_LUW_API_KEY" }
}
}
}Add to ~/.cursor/mcp.json:
{
"mcpServers": {
"luw": {
"command": "npx",
"args": ["-y", "@luw-ai/mcp"],
"env": { "LUW_API_KEY": "YOUR_LUW_API_KEY" }
}
}
}Add to .vscode/mcp.json. VS Code asks for your key and keeps it in its secret storage:
{
"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}" }
}
}
}Add to ~/.config/devin/mcp_config.json (Windows: %APPDATA%\devin\mcp_config.json). Older Windsurf versions use ~/.codeium/windsurf/mcp_config.json.
{
"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/mcpOr in ~/.codex/config.toml:
[mcp_servers.luw]
command = "npx"
args = ["-y", "@luw-ai/mcp"]
env = { LUW_API_KEY = "YOUR_LUW_API_KEY" }gemini extensions install https://github.com/Luvi-io/luw-mcpGemini CLI asks for your key and keeps it in the system keychain. Or add to ~/.gemini/settings.json:
{
"mcpServers": {
"luw": {
"command": "npx",
"args": ["-y", "@luw-ai/mcp"],
"env": { "LUW_API_KEY": "YOUR_LUW_API_KEY" }
}
}
}Click Add to Kiro above, confirm, then replace YOUR_LUW_API_KEY in Kiro's MCP config.
Windows: if npx isn't found, use "command": "cmd", "args": ["/c", "npx", "-y", "@luw-ai/mcp"].
~/Downloads/bedroom.jpg) as Mid-Century Modern, 3 variations."plan-sketch.png as a photoreal modern villa at golden hour."Built-in prompts show up as slash commands or prompt templates in your client: redesign_room, stage_empty_room, sketch_to_render, product_shot.
| Tool | What it does | Credits |
|---|---|---|
luw_interior_design | Redesign a room in any style; empty_room for virtual staging | 1 |
luw_exterior_design | Redesign a facade or building exterior | 1 |
luw_sketch_to_render | Sketch or drawing to photoreal render | 1 |
luw_render | 3D, CAD or clay view to photoreal render | 1 |
luw_edit_image | Edit any image with a sentence (Magic Prompt); 2K/4K | 1 |
luw_magic_wand | Masked edit: replace, remove, or apply a material | 1 |
luw_landscape_design | Gardens and outdoor areas, matched to climate and sun | 1 |
luw_upscale_image | Enhance and enlarge 2/4/8× | 1 |
luw_expand_image | Outpaint a cropped photo to a wider view | 1 |
luw_remove_furniture | Empty a furnished room | 1 |
luw_vectorize_image | Photo or drawing to SVG | 1 |
luw_background | Remove a background, or replace it with a generated scene | 1 |
luw_segment | Object masks (all objects, or by prompt) as image URLs | 1 |
luw_generate_image | Text to image (Fluw), or format: "svg" for vectors | 2 |
luw_generate_pattern | Seamless, tileable textures and patterns | 1 |
luw_generate_video | Image to cinematic video with 12 camera motions, optionally ending on an end_image | 10 (20 with Symphony) |
luw_image_to_3d | Photos to a textured 3D model (GLB) | 3 (8 with Symphony) |
luw_archigpt | Ask ArchiGPT, an AI architect, a standalone question (accepts images) | 1 per ~3k words |
luw_get_result | Collect a long-running job (free) | 0 |
luw_list_options | Valid styles, room and building types, camera motions, materials (free) | 0 |
luw_upload_file | Upload a file to Luw.ai storage and get a URL (free) | 0 |
luw_run_model | Call any Luw.ai model with raw API parameters (local server only) | varies |
luw_personas | Personas: reusable style identity, training images and slots (local server only) | 0 |
luw_projects | Projects (boards), folders and media (local server only; hosted: luw://projects resources) | 0 |
luw_team | Enterprise: credits, usage, members, invitations (opt-in) | 0 |
Every generation uses your Luw.ai credits. Variations are billed one generation each.
Luw Studio designs buildings in 3D. With the studio tools, your assistant edits your Studio projects directly: rooms, walls, doors and windows, stairs, roofs, furniture and finishes. Each edit is saved to the project as it is made, and a Studio tab that has the project open shows it within seconds.
https://mcp.luw.ai/studio instead of /mcp (same sign-in). It has every hosted tool plus the studio tools.studio to LUW_TOOLSETS, e.g. LUW_TOOLSETS=generate,archigpt,personas,projects,studio."In my Luw Studio project Beach House, add a 3×4 m bedroom east of the living room with a window, and furnish it."
| Tool | What it does |
|---|---|
luw_studio_list_projects | Your Studio projects, newest first, with each project_id and Studio link |
luw_studio_create_project | A new project: an empty site, or a starter house (list_templates) |
luw_studio_rename_project | Rename a project |
luw_studio_undo | Put back the scene from before the last assistant edit (again: redo) |
| Scene tools | Luw Studio's editor tools, each taking a project_id: read (get_level_summary, get_zones, get_walls, find_nodes, measure, verify_scene, …) and build (create_story_shell, create_room, add_wall, add_door, add_window, create_stair, create_roof, furnish_room, place_items, paint, apply_patch, …) |
The scene tools run on the same core as Luw Studio, with its catalog (Luw's own pieces included) and its defaults. They don't use credits. A project last saved by the previous Luw Studio is readable; open it once in Studio to edit it here. luw://studio/guide is the building guide the assistant reads first.
Read-only context you can attach to a conversation. In Claude Code, type @luw: to pick one; other clients that support resources offer them as attachments.
| Resource | What it holds |
|---|---|
luw://account | Your credit balance |
luw://history/{app} | Your 10 most recently updated projects in one Luw.ai app (Interior, Exterior, Video, …) with their latest results: file links, prompts and source images |
luw://projects/{id} | One project: its folders and the file link of every item in it |
luw://catalog/{kind} | Design styles, room and building types, video camera motions, materials and persona professions, with previews |
luw://guide | Every tool and what it costs |
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.LUW_OUTPUT_DIR to also save every result to disk.processing_url and the assistant collects it with luw_get_result, without generating (or paying) twice.Idempotency-Key, so if a network error forces a retry, Luw.ai returns the original job instead of charging again.luw_segment returns masks as URLs, so "change the floor" becomes segment ⟶ magic wand with no manual masking.npx downloads a single ~0.9 MB package and starts right away.| Variable | Default | |
|---|---|---|
LUW_API_KEY | (required) | Your API key (get one). LUW_API_TOKEN also works. |
LUW_OUTPUT_DIR | (off) | Also download results (images, videos, GLB, SVG) into this folder |
LUW_TOOLSETS | all except team and studio | Comma-separated list from generate, archigpt, personas, projects, team, studio, or all |
LUW_STUDIO_CATALOG_URL | https://studio.luw.ai/api/catalog | Where the studio tools read Luw Studio's item catalog; empty uses the built-in list |
LUW_WAIT_TIMEOUT_SECONDS | 50 | How long a call waits before returning a processing_url. Raise it for clients with long tool timeouts, such as Claude Code. |
LUW_INLINE_IMAGES | true | Embed result images in tool output |
LUW_API_BASE_URL | https://api.luw.ai/v2 | API endpoint override |
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 /healthdocker build -t luw-mcp . && docker run -p 8080:8080 luw-mcpIt's stateless. Each request brings its own key in Authorization: Bearer …, X-Luw-Api-Key, or ?api_key=. Set LUW_MCP_OAUTH_SECRET to also let clients sign in to Luw.ai instead (OAuth); the sign-in hands the client an ordinary 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.
npm ci
npm test # unit and protocol tests (no network)
npm run build # bundles dist/cli.js
npm run inspector # try every tool in the MCP Inspector
LUW_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
node scripts/vendor-editor.mjs ../luwstudio2 # rebuild vendor/: the editor core + MCP as Luw Studio runs them© Luvi Technologies, Inc., all rights reserved. Free to install and run with your Luw.ai account; copying, changing or redistributing it is not allowed (see LICENSE). Bundled open-source components and their licenses: dist/THIRD_PARTY_NOTICES.md.
Pick your client and paste the snippet. Each one is the same server, written the way that client expects it.
claude mcp add luw --transport http https://mcp.luw.ai/mcp{
"mcpServers": {
"luw": {
"url": "https://mcp.luw.ai/mcp"
}
}
}code --add-mcp '{"name":"luw","url":"https://mcp.luw.ai/mcp"}'Runs as a hosted service. Your client connects over the network and nothing is installed locally.
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/luw-mcp to learn what the "Luw Mcp" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
claude mcp add --transport http luw https://mcp.luw.ai/mcp --scope user
claude mcp add luw --scope user --env LUW_API_KEY=YOUR_LUW_API_KEY -- npx -y @luw-ai/mcpnpx -y @luw-ai/mcp --http --port 8080 --host 0.0.0.0 # MCP at /mcp, health at /health| Name | What it does |
|---|---|
luw_interior_design | Luw.ai Interior AI: redesign an interior photo — home, office, shop, hotel — in any style while keeping the room's architecture. Restyles furniture, materials, colors and lighting. Set empty_room=true |
luw_exterior_design | Luw.ai Exterior AI: redesign a building exterior or facade photo — houses, villas, apartments, commercial buildings — in a new architectural style, with new materials, colors and landscaping, keeping |
luw_sketch_to_render | Luw.ai Sketch AI: turn a hand sketch, line drawing, floor-plan perspective or rough draft into a photorealistic render. Costs 1 credit per variation. |
luw_render | Luw.ai Render AI: turn a 3D model view, CAD/BIM screenshot, clay render or basic visualization into a photorealistic architectural render. Costs 1 credit per variation. |
luw_edit_image | Luw.ai Magic Prompt AI: edit any image with a plain-language instruction: "make the sofa green velvet", "add a pendant lamp over the table", "turn it into a night scene". Pass products, materials or a |
luw_magic_wand | Luw.ai Magic Wand AI: change only a masked area of an image. Give a prompt to add/replace what's there, remove=true to erase it, or material_image to re-surface it (e.g. new flooring or wall tiles). T |
luw_landscape_design | Luw.ai Landscape AI: design a garden, yard or outdoor area inside a masked region of a photo, with plants chosen for the location's climate and sun exposure. Costs 1 credit. |
luw_upscale_image | Luw.ai Photo Enhance AI: enhance the quality of an image and enlarge it 2x, 4x or 8x. Costs 1 credit. |
luw_expand_image | Luw.ai Expand AI: outpaint a tightly cropped architectural or interior photo to a wider view. Costs 1 credit. |
luw_remove_furniture | Luw.ai Remove Furniture AI: remove the furniture from a room photo, keeping walls, floor and windows. Costs 1 credit. |
luw_vectorize_image | Luw.ai Vector AI: convert a photo or drawing into a clean SVG vector. Costs 1 credit. |
luw_background | Luw.ai Change Background: cut out a product/object from its background (transparent PNG) — or, with a prompt, place it in a new generated scene for marketing shots ("on a marble kitchen counter, morni |
luw_segment | Luw.ai Segment AI: detect objects in a photo and return black-and-white masks as image URLs — every object (wall, floor, sofa, …) or only what you describe in prompt. Feed a mask URL into luw_magic_wa |
luw_generate_image | Luw.ai Fluw AI: generate a photorealistic image or illustration from a text prompt (optionally guided by an input image) — concept art, interiors, products, marketing visuals. Set format="svg" for a v |
luw_generate_pattern | Luw.ai Pattern AI: generate a seamless, tileable pattern or texture — tiles, wallpaper, fabric, terrazzo, wood, stone — ready to repeat across a surface. Costs 1 credit. |
luw_generate_video | Luw.ai Video AI (Motion): animate a design image into a short cinematic video — fly-throughs, dolly moves, drone shots, reveals. Camera motions: A Forward Dolly, Flythrough Cinematic, Return to Empty |
luw_image_to_3d | Luw.ai 3DGen AI: generate a textured 3D model (GLB) from a photo of an object — furniture, decor, products. Add up to 3 photos from other angles for better accuracy. For text-to-3D, first make an imag |
luw_get_result | Collect the result of a Luw.ai generation that was still processing (tools return a processing_url when a job outlasts their wait). Waits for the job to finish (up to the server's wait limit) — call a |
luw_upload_file | Upload an image, video or 3D file to Luw.ai storage and get a URL usable by every Luw.ai tool. Rarely needed: all tools already accept local paths and data: URIs and upload them automatically. Useful |
luw_list_options | Look up valid values for other Luw.ai tools: design_styles (styles param), interior_types (room_type), exterior_types (building_type), video_styles (camera_motion), materials (Magic Wand material_imag |
luw_run_model | Call POST /generate with raw API parameters, for models or options the dedicated tools don't cover (e.g. persona-slot inputs, webhooks). Models: interior, exterior, sketch, render, magicprompt, magicw |
luw_archigpt | Ask Luw.ai's ArchiGPT, an AI architect: design advice, feng shui, space planning, material and color suggestions, technical questions, and estimating square meters from a photo or plan. Attach an imag |
luw_personas | Personas hold a reusable design identity: style knowledge plus saved images (trainings). Slots 1-6 train the persona's visual style (slot 1 is the style-transfer reference used by style_reference="per |
luw_projects | Organize work in Luw.ai projects (called boards in the API), with nested folders and media. Use add_media to save generated results into a project. Actions: list, get, create, rename, delete, list_fol |
| Name | What it does |
|---|---|
redesign_room | Restyle a room photo in a chosen design style (2 variations). |
stage_empty_room | Furnish an empty room photo for a listing. |
sketch_to_render | Turn a sketch or drawing into a photorealistic render. |
product_shot | Put a product photo into a new generated scene. |
| Name | What it does |
|---|---|
account | Your Luw.ai credit balance. |
guide | What each Luw.ai tool does and what it costs in credits. |
Design styles | Valid design styles, room and building types, video camera motions, materials and persona professions, with previews. |
Room types | Valid design styles, room and building types, video camera motions, materials and persona professions, with previews. |
Building types | Valid design styles, room and building types, video camera motions, materials and persona professions, with previews. |
Video camera motions | Valid design styles, room and building types, video camera motions, materials and persona professions, with previews. |
Materials | Valid design styles, room and building types, video camera motions, materials and persona professions, with previews. |
Persona professions | Valid design styles, room and building types, video camera motions, materials and persona professions, with previews. |
Interior history | Your latest Interior projects and results. |
Exterior history | Your latest Exterior projects and results. |
Sketch history | Your latest Sketch projects and results. |
Render history | Your latest Render projects and results. |
MagicPrompt history | Your latest MagicPrompt projects and results. |
MagicWand history | Your latest MagicWand projects and results. |
Landscape history | Your latest Landscape projects and results. |
Enhance history | Your latest Enhance projects and results. |
Expand history | Your latest Expand projects and results. |
RemoveFurniture history | Your latest RemoveFurniture projects and results. |
Vector history | Your latest Vector projects and results. |
ChangeBG history | Your latest ChangeBG projects and results. |
Fluw history | Your latest Fluw projects and results. |
Pattern history | Your latest Pattern projects and results. |
MoodBoard history | Your latest MoodBoard projects and results. |
Video history | Your latest Video projects and results. |
3DGen history | Your latest 3DGen projects and results. |
Read live from the server on November 6, 2026.
Maintain this server? Claiming proves you own the listing and earns the last 4 points.
Claim this listingPaste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/luw-mcp)Nothing comparable is listed yet.
v0.3.17Release notesv0.3.16Release notesv0.3.15Release notesv0.3.14Release notesv0.3.13Release notesv0.3.12Release notesv0.3.11Release notesv0.3.10Release notesv0.3.9Release notesv0.3.8Release notesv0.3.7Release notesv0.3.6Release notesv0.3.5Release notesv0.3.4Release notesv0.3.3Release notesv0.3.2Release notesv0.3.1Release notesv0.3.0Release notesv0.2.0Release notesv0.1.0Release notesConnect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "luw-mcp" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
One email a week. New agents, MCP servers and skills, and what is actually getting traction.