{
  "server": {
    "name": "housedata-zillow",
    "title": "HouseData — Zillow data",
    "endpoint": "https://mcp.housedata.dev/mcp",
    "transport": "streamable-http",
    "auth": "none",
    "payment": {
      "protocol": "x402",
      "asset": "USDC",
      "chain": "Base"
    }
  },
  "groups": [
    {
      "id": "search",
      "title": "Search and places",
      "min_usd": 0.005,
      "max_usd": 0.01
    },
    {
      "id": "property",
      "title": "Property records",
      "min_usd": 0.005,
      "max_usd": 0.01
    },
    {
      "id": "valuation",
      "title": "Zestimate and comps",
      "min_usd": 0.01,
      "max_usd": 0.01
    },
    {
      "id": "agents",
      "title": "Agents",
      "min_usd": 0.01,
      "max_usd": 0.01
    },
    {
      "id": "market",
      "title": "Market and rates",
      "min_usd": 0.005,
      "max_usd": 0.01
    },
    {
      "id": "rentals",
      "title": "Rental buildings",
      "min_usd": 0.01,
      "max_usd": 0.02
    }
  ],
  "tools": [
    {
      "name": "zillow_search_listings",
      "group": "search",
      "title": "Search listings",
      "description": "Listings for a place typed as on Zillow — a city (Austin, TX), a ZIP, a neighborhood or a county — for sale, for rent or recently sold. One row per listing with its zpid, address, price, beds, baths, living area, days on Zillow and Zestimate; up to 40 per page and 1,000 per search (page x pageSize). Rentals come back as buildings (resultType propertyGroup, with a buildingId) and single homes (property). Sort daysOn ascending for newest first.",
      "price_usd": 0.01,
      "params": [
        {
          "name": "location",
          "type": "string",
          "required": false,
          "description": "A city, ZIP, neighborhood or county as typed into Zillow. Required unless regionId is given."
        },
        {
          "name": "regionId",
          "type": "string",
          "required": false,
          "description": "A Zillow region id from zillow_autocomplete_places or zillow_region, instead of location."
        },
        {
          "name": "status",
          "type": "string",
          "required": false,
          "description": "forSale (default), forRent or sold.",
          "enum": [
            "forSale",
            "forRent",
            "sold"
          ],
          "default": "forSale"
        },
        {
          "name": "sort",
          "type": "string",
          "required": false,
          "description": "Zillow's sort orders; daysOn with sortAscending true is newest first.",
          "enum": [
            "relevance",
            "daysOn",
            "price",
            "beds",
            "baths",
            "livingArea",
            "lotArea",
            "yearBuilt",
            "recentlyChanged",
            "featured",
            "rentalPriorityScore"
          ]
        },
        {
          "name": "sortAscending",
          "type": "boolean",
          "required": false,
          "description": "Reverse the sort; false by default.",
          "default": false
        },
        {
          "name": "page",
          "type": "int",
          "required": false,
          "description": "Page number; page x pageSize must not exceed 1,000.",
          "min": 1,
          "default": 1
        },
        {
          "name": "pageSize",
          "type": "int",
          "required": false,
          "description": "Rows per page, up to 40.",
          "min": 1,
          "max": 40,
          "default": 20
        }
      ]
    },
    {
      "name": "zillow_autocomplete_places",
      "group": "search",
      "title": "Autocomplete places",
      "description": "The regions Zillow knows for a partial place name — cities, ZIPs, neighborhoods, counties — each with its region id, type and centre. What a search box needs before zillow_search_listings, and the way to a regionId.",
      "price_usd": 0.005,
      "params": [
        {
          "name": "q",
          "type": "string",
          "required": true,
          "description": "The partial place name, as a person would type it."
        },
        {
          "name": "types",
          "type": "string",
          "required": false,
          "description": "Comma-separated region types to keep, e.g. city,zipcode,neighborhood.",
          "default": "REGIONS"
        },
        {
          "name": "count",
          "type": "int",
          "required": false,
          "description": "How many suggestions to return.",
          "min": 1,
          "max": 20,
          "default": 5
        }
      ]
    },
    {
      "name": "zillow_region",
      "group": "search",
      "title": "Region lookup",
      "description": "A place name resolved to Zillow's region — id, type, parent state and city, centre and the exact bounding rectangle search uses — or a region id described. Give location or regionId.",
      "price_usd": 0.005,
      "params": [
        {
          "name": "location",
          "type": "string",
          "required": false,
          "description": "A place name to resolve, as typed into Zillow."
        },
        {
          "name": "regionId",
          "type": "string",
          "required": false,
          "description": "A Zillow region id to describe, instead of location."
        }
      ]
    },
    {
      "name": "zillow_property",
      "group": "property",
      "title": "Property record",
      "description": "The record for any zpid, listed or off market — every zpid has one. Compact: the headline (status, price, Zestimate, rent Zestimate, address, coordinates, beds, baths, living area, year built, home type, lot, HOA, days on Zillow, hero photo). expand true: everything — 23 facts, price and tax history, schools with ratings, listing agent and broker, MLS, walk/transit/bike scores, nearby homes, open houses, description and the photo gallery (~17 KB).",
      "price_usd": 0.01,
      "params": [
        {
          "name": "zpid",
          "type": "string",
          "required": true,
          "description": "The Zillow property id — the number before _zpid in any Zillow property URL, and on every search row."
        }
      ]
    },
    {
      "name": "zillow_property_facts",
      "group": "property",
      "title": "Property facts",
      "description": "The facts for one home: beds, baths, living area, lot, year built, home type, parking, heating and cooling, HOA, price per square foot, and the rest of Zillow's fact sheet — with the current status and price.",
      "price_usd": 0.005,
      "params": [
        {
          "name": "zpid",
          "type": "string",
          "required": true,
          "description": "The Zillow property id."
        }
      ]
    },
    {
      "name": "zillow_price_history",
      "group": "property",
      "title": "Price history",
      "description": "Every listing, price cut, pending, sale and delisting Zillow records for a home, newest first, with the price, the change and the source.",
      "price_usd": 0.005,
      "params": [
        {
          "name": "zpid",
          "type": "string",
          "required": true,
          "description": "The Zillow property id."
        }
      ]
    },
    {
      "name": "zillow_tax_history",
      "group": "property",
      "title": "Tax history",
      "description": "Assessed value and tax paid by year for a home, as far back as Zillow records them.",
      "price_usd": 0.005,
      "params": [
        {
          "name": "zpid",
          "type": "string",
          "required": true,
          "description": "The Zillow property id."
        }
      ]
    },
    {
      "name": "zillow_schools",
      "group": "property",
      "title": "Assigned schools",
      "description": "The schools assigned to a home — name, level, grades, distance and GreatSchools rating.",
      "price_usd": 0.005,
      "params": [
        {
          "name": "zpid",
          "type": "string",
          "required": true,
          "description": "The Zillow property id."
        }
      ]
    },
    {
      "name": "zillow_scores",
      "group": "property",
      "title": "Walk, transit and bike scores",
      "description": "Walk Score, Transit Score and Bike Score for a home's location, with their descriptions.",
      "price_usd": 0.005,
      "params": [
        {
          "name": "zpid",
          "type": "string",
          "required": true,
          "description": "The Zillow property id."
        }
      ]
    },
    {
      "name": "zillow_nearby_homes",
      "group": "property",
      "title": "Nearby homes",
      "description": "Homes Zillow shows near this one, each with zpid, address, price, beds, baths, living area and status.",
      "price_usd": 0.005,
      "params": [
        {
          "name": "zpid",
          "type": "string",
          "required": true,
          "description": "The Zillow property id."
        }
      ]
    },
    {
      "name": "zillow_photos",
      "group": "property",
      "title": "Photo gallery",
      "description": "The photo gallery for a home — one URL per photo, in order, with the hero photo first. size full adds every size Zillow serves for each photo.",
      "price_usd": 0.005,
      "params": [
        {
          "name": "zpid",
          "type": "string",
          "required": true,
          "description": "The Zillow property id."
        },
        {
          "name": "size",
          "type": "string",
          "required": false,
          "description": "full to add every image size Zillow serves (larger answer).",
          "enum": [
            "full"
          ]
        }
      ]
    },
    {
      "name": "zillow_zestimate",
      "group": "valuation",
      "title": "Zestimate and history",
      "description": "The Zestimate for any zpid, listed or not: the value with its low and high, the value 30 days ago, the rent Zestimate, and zestimateHistory — one point a month for about ten years — plus the home's price history. Null where Zillow publishes no Zestimate; nothing is estimated in its place.",
      "price_usd": 0.01,
      "params": [
        {
          "name": "zpid",
          "type": "string",
          "required": true,
          "description": "The Zillow property id."
        }
      ]
    },
    {
      "name": "zillow_comps",
      "group": "valuation",
      "title": "Comparable homes",
      "description": "The comparable homes Zillow uses to value this one — each with zpid, address, price, beds, baths, living area, distance and sale date where sold.",
      "price_usd": 0.01,
      "params": [
        {
          "name": "zpid",
          "type": "string",
          "required": true,
          "description": "The Zillow property id."
        }
      ]
    },
    {
      "name": "zillow_listing_agent",
      "group": "agents",
      "title": "Listing agent",
      "description": "The listing agent's full profile for a listed home — name, license, phone, email, website, brokerage, bio, social links, Zillow rating and review count — with the broker and the MLS id. Agent fields are null on a home with no active listing. Personal data: handle it as such.",
      "price_usd": 0.01,
      "params": [
        {
          "name": "zpid",
          "type": "string",
          "required": true,
          "description": "The Zillow property id of a listed home."
        }
      ]
    },
    {
      "name": "zillow_top_agents",
      "group": "agents",
      "title": "Top agents nearby",
      "description": "The agents Zillow ranks around a home by sales in the past year: name, Zillow id, sales count, min/max/average/median sale price, sales in this price range, bio and profile. Who actually sells here.",
      "price_usd": 0.01,
      "params": [
        {
          "name": "zpid",
          "type": "string",
          "required": true,
          "description": "The Zillow property id."
        }
      ]
    },
    {
      "name": "zillow_market_stats",
      "group": "market",
      "title": "Market statistics",
      "description": "Monthly market statistics for a region, newest first: market temperature with Zillow's buyer/seller label, for-sale inventory, new listings, new pending, median days to pending, and the share sold above and below list — up to 100 months. Give location (a place name) or regionId; `latest` carries the newest row of each series.",
      "price_usd": 0.01,
      "params": [
        {
          "name": "location",
          "type": "string",
          "required": false,
          "description": "A city, ZIP, neighborhood, county or metro as typed into Zillow."
        },
        {
          "name": "regionId",
          "type": "string",
          "required": false,
          "description": "A Zillow region id, instead of location."
        },
        {
          "name": "months",
          "type": "int",
          "required": false,
          "description": "How many months back, up to 100 (default 12).",
          "min": 1,
          "max": 100,
          "default": 12
        }
      ]
    },
    {
      "name": "zillow_mortgage_rates",
      "group": "market",
      "title": "Mortgage rates today",
      "description": "Today's mortgage rates as Zillow lists them — product (30-year fixed, FHA, VA, 15-year, ARMs), rate and APR, with Zillow's tag for each.",
      "price_usd": 0.005,
      "params": []
    },
    {
      "name": "zillow_building",
      "group": "rentals",
      "title": "Rental building",
      "description": "A rental building — name, address, description, amenities, unit and floor-plan counts, rent range and photos — by buildingId (from a forRent search row with resultType propertyGroup) or by lat and lng.",
      "price_usd": 0.01,
      "params": [
        {
          "name": "buildingId",
          "type": "string",
          "required": false,
          "description": "The building id from a rental search row (resultType propertyGroup)."
        },
        {
          "name": "lat",
          "type": "number",
          "required": false,
          "description": "Latitude, with lng, instead of buildingId."
        },
        {
          "name": "lng",
          "type": "number",
          "required": false,
          "description": "Longitude, with lat, instead of buildingId."
        }
      ]
    },
    {
      "name": "zillow_floor_plans",
      "group": "rentals",
      "title": "Floor plans and units",
      "description": "Every floor plan of a rental building — name, beds, baths, square feet, rent range, lease term — and the units available under each, with unit number, price, square feet and move-in date. Compact drops photo and tour links; expand true keeps them.",
      "price_usd": 0.02,
      "params": [
        {
          "name": "buildingId",
          "type": "string",
          "required": false,
          "description": "The building id from a rental search row (resultType propertyGroup)."
        },
        {
          "name": "lat",
          "type": "number",
          "required": false,
          "description": "Latitude, with lng, instead of buildingId."
        },
        {
          "name": "lng",
          "type": "number",
          "required": false,
          "description": "Longitude, with lat, instead of buildingId."
        }
      ]
    }
  ]
}