Supports containerized deployment with Docker, enabling portable and isolated running of the Zillow MCP server with proper environment configuration.
Uses .env files for managing environment variables, particularly for securely storing the Zillow API key required for server operation.
Provides repository access via GitHub where users can clone the server code, access documentation, and potentially contribute to development.
Supports specific configuration for Claude Desktop on macOS, with detailed paths for configuration files to enable the Zillow MCP integration.
Built using Python and FastMCP, allowing for development of tools that interact with Zillow's Bridge API to retrieve and process real estate data.
Provides real-time access to Zillow real estate data, including property search, property details, Zestimates, market trends, and mortgage calculations.
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
- Python 3.8 or higher
- A Zillow Bridge API key (request access at api@bridgeinteractive.com)
Installation
- Clone this repository:
- Install the dependencies:
- Create a
.env
file with your Zillow API key:
Usage
Run the server with options:
You can also run the server using Docker:
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
For remote HTTP server:
Available Tools
search_properties
Search for properties based on various criteria:
Example usage in Claude:
get_property_details
Get detailed information about a specific property:
Example usage in Claude:
get_zestimate
Get Zillow's estimated value for a property:
Example usage in Claude:
get_market_trends
Get real estate market trends for a specific location:
Example usage in Claude:
calculate_mortgage
Calculate mortgage payments and related costs:
Example usage in Claude:
check_health
Verify the Zillow API connection and get server status:
Example usage in Claude:
get_server_tools
Get a list of all available tools on this server:
Example usage in Claude:
Resources
Get property information as a formatted text resource:
Get market trends information as a formatted text resource:
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
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
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.
Related MCP Servers
- AsecurityAlicenseAqualityThis server allows users to interact with their Zotero library through the Model Context Protocol, providing tools for searching items, retrieving metadata, and accessing full text using natural language queries.Last updated -397PythonMIT License
ZenML MCP Serverofficial
-securityAlicense-qualityA server implementing Model Context Protocol that enables LLMs to interact with the ZenML platform, providing access to pipeline data, stack information, and the ability to trigger new pipeline runs.Last updated -23PythonMIT LicenseJSer.info MCP Serverofficial
-securityAlicense-qualityA Model Context Protocol server that provides search and retrieval capabilities for JSer.info's JavaScript resource database, enabling access to items, posts, product information, and timeline data through various specialized tools.Last updated -121TypeScriptMIT License- -securityFlicense-qualityAn MCP server that connects to a SQLite database of Zillow real estate data, enabling users to explore property values, rent indexes, and forecasts through a chat interface to make informed investment decisions.Last updated -1Python