ImmoStage Virtual Staging MCP Server (io.github.LarryWalkerDEV/immostage)

ImmoStage is an AI virtual staging MCP server for real estate professionals. It can stage empty rooms with photorealistic furniture and beautify floor plans, and it also supports classifying images. It generates a complete marketing package through Model Context Protocol, including social media posts, an Exposé PDF, and a property video.

🛠️ Key Features

Stage rooms with photorealistic furniture
Beautify floor plans
Classify images
Produce marketing outputs (social media posts, Exposé PDF, property video)
Built as an MCP-compatible server

🚀 Use Cases

Immobilienmakler workflows
Preparing staged visuals for property listings
Generating listing marketing materials from staged images and floor plans

⚡ Developer Benefits

Exposes functionality via Model Context Protocol (MCP)
TypeScript-based implementation
Developer-facing integration for real-estate staging and marketing generation

⚠️ Limitations

Source excerpt describes specific outputs (posts, Exposé PDF, video) but does not specify additional supported formats or configuration options.

ImmoStage Virtual Staging MCP Server

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:

json

{
  "mcpServers": {
    "immostage": {
      "url": "https://mcp.immostage.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Or install via the Claude Code CLI:

code

claude mcp add --transport http immostage https://mcp.immostage.ai/api/mcp --header "Authorization: Bearer YOUR_KEY"

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

code

Stage this room in modern style: https://example.com/empty-living-room.jpg

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

code

Check the status of job abc123

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

code

Generate the marketing package for Hubertstraße 10, Berlin

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.

Get the download link

code

Get the download link for Hubertstraße 10, Berlin

The get_download_link tool accepts:

property_name — same property name used with stage_room

Returns a share link (valid 3 days) to a page with all assets bundled as a ZIP, plus a permanent link to the ImmoStage dashboard.

Authentication

All requests require a Bearer token in the Authorization header:

code

Authorization: Bearer YOUR_API_KEY

Create your key at app.immostage.ai → Einstellungen → "Claude / MCP Zugang" (see Getting an API Key above). The first 3 staging images per account are free.

Rate Limits

100 requests/minute per API key
Rate limit headers included in responses (X-RateLimit-Remaining)
Staging and marketing-package generation consume credits based on your plan

ImmoStage Virtual Staging