MCP Immostage

What LarryWalkerDEV/mcp-immostage MCP server does

LarryWalkerDEV/mcp-immostage MCP server exposes ImmoStage's current virtual-staging workflow through MCP. It is aimed at real-estate professionals and related platforms that need furnished room images and marketing materials for a property.

The workflow begins with stage_room, which accepts a property name, an image supplied by public URL or base64 data, a design style, and a room category. Supported styles are modern, Scandinavian, classic, minimal, and luxury. Room categories include living room, bedroom, kitchen, bathroom, office, and other.

After staging is submitted, check_staging retrieves the job state. Once processing is complete, the tool provides an inline image preview and a download URL. generate_marketing can then create six social-media posts, an Exposé PDF, and a property video. Video generation is limited to the Pro plan. Finally, get_download_link provides a property download page with a ZIP of the generated assets and a permanent ImmoStage dashboard link.

How it works

LarryWalkerDEV/mcp-immostage MCP server uses the hosted MCP endpoint at https://mcp.immostage.ai/api/mcp. The normal tool sequence is:

1. Submit a room with stage_room.
2. Poll the returned job_id with check_staging until the image is ready.
3. Optionally start generate_marketing for the property.
4. Call get_download_link to retrieve the generated assets.

Staging typically takes about 30–90 seconds, while marketing-package generation is asynchronous and may take several minutes. The download-page ZIP link remains valid for three days; the dashboard link is permanent.

Setup and configuration

The hosted endpoint can be added to an MCP client using an HTTP connection and an Authorization header. Every request must include a Bearer token. Create the token in the ImmoStage application under Einstellungen → “Claude / MCP Zugang”.

For Claude Desktop, configure the server URL and set the header to Authorization: Bearer YOUR_API_KEY. The README also documents adding the same HTTP endpoint through the Claude Code CLI. No local package installation command is provided because the documented server is hosted by ImmoStage.

The account includes the first three staging images at no charge. Further usage is credit-based under ImmoStage plans: Einzel, Starter, or Pro. API keys are subject to a limit of 100 requests per minute, with remaining capacity reported in response headers.

Limitations and notes

LarryWalkerDEV/mcp-immostage MCP server currently exposes staging and marketing tools only. Floor-plan beautification, room-image classification, listing-copy optimization, and style recommendations are identified as planned features and are not registered callable tools in the documented release.

The workflow depends on the property name being reused across related calls. Staging and marketing operations are asynchronous, so clients must poll or wait for completion rather than expecting immediate results. A property video requires the Pro plan; other plans receive an upgrade link instead. Generated assets are available through the download page, but the ZIP share link expires after three days.