Real Estate MCP Server

# Claude Desktop MCP Setup Guide Complete configuration guide to access your Real Estate MCP from Claude Desktop. ## 1. Claude Desktop Configuration ### Step 1: Locate Claude Desktop Config File **macOS:** ```bash ~/Library/Application Support/Claude/claude_desktop_config.json ``` **Windows:** ```bash %APPDATA%/Claude/claude_desktop_config.json ``` ### Step 2: Add Real Estate MCP Configuration Open `claude_desktop_config.json` and add the following configuration: ```json { "mcpServers": { "real-estate": { "command": "node", "args": ["/Users/kevinlappe/Obsidian/Real Estate MCP/dist/index.js"], "env": { "NODE_ENV": "production" } } } } ``` **⚠️ Important:** Replace the path with your actual project path. Use forward slashes even on Windows. ### Step 3: Full Configuration Example If you already have other MCP servers, merge like this: ```json { "mcpServers": { "filesystem": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/username"], "env": {} }, "real-estate": { "command": "node", "args": ["/Users/kevinlappe/Obsidian/Real Estate MCP/dist/index.js"], "env": { "NODE_ENV": "production" } }, "brave-search": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-brave-search"], "env": { "BRAVE_API_KEY": "your-brave-api-key" } } } } ``` ## 2. Environment Setup ### Step 1: Verify .env File Your `.env` file should be properly configured: ```bash # Real Estate MCP API Configuration RAPIDAPI_KEY=980bf6854emsh3f0d749504422ebp1c5293jsn64787be3d36d RAPIDAPI_HOST_ZILLOW=zillow-com1.p.rapidapi.com # Application Configuration NODE_ENV=production LOG_LEVEL=info API_TIMEOUT=10000 CACHE_TTL=3600 # Rate Limiting (requests per minute) ZILLOW_RATE_LIMIT=60 ``` ### Step 2: Build Project ```bash cd "/Users/kevinlappe/Obsidian/Real Estate MCP" npm run build ``` ## 3. Restart Claude Desktop 1. **Quit Claude Desktop completely** 2. **Restart Claude Desktop** 3. **Wait 5-10 seconds** for MCP servers to initialize ## 4. Verify MCP Connection ### Check Server Status Look for the MCP server indicator in Claude Desktop (usually a small icon or status indicator showing connected MCP servers). ### Test Basic Functionality Try this message in Claude Desktop: ``` Search for properties in Newport Beach, CA under $2M with at least 3 bedrooms ``` ## 5. Available Tools Once connected, you'll have access to these tools: ### 🏠 Property Search ``` property.search - Search for properties with filters - location: "City, State" or "Zipcode" - minPrice/maxPrice: Price range - minBeds/maxBeds: Bedroom count - propertyType: single_family, condo, townhouse, etc. ``` ### 🔍 Property Details ``` property.details - Get comprehensive property information - propertyId: Zillow ZPID for detailed info ``` ### 📊 Property Comparables ``` property.comparables - Find similar properties - propertyId: Zillow ZPID to find comps for ``` ### 🏡 Enhanced Search ``` property.searchDetailed - Search with immediate details - location: Search area - maxResults: Limit (default 5, max 10) ``` ### 💰 Mortgage Tools ``` mortgage.calculate - Calculate monthly payments mortgage.affordability - Estimate max home price ``` ## 6. Example Queries Try these example queries in Claude Desktop: ``` 1. "Find luxury homes in Orange County over $3M" 2. "Search for condos in San Diego under $800K with ocean views" 3. "Calculate monthly payment for a $1.2M home with 20% down at 7% interest" 4. "Find properties similar to ZPID 123456789" 5. "Show me detailed information for properties in Beverly Hills with 4+ bedrooms" ``` ## 7. Troubleshooting ### MCP Server Not Connecting 1. **Check file paths** - Ensure absolute path is correct 2. **Verify build** - Run `npm run build` 3. **Check permissions** - Ensure Node.js can access the files 4. **Restart Claude Desktop** completely ### No Real Data Returned 1. **Check API key** - Verify RAPIDAPI_KEY in .env 2. **Check .env location** - Must be in project root 3. **Check rate limits** - May need to wait if exceeded ### Configuration Errors ```bash # Validate your config file syntax cat ~/Library/Application\ Support/Claude/claude_desktop_config.json | jq . ``` ### Test MCP Directly ```bash cd "/Users/kevinlappe/Obsidian/Real Estate MCP" node test-mcp.js ``` ## 8. Performance Tips - **Cache Duration**: Properties cached for 1 hour (3600s) - **Rate Limits**: 60 requests/minute to Zillow API - **Batch Queries**: Use searchDetailed for multiple properties - **Location Format**: Use "City, State" format for best results ## 9. Security Notes - **API Keys**: Never share your .env file or commit it to version control - **Rate Limits**: Respect API rate limits to avoid temporary blocks - **Data Usage**: Real estate data is for informational purposes only ## 10. Support If you encounter issues: 1. **Check logs** in Claude Desktop developer console 2. **Test MCP directly** with `node test-mcp.js` 3. **Verify API key** is working with curl: ```bash curl --request GET \ --url 'https://zillow-com1.p.rapidapi.com/marketData?resourceId=32810' \ --header 'x-rapidapi-host: zillow-com1.p.rapidapi.com' \ --header 'x-rapidapi-key: 980bf6854emsh3f0d749504422ebp1c5293jsn64787be3d36d' ``` --- 🏠 **Your Real Estate MCP is now ready for Claude Desktop!** You can now search real properties, get detailed information, calculate mortgages, and analyze real estate data directly through Claude Desktop conversations.