mcp-real-estate

mcp-real-estate

MCP server for real estate professionals -- 15 AI-powered tools for property agents, architects, and developers.

Virtual staging, photo enhancement, decluttering, floor plan analysis, interior renders, expose PDFs, lead scoring, marketing copy, property comparison, renovation estimates, quality checks, and OpenImmo XML export.

Why This Exists

Real estate professionals spend hours on photo editing, writing descriptions, creating exposes, and qualifying leads. Traditional virtual staging costs $24--49 per image. This MCP server gives your AI assistant 15 specialized tools that handle all of it -- from $0.02 per image for virtual staging to completely free lead scoring.

Key differentiators:

• OpenImmo XML -- The only MCP server that generates OpenImmo v1.2.8 XML for German portal export (ImmoScout24, Immowelt, Immonet)
• Full pipeline -- Floor plan image to finished PDF expose in one command
• 3 languages -- German, English, Spanish out of the box
• Cost-transparent -- Every tool documents its API cost. 4 tools are completely free (no API key needed)

Quick Start

npx mcp-real-estate

Claude Desktop / Claude Code / Cursor / Windsurf

Add to your MCP configuration:

{
  "mcpServers": {
    "real-estate": {
      "command": "npx",
      "args": ["-y", "mcp-real-estate"],
      "env": {
        "OPENAI_API_KEY": "sk-..."
      }
    }
  }
}

Environment Variables

Variable	Required	Description
OPENAI_API_KEY	For AI tools	OpenAI API key (GPT Vision + gpt-image-1.5)
MCP_HTTP	No	Set to 1 for HTTP transport (default: stdio)
MCP_PORT	No	HTTP port (default: 3108)

What works without an API key

These 4 tools require zero configuration:

• qualify_lead -- Pure keyword-based lead scoring
• generate_openimmo_xml -- XML generation from structured data
• generate_expose_pdf -- HTML-to-PDF via Puppeteer
• extract_property_data -- Regex fallback for text-only extraction

All 15 Tools

Image AI (gpt-image-1.5)

Tool	What it does	Cost
virtual_staging	Furnish empty rooms -- 5 styles, 7 room types	$0.02--0.19
enhance_image	Sky replacement, HDR, twilight, wire removal -- 8 enhancements	$0.02--0.19
declutter_room	Remove clutter + renovation preview -- 3 modes, 6 presets	$0.02--0.19

Floor Plan Pipeline

Tool	What it does	Cost
analyze_floorplan	Extract rooms, dimensions, features from floor plan image (Vision AI)	~$0.05
render_rooms	Photorealistic interior renders from analysis data	$0.02--0.19/room
quality_check	QC renders for style consistency and photorealism	~$0.03--0.08
generate_expose_from_floorplan	Full pipeline: floor plan -> renders -> PDF expose	$0.17--1.19

Documents and Export

Tool	What it does	Cost
generate_expose_pdf	Premium A4 expose PDF with branding (Puppeteer)	Free
generate_openimmo_xml	OpenImmo v1.2.8 XML for ImmoScout24, Immowelt, Immonet	Free

AI Analysis and Marketing

Tool	What it does	Cost
extract_property_data	Extract structured data from property descriptions/images	Free--$0.03
analyze_property_images	Score photos for quality, composition, staging	~$0.03
generate_marketing_copy	Marketing text for 5 channels, 5 tones, DE/EN/ES	~$0.005
compare_properties	Side-by-side comparison of 2--4 properties with scoring	~$0.01
estimate_renovation_cost	Itemized costs with 15 regional multipliers (DE + ES)	~$0.01

Lead Management

Tool	What it does	Cost
qualify_lead	Score leads 0--100, detect intent/urgency/budget (DE/EN/ES)	Free

Workflows

New Listing

extract_property_data -> analyze_property_images -> generate_marketing_copy -> generate_expose_pdf

Floor Plan to Expose (one command)

generate_expose_from_floorplan

This orchestrates: analyze_floorplan -> render_rooms -> PDF generation automatically.

Photo Enhancement

enhance_image (sky_replacement + hdr) -> quality_check
virtual_staging (modern style) -> quality_check

Portal Export (Germany)

extract_property_data -> generate_openimmo_xml

Tool Examples

Virtual Staging

{
  "imagePath": "/photos/empty-living-room.jpg",
  "style": "mediterranean",
  "roomType": "living_room",
  "quality": "high"
}

Styles: modern, mediterranean, luxury, minimalist, rustic Room types: living_room, bedroom, kitchen, dining, bathroom, office, terrace

Qualify Lead

