realestate-mcp v2.2.0

![npm version](https://www.npmjs.com/package/realestate-mcp) ![tests](#) ![license](./LICENSE)

Disclaimer: This tool provides estimates and suggestions for informational purposes only. It does not constitute professional real estate, legal, financial, tax, or architectural advice. Always consult a licensed real estate professional before making property decisions. All generated content (descriptions, floor plans, valuations, neighborhood data) must be verified independently. See TERMS.md and PRIVACY.md.

MCP server for real estate agents — 12 tools covering floor plans, virtual tours, property descriptions (EN/FR), price estimation, property comparison, staging suggestions, neighborhood analysis, 3D previews, French DPE energy diagnostic, and live DVF transaction data.

What's new in v2.0.0

estimate_price — rough property price estimation with comparables, price factors, and confidence scoring
compare_properties — side-by-side comparison of 2-5 properties with weighted scores and recommendations
Multi-language — property_description now supports English and French
SEO output — property descriptions include SEO title, meta description, JSON-LD structured data, and character counts
Improved floor plans — scale bar, room type legend, dimension arrows, imperial/metric toggle, new room types (storage, laundry, balcony)
Improved virtual tours — smooth transitions, fullscreen mode, touch/swipe navigation, progress bar, photo gallery
91 tests covering all tools

Tools

| Tool | Description | |---|---| | generate_floor_plan | SVG floor plan with room labels, dimensions, area (m2/sqft), legend, scale bar, compass | | create_virtual_tour | Embeddable HTML virtual tour with transitions, fullscreen, keyboard/touch navigation | | property_description | Listing descriptions in EN or FR — MLS, social, luxury, investor + SEO + JSON-LD | | estimate_price | Property price estimation with price range, confidence, factors, and comparable sales | | compare_properties | Side-by-side comparison table with scores, pros/cons, and recommendation | | staging_suggestions | Virtual staging recommendations — furniture, decor, placement, cost estimates | | neighborhood_analysis | Walk score, schools, transit, amenities, demographics, safety, market context | | render_property_preview | 3D model-viewer HTML with AR support and annotation hotspots | | generate_energy_diagnostic | French DPE energy class estimate (A–G) with kWh/m²/year and greenhouse-gas projection | | search_property_transactions | Live DVF (Demandes de Valeurs Foncières) transaction data from data.gouv.fr — real French sale prices | | get_price_per_sqm | Average price per m² for a French postal code, computed from recent DVF transactions | | compare_neighborhoods | Side-by-side French neighborhood comparison (price/m², volume, trend) using DVF data |

Quick start

With Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "realestate": {
      "command": "npx",
      "args": ["realestate-mcp"]
    }
  }
}

With an API key (optional)

{
  "mcpServers": {
    "realestate": {
      "command": "npx",
      "args": ["realestate-mcp"],
      "env": {
        "REALESTATE_MCP_API_KEY": "your-api-key"
      }
    }
  }
}

Examples

Generate a floor plan

Generate a floor plan for a 2-bedroom apartment:
- Living room: 5m x 4m
- Kitchen: 3m x 3m
- Bedroom 1: 4m x 3.5m
- Bedroom 2: 3.5m x 3m
- Bathroom: 2.5m x 2m
- Balcony: 3m x 1.5m
Use modern style with metric units.

Estimate a property's price

Estimate the price for a 3BR/2BA house at 456 Oak Ave, San Francisco, CA.
2,000 sqft, built 2015, good condition, with hardwood floors and a pool.

Compare properties

Compare these 3 properties for me:
1. "Oak House" — 123 Oak St, $400,000, 3BR/2BA, 2,000 sqft, 2015, good condition
2. "Elm Condo" — 456 Elm Ave, $300,000, 2BR/1BA, 1,200 sqft, 2020, new construction
3. "Maple Town" — 789 Maple Dr, $350,000, 3BR/2BA, 1,800 sqft, 2018, renovated
Priority: value and size.

Create a virtual tour

Create a virtual tour for "123 Main Street, Springfield" with rooms:
- Living room with hardwood floors and bay window
- Modern kitchen with island and stainless appliances
- Master bedroom with walk-in closet
- Updated bathroom with marble tiles
Agent: Jane Smith, 555-1234.

Property description (French)

Write a French listing description for a 4-bedroom house at
15 Rue de la Paix, Lyon. 180 m2, renovated, asking 650,000 EUR.
Features: parquet, chemin\u00E9e, jardin.

Property description (English with SEO)

Write a listing description for a 3BR/2BA house at 456 Oak Ave, Springfield.
1,800 sqft, built 1985, renovated condition, asking $350,000.
Features: hardwood floors, granite counters, fenced backyard.
Include SEO keywords and JSON-LD structured data.

Staging suggestions

What staging would you suggest for an empty living room?
Modern style, medium budget, targeting young professionals.

Neighborhood analysis

What's the neighborhood like around 789 Elm Drive, Portland, OR?
Focus on schools, transit, and safety.

3D property preview

Create a 3D preview for "Luxury Villa" using the model at
https://example.com/villa.glb with AR enabled.

Pricing

| Tier | Requests | Price | |---|---|---| | Free | 50/month | $0 | | Pro | Unlimited | $19/month |

Development

npm install
npm run build
npm test        # 91 tests across 9 test files
npm run dev     # run with tsx (hot reload)

Legal

LICENSE -- MIT License
TERMS.md -- Terms of Service
PRIVACY.md -- Privacy Policy (no data collected)

License

MIT -- see LICENSE.

realestate-mcp