LarryWalkerDEV/mcp-immostage

AI-powered virtual staging MCP server for real estate professionals. Stage empty rooms with photorealistic furniture, then generate a full marketing package (social media posts, an Exposé PDF, and a property video) — all through the Model Context Protocol. Built for Immobilienmakler, PropTech platforms, and real estate photographers in the DACH market.
Quick Start
Connect your MCP client to the ImmoStage server:
**Server URL:** https://mcp.immostage.ai/api/mcp
Claude Desktop Configuration
Add to your claude_desktop_config.json:
Or install via the Claude Code CLI:
Getting an API Key
Self-service — no need to contact anyone. Create your Bearer key at app.immostage.ai, under **Einstellungen → "Claude / MCP Zugang"**.
The first **3 staging images per account are free**. After that, pick a plan:
| Plan | Price |
|------|-------|
| Einzel | 29 € einmalig |
| Starter | 49 € / Monat |
| Pro | 199 € / Monat, unbegrenzt |
Tools
Call these in order: stage_room → check_staging → (optional) generate_marketing → get_download_link.
| Tool | Description | Latency |
|------|-------------|---------|
| stage_room | Submits an empty-room photo for AI virtual staging. Returns a job_id to poll. | Async, ~30-90s |
| check_staging | Polls a staging job by job_id. Returns the staged image (inline preview) and its download URL once ready. | Poll until done |
| generate_marketing | Generates the full marketing package from staged rooms: 6 social media posts, an Exposé (PDF), and a property video (video requires the Pro plan). | Async, minutes |
| get_download_link | Returns the download page for a property: all generated assets as a ZIP (valid 3 days), plus a permanent dashboard link. | Instant |
> **Roadmap:** Floor-plan beautification, room classification, listing-copy optimization, and style suggestion are planned for a future release and are not yet registered as callable tools.
Usage Examples
Stage an empty room
The stage_room tool accepts:
- property_name — Name/address of the property, e.g. "Hubertstraße 10, Berlin"
- image_url — Public URL to the room photo (or image_base64 to paste an image directly)
- style — modern, scandinavian, classic, minimal, or luxury
- room_type — living_room, bedroom, kitchen, bathroom, office, or other
Returns a job_id — poll it with check_staging until the staged image is ready.
Check a staging job
The check_staging tool accepts:
- job_id — the job ID returned by stage_room
Returns the staged image inline (once ready) plus its download URL, or a "still processing" message to poll again.
Generate the marketing package
The generate_marketing tool accepts:
- property_name — same property name used with stage_room
Starts async generation of 6 social media posts, an Exposé (PDF), and a property video (the video requires the Pro plan; other plans get an upgrade link instead). Call get_download_link afterward to retrieve the assets.