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`:

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

Or install via the Claude Code CLI:

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:

Tools

Call these in order: `stage_room` → `check_staging` → (optional) `generate_marketing` → `get_download_link`.

> 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

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

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

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

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:

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

Links

• ImmoStage Homepage — AI Virtual Staging Platform
• GitHub — Source Code

License

MIT — Copyright 2026 ImmoStage