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.
This server publishes no instructions, or was last inspected before Glama recorded them.
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_designB | 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_renderB | 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_renderA | 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. |
| 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_imageB | Luw.ai Photo Enhance AI: enhance the quality of an image and enlarge it 2x, 4x or 8x. Costs 1 credit. |
| luw_expand_imageB | 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). |
| 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 tool maps to a distinct Luw.ai model or resource, and the descriptions actively draw the boundaries (e.g. edit_image vs magic_wand for whole-image vs masked edits, interior vs exterior design). The main overlap is luw_run_model, which duplicates every dedicated tool, but it is clearly framed as a raw escape hatch for uncovered parameters.
Every tool uses the same luw_ prefix and snake_case, mostly verb_noun (expand_image, generate_video, remove_furniture). luw_personas and luw_projects are noun-named, but this is a reasonable convention for multi-action resource managers and does not break predictability.
24 tools is on the heavy side, but each corresponds to a genuinely distinct AI model or capability (video, 3D, segment, pattern, vector, etc.), so they mostly earn their place. The set is slightly large yet well-organized rather than redundant.
The surface covers the full lifecycle: generation, editing, upscaling, vectorization, segmentation, 3D, video, background removal, persona/project management, async result polling, option lookup, uploads, and a raw API fallback. No obvious dead ends for the image/video design domain.