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

Related MCP server: OpenAI Web Search MCP Server

Installation

Prerequisites

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

• npm or yarn

Install from Source

# Clone the repository
git clone https://github.com/klappe-pm/Real-Estate-MCP.git
cd Real-Estate-MCP

# Install dependencies
npm install

# Build the TypeScript code
npm run build

Development Mode

# Run in watch mode for development
npm run dev

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:

{
  "mcpServers": {
    "real-estate": {
      "command": "node",
      "args": ["/path/to/Real-Estate-MCP/dist/index.js"],
      "env": {}
    }
  }
}

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:

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

Note: This requires publishing to npm first.

Example Usage in Claude

Once configured, you can use the tools in Claude:

"Search for homes in Austin, Texas under $600,000 with at least 3 bedrooms"

"Calculate the monthly mortgage payment for a $500,000 home with 20% down, 
6.5% interest rate, 30-year term, $6000/year property tax, and $1200/year insurance"

"What's the maximum home price I can afford with a $3000/month budget, 
$100,000 down payment, and 6.5% interest rate?"

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

src/
├── index.ts              # Main MCP server
├── tools/
│   ├── property-search.ts    # Property search implementation
│   └── mortgage-calculator.ts # Mortgage calculations
└── types/
    └── real-estate.ts    # TypeScript interfaces

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:

ZILLOW_API_KEY=your_api_key
REDFIN_API_KEY=your_api_key
MLS_API_KEY=your_api_key

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