{
  "message": "Guten Tag, wir suchen dringend eine 4-Zimmer Wohnung. Budget bis 800.000 EUR, Finanzierung steht. Koennten wir diese Woche besichtigen?",
  "source": "portal",
  "locale": "de"
}

Returns:

{
  "score": 92,
  "intent": "kaufinteresse",
  "urgency": "hot",
  "keywords": ["dringend", "besichtigen", "finanzierung"],
  "extractedData": {
    "budget": { "max": 800000, "currency": "EUR" },
    "timeline": "immediate",
    "financingReady": true
  },
  "recommendation": "HOHE PRIORITAET: Innerhalb 1 Stunde kontaktieren."
}

Generate OpenImmo XML

{
  "property": {
    "projectName": "3-Zimmer Altbau",
    "propertyType": "apartment",
    "address": "Schwabing, Muenchen",
    "livingArea": 87,
    "bedrooms": 2,
    "price": 489000
  },
  "config": {
    "anbieterNr": "MYR-001",
    "firma": "Immobilien GmbH",
    "kontakt": { "email": "[e-mail]", "telefon": "[phone]" }
  }
}

Expose PDF with Custom Branding

{
  "property": {
    "projectName": "Penthouse Maxvorstadt",
    "propertyType": "penthouse",
    "address": "Maxvorstadt, Muenchen",
    "livingArea": 185,
    "bedrooms": 3,
    "bathrooms": 2,
    "price": 1290000,
    "features": ["Dachterrasse", "Aufzug", "Tiefgarage"]
  },
  "images": ["/photos/exterior.jpg", "/photos/living.jpg"],
  "locale": "de",
  "branding": {
    "companyName": "Premium Immobilien",
    "primaryColor": "#1a365d",
    "phone": "[phone]",
    "email": "[e-mail]"
  }
}

Renovation Cost Estimate

Regional cost multipliers are built in:

Region	Multiplier	Region	Multiplier
Munich	1.30x	Barcelona	0.80x
Hamburg	1.25x	Madrid	0.78x
Frankfurt	1.22x	Mallorca/Ibiza	0.85x
Berlin	1.15x	Costa del Sol	0.72x
Rural Germany	0.80--0.90x	Rural Spain	0.60x

Cost Calculator

Use Case	Tools	Estimated Cost
Stage 1 empty room	virtual_staging	$0.02--0.19
Enhance 5 exterior photos	enhance_image x5	$0.10--0.95
Full expose from floor plan	generate_expose_from_floorplan	$0.17--1.19
Score 100 leads	qualify_lead x100	$0.00
Marketing copy for 5 channels	generate_marketing_copy x5	~$0.025
Compare 4 properties	compare_properties	~$0.01
Renovation estimate	estimate_renovation_cost	~$0.01
OpenImmo XML export	generate_openimmo_xml	$0.00

Architecture

src/
  server.ts              MCP server (Zod schemas, registerTool)
  types.ts               TypeScript interfaces
  imageEditHelper.ts     Shared gpt-image-1.5 edit helper
  lib/
    logger.ts            Structured logging (stderr)
    result.ts            Result<T> type
    dual-transport.ts    Stdio + HTTP transport
    index.ts             Re-exports
  tools/
    virtualStaging.ts    5 styles, 7 room types
    enhanceImage.ts      8 enhancement presets
    declutterRoom.ts     3 modes, 6 renovation presets
    analyzeFloorplan.ts  Vision AI floor plan analysis
    renderRooms.ts       gpt-image-1.5 room rendering
    qualityCheck.ts      AI quality control
    generateExposeFromFloorplan.ts  Full pipeline
    generateExposePdf.ts            Puppeteer HTML-to-PDF
    generateOpenimmoXml.ts          OpenImmo v1.2.8
    extractPropertyData.ts          AI + regex extraction
    analyzePropertyImages.ts        Photo quality scoring
    generateMarketingCopy.ts        Multi-channel text
    compareProperties.ts            Property comparison
    estimateRenovation.ts           Cost estimator
    qualifyLead.ts                  Lead scoring (pure logic)

Dependencies

Package	Purpose
@modelcontextprotocol/sdk	MCP protocol (stdio + HTTP)
openai	GPT Vision + gpt-image-1.5
puppeteer	HTML-to-PDF for exposes
zod	Input validation

No database. No external services besides OpenAI. Fully standalone.

Development

npm install
npm run build        # TypeScript -> dist/
npm run dev          # Development with tsx
npm test             # Vitest (12 tests)
npm run typecheck    # TypeScript strict mode

License

MIT