home / mcp / zillow mcp server

Zillow MCP Server

Provides real-time access to Zillow data via MCP, including property search, details, Zestimate, market trends, and mortgage calculations.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "rohitsingh-iitd-zillow-mcp-server": {
      "url": "https://your-mcp-server-url.com/sse",
      "headers": {
        "ZILLOW_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

This MCP server gives you real-time access to Zillow data through a flexible Model Context Protocol interface. It lets you search properties, fetch property details, view market trends, obtain valuations, and calculate mortgage payments, all while offering health checks and remote access options for integration with your MCP client.

How to use

You can connect to Zillow MCP in two primary ways: a local, stdio-based run on your machine or a remote HTTP endpoint you expose for others to access. In both modes, you interact with a consistent set of tools to search properties, retrieve details, get Zillow estimates, inspect market trends, and perform mortgage calculations. Use the remote HTTP endpoint if you want to integrate with Claude Desktop or other clients over the network. Use the local stdio mode when running directly on your machine or within environments that support stdio MCP connections.

Available operations you can perform include: searching properties by location and price range, getting detailed property information, obtaining Zillow valuations (Zestimates), retrieving real estate market trends, and calculating mortgage payments. You can also verify connectivity with a health check and discover all available server tools.

How to install

Prerequisites you need before installation:

Python 3.8 or higher
A Zillow Bridge API key

Step-by-step setup on your machine:

# 1. Clone the MCP server repository
git clone https://github.com/rohitsingh-iitd/zillow-mcp-server
cd zillow-mcp-server

# 2. Install Python dependencies
pip install -r requirements.txt

# 3. Create a local environment file with your Zillow API key
# Place your actual key in place of YOUR_KEY_HERE
ZILLOW_API_KEY=YOUR_KEY_HERE

Configure the API key in an environment file or export it in your shell before starting the server.

Starting in standard stdio mode (local, interactive):

python zillow_mcp_server.py

Starting in HTTP server mode (remote access):

python zillow_mcp_server.py --http --port 8000

Optionally, run in debug mode for verbose logging to help diagnose issues:

python zillow_mcp_server.py --debug

If you prefer containerized deployment, you can build and run the server with Docker. Use your actual API key when launching the container.

# 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 zillow-mcp-server

# Or using an env file
docker run -p 8000:8000 --env-file .env zillow-mcp-server

Additional configuration and notes

Environment variables you will work with include the Zillow API key required to access the Bridge API. You can supply this key in a dedicated environment file or pass it at runtime when launching the server.

For Claude Desktop integration, you can point to the local server or remote endpoint using the provided configuration examples. The local stdio configuration starts the Python runtime with the path to the MCP server script, while the remote example uses a network URL to access the HTTP endpoint.

Key features supported by this MCP server include property search, property details, Zestimate access, market trends, mortgage calculations, and health checks to monitor connectivity and performance.

Security and usage considerations: respect data usage limits and attribution guidelines where applicable. Ensure you have proper authorization for data access and comply with any terms of service for data sources.

Health and reliability: the server includes automatic retries with exponential backoff, detailed logging, rate limit handling, and timeouts to promote resilient operation.

Recommended practice is to use the remote HTTP endpoint for integration with clients that support MCP over HTTP, and to use the local stdio setup for development and testing on your workstation.

Resources

Benefit from structured access to property information and market insights through clearly defined tools and endpoints.

Available tools

search_properties

Search for properties by location, price range, and filtering criteria such as beds, baths, and home types.

get_property_details

Retrieve detailed information for a specified property by ID or address.

get_zestimate

Fetch Zillow's estimated value (Zestimate) for a given property.

get_market_trends

Get real estate market trends for a location, including metrics like median prices and days on market.

calculate_mortgage

Compute mortgage payments given price, down payment, loan term, interest rate, taxes, and insurance.

check_health

Perform a health check to verify connectivity to Zillow API and monitor server status.

get_server_tools

List all available MCP tools exposed by this server.