Real Estate MCP Server

A Model Context Protocol (MCP) server that provides real estate search and mortgage calculation tools.

Features

Available Tools

1. property.search - Search for properties with filters

   • Location-based search

   • Price range filtering

   • Bedrooms/bathrooms filtering

   • Square footage filtering

   • Property type filtering

   • Note: Currently returns mock data - real API integration needed

2. mortgage.calculate - Calculate monthly mortgage payments

   • Principal & interest calculation

   • Property tax breakdown

   • Insurance costs

   • HOA fees

   • PMI estimation

3. mortgage.affordability - Calculate home affordability

   • Estimate maximum home price based on monthly payment budget

   • Considers down payment and loan terms

Installation

Prerequisites

• Node.js 18+ (check with node --version)

• npm or yarn

Install from Source

Development Mode

Usage with Claude Desktop

Configure Claude Desktop

1. Edit your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Add the server configuration:

Replace /path/to/Real-Estate-MCP with the actual path to your cloned repository.

3. Restart Claude Desktop

Using with npx (No Installation)

You can also run directly without cloning:

Note: This requires publishing to npm first.

Example Usage in Claude

Once configured, you can use the tools in Claude:

API Integration

The property search currently returns mock data. To integrate real APIs:

Zillow Integration

• Use RapidAPI's Zillow endpoints (unofficial)

• Or implement web scraping (check ToS and robots.txt)

• Store API key in environment variables

Redfin Integration

• No official public API available

• Consider unofficial endpoints or web scraping

• Respect rate limits and ToS

MLS Integration

• Requires MLS membership or broker partnership

• Different APIs per region (RETS, Web API, etc.)

• Authentication typically required

Alternative APIs

• Rentberry API

• Realty Mole API

• RentSpree API

• Estated API

Development

Project Structure

Available Scripts

• npm run dev - Start development server with hot reload

• npm run build - Build TypeScript to JavaScript

• npm run lint - Run ESLint

• npm run type-check - Check TypeScript types

Adding New Tools

1. Create a new tool file in src/tools/

2. Define the tool's input/output types in src/types/

3. Register the tool in src/index.ts using server.tool()

4. Rebuild with npm run build

Environment Variables

For production API integration, set these environment variables:

Contributing

1. Fork the repository

2. Create a feature branch

3. Make your changes

4. Run tests and linting

5. Submit a pull request

License

MIT - See LICENSE file for details

Support

For issues and questions:

• GitHub Issues: https://github.com/klappe-pm/Real-Estate-MCP/issues

Roadmap

• Integrate real Zillow API

• Add Redfin data source

• MLS integration

• Add rental property search

• Investment property analysis tools

• Comparative market analysis (CMA)

• Property valuation estimates

• Neighborhood data integration

• School district information

• Crime statistics

• Walk/transit scores