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
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| luw_interior_designA | 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 | 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 | Turn a hand sketch, line drawing, floor-plan perspective or rough draft into a photorealistic render. Costs 1 credit per variation. |
| luw_renderA | 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 | 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 | 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 | 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_image_toolsA | One-step image utilities, 1 credit each:
|
| luw_backgroundA | 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 | 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 | 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 | 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 | 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. Takes a few minutes — expect a processing_url to collect with luw_get_result. Costs 10 credits (aria) or 20 (symphony). |
| luw_image_to_3dA | 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, 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. Pass earlier turns in history to continue a conversation. 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 |
|---|---|
No resources | |
TDQS
Scored across 21 tools
Most tools target distinct models/operations and the descriptions carefully draw boundaries (e.g. luw_edit_image vs luw_magic_wand, magic_wand for masked areas). However there is real overlap among luw_sketch_to_render, luw_render and luw_generate_image, and luw_run_model is a generic catch-all that overlaps every dedicated tool.
All tools share a uniform luw_ prefix, and generate_* tools follow a clear pattern. There are minor deviations (magic_wand, background, segment are noun/verb fragments rather than verb_noun, and interior_design/exterior_design use noun_design), but the set remains readable and predictable.
21 tools is on the heavy side for this surface, and several tools (luw_image_tools with 4 sub-actions, luw_personas with 11 actions, luw_projects with 12 actions) multiplex many operations each. The breadth of distinct AI models justifies much of it, but consolidation (e.g. merging sketch/render, or splitting bundled multi-action tools) would improve scoping.
Coverage is broad: generation, editing, segmentation, upscaling, 3D, video, personas, projects, result retrieval, option lookup and raw API access. Minor gaps exist (no history/listing of past generations, no credit/billing status, no deletion of individual generations), but core workflows have no dead ends.