zillow

The Zillow MCP Server provides real-time access to Zillow data via a Python-based MCP server built with FastMCP. It exposes tools and resources for property search, property details, Zestimate values, market trends, mortgage calculations, and health checks, enabling Claude and other clients to interact with Zillow data through standardized MCP functions. You can call search_properties, get_property_details, get_zestimate, get_market_trends, calculate_mortgage, and check_health, or retrieve server tools and resources like zillow://property/{id} and zillow://market-trends/{location}. For remote usage, you can also connect to an HTTP-enabled MCP server endpoint via the provided remote configuration.

To use it, ensure you have a valid Zillow Bridge API key configured in the environment (ZILLOW_API_KEY). The server uses this key to reach Zillow data and must be kept secure. When integrating with Claude Desktop, you can point Claude to the local Python MCP server or to a remote HTTP endpoint, depending on your deployment choice.

Prerequisites:

• Python 3.8 or higher
• pip (comes with Python)
• A Zillow Bridge API key (request access at api@bridgeinteractive.com)

Setup and installation:

1. Clone the repository and navigate to the project directory:

git clone https://github.com/yourusername/zillow-mcp-server.git
cd zillow-mcp-server

2. Install dependencies:

pip install -r requirements.txt

3. Create a .env file (or set environment variables) with your Zillow API key:

ZILLOW_API_KEY=your_zillow_api_key_here

4. Run the server locally (std IO):

python zillow_mcp_server.py

5. Optional HTTP/remote access: run in HTTP mode and specify a port:

python zillow_mcp_server.py --http --port 8000

6. Docker deployment (optional):

# Build the image
docker build -t zillow-mcp-server .

# Run with environment variable
docker run -p 8000:8000 -e ZILLOW_API_KEY=your_key_here zillow-mcp-server

Notes and tips:

• Ensure the ZILLOW_API_KEY is kept secret and not committed to version control.
• The server uses environment configuration; you can switch between stdio and HTTP modes as needed.
• If you encounter API rate limits, adjust request frequency or apply for higher quota via Zillow's Bridge API terms.
• When deploying the Docker image, you can supply an .env file to docker run with --env-file .env for convenience.
• For Claude Desktop, configure the local path to zillow_mcp_server.py or connect to a remote HTTP endpoint using the provided JSON configuration format.