ImmoStage Virtual Staging MCP Server

1# ImmoStage Virtual Staging MCP Server
2 
3[![MCP](https://img.shields.io/badge/MCP-Compatible-blue)](https://modelcontextprotocol.io)
4[![TypeScript](https://img.shields.io/badge/TypeScript-5.0-blue)](https://www.typescriptlang.org/)
5[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](./LICENSE)
6 
7AI-powered virtual staging MCP server for real estate professionals. Stage empty rooms with photorealistic furniture, beautify floor plans into 3D renders, classify room images, generate German property descriptions, and get staging style recommendations — all through the Model Context Protocol. Built for Immobilienmakler, PropTech platforms, and real estate photographers in the DACH market.
8 
9## Quick Start
10 
11Connect your MCP client to the ImmoStage server:
12 
13**Server URL:** `https://mcp.immostage.ai/api/mcp`
14 
15### Claude Desktop Configuration
16 
17Add to your `claude_desktop_config.json`:
18 
19```json
20{
21  "mcpServers": {
22    "immostage": {
23      "url": "https://mcp.immostage.ai/api/mcp",
24      "headers": {
25        "Authorization": "Bearer YOUR_API_KEY"
26      }
27    }
28  }
29}
30```
31 
32Contact [goerz@immostage.ai](mailto:goerz@immostage.ai) for API access.
33 
34## Tools
35 
36| Tool | Description | Cost | Latency |
37|------|-------------|------|---------|
38| `stage_room` | AI virtual staging — transform empty room photos into beautifully furnished spaces | Uses credits | ~20-40s |
39| `beautify_floor_plan` | Transform 2D floor plans into 3D isometric architectural renders | Uses credits | ~20-40s |
40| `classify_room` | Classify room images: type, empty/furnished, quality score, style suggestion | Free | ~2s |
41| `optimize_listing` | Generate professional German property descriptions from basic listing data | Free | ~3s |
42| `suggest_style` | Get staging style recommendation based on room type and target audience | Free | Instant |
43 
44## Usage Examples
45 
46### Stage an empty living room
47 
48```
49Stage this room in modern style: https://example.com/empty-living-room.jpg
50```
51 
52The `stage_room` tool accepts:
53- `image_url` — Public URL to the room image (JPEG/PNG)
54- `style` — Staging style: `modern`, `skandinavisch`, `luxus`, `minimalistisch`, `boho`, `landhausstil`
55- `room_type` — Room type: `wohnzimmer`, `schlafzimmer`, `kueche`, `bad`, `buero`, `kinderzimmer`, `flur`
56- `quality` — Output quality: `draft` (fast) or `high` (detailed)
57 
58Returns staged image URLs ready for download or embedding.
59 
60### Classify then stage
61 
62```
63First classify this room image, then stage it with the recommended style:
64https://example.com/room-photo.jpg
65```
66 
67The agent will:
681. Call `classify_room` to detect room type and suggest a style
692. Call `stage_room` with the detected room type and suggested style
70 
71### Optimize a property listing
72 
73```
74Write a listing description for a 3-room apartment in Berlin-Mitte,
7585m2, balcony, built 1998, renovated 2023, asking price 420,000 EUR.
76```
77 
78The `optimize_listing` tool generates:
79- Professional German property description (Exposé-ready)
80- TLDR summary
81- Key feature highlights
82- SEO-optimized text
83 
84## Authentication
85 
86All requests require a Bearer token in the Authorization header:
87 
88```
89Authorization: Bearer YOUR_API_KEY
90```
91 
92Contact [goerz@immostage.ai](mailto:goerz@immostage.ai) for API access. Free tier includes 10 staging credits for testing.
93 
94## Rate Limits
95 
96- **100 requests/minute** per API key
97- Rate limit headers included in responses (`X-RateLimit-Remaining`)
98- Staging and floor plan tools consume credits based on your plan
99 
100## Links
101 
102- [ImmoStage Homepage](https://immostage.ai) — AI Virtual Staging Platform
103- [GitHub](https://github.com/LarryWalkerDEV/mcp-immostage) — Source Code
104 
105## License
106 
107[MIT](./LICENSE) — Copyright 2026 [ImmoStage](https://immostage.ai)
108