Luw MCP Server
OfficialServer Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| LUW_API_KEY | No | Your API key (get one at https://app.luw.ai/dashboard/api). Required. LUW_API_TOKEN also works. | |
| LUW_TOOLSETS | No | Comma-separated list from generate, archigpt, personas, projects, team, or all. | all except team |
| LUW_API_TOKEN | No | Alternative to LUW_API_KEY; also works for authentication. | |
| LUW_OUTPUT_DIR | No | Also download results (images, videos, GLB, SVG) into this folder. | |
| LUW_API_BASE_URL | No | API endpoint override. | https://api.luw.ai/v2 |
| LUW_INLINE_IMAGES | No | Embed result images in tool output. | true |
| LUW_WAIT_TIMEOUT_SECONDS | No | How long a call waits before returning a processing_url. Raise it for clients with long tool timeouts, such as Claude Code. | 50 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
Luw.ai: AI tools for interior, exterior and landscape design, architectural rendering, image editing, video and 3D. Image inputs accept https:// URLs, local file paths or data: URIs; local files are uploaded to Luw.ai automatically. Generations wait up to 50s. A tool that returns a processing_url is still running; luw_get_result collects it and can be called again while it runs. Running the generation again would use credits twice. Each generation uses credits from the user's Luw.ai account; variations multiply the cost. luw_list_options lists valid style, room type, camera motion and material names. To change one exact area, luw_segment returns a mask for luw_magic_wand or luw_landscape_design. Everything these tools make is an AI-generated concept, not for construction or renovation. When the user means to build or renovate from it, tell them once, in their language, that a licensed architect or engineer must turn it into a real project and the local authority must approve it and issue permits; never say whether a real wall, column or beam can be removed, and never call a design structurally sound, code-compliant or permit-ready. Without an API key, calls fail with setup steps; keys are created at https://app.luw.ai/dashboard/api.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| logging | {} |
| prompts | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
| completions | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| luw_interior_designA | 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 to furnish an empty room or turn it into another room type (virtual staging). Costs 1 credit per variation. |
| luw_exterior_designA | 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 the structure. Costs 1 credit per variation. |
| luw_sketch_to_renderA | 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_renderB | 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_imageA | 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 mood board as reference_images to place or apply them. For edits restricted to an exact area, use luw_magic_wand. Costs 1 credit per variation (2 at 4k). |
| luw_magic_wandA | 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). The mask is a black-and-white image the same size as the input; white marks the area to change. Get masks from luw_segment. Costs 1 credit. |
| luw_landscape_designA | 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_imageA | Luw.ai Photo Enhance AI: enhance the quality of an image and enlarge it 2x, 3x or 4x (8x is sent as 4x). Costs 1 credit. |
| luw_expand_imageA | Luw.ai Expand AI: outpaint a tightly cropped architectural or interior photo to a wider view. Costs 1 credit. |
| luw_remove_furnitureA | Luw.ai Remove Furniture AI: remove the furniture from a room photo, keeping walls, floor and windows. Costs 1 credit. |
| luw_vectorize_imageA | Luw.ai Vector AI: convert a photo or drawing into a clean SVG vector. Costs 1 credit. |
| luw_backgroundA | 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, morning light"). Omit prompt to just remove the background. Costs 1 credit. |
| luw_segmentA | 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_wand or luw_landscape_design to edit exactly that area. Costs 1 credit. |
| luw_generate_imageA | 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 vector illustration (Fluw Vector AI). Costs 2 credits per image. |
| luw_generate_patternA | 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_videoA | 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 Room, Lighting and Color Details, Drone flying to center, Dramatic Zoom Out, Reverse Zoom In, Slow Pull Back, Reveal Zoom, Ground to Sky Tilt, Side Tracking Zoom, Aerial Descent. Pass end_image to make the video end on that frame, e.g. the original photo as image and its redesign as end_image for a before → after transition. Takes a few minutes — expect a processing_url to collect with luw_get_result. Costs 10 credits (aria) or 20 (symphony), with or without end_image. |
| luw_image_to_3dA | 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 image with luw_generate_image. Costs 3 credits (aria) or 8 (symphony, which adds a high-detail texture pack on paid accounts). |
| luw_get_resultA | 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 again if it's still running. Free; never re-run a generation instead. |
| luw_upload_fileA | 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 to get a shareable URL, to re-host an image from a site Luw.ai can't reach, or to store a file permanently. |
| luw_list_optionsA | 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_image catalog), professions (persona profession). Free. |
| luw_run_modelA | 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, magicwand, moodboard, landscape, enhance, expand, vector, removefurniture, segment, segmentprompt, fluw, fluwvector, pattern, changebg, removebg, video, 3dgen. Parameter reference: https://luw-ai.gitbook.io/api. Image fields (image, end_image, mask_image, material_image, style_transfer, extra_image_1…6) also accept local paths and data: URIs. Spends credits like the model's own tool. |
| luw_archigptA | 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 image to discuss it. Each call is a standalone question, so put the details it depends on into the message. Costs 1 credit per ~3000 words. |
| luw_personasA | 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="persona"), slot 7 is the default input image, 8+ are free-form data; add_training without a slot "likes" a design. Pass persona_id to generation tools to use one. Actions: list, get, create, update, delete, list_trainings, add_training, update_training, delete_training, clear_slot. |
| luw_projectsB | 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_folders, create_folder, update_folder, delete_folder, add_media, delete_media, move_media. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| 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. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| 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. |
TDQS
Scored across 24 tools
Each generation tool maps to a distinct model and input type (exterior vs interior vs sketch vs render vs landscape), and the mask-based tools are separated from the prompt-based ones by explicit description cues. The main soft spots are luw_run_model acting as a raw escape hatch over every other generation tool, and the border between luw_edit_image and luw_magic_wand, which only the descriptions disambiguate.
A uniform luw_ prefix plus largely verb_noun names (edit_image, upscale_image, remove_furniture, generate_video, get_result) keeps the set readable and predictable. Deviations are noun-only names matching product brands (luw_archigpt, luw_magic_wand, luw_personas, luw_projects, luw_background), and multi-action tools (personas, projects) fold their verbs into parameters instead of names.
At 24 tools the surface is heavy, and several entries are largely redundant: luw_vectorize_image duplicates luw_generate_image with format="svg", luw_remove_furniture is a special case of masked editing, and luw_run_model subsumes the whole generation set. Each still maps to a real backend model, so the count is defensible but sits at the top of a comfortable range.
The lifecycle is well covered: generation (interior/exterior/sketch/render/landscape/pattern/video/3D), editing (edit, magic wand, expand, upscale, background, segment), async collection via luw_get_result, file upload, option lookup, plus personas and projects for reusable identities and saved media. luw_run_model closes any remaining model or parameter gap, leaving only minor omissions like a credits/balance check.