Skip to main content
Glama
Sign In

Zillow MCP Server

by rohitsingh-iitd
GitHub
Python
MIT License
3
  • Apple
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

README.md - Zillow MCP Server

A Model Context Protocol (MCP) server that provides real-time access to Zillow real estate data, built with Python and FastMCP.

Features

  • 🏠 Property Search: Search for properties by location, price range, and property features
  • 💰 Property Details: Get detailed information about specific properties
  • 📊 Zestimates: Access Zillow's proprietary home valuation data
  • 📈 Market Trends: View real estate market trends for any location
  • 🧮 Mortgage Calculator: Calculate mortgage payments based on various inputs
  • 🔍 Health Check: Verify API connectivity and monitor performance

Requirements

Installation

  1. Clone this repository:
git clone https://github.com/rohitsingh-iitd/zillow-mcp-server cd zillow-mcp-server
  1. Install the dependencies:
pip install -r requirements.txt
  1. Create a .env file with your Zillow API key:
ZILLOW_API_KEY=your_zillow_api_key_here

Usage

Run the server with options:

# Standard stdio mode (for Claude Desktop) python zillow_mcp_server.py # HTTP server mode (for remote access) python zillow_mcp_server.py --http --port 8000 # Debug mode for more verbose logging python zillow_mcp_server.py --debug

You can also run the server using Docker:

# Build the Docker image docker build -t zillow-mcp-server . # Run with environment variables docker run -p 8000:8000 -e ZILLOW_API_KEY=your_key_here zillow-mcp-server # Or using an env file docker run -p 8000:8000 --env-file .env zillow-mcp-server

Usage with Claude Desktop

Add the Zillow MCP server to your Claude Desktop configuration file:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
{ "mcpServers": { "zillow": { "command": "python", "args": ["/path/to/zillow_mcp_server.py"] } } }

For remote HTTP server:

{ "mcpServers": { "zillow-remote": { "command": "npx", "args": ["mcp-remote", "https://your-mcp-server-url.com/sse"] } } }

Available Tools

search_properties

Search for properties based on various criteria:

search_properties( location: str, type: str = "forSale", min_price: Optional[int] = None, max_price: Optional[int] = None, beds_min: Optional[int] = None, beds_max: Optional[int] = None, baths_min: Optional[float] = None, baths_max: Optional[float] = None, home_types: Optional[List[str]] = None )

Example usage in Claude:

Please search for properties in Seattle with prices between $500,000 and $800,000.

get_property_details

Get detailed information about a specific property:

get_property_details( property_id: str = None, address: str = None )

Example usage in Claude:

Can you get the details for the property with ID 12345?

get_zestimate

Get Zillow's estimated value for a property:

get_zestimate( property_id: str = None, address: str = None )

Example usage in Claude:

What's the Zestimate for 123 Main St, Seattle, WA?

Get real estate market trends for a specific location:

get_market_trends( location: str, metrics: List[str] = ["median_list_price", "median_sale_price", "median_days_on_market"], time_period: str = "1year" )

Example usage in Claude:

What are the current real estate trends in Boston over the past year?

calculate_mortgage

Calculate mortgage payments and related costs:

calculate_mortgage( home_price: int, down_payment: int = None, down_payment_percent: float = None, loan_term: int = 30, interest_rate: float = 6.5, annual_property_tax: int = None, annual_homeowners_insurance: int = None, monthly_hoa: int = 0, include_pmi: bool = True )

Example usage in Claude:

Calculate the monthly mortgage payment for a $600,000 house with 20% down and a 6% interest rate.

check_health

Verify the Zillow API connection and get server status:

check_health()

Example usage in Claude:

Please check if the Zillow API is currently responsive.

get_server_tools

Get a list of all available tools on this server:

get_server_tools()

Example usage in Claude:

What tools are available in the Zillow MCP server?

Resources

Get property information as a formatted text resource:

zillow://property/{property_id}

Get market trends information as a formatted text resource:

zillow://market-trends/{location}

Error Handling

The server implements robust error handling with:

  • Automatic retries with exponential backoff
  • Detailed error logging
  • Rate limit handling
  • Connection timeouts
  • Graceful degradation

Technical Details

This MCP server is built using:

  • FastMCP: A Pythonic framework for building Model Context Protocol servers
  • Requests: For making HTTP requests to the Zillow Bridge API with connection pooling and retries
  • Backoff: For implementing exponential backoff retry logic
  • python-dotenv: For managing environment variables

The server provides both tools (interactive functions) and resources (static data) that Claude can access to provide real estate information to users.

Limitations and Considerations

  • Zillow's API has usage limits (typically 1,000 requests per day per dataset)
  • Zillow's terms of service prohibit storing data locally; all requests must be dynamic
  • You must properly attribute data to Zillow in the user interface
  • The Bridge API functionality may change over time, requiring server updates

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

  • Zillow for providing the Bridge API
  • Anthropic for the Model Context Protocol specification

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

A Model Context Protocol server that provides real-time access to Zillow real estate data, enabling property search, detailed information retrieval, Zestimates, market trends analysis, and mortgage calculations.

  1. Features
    1. Requirements
      1. Installation
        1. Usage
          1. Usage with Claude Desktop
            1. Available Tools
              1. search_properties
              2. get_property_details
              3. get_zestimate
              4. get_market_trends
              5. calculate_mortgage
              6. check_health
              7. get_server_tools
            2. Resources
              1. Error Handling
                1. Technical Details
                  1. Limitations and Considerations
                    1. License
                      1. Acknowledgments

                        Related MCP Servers

                        • StockFlow MCP Server

                          twolven
                          -
                          security
                          A
                          license
                          -
                          quality
                          A Model Context Protocol server providing real-time stock data and options analysis through Yahoo Finance, enabling LLMs to access market data, analyze stocks, and evaluate options strategies.
                          Last updated -
                          4
                          Python
                          MIT License

                        • Home Assistant MCP Server

                          miguelg719
                          -
                          security
                          A
                          license
                          -
                          quality
                          A Model Context Protocol server that integrates with Home Assistant to provide smart home control capabilities through natural language, supporting devices like lights, climate systems, locks, alarms, and humidifiers.
                          Last updated -
                          Python
                          MIT License
                          • Apple

                        • WSB Analyst MCP Server

                          ferdousbhai
                          A
                          security
                          A
                          license
                          A
                          quality
                          A Model Context Protocol server that enables LLM clients to fetch, analyze, and extract insights from real-time WallStreetBets posts, comments, and shared links for market analysis.
                          Last updated -
                          6
                          1
                          Python
                          MIT License
                          • Apple

                        • A Share MCP

                          24mlight
                          A
                          security
                          A
                          license
                          A
                          quality
                          A Model Context Protocol server providing tools for querying A-share stock market data, including historical prices, financial reports, market indices, and macroeconomic indicators.
                          Last updated -
                          28
                          178
                          Python
                          MIT License

                        View all related MCP servers

                        New MCP Servers

                        MCP directory API

                        We provide all the information about MCP servers via our MCP API.

                        curl -X GET 'https://glama.ai/api/mcp/v1/servers/rohitsingh-iitd/zillow-mcp-server'

                        If you have feedback or need assistance with the MCP directory API, please join our Discord server