Zillow56 MCP Server
README.md
# Zillow56 MCP Server
[English](./README_EN.md) | 简体中文 | [繁體中文](./README_ZH-TW.md)
## 🚀 使用 EMCP 平台快速体验
**[EMCP](https://sit-emcp.kaleido.guru)** 是一个强大的 MCP 服务器管理平台，让您无需手动配置即可快速使用各种 MCP 服务器！
### 快速开始：
1. 🌐 访问 **[EMCP 平台](https://sit-emcp.kaleido.guru)**
2. 📝 注册并登录账号
3. 🎯 进入 **MCP 广场**，浏览所有可用的 MCP 服务器
4. 🔍 搜索或找到本服务器（`bach-zillow56`）
5. 🎉 点击 **"安装 MCP"** 按钮
6. ✅ 完成！即可在您的应用中使用
### EMCP 平台优势：
- ✨ **零配置**：无需手动编辑配置文件
- 🎨 **可视化管理**：图形界面轻松管理所有 MCP 服务器
- 🔐 **安全可靠**：统一管理 API 密钥和认证信息
- 🚀 **一键安装**：MCP 广场提供丰富的服务器选择
- 📊 **使用统计**：实时查看服务调用情况
立即访问 **[EMCP 平台](https://sit-emcp.kaleido.guru)** 开始您的 MCP 之旅！
---
## 简介
这是一个 MCP 服务器，用于访问 Zillow56 API。
- **PyPI 包名**: `bach-zillow56`
- **版本**: 2.0.0
- **传输协议**: stdio
## 安装
### 从 PyPI 安装:
```bash
pip install bach-zillow56
```
### 从源码安装:
```bash
pip install -e .
```
## 运行
### 方式 1: 使用 uvx（推荐，无需安装）
```bash
# 运行（uvx 会自动安装并运行）
uvx --from bach-zillow56 bach_zillow56
# 或指定版本
uvx --from bach-zillow56@latest bach_zillow56
```
### 方式 2: 直接运行（开发模式）
```bash
python server.py
```
### 方式 3: 安装后作为命令运行
```bash
# 安装
pip install bach-zillow56
# 运行（命令名使用下划线）
bach_zillow56
```
## 配置
### API 认证
此 API 需要认证。请设置环境变量:
```bash
export API_KEY="your_api_key_here"
```
### 环境变量
| 变量名 | 说明 | 必需 |
|--------|------|------|
| `API_KEY` | API 密钥 | 是 |
| `PORT` | 不适用 | 否 |
| `HOST` | 不适用 | 否 |
### 在 Claude Desktop 中使用
编辑 Claude Desktop 配置文件 `claude_desktop_config.json`:
```json
{
"mcpServers": {
"zillow56": {
"command": "uvx",
"args": ["--from", "bach-zillow56", "bach_zillow56"],
"env": {
"API_KEY": "your_api_key_here"
}
}
}
}
```
**注意**: 请将 `E:\path\to\zillow56\server.py` 替换为实际的服务器文件路径。
## 可用工具
此服务器提供以下工具:
### `search_polygon_search_for_properties_by_polygon`
Search for filtered properties by polygon coordinates. For a list of properties, you can select the output format (JSON , CSV , XLSX) using the optional \
**端点**: `GET /search_polygon`
**参数**:
- `polygon` (string) *必需*: It is required if the location is empty. Format: lat lng,lat1 lng1,lat2 lng2 34.03959576441558 -118.50636536779786,34.0418716916327 -118.50276047888184,34.042440663894304 -118.49846894445801,34.04201393505594 -118.49417741003418,34.04087598099002 -118.4897142142334,34.03945351693672 -118.48525101843262,34.03788877892429 -118.48095948400879,34.03618175908096 -118.47683961096192,34.034190192514366 -118.47271973791504,34.031629538228394 -118.46962983312989,34.02835747861639 -118.4677415579834,34.02
- `page` (string): Example value:
- `output` (string): Output format possible values : json (Default value) :Data in a JSON format csv : URL to the generated CSV file xlsx : URL to the generated XLSX (excel) file
- `status` (string): Status type of the properties Default : forSale -forSale -forRent -recentlySold
- `sortSelection` (string): Sorting possible values : days: Newest (Default value), saved: Date Saved, listingstatus: Listing Status, mostrecentchange: Most Recent Change, globalrelevanceex: Homes for You, featured: Verified Source, priced: Price (High to Low), pricea: Price (Low to High), paymentd: Payment (High to Low), paymenta: Payment (Low to High), beds: Bedrooms, baths: Bathrooms, size: Square Feet, lot: Lot Size, zest: Zestimate (High to Low), zesta: Zestimate (Low to High),
- `listing_type` (string): Listing Type possible values : by_agent : By agent (Default value) by_owner_other : By owner & other (for off market properties)
- `isSingleFamily` (string): Example value:
- `isMultiFamily` (string): Example value:
- `isApartment` (string): Example value:
- `isCondo` (string): Example value:
- `isManufactured` (string): Example value:
- `isTownhouse` (string): Example value:
- `isLotLand` (string): Example value:
- `doz` (string): Days on Zillow (For Sale/Rent listings)/ Sold In Last (Sold listings) Possible values : any: Any, 1: 1 day, 7: 7 days, 14: 14 days, 30: 30 days, 90: 90 days, 6m: 6 months, 12m: 12 months, 24m: 24 months, 36m: 36 months
- `price_min` (string): Example value:
- `price_max` (string): Example value:
- `sqft_min` (string): Example value:
- `sqft_max` (string): Example value:
- `monthlyPayment_min` (string): Example value:
- `monthlyPayment_max` (string): Example value:
- `beds_min` (string): Example value:
- `beds_max` (string): Example value:
- `baths_min` (string): Example value:
- `baths_max` (string): Example value:
- `hoa_min` (string): Example value:
- `hoa_max` (string): Example value:
- `hasPool` (string): Example value:
- `hasGarage` (string): Example value:
- `built_min` (string): Example value:
- `built_max` (string): Example value:
- `isForSaleByOwner` (string): Example value:
- `isForSaleByAgent` (string): Example value:
- `isCityView` (string): Example value:
- `isWaterfront` (string): Example value:
- `isPublicSchool` (string): Example value:
- `isPrivateSchool` (string): Example value:
- `isMountainView` (string): Example value:
- `singleStory` (string): Example value:
- `onlyPriceReduction` (string): Example value:
- `onlyRentalAcceptsApplications` (string): Example value:
- `isZillowOwnedOnly` (string): Example value:
- `hasAirConditioning` (string): Example value:
- `isMiddleSchool` (string): Example value:
- `isWaterView` (string): Example value:
- `onlyRentalIncomeRestricted` (string): Example value:
- `isComingSoon` (string): Example value:
- `isForSaleForeclosure` (string): Example value:
- `onlyWithPhotos` (string): Example value:
- `onlyRentalCatsAllowed` (string): Example value:
- `onlyRentalPetsAllowed` (string): Example value:
- `onlyRentalSmallDogsAllowed` (string): Example value:
- `onlyRentalLargeDogsAllowed` (string): Example value:
- `isAuction` (string): Example value:
- `is3dHome` (string): Example value:
- `isNewConstruction` (string): Example value:
- `parkingSpots_min` (string): Example value:
- `greatSchoolsRating_min` (string): Example value:
- `isElementarySchool` (string): Example value:
- `isParkView` (string): Example value:
- `enableSchools` (string): Example value:
- `lotSize_max` (string): in sqft
- `keywords` (string): Example value:
---
### `market_data_rental_market_trends`
Get market rental data of a location by city or ZIP
**端点**: `GET /market_data`
**参数**:
- `location` (string) *必需*: Example value: houston, tx
---
### `market_sale_overview`
This endpoint delivers a comprehensive snapshot and historical trends of the housing market in a given region using metrics aligned with the Zillow Home Value Index (ZHVI) framework
**端点**: `GET /market_sale_overview`
**参数**:
- `location` (string): Example value: houston,tx
---
### `zhvi_range`
This endpoint provides monthly historical data for the Zillow Home Value Index (ZHVI) for a specified region. The ZHVI is a proprietary metric that captures median home values across a wide variety of geographies and housing types, reflecting trends in the real estate market over time.
**端点**: `GET /zhvi_range`
**参数**:
- `location` (string) *必需*: Example value: 11771
- `type` (string): Home type
---
### `search_search_for_properties_by_neighborhood_city_or_zip_code`
Search for filtered properties by neighborhood, city, or ZIP code. PS : To search for an address of a property, use the \
**端点**: `GET /search`
**参数**:
- `location` (string) *必需*: Location can be an address, neighborhood, city, or ZIP code.
- `page` (string): Example value:
- `output` (string): Output format possible values : json (Default value) :Data in a JSON format csv : URL to the generated CSV file xlsx : URL to the generated XLSX (excel) file
- `status` (string): Status type of the properties Default : forSale -forSale -forRent -recentlySold
- `sortSelection` (string): Sorting possible values : days: Newest (Default value), saved: Date Saved, listingstatus: Listing Status, mostrecentchange: Most Recent Change, globalrelevanceex: Homes for You, featured: Verified Source, priced: Price (High to Low), pricea: Price (Low to High), paymentd: Payment (High to Low), paymenta: Payment (Low to High), beds: Bedrooms, baths: Bathrooms, size: Square Feet, lot: Lot Size, zest: Zestimate (High to Low), zesta: Zestimate (Low to High),
- `listing_type` (string): Listing Type possible values : by_agent : By agent (Default value) by_owner_other : By owner & other (for off market properties)
- `isSingleFamily` (string): Example value:
- `isMultiFamily` (string): Example value:
- `isApartment` (string): Example value:
- `isCondo` (string): Example value:
- `isManufactured` (string): Example value:
- `isTownhouse` (string): Example value:
- `isLotLand` (string): Example value:
- `doz` (string): Days on Zillow (For Sale/Rent listings)/ Sold In Last (Sold listings) Possible values : any: Any, 1: 1 day, 7: 7 days, 14: 14 days, 30: 30 days, 90: 90 days, 6m: 6 months, 12m: 12 months, 24m: 24 months, 36m: 36 months
- `price_min` (string): Example value:
- `price_max` (string): Example value:
- `sqft_min` (string): Example value:
- `sqft_max` (string): Example value:
- `monthlyPayment_min` (string): Example value:
- `monthlyPayment_max` (string): Example value:
- `beds_min` (string): Example value:
- `beds_max` (string): Example value:
- `baths_min` (string): Example value:
- `baths_max` (string): Example value:
- `hoa_min` (string): Example value:
- `hoa_max` (string): Example value:
- `hasPool` (string): Example value:
- `hasGarage` (string): Example value:
- `built_min` (string): Example value:
- `built_max` (string): Example value:
- `isForSaleByOwner` (string): Example value:
- `isForSaleByAgent` (string): Example value:
- `isCityView` (string): Example value:
- `isWaterfront` (string): Example value:
- `isPublicSchool` (string): Example value:
- `isPrivateSchool` (string): Example value:
- `isMountainView` (string): Example value:
- `singleStory` (string): Example value:
- `onlyPriceReduction` (string): Example value:
- `onlyRentalAcceptsApplications` (string): Example value:
- `isZillowOwnedOnly` (string): Example value:
- `hasAirConditioning` (string): Example value:
- `isMiddleSchool` (string): Example value:
- `isWaterView` (string): Example value:
- `onlyRentalIncomeRestricted` (string): Example value:
- `isComingSoon` (string): Example value:
- `isForSaleForeclosure` (string): Example value:
- `onlyWithPhotos` (string): Example value:
- `onlyRentalCatsAllowed` (string): Example value:
- `onlyRentalPetsAllowed` (string): Example value:
- `onlyRentalSmallDogsAllowed` (string): Example value:
- `onlyRentalLargeDogsAllowed` (string): Example value:
- `isAuction` (string): Example value:
- `is3dHome` (string): Example value:
- `isNewConstruction` (string): Example value:
- `parkingSpots_min` (string): Example value:
- `greatSchoolsRating_min` (string): Example value:
- `isElementarySchool` (string): Example value:
- `isParkView` (string): Example value:
- `enableSchools` (string): Example value:
- `lotSize_min` (string): in sqft
- `lotSize_max` (string): in sqft
- `keywords` (string): Example value:
---
### `mortgagerates_mortgage_rates`
Get mortgage rates
**端点**: `GET /mortgage/rates`
**参数**:
- `program` (string) *必需*: The loan program. You can select one or two programs, separated by commas. Available: Fixed30Year, Fixed20Year, Fixed15Year, Fixed10Year, ARM3, ARM5, ARM7, HomeEquity30Year, HomeEquity30YearDueIn15, HomeEquity15Year, HELOC20Year, HELOC15Year, HELOC10Year
- `state` (string): The state abbreviation. AK,AL,AR,AS,AZ,CA,CO,CT,DC,DE,FL,GA, GU,HI,IA,ID,IL,IN,KS,KY,LA,MA,MD,ME,MH, MI,MN,MO,MP,MS,MT,NC,ND,NE, NH,NJ,NM,NV,NY,OH,OK,OR,PA,PR,RI,SC,SD,TN,TX,UT,VA,VI,VT,WA,WI,WV,WY,US
- `refinance` (string): Example value:
- `loanType` (string): Example value:
- `loanAmount` (string): Micro < $100,000 SmallConforming $100,000 - $200,000 Conforming > $200,000 SuperConforming Jumbo
- `loanToValue` (string): Normal < 80% High > 80% < 95% VeryHigh >= 95%
- `creditScore` (string): Low < 680 credit score. High > 680 < 740 VeryHigh > 740
- `duration` (string): From 0 to 4000
---
### `buildersdetails_builders_details`
Get details of builders by their builderId (found in `builders/search` results)
**端点**: `GET /builders/details`
**参数**:
- `builderId` (string) *必需*: Example value: 14987
---
### `builderscommunity_cards_builders_community_cards`
Get community cards of a builder by their builderId (found in `builders/search` results)
**端点**: `GET /builders/community_cards`
**参数**:
- `builderId` (string) *必需*: Example value: 14987
- `regionId` (string): Example value:
- `page` (string): Example value:
---
### `buildersreviews_builders_reviews`
Get reviews of a builder by their builderId (found in `builders/search` results)
**端点**: `GET /builders/reviews`
**参数**:
- `builderId` (string) *必需*: Example value: 14987
- `regionId` (string): Example value:
- `page` (string): Example value:
---
### `builderssearch_search_for_builders`
Searchfor builders by location or name
**端点**: `GET /builders/search`
**参数**:
- `location` (string): Example value: Houston,Tx
- `name` (string): Example value:
- `page` (string): Example value:
---
### `other_professionalsreviews_professionals_reviews`
Get reviews of a professional by their zuid (found in `/other_professionals/details` result)
**端点**: `GET /other_professionals/reviews`
**参数**:
- `zuid` (string) *必需*: Example value: X1-ZU1328lo3ng72mh_5xifh
- `page` (string): Example value:
- `size` (string): Example value:
---
### `other_professionalsdetails_professionals_details`
Get details of a professional by username (found in `/other_professionals/search` results)
**端点**: `GET /other_professionals/details`
**参数**:
- `username` (string) *必需*: Example value: InnerLoopHomes
---
### `other_professionalssearch_search_for_professionals`
Search for professoinals (property managers, inspectors,photographers,home_improvement,etc) by location or name
**端点**: `GET /other_professionals/search`
**参数**:
- `location` (string): Example value: Houston,tx
- `type` (string) *必需*: Example value:
- `name` (string): Example value:
- `page` (string): Example value:
---
### `walk_transit_bike_score_walk_transit_and_bike_score`
Get Walk, Transit and Bike Score of a property by zpid
**端点**: `GET /walk_transit_bike_score`
**参数**:
- `zpid` (string): The zpid can be extracted from the searching endpoints (/search , /search_url…), or from a property's URL.
- `url` (string): Property details URL - eg :https://www.zillow.com/homedetails/15626-Laurel-Heights-Dr-Houston-TX-77084/28253016_zpid/
---
### `schools_nearby_schools`
Nearby schools of a property by ZPID
**端点**: `GET /schools`
**参数**:
- `zpid` (string): The zpid can be extracted from the searching endpoints (/search , /search_url…), or from a property's URL.
- `url` (string): Property details URL - eg :https://www.zillow.com/homedetails/15626-Laurel-Heights-Dr-Houston-TX-77084/28253016_zpid/
---
### `photos_photos_of_a_property`
Returns a property's photos with different sizes and types.
**端点**: `GET /photos`
**参数**:
- `zpid` (string): The zpid can be extracted from the searching endpoints (/search , /search_url…), or from a property's URL.
- `url` (string): Property details URL - eg :https://www.zillow.com/homedetails/15626-Laurel-Heights-Dr-Houston-TX-77084/28253016_zpid/
---
### `property_deprecated`
Get a property's details by its zpid
**端点**: `GET /property`
**参数**:
- `zpid` (string): The zpid can be extracted from the searching endpoints (/search , /search_url…), or from a property's URL.
- `url` (string): Property details URL - eg :https://www.zillow.com/homedetails/15626-Laurel-Heights-Dr-Houston-TX-77084/28253016_zpid/
---
### `propertyv2_property_details_by_zpid`
Get a property's details by its zpid
**端点**: `GET /propertyV2`
**参数**:
- `zpid` (string): The zpid can be extracted from the searching endpoints (/search , /search_url…), or from a property's URL.
- `url` (string): Property details URL - eg :https://www.zillow.com/homedetails/15626-Laurel-Heights-Dr-Houston-TX-77084/28253016_zpid/
---
### `lenderreviews`
Get lender reviews
**端点**: `GET /lender/reviews`
**参数**:
- `screenName` (string) *必需*: Example value: mortgagecapitalpartners
- `page` (string): Example value:
---
### `lenderdetails`
Get lender details
**端点**: `GET /lender/details`
**参数**:
- `screenName` (string) *必需*: Example value: mortgagecapitalpartners
---
### `lendersearch`
Search for Lenders
**端点**: `GET /lender/search`
**参数**:
- `location` (string) *必需*: City, State or Zip. Only lenders licensed in the state will be displayed.
- `lenderName` (string): Example value:
- `page` (string): Example value:
---
### `similar_rent_properties_similar_for_rent_properties`
List of similar for rent properties by Zpid or URL or address
**端点**: `GET /similar_rent_properties`
**参数**:
- `zpid` (string): The zpid can be extracted from the searching endpoints (/search , /search_url...), or from a property's URL.
- `url` (string): Property details URL - eg :https://www.zillow.com/homedetails/15626-Laurel-Heights-Dr-Houston-TX-77084/28253016_zpid/
- `address` (string): Example value:
---
### `search_coordinates_search_for_properties_by_coordinates`
Search for filtered properties by coordinates. You can select the output format (JSON , CSV , XLSX) using the optional \
**端点**: `GET /search_coordinates`
**参数**:
- `lat` (string) *必需*: Latitude
- `long` (string) *必需*: Longitude
- `page` (string): Example value:
- `status` (string): Status type of the properties Default : forSale -forSale -forRent -recentlySold
- `output` (string): Output format possible values : json (Default value) :Data in a JSON format csv : URL to the generated CSV file xlsx : URL to the generated XLSX (excel) file
- `sort` (string): Sorting possible values : priorityscore: Default, saved: Date Saved, listingstatus: Listing Status, mostrecentchange: Most Recent Change, globalrelevanceex: Homes for You, featured: Verified Source, priced: Price (High to Low), pricea: Price (Low to High), paymentd: Payment (High to Low), paymenta: Payment (Low to High), days: Newest, beds: Bedrooms, baths: Bathrooms, size: Square Feet, lot: Lot Size, zest: Zestimate (High to Low), zesta: Zestimate (Low to High),
- `listing_type` (string): Listing Type possible values : By agent (Default value) By owner & other (for off market properties)
- `isSingleFamily` (string): Example value:
- `isMultiFamily` (string): Example value:
- `isApartment` (string): Example value:
- `isCondo` (string): Example value:
- `isManufactured` (string): Example value:
- `isTownhouse` (string): Example value:
- `isLotLand` (string): Example value:
- `doz` (string): Days on Zillow possible values : any: Any, 1: 1 day, 7: 7 days, 14: 14 days, 30: 30 days, 90: 90 days, 6m: 6 months, 12m: 12 months, 24m: 24 months, 36m: 36 months
- `price_min` (string): Example value:
- `price_max` (string): Example value:
- `sqft_min` (string): Example value:
- `sqft_max` (string): Example value:
- `monthlyPayment_min` (string): Example value:
- `monthlyPayment_max` (string): Example value:
- `beds_min` (string): Example value:
- `beds_max` (string): Example value:
- `baths_min` (string): Example value:
- `baths_max` (string): Example value:
- `hoa_min` (string): Example value:
- `hoa_max` (string): Example value:
- `hasPool` (string): Example value:
- `hasGarage` (string): Example value:
- `built_min` (string): Example value:
- `built_max` (string): Example value:
- `isForSaleByOwner` (string): Example value:
- `isForSaleByAgent` (string): Example value:
- `isCityView` (string): Example value:
- `isWaterfront` (string): Example value:
- `isPublicSchool` (string): Example value:
- `isPrivateSchool` (string): Example value:
- `isMountainView` (string): Example value:
- `singleStory` (string): Example value:
- `onlyPriceReduction` (string): Example value:
- `onlyRentalAcceptsApplications` (string): Example value:
- `isZillowOwnedOnly` (string): Example value:
- `hasAirConditioning` (string): Example value:
- `isMiddleSchool` (string): Example value:
- `isWaterView` (string): Example value:
- `onlyRentalIncomeRestricted` (string): Example value:
- `isComingSoon` (string): Example value:
- `isForSaleForeclosure` (string): Example value:
- `onlyWithPhotos` (string): Example value:
- `onlyRentalCatsAllowed` (string): Example value:
- `onlyRentalPetsAllowed` (string): Example value:
- `onlyRentalSmallDogsAllowed` (string): Example value:
- `onlyRentalLargeDogsAllowed` (string): Example value:
- `isAuction` (string): Example value:
- `is3dHome` (string): Example value:
- `isNewConstruction` (string): Example value:
- `greatSchoolsRating_min` (string): Example value:
- `isElementarySchool` (string): Example value:
- `isParkView` (string): Example value:
- `enableSchools` (string): Example value:
- `keywords` (string): Example value:
---
### `search_url_list_of_properties_by_url`
Get a list of properties by providing the zillow search results URL You can select the output format (JSON , CSV , XLSX) using the optional \
**端点**: `GET /search_url`
**参数**:
- `url` (string) *必需*: Example value: https://www.zillow.com/homes/for_sale/2_p/?searchQueryState=%7B%22pagination%22%3A%7B%22currentPage%22%3A2%7D%2C%22mapBounds%22%3A%7B%22west%22%3A-112.39143704189931%2C%22east%22%3A-110.78468655361806%2C%22south%22%3A32.79032628812945%2C%22north%22%3A33.7227901388417%7D%2C%22isMapVisible%22%3Atrue%2C%22filterState%22%3A%7B%22con%22%3A%7B%22value%22%3Afalse%7D%2C%22apa%22%3A%7B%22value%22%3Afalse%7D%2C%22mf%22%3A%7B%22value%22%3Afalse%7D%2C%22ah%22%3A%7B%22value%22%3Atrue%7D%2C%22sort%22%3A%7B%22value%22%3A%22globalrelevanceex%22%7D%2C%22land%22%3A%7B%22value%22%3Afalse%7D%2C%22manu%22%3A%7B%22value%22%3Afalse%7D%2C%22apco%22%3A%7B%22value%22%3Afalse%7D%7D%2C%22isListVisible%22%3Atrue%7D
- `page` (string): Example value: 3
- `output` (string): Output format possible values : json (Default value) :Data in a JSON format csv : URL to the generated CSV file xlsx : URL to the generated XLSX (excel) file
- `listing_type` (string): Listing Type possible values : By agent (Default value) By owner & other (for off market properties)
---
### `search_mls_search_by_mls`
Search for properties by their MLS ID.
**端点**: `GET /search_mls`
**参数**:
- `mls` (string) *必需*: Example value: SR25078433
---
### `agent_details_by_username`
Get agent's details by username(contact infos, active listings and reviews etc). PS : username is the profile link Example : username : Pardee-Properties for https://www.zillow.com/profile/Pardee-Properties/
**端点**: `GET /agent`
**参数**:
- `username` (string) *必需*: Example value: Pardee-Properties
---
### `agents_rental_listings`
Get agent's rental listings by zuid
**端点**: `GET /agent_rental_listings`
**参数**:
- `zuid` (string) *必需*: Example value: X1-ZUz0nmomozy2o9_9bpwk
- `page` (string): Example value:
---
### `agent_reviews`
Get agent reviews by the agent's zuid
**端点**: `GET /agent_reviews`
**参数**:
- `zuid` (string) *必需*: Example value: X1-ZUz0nmomozy2o9_9bpwk
- `page` (string): Example value:
---
### `agents_active_listings`
Get agent's active listings by zuid
**端点**: `GET /agent_active_listings`
**参数**:
- `zuid` (string) *必需*: Example value: X1-ZUz0nmomozy2o9_9bpwk
- `page` (string): Example value:
---
### `search_for_agents`
Search for agents by location and name
**端点**: `GET /search_agents`
**参数**:
- `location` (string) *必需*: Example value: houston, tx
- `name` (string): Example value:
- `page` (string): Example value:
- `specialty` (string): Example value:
- `language` (string): Example value:
---
### `agents_past_sales`
Get agent's past sales by zuid
**端点**: `GET /agent_past_sales`
**参数**:
- `zuid` (string) *必需*: The zuid can be extracted from the agent's details \"/agent\"
- `page` (string): Example value:
---
### `similar_sold_properties_similar_sold_properties`
List of similar sold properties by Zpid or URL or address
**端点**: `GET /similar_sold_properties`
**参数**:
- `zpid` (string): The zpid can be extracted from the searching endpoints (/search , /search_url...), or from a property's URL.
- `url` (string): Property details URL - eg :https://www.zillow.com/homedetails/15626-Laurel-Heights-Dr-Houston-TX-77084/28253016_zpid/
- `address` (string): Example value:
---
### `similar_properties_similar_for_sale_properties`
List of similar for sale properties by Zpid or URL or address
**端点**: `GET /similar_properties`
**参数**:
- `zpid` (string): The zpid can be extracted from the searching endpoints (/search , /search_url...), or from a property's URL.
- `url` (string): Property details URL - eg :https://www.zillow.com/homedetails/15626-Laurel-Heights-Dr-Houston-TX-77084/28253016_zpid/
- `address` (string): Example value:
---
### `price_tax_history_price_and_tax_history`
Price and Tax history of a property by ZPID
**端点**: `GET /price_tax_history`
**参数**:
- `zpid` (string): The zpid can be extracted from the searching endpoints (/search , /search_url…), or from a property's URL.
- `url` (string): Property details URL - eg :https://www.zillow.com/homedetails/15626-Laurel-Heights-Dr-Houston-TX-77084/28253016_zpid/
---
### `rent_estimate_rent_zestimate`
Returns a property's rent zestimate and it's comparable properties in the same area.
**端点**: `GET /rent_estimate`
**参数**:
- `address` (string) *必需*: Example value: 1545 Yale St, Santa Monica, CA 90404
- `activeTypes` (string): SimilarFloorPlans filter: Possible values: any (Default) active (Active Rentals) inactive (Inactive Rentals)
- `activatedDays` (string): [SIMILARFLOORPLANS] Filter for Active Rentals within X days: Possible values: any (Default) 30 (Within 30 days) 15 (Within 15 days) 7 (Within 7 days)
- `deactivatedDays` (string): [SIMILARFLOORPLANS] Filter for inactive rentals within X days: Possible values: 30 (Within 30 days (max)) 15 (Within 15 days) 7 (Within 7 days)
- `distanceInMiles` (string): [SIMILARFLOORPLANS] Filter for distance in Miles: Possible values: any 1 2 3 4 5
- `propertyTypes` (string): [SIMILARFLOORPLANS] Filter for Property Types: (To choose multiple values separate with comma eg : house,condo) Possible values: any (Default) apartment house townhouse condo
- `bedrooms` (string): [SIMILARFLOORPLANS] Filter for number of bedrooms: (To choose multiple values separate with comma eg : 0,1,2) Possible values: 0 1 2 3 4plus
- `pets` (string): [SIMILARFLOORPLANS] Filter for Pets: (To choose multiple values separate with comma eg : dogs,cats) Possible values: any (Default) dogs cats
- `laundry` (string): [SIMILARFLOORPLANS] Filter for Laundry: (To choose multiple values separate with comma eg : inUnit,shared) Possible values: any (Default) inUnit shared
- `amenities` (string): [SIMILARFLOORPLANS] Filter for amenities: (To choose multiple values separate with comma eg : cooling,parking) Possible values: any (Default) cooling heating parking
---
### `zestimate_history_zestimate_history`
Zestimate history by zpid
**端点**: `GET /zestimate_history`
**参数**:
- `zpid` (string): The zpid can be extracted from the searching endpoints (/search , /search_url…), or from a property's URL.
- `url` (string): Property details URL - eg :https://www.zillow.com/homedetails/15626-Laurel-Heights-Dr-Houston-TX-77084/28253016_zpid/
---
### `search_address_search_for_a_property_by_address`
Search for a property by address.
**端点**: `GET /search_address`
**参数**:
- `address` (string) *必需*: Example value: 1161 Natchez Dr College Station Texas 77845
---
## 技术栈
- **传输协议**: stdio
- **HTTP 客户端**: httpx
## 开发
此服务器由 [API-to-MCP](https://github.com/BACH-AI-Tools/api-to-mcp) 工具自动生成。
版本: 2.0.0
TDQS
C2.6/5.0
Scored across 37 tools
Disambiguation3/5
Most tools target distinct resources like agents, builders, properties, or market data, but there is notable overlap in search tools (e.g., search_address_search_for_a_property_by_address, search_coordinates_search_for_properties_by_coordinates, search_search_for_properties_by_neighborhood_city_or_zip) that could confuse agents on which to use for location-based queries. Additionally, property_deprecated and propertyv2_property_details_by_zpid serve similar purposes, though the deprecated tag helps clarify.
Naming Consistency2/5
Naming is highly inconsistent with mixed patterns: some use snake_case (agent_details_by_username), some use camelCase-like concatenation (builderscommunity_cards_builders_community_cards), and others have verbose, redundant names (search_address_search_for_a_property_by_address). There is no uniform verb_noun structure, making it hard to predict tool names.
Tool Count2/5
With 37 tools, the count is excessive for a real estate data server, leading to bloat and potential confusion. Many tools could be consolidated (e.g., multiple similar property search variants), and the high number suggests poor scoping, making it cumbersome for agents to navigate efficiently.
Completeness4/5
The tool set covers a broad range of real estate domains including agents, builders, lenders, properties, market data, and searches, with good CRUD-like coverage for details, reviews, and listings. Minor gaps exist, such as lack of tools for updating or deleting data (likely read-only by design), but overall it provides comprehensive access to Zillow's data surface.
Maintenance
ActivityInactive
ResponsivenessNo issues