Skip to main content
Glama

HasData

by com.hasdata.mcp
OverviewDiscussionsAdmin

redfin_listing: GET /

hasdata_redfin_listing_getRealEstateListings

Get Redfin Real Estate Listings

Searches Redfin for-sale, for-rent, or sold listings with pagination. The location accepts a zipcode, city, neighborhood, school, school district, apartment-building name, or a full street address. Returns each listing with address, Redfin URL, list price, beds/baths, square footage, lot size, year built, days on market, status, coordinates, photos, MLS number, and HOA; an address or building returns a single property card instead. Use for real-estate market research, lead generation for agents, price/DOM trend analysis, and feeding URLs into the Redfin Property endpoint for deep-dive details.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
pageNoThe page number of the results to retrieve.
sortNoThe sorting option for the search results.
typeYesThe type of listing.
bathsNoThe minimum number of bathrooms.
pets__NoAn array of pet types allowed.
keywordYesThe location to search for listings. Accepts a zipcode (`33321`), a city (`Austin` or `Austin, TX`), a neighborhood (`East Austin`), a school (`BASIS Austin`), a school district (`Austin Independent School District`), an apartment building by its name (`Maizon Brickell`), or a full street address (`5805 Woodview Ave, Austin, TX 78756`), including a single unit (`221 SW 12th St Unit 1716, Miami, FL`). An address or a building returns a single property card instead of a list of listings, and the `type` parameter does not apply to it.
beds_max_NoThe maximum number of bedrooms.
beds_min_NoThe minimum number of bedrooms.
cost_hoa_NoThe maximum monthly Homeowners Association (HOA) fee.
moveInDateNoThe desired move-in date in MM/DD/YYYY format.
price_max_NoThe maximum price of the listing.
price_min_NoThe minimum price of the listing.
homeTypes__NoAn array of home types to filter the listings. Allowed values depend on the listing `type`.
lotSize_max_NoThe maximum lot size.
lotSize_min_NoThe minimum lot size.
stories_max_NoThe maximum number of stories.
stories_min_NoThe minimum number of stories.
timeOnRedfinNoHow long the listing has been on Redfin.
yearBuilt_max_NoThe maximum year the property was built.
yearBuilt_min_NoThe minimum year the property was built.
statusOptions__NoAn array of listing statuses.
soldWithinOptionNoFilter sold listings by how recently they were sold.
rentalAmenities__NoAn array of rental amenities to filter the listings.
cost_priceReduced_NoFilter listings by when the price was reduced.
rentalOtherTerms__NoAn array of additional rental terms.
monthlyPayment_max_NoThe maximum monthly payment.
monthlyPayment_min_NoThe minimum monthly payment.
schools_schoolType___NoAn array of school types.
forSaleSquareFeet_max_NoThe maximum square footage for for-sale listings.
forSaleSquareFeet_min_NoThe minimum square footage for for-sale listings.
homeFeatures_basement_NoThe basement type.
homeFeatures_poolType_NoThe type of pool.
cost_acceptedFinancing_NoThe accepted financing type.
cost_excludeLandLeases_NoIf set to true, listings with land leases will be excluded.
cost_pricePerSqft__max_NoThe maximum price per square foot.
cost_pricePerSqft__min_NoThe minimum price per square foot.
homeFeatures_options___NoAn array of home feature flags to filter the listings.
listingType_category___NoAn array of listing categories.
onlyWithDealOrPromotionNoIf set to true, only listings with a deal or promotion will be included.
exclude55PlusCommunitiesNoIf set to true, 55+ communities will be excluded.
forRentSquareFootage_max_NoThe maximum square footage for for-rent listings.
forRentSquareFootage_min_NoThe minimum square footage for for-rent listings.
schools_greatSchoolRating_NoThe minimum GreatSchools rating (1-10).
transportScores_bikeScore_NoThe minimum bike score (1-100).
transportScores_walkScore_NoThe minimum walk score (1-100).
cost_maxPropertyTaxPerYear_NoThe maximum property tax per year.
homeFeatures_keywordSearch_NoA free-text keyword search applied to listing descriptions.
openHouseAndTour_openHouse_NoFilter listings with an open house.
openHouseAndTour_videoTour_NoIf set to true, only listings with a video tour will be included.
homeFeatures_garageSpotsMin_NoThe minimum number of garage spots.
monthlyPayment_interestRate_NoThe mortgage interest rate (percent) used to calculate the monthly payment.
monthlyPayment_mortgageTerm_NoThe mortgage term used to calculate the monthly payment.
monthlyPayment_insuranceRate_NoThe home insurance rate (percent) used to calculate the monthly payment.
transportScores_transitScore_NoThe minimum transit score (1-100).
listingType_excludeShortSales_NoIf set to true, short sales will be excluded.
schools_includeUnratedSchools_NoIf set to true, unrated schools will be included.
listingType_redfinListingsOnly_NoIf set to true, only Redfin-listed properties will be included.
monthlyPayment_downPaymentAmount_NoThe down payment as an absolute amount.
monthlyPayment_downPaymentPercent_NoThe down payment as a percentage of the home price.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / keyword / description
      Previous value: -"The zipcode used to search for listings."New value: +"The location to search for listings. Accepts a zipcode (`33321`), a city (`Austin` or `Austin, TX`), a neighborhood (`East Austin`), a school (`BASIS Austin`), a school district (`Austin Independent School District`), an apartment building by its name (`Maizon Brickell`), or a full street address (`5805 Woodview Ave, Austin, TX 78756`), including a single unit (`221 SW 12th St Unit 1716, Miami, FL`). An address or a building returns a single property card instead of a list of listings, and the `type` parameter does not apply to it."
  2. Changed98 schema fields changed
    • removedInput schema / properties / beds[max]
      Removed value: -{
-  "description": "The maximum number of bedrooms.",
-  "type": "number"
-}
    • removedInput schema / properties / beds[min]
      Removed value: -{
-  "description": "The minimum number of bedrooms.",
-  "type": "number"
-}
    • addedInput schema / properties / beds_max_
      Added value: +{
+  "description": "The maximum number of bedrooms.",
+  "type": "number"
+}
    • addedInput schema / properties / beds_min_
      Added value: +{
+  "description": "The minimum number of bedrooms.",
+  "type": "number"
+}
    • removedInput schema / properties / cost[acceptedFinancing]
      Removed value: -{
-  "description": "The accepted financing type.",
-  "enum": [
-    "FHA",
-    "VA"
-  ],
-  "type": "string"
-}
    • removedInput schema / properties / cost[excludeLandLeases]
      Removed value: -{
-  "description": "If set to true, listings with land leases will be excluded.",
-  "type": "boolean"
-}
    • removedInput schema / properties / cost[hoa]
      Removed value: -{
-  "description": "The maximum monthly Homeowners Association (HOA) fee.",
-  "type": "number"
-}
    • removedInput schema / properties / cost[maxPropertyTaxPerYear]
      Removed value: -{
-  "description": "The maximum property tax per year.",
-  "type": "number"
-}
    • removedInput schema / properties / cost[pricePerSqft][max]
      Removed value: -{
-  "description": "The maximum price per square foot.",
-  "enum": [
-    "50",
-    "100",
-    "150",
-    "200",
-    "250",
-    "300",
-    "400",
-    "500",
-    "600",
-    "800",
-    "1000",
-    "1400",
-    "1800",
-    "2200",
-    "2600",
-    "3000"
-  ],
-  "type": "string"
-}
    • removedInput schema / properties / cost[pricePerSqft][min]
      Removed value: -{
-  "description": "The minimum price per square foot.",
-  "enum": [
-    "50",
-    "100",
-    "150",
-    "200",
-    "250",
-    "300",
-    "400",
-    "500",
-    "600",
-    "800",
-    "1000",
-    "1400",
-    "1800",
-    "2200",
-    "2600",
-    "3000"
-  ],
-  "type": "string"
-}
    • removedInput schema / properties / cost[priceReduced]
      Removed value: -{
-  "description": "Filter listings by when the price was reduced.",
-  "enum": [
-    "inTheLastDay",
-    "inTheLast3Days",
-    "inTheLast7Days",
-    "inTheLast14Days",
-    "inTheLast30Days",
-    "moreThan30Days",
-    "moreThan60Days",
-    "moreThan120Days"
-  ],
-  "type": "string"
-}
    • addedInput schema / properties / cost_acceptedFinancing_
      Added value: +{
+  "description": "The accepted financing type.",
+  "enum": [
+    "FHA",
+    "VA"
+  ],
+  "type": "string"
+}
    • addedInput schema / properties / cost_excludeLandLeases_
      Added value: +{
+  "description": "If set to true, listings with land leases will be excluded.",
+  "type": "boolean"
+}
    • addedInput schema / properties / cost_hoa_
      Added value: +{
+  "description": "The maximum monthly Homeowners Association (HOA) fee.",
+  "type": "number"
+}
    • addedInput schema / properties / cost_maxPropertyTaxPerYear_
      Added value: +{
+  "description": "The maximum property tax per year.",
+  "type": "number"
+}
    • addedInput schema / properties / cost_pricePerSqft__max_
      Added value: +{
+  "description": "The maximum price per square foot.",
+  "enum": [
+    "50",
+    "100",
+    "150",
+    "200",
+    "250",
+    "300",
+    "400",
+    "500",
+    "600",
+    "800",
+    "1000",
+    "1400",
+    "1800",
+    "2200",
+    "2600",
+    "3000"
+  ],
+  "type": "string"
+}
    • addedInput schema / properties / cost_pricePerSqft__min_
      Added value: +{
+  "description": "The minimum price per square foot.",
+  "enum": [
+    "50",
+    "100",
+    "150",
+    "200",
+    "250",
+    "300",
+    "400",
+    "500",
+    "600",
+    "800",
+    "1000",
+    "1400",
+    "1800",
+    "2200",
+    "2600",
+    "3000"
+  ],
+  "type": "string"
+}
    • addedInput schema / properties / cost_priceReduced_
      Added value: +{
+  "description": "Filter listings by when the price was reduced.",
+  "enum": [
+    "inTheLastDay",
+    "inTheLast3Days",
+    "inTheLast7Days",
+    "inTheLast14Days",
+    "inTheLast30Days",
+    "moreThan30Days",
+    "moreThan60Days",
+    "moreThan120Days"
+  ],
+  "type": "string"
+}
    • removedInput schema / properties / forRentSquareFootage[max]
      Removed value: -{
-  "description": "The maximum square footage for for-rent listings.",
-  "type": "number"
-}
    • removedInput schema / properties / forRentSquareFootage[min]
      Removed value: -{
-  "description": "The minimum square footage for for-rent listings.",
-  "type": "number"
-}
    • addedInput schema / properties / forRentSquareFootage_max_
      Added value: +{
+  "description": "The maximum square footage for for-rent listings.",
+  "type": "number"
+}
    • addedInput schema / properties / forRentSquareFootage_min_
      Added value: +{
+  "description": "The minimum square footage for for-rent listings.",
+  "type": "number"
+}
    • removedInput schema / properties / forSaleSquareFeet[max]
      Removed value: -{
-  "description": "The maximum square footage for for-sale listings.",
-  "enum": [
-    "750",
-    "1000",
-    "1100",
-    "1200",
-    "1300",
-    "1400",
-    "1500",
-    "1600",
-    "1700",
-    "1800",
-    "1900",
-    "2000",
-    "2250",
-    "2500",
-    "2750",
-    "3000",
-    "4000",
-    "5000",
-    "7500",
-    "10000"
-  ],
-  "type": "string"
-}
    • removedInput schema / properties / forSaleSquareFeet[min]
      Removed value: -{
-  "description": "The minimum square footage for for-sale listings.",
-  "enum": [
-    "750",
-    "1000",
-    "1100",
-    "1200",
-    "1300",
-    "1400",
-    "1500",
-    "1600",
-    "1700",
-    "1800",
-    "1900",
-    "2000",
-    "2250",
-    "2500",
-    "2750",
-    "3000",
-    "4000",
-    "5000",
-    "7500",
-    "10000"
-  ],
-  "type": "string"
-}
    • addedInput schema / properties / forSaleSquareFeet_max_
      Added value: +{
+  "description": "The maximum square footage for for-sale listings.",
+  "enum": [
+    "750",
+    "1000",
+    "1100",
+    "1200",
+    "1300",
+    "1400",
+    "1500",
+    "1600",
+    "1700",
+    "1800",
+    "1900",
+    "2000",
+    "2250",
+    "2500",
+    "2750",
+    "3000",
+    "4000",
+    "5000",
+    "7500",
+    "10000"
+  ],
+  "type": "string"
+}
    • addedInput schema / properties / forSaleSquareFeet_min_
      Added value: +{
+  "description": "The minimum square footage for for-sale listings.",
+  "enum": [
+    "750",
+    "1000",
+    "1100",
+    "1200",
+    "1300",
+    "1400",
+    "1500",
+    "1600",
+    "1700",
+    "1800",
+    "1900",
+    "2000",
+    "2250",
+    "2500",
+    "2750",
+    "3000",
+    "4000",
+    "5000",
+    "7500",
+    "10000"
+  ],
+  "type": "string"
+}
    • removedInput schema / properties / homeFeatures[basement]
      Removed value: -{
-  "description": "The basement type.",
-  "enum": [
-    "finished",
-    "unfinished"
-  ],
-  "type": "string"
-}
    • removedInput schema / properties / homeFeatures[garageSpotsMin]
      Removed value: -{
-  "description": "The minimum number of garage spots.",
-  "enum": [
-    "1",
-    "2",
-    "3",
-    "4",
-    "5"
-  ],
-  "type": "string"
-}
    • removedInput schema / properties / homeFeatures[keywordSearch]
      Removed value: -{
-  "description": "A free-text keyword search applied to listing descriptions.",
-  "type": "string"
-}
    • removedInput schema / properties / homeFeatures[options][]
      Removed value: -{
-  "description": "An array of home feature flags to filter the listings.",
-  "items": {
-    "enum": [
-      "airConditioning",
-      "waterfront",
-      "hasAView",
-      "fireplace",
-      "fixerUpper",
-      "guestHouse",
-      "elevator",
-      "washerDryerHookup",
-      "petsAllowed",
-      "primaryBedroomOnMainFloor",
-      "rvparking",
-      "greenHome",
-      "accessibleHome",
-      "includeOutdoorParking"
-    ],
-    "type": "string"
-  },
-  "type": "array"
-}
    • removedInput schema / properties / homeFeatures[poolType]
      Removed value: -{
-  "description": "The type of pool.",
-  "enum": [
-    "privatePool",
-    "communityPool",
-    "privateOrCommunityPool",
-    "noPrivatePool"
-  ],
-  "type": "string"
-}
    • addedInput schema / properties / homeFeatures_basement_
      Added value: +{
+  "description": "The basement type.",
+  "enum": [
+    "finished",
+    "unfinished"
+  ],
+  "type": "string"
+}
    • addedInput schema / properties / homeFeatures_garageSpotsMin_
      Added value: +{
+  "description": "The minimum number of garage spots.",
+  "enum": [
+    "1",
+    "2",
+    "3",
+    "4",
+    "5"
+  ],
+  "type": "string"
+}
    • addedInput schema / properties / homeFeatures_keywordSearch_
      Added value: +{
+  "description": "A free-text keyword search applied to listing descriptions.",
+  "type": "string"
+}
    • addedInput schema / properties / homeFeatures_options___
      Added value: +{
+  "description": "An array of home feature flags to filter the listings.",
+  "items": {
+    "enum": [
+      "airConditioning",
+      "waterfront",
+      "hasAView",
+      "fireplace",
+      "fixerUpper",
+      "guestHouse",
+      "elevator",
+      "washerDryerHookup",
+      "petsAllowed",
+      "primaryBedroomOnMainFloor",
+      "rvparking",
+      "greenHome",
+      "accessibleHome",
+      "includeOutdoorParking"
+    ],
+    "type": "string"
+  },
+  "type": "array"
+}
    • addedInput schema / properties / homeFeatures_poolType_
      Added value: +{
+  "description": "The type of pool.",
+  "enum": [
+    "privatePool",
+    "communityPool",
+    "privateOrCommunityPool",
+    "noPrivatePool"
+  ],
+  "type": "string"
+}
    • removedInput schema / properties / homeTypes[]
      Removed value: -{
-  "description": "An array of home types to filter the listings. Allowed values depend on the listing `type`.",
-  "items": {
-    "enum": [
-      "house",
-      "townhouse",
-      "townhome",
-      "condo",
-      "land",
-      "multiFamily",
-      "mobile",
-      "coOp",
-      "other",
-      "apartment"
-    ],
-    "type": "string"
-  },
-  "type": "array"
-}
    • addedInput schema / properties / homeTypes__
      Added value: +{
+  "description": "An array of home types to filter the listings. Allowed values depend on the listing `type`.",
+  "items": {
+    "enum": [
+      "house",
+      "townhouse",
+      "townhome",
+      "condo",
+      "land",
+      "multiFamily",
+      "mobile",
+      "coOp",
+      "other",
+      "apartment"
+    ],
+    "type": "string"
+  },
+  "type": "array"
+}
    • removedInput schema / properties / listingType[category][]
      Removed value: -{
-  "description": "An array of listing categories.",
-  "items": {
-    "enum": [
-      "byAgent",
-      "byOwnerFsbo",
-      "newConstruction",
-      "foreclosures"
-    ],
-    "type": "string"
-  },
-  "type": "array"
-}
    • removedInput schema / properties / listingType[excludeShortSales]
      Removed value: -{
-  "description": "If set to true, short sales will be excluded.",
-  "type": "boolean"
-}
    • removedInput schema / properties / listingType[redfinListingsOnly]
      Removed value: -{
-  "description": "If set to true, only Redfin-listed properties will be included.",
-  "type": "boolean"
-}
    • addedInput schema / properties / listingType_category___
      Added value: +{
+  "description": "An array of listing categories.",
+  "items": {
+    "enum": [
+      "byAgent",
+      "byOwnerFsbo",
+      "newConstruction",
+      "foreclosures"
+    ],
+    "type": "string"
+  },
+  "type": "array"
+}
    • addedInput schema / properties / listingType_excludeShortSales_
      Added value: +{
+  "description": "If set to true, short sales will be excluded.",
+  "type": "boolean"
+}
    • addedInput schema / properties / listingType_redfinListingsOnly_
      Added value: +{
+  "description": "If set to true, only Redfin-listed properties will be included.",
+  "type": "boolean"
+}
    • removedInput schema / properties / lotSize[max]
      Removed value: -{
-  "description": "The maximum lot size.",
-  "enum": [
-    "2000 sqft",
-    "4500 sqft",
-    "6500 sqft",
-    "8000 sqft",
-    "9500 sqft",
-    "0.25 acres",
-    "0.5 acres",
-    "1 acres",
-    "2 acres",
-    "3 acres",
-    "4 acres",
-    "5 acres",
-    "10 acres",
-    "20 acres",
-    "40 acres",
-    "100 acres"
-  ],
-  "type": "string"
-}
    • removedInput schema / properties / lotSize[min]
      Removed value: -{
-  "description": "The minimum lot size.",
-  "enum": [
-    "2000 sqft",
-    "4500 sqft",
-    "6500 sqft",
-    "8000 sqft",
-    "9500 sqft",
-    "0.25 acres",
-    "0.5 acres",
-    "1 acres",
-    "2 acres",
-    "3 acres",
-    "4 acres",
-    "5 acres",
-    "10 acres",
-    "20 acres",
-    "40 acres",
-    "100 acres"
-  ],
-  "type": "string"
-}
    • addedInput schema / properties / lotSize_max_
      Added value: +{
+  "description": "The maximum lot size.",
+  "enum": [
+    "2000 sqft",
+    "4500 sqft",
+    "6500 sqft",
+    "8000 sqft",
+    "9500 sqft",
+    "0.25 acres",
+    "0.5 acres",
+    "1 acres",
+    "2 acres",
+    "3 acres",
+    "4 acres",
+    "5 acres",
+    "10 acres",
+    "20 acres",
+    "40 acres",
+    "100 acres"
+  ],
+  "type": "string"
+}
    • addedInput schema / properties / lotSize_min_
      Added value: +{
+  "description": "The minimum lot size.",
+  "enum": [
+    "2000 sqft",
+    "4500 sqft",
+    "6500 sqft",
+    "8000 sqft",
+    "9500 sqft",
+    "0.25 acres",
+    "0.5 acres",
+    "1 acres",
+    "2 acres",
+    "3 acres",
+    "4 acres",
+    "5 acres",
+    "10 acres",
+    "20 acres",
+    "40 acres",
+    "100 acres"
+  ],
+  "type": "string"
+}
    • removedInput schema / properties / monthlyPayment[downPaymentAmount]
      Removed value: -{
-  "description": "The down payment as an absolute amount.",
-  "type": "number"
-}
    • removedInput schema / properties / monthlyPayment[downPaymentPercent]
      Removed value: -{
-  "description": "The down payment as a percentage of the home price.",
-  "type": "number"
-}
    • removedInput schema / properties / monthlyPayment[insuranceRate]
      Removed value: -{
-  "description": "The home insurance rate (percent) used to calculate the monthly payment.",
-  "type": "number"
-}
    • removedInput schema / properties / monthlyPayment[interestRate]
      Removed value: -{
-  "description": "The mortgage interest rate (percent) used to calculate the monthly payment.",
-  "type": "number"
-}
    • removedInput schema / properties / monthlyPayment[max]
      Removed value: -{
-  "description": "The maximum monthly payment.",
-  "type": "number"
-}
    • removedInput schema / properties / monthlyPayment[min]
      Removed value: -{
-  "description": "The minimum monthly payment.",
-  "type": "number"
-}
    • removedInput schema / properties / monthlyPayment[mortgageTerm]
      Removed value: -{
-  "description": "The mortgage term used to calculate the monthly payment.",
-  "enum": [
-    "fixed15Years",
-    "fixed20Years",
-    "fixed30Years",
-    "fixed30YearsFha",
-    "fixed30YearsVa",
-    "fixed30YearsJumbo"
-  ],
-  "type": "string"
-}
    • addedInput schema / properties / monthlyPayment_downPaymentAmount_
      Added value: +{
+  "description": "The down payment as an absolute amount.",
+  "type": "number"
+}
    • addedInput schema / properties / monthlyPayment_downPaymentPercent_
      Added value: +{
+  "description": "The down payment as a percentage of the home price.",
+  "type": "number"
+}
    • addedInput schema / properties / monthlyPayment_insuranceRate_
      Added value: +{
+  "description": "The home insurance rate (percent) used to calculate the monthly payment.",
+  "type": "number"
+}
    • addedInput schema / properties / monthlyPayment_interestRate_
      Added value: +{
+  "description": "The mortgage interest rate (percent) used to calculate the monthly payment.",
+  "type": "number"
+}
    • addedInput schema / properties / monthlyPayment_max_
      Added value: +{
+  "description": "The maximum monthly payment.",
+  "type": "number"
+}
    • addedInput schema / properties / monthlyPayment_min_
      Added value: +{
+  "description": "The minimum monthly payment.",
+  "type": "number"
+}
    • addedInput schema / properties / monthlyPayment_mortgageTerm_
      Added value: +{
+  "description": "The mortgage term used to calculate the monthly payment.",
+  "enum": [
+    "fixed15Years",
+    "fixed20Years",
+    "fixed30Years",
+    "fixed30YearsFha",
+    "fixed30YearsVa",
+    "fixed30YearsJumbo"
+  ],
+  "type": "string"
+}
    • removedInput schema / properties / openHouseAndTour[openHouse]
      Removed value: -{
-  "description": "Filter listings with an open house.",
-  "enum": [
-    "thisWeekend",
-    "anytime"
-  ],
-  "type": "string"
-}
    • removedInput schema / properties / openHouseAndTour[videoTour]
      Removed value: -{
-  "description": "If set to true, only listings with a video tour will be included.",
-  "type": "boolean"
-}
    • addedInput schema / properties / openHouseAndTour_openHouse_
      Added value: +{
+  "description": "Filter listings with an open house.",
+  "enum": [
+    "thisWeekend",
+    "anytime"
+  ],
+  "type": "string"
+}
    • addedInput schema / properties / openHouseAndTour_videoTour_
      Added value: +{
+  "description": "If set to true, only listings with a video tour will be included.",
+  "type": "boolean"
+}
    • removedInput schema / properties / pets[]
      Removed value: -{
-  "description": "An array of pet types allowed.",
-  "items": {
-    "enum": [
-      "dogsAllowed",
-      "catsAllowed"
-    ],
-    "type": "string"
-  },
-  "type": "array"
-}
    • addedInput schema / properties / pets__
      Added value: +{
+  "description": "An array of pet types allowed.",
+  "items": {
+    "enum": [
+      "dogsAllowed",
+      "catsAllowed"
+    ],
+    "type": "string"
+  },
+  "type": "array"
+}
    • removedInput schema / properties / price[max]
      Removed value: -{
-  "description": "The maximum price of the listing.",
-  "type": "number"
-}
    • removedInput schema / properties / price[min]
      Removed value: -{
-  "description": "The minimum price of the listing.",
-  "type": "number"
-}
    • addedInput schema / properties / price_max_
      Added value: +{
+  "description": "The maximum price of the listing.",
+  "type": "number"
+}
    • addedInput schema / properties / price_min_
      Added value: +{
+  "description": "The minimum price of the listing.",
+  "type": "number"
+}
    • removedInput schema / properties / rentalAmenities[]
      Removed value: -{
-  "description": "An array of rental amenities to filter the listings.",
-  "items": {
-    "enum": [
-      "airConditioning",
-      "dishwasher",
-      "inUnitWasherDryer",
-      "parkingAllowed",
-      "utilitiesIncluded",
-      "attFiber",
-      "furnished",
-      "laundryFacility",
-      "pool",
-      "washerDryerHookup"
-    ],
-    "type": "string"
-  },
-  "type": "array"
-}
    • addedInput schema / properties / rentalAmenities__
      Added value: +{
+  "description": "An array of rental amenities to filter the listings.",
+  "items": {
+    "enum": [
+      "airConditioning",
+      "dishwasher",
+      "inUnitWasherDryer",
+      "parkingAllowed",
+      "utilitiesIncluded",
+      "attFiber",
+      "furnished",
+      "laundryFacility",
+      "pool",
+      "washerDryerHookup"
+    ],
+    "type": "string"
+  },
+  "type": "array"
+}
    • removedInput schema / properties / rentalOtherTerms[]
      Removed value: -{
-  "description": "An array of additional rental terms.",
-  "items": {
-    "enum": [
-      "incomeRestricted",
-      "student",
-      "shortTerm",
-      "seniorLiving",
-      "military"
-    ],
-    "type": "string"
-  },
-  "type": "array"
-}
    • addedInput schema / properties / rentalOtherTerms__
      Added value: +{
+  "description": "An array of additional rental terms.",
+  "items": {
+    "enum": [
+      "incomeRestricted",
+      "student",
+      "shortTerm",
+      "seniorLiving",
+      "military"
+    ],
+    "type": "string"
+  },
+  "type": "array"
+}
    • removedInput schema / properties / schools[greatSchoolRating]
      Removed value: -{
-  "description": "The minimum GreatSchools rating (1-10).",
-  "type": "number"
-}
    • removedInput schema / properties / schools[includeUnratedSchools]
      Removed value: -{
-  "description": "If set to true, unrated schools will be included.",
-  "type": "boolean"
-}
    • removedInput schema / properties / schools[schoolType][]
      Removed value: -{
-  "description": "An array of school types.",
-  "items": {
-    "enum": [
-      "elementary",
-      "middle",
-      "high"
-    ],
-    "type": "string"
-  },
-  "type": "array"
-}
    • addedInput schema / properties / schools_greatSchoolRating_
      Added value: +{
+  "description": "The minimum GreatSchools rating (1-10).",
+  "type": "number"
+}
    • addedInput schema / properties / schools_includeUnratedSchools_
      Added value: +{
+  "description": "If set to true, unrated schools will be included.",
+  "type": "boolean"
+}
    • addedInput schema / properties / schools_schoolType___
      Added value: +{
+  "description": "An array of school types.",
+  "items": {
+    "enum": [
+      "elementary",
+      "middle",
+      "high"
+    ],
+    "type": "string"
+  },
+  "type": "array"
+}
    • removedInput schema / properties / statusOptions[]
      Removed value: -{
-  "description": "An array of listing statuses.",
-  "items": {
-    "enum": [
-      "active",
-      "comingSoon",
-      "contingentPending"
-    ],
-    "type": "string"
-  },
-  "type": "array"
-}
    • addedInput schema / properties / statusOptions__
      Added value: +{
+  "description": "An array of listing statuses.",
+  "items": {
+    "enum": [
+      "active",
+      "comingSoon",
+      "contingentPending"
+    ],
+    "type": "string"
+  },
+  "type": "array"
+}
    • removedInput schema / properties / stories[max]
      Removed value: -{
-  "description": "The maximum number of stories.",
-  "enum": [
-    "1",
-    "2",
-    "3",
-    "4",
-    "5",
-    "10",
-    "15",
-    "20"
-  ],
-  "type": "string"
-}
    • removedInput schema / properties / stories[min]
      Removed value: -{
-  "description": "The minimum number of stories.",
-  "enum": [
-    "1",
-    "2",
-    "3",
-    "4",
-    "5",
-    "10",
-    "15",
-    "20"
-  ],
-  "type": "string"
-}
    • addedInput schema / properties / stories_max_
      Added value: +{
+  "description": "The maximum number of stories.",
+  "enum": [
+    "1",
+    "2",
+    "3",
+    "4",
+    "5",
+    "10",
+    "15",
+    "20"
+  ],
+  "type": "string"
+}
    • addedInput schema / properties / stories_min_
      Added value: +{
+  "description": "The minimum number of stories.",
+  "enum": [
+    "1",
+    "2",
+    "3",
+    "4",
+    "5",
+    "10",
+    "15",
+    "20"
+  ],
+  "type": "string"
+}
    • removedInput schema / properties / transportScores[bikeScore]
      Removed value: -{
-  "description": "The minimum bike score (1-100).",
-  "type": "number"
-}
    • removedInput schema / properties / transportScores[transitScore]
      Removed value: -{
-  "description": "The minimum transit score (1-100).",
-  "type": "number"
-}
    • removedInput schema / properties / transportScores[walkScore]
      Removed value: -{
-  "description": "The minimum walk score (1-100).",
-  "type": "number"
-}
    • addedInput schema / properties / transportScores_bikeScore_
      Added value: +{
+  "description": "The minimum bike score (1-100).",
+  "type": "number"
+}
    • addedInput schema / properties / transportScores_transitScore_
      Added value: +{
+  "description": "The minimum transit score (1-100).",
+  "type": "number"
+}
    • addedInput schema / properties / transportScores_walkScore_
      Added value: +{
+  "description": "The minimum walk score (1-100).",
+  "type": "number"
+}
    • removedInput schema / properties / yearBuilt[max]
      Removed value: -{
-  "description": "The maximum year the property was built.",
-  "enum": [
-    "2026",
-    "2025",
-    "2024",
-    "2023",
-    "2022",
-    "2021",
-    "2020",
-    "2019",
-    "2018",
-    "2017",
-    "2016",
-    "2015",
-    "2010",
-    "2005",
-    "2000",
-    "1990",
-    "1980",
-    "1970",
-    "1960",
-    "1950",
-    "1940",
-    "1920",
-    "1900"
-  ],
-  "type": "string"
-}
    • removedInput schema / properties / yearBuilt[min]
      Removed value: -{
-  "description": "The minimum year the property was built.",
-  "enum": [
-    "2026",
-    "2025",
-    "2024",
-    "2023",
-    "2022",
-    "2021",
-    "2020",
-    "2019",
-    "2018",
-    "2017",
-    "2016",
-    "2015",
-    "2010",
-    "2005",
-    "2000",
-    "1990",
-    "1980",
-    "1970",
-    "1960",
-    "1950",
-    "1940",
-    "1920",
-    "1900"
-  ],
-  "type": "string"
-}
    • addedInput schema / properties / yearBuilt_max_
      Added value: +{
+  "description": "The maximum year the property was built.",
+  "enum": [
+    "2026",
+    "2025",
+    "2024",
+    "2023",
+    "2022",
+    "2021",
+    "2020",
+    "2019",
+    "2018",
+    "2017",
+    "2016",
+    "2015",
+    "2010",
+    "2005",
+    "2000",
+    "1990",
+    "1980",
+    "1970",
+    "1960",
+    "1950",
+    "1940",
+    "1920",
+    "1900"
+  ],
+  "type": "string"
+}
    • addedInput schema / properties / yearBuilt_min_
      Added value: +{
+  "description": "The minimum year the property was built.",
+  "enum": [
+    "2026",
+    "2025",
+    "2024",
+    "2023",
+    "2022",
+    "2021",
+    "2020",
+    "2019",
+    "2018",
+    "2017",
+    "2016",
+    "2015",
+    "2010",
+    "2005",
+    "2000",
+    "1990",
+    "1980",
+    "1970",
+    "1960",
+    "1950",
+    "1940",
+    "1920",
+    "1900"
+  ],
+  "type": "string"
+}
  3. Changed56 schema fields changed
    • addedInput schema / properties / baths
      Added value: +{
+  "description": "The minimum number of bathrooms.",
+  "enum": [
+    "one",
+    "oneAndHalf",
+    "two",
+    "twoAndHalf",
+    "three",
+    "four"
+  ],
+  "type": "string"
+}
    • addedInput schema / properties / beds[max]
      Added value: +{
+  "description": "The maximum number of bedrooms.",
+  "type": "number"
+}
    • addedInput schema / properties / beds[min]
      Added value: +{
+  "description": "The minimum number of bedrooms.",
+  "type": "number"
+}
    • addedInput schema / properties / cost[acceptedFinancing]
      Added value: +{
+  "description": "The accepted financing type.",
+  "enum": [
+    "FHA",
+    "VA"
+  ],
+  "type": "string"
+}
    • addedInput schema / properties / cost[excludeLandLeases]
      Added value: +{
+  "description": "If set to true, listings with land leases will be excluded.",
+  "type": "boolean"
+}
    • addedInput schema / properties / cost[hoa]
      Added value: +{
+  "description": "The maximum monthly Homeowners Association (HOA) fee.",
+  "type": "number"
+}
    • addedInput schema / properties / cost[maxPropertyTaxPerYear]
      Added value: +{
+  "description": "The maximum property tax per year.",
+  "type": "number"
+}
    • addedInput schema / properties / cost[pricePerSqft][max]
      Added value: +{
+  "description": "The maximum price per square foot.",
+  "enum": [
+    "50",
+    "100",
+    "150",
+    "200",
+    "250",
+    "300",
+    "400",
+    "500",
+    "600",
+    "800",
+    "1000",
+    "1400",
+    "1800",
+    "2200",
+    "2600",
+    "3000"
+  ],
+  "type": "string"
+}
    • addedInput schema / properties / cost[pricePerSqft][min]
      Added value: +{
+  "description": "The minimum price per square foot.",
+  "enum": [
+    "50",
+    "100",
+    "150",
+    "200",
+    "250",
+    "300",
+    "400",
+    "500",
+    "600",
+    "800",
+    "1000",
+    "1400",
+    "1800",
+    "2200",
+    "2600",
+    "3000"
+  ],
+  "type": "string"
+}
    • addedInput schema / properties / cost[priceReduced]
      Added value: +{
+  "description": "Filter listings by when the price was reduced.",
+  "enum": [
+    "inTheLastDay",
+    "inTheLast3Days",
+    "inTheLast7Days",
+    "inTheLast14Days",
+    "inTheLast30Days",
+    "moreThan30Days",
+    "moreThan60Days",
+    "moreThan120Days"
+  ],
+  "type": "string"
+}
    • addedInput schema / properties / exclude55PlusCommunities
      Added value: +{
+  "description": "If set to true, 55+ communities will be excluded.",
+  "type": "boolean"
+}
    • addedInput schema / properties / forRentSquareFootage[max]
      Added value: +{
+  "description": "The maximum square footage for for-rent listings.",
+  "type": "number"
+}
    • addedInput schema / properties / forRentSquareFootage[min]
      Added value: +{
+  "description": "The minimum square footage for for-rent listings.",
+  "type": "number"
+}
    • addedInput schema / properties / forSaleSquareFeet[max]
      Added value: +{
+  "description": "The maximum square footage for for-sale listings.",
+  "enum": [
+    "750",
+    "1000",
+    "1100",
+    "1200",
+    "1300",
+    "1400",
+    "1500",
+    "1600",
+    "1700",
+    "1800",
+    "1900",
+    "2000",
+    "2250",
+    "2500",
+    "2750",
+    "3000",
+    "4000",
+    "5000",
+    "7500",
+    "10000"
+  ],
+  "type": "string"
+}
    • addedInput schema / properties / forSaleSquareFeet[min]
      Added value: +{
+  "description": "The minimum square footage for for-sale listings.",
+  "enum": [
+    "750",
+    "1000",
+    "1100",
+    "1200",
+    "1300",
+    "1400",
+    "1500",
+    "1600",
+    "1700",
+    "1800",
+    "1900",
+    "2000",
+    "2250",
+    "2500",
+    "2750",
+    "3000",
+    "4000",
+    "5000",
+    "7500",
+    "10000"
+  ],
+  "type": "string"
+}
    • addedInput schema / properties / homeFeatures[basement]
      Added value: +{
+  "description": "The basement type.",
+  "enum": [
+    "finished",
+    "unfinished"
+  ],
+  "type": "string"
+}
    • addedInput schema / properties / homeFeatures[garageSpotsMin]
      Added value: +{
+  "description": "The minimum number of garage spots.",
+  "enum": [
+    "1",
+    "2",
+    "3",
+    "4",
+    "5"
+  ],
+  "type": "string"
+}
    • addedInput schema / properties / homeFeatures[keywordSearch]
      Added value: +{
+  "description": "A free-text keyword search applied to listing descriptions.",
+  "type": "string"
+}
    • addedInput schema / properties / homeFeatures[options][]
      Added value: +{
+  "description": "An array of home feature flags to filter the listings.",
+  "items": {
+    "enum": [
+      "airConditioning",
+      "waterfront",
+      "hasAView",
+      "fireplace",
+      "fixerUpper",
+      "guestHouse",
+      "elevator",
+      "washerDryerHookup",
+      "petsAllowed",
+      "primaryBedroomOnMainFloor",
+      "rvparking",
+      "greenHome",
+      "accessibleHome",
+      "includeOutdoorParking"
+    ],
+    "type": "string"
+  },
+  "type": "array"
+}
    • addedInput schema / properties / homeFeatures[poolType]
      Added value: +{
+  "description": "The type of pool.",
+  "enum": [
+    "privatePool",
+    "communityPool",
+    "privateOrCommunityPool",
+    "noPrivatePool"
+  ],
+  "type": "string"
+}
    • addedInput schema / properties / homeTypes[]
      Added value: +{
+  "description": "An array of home types to filter the listings. Allowed values depend on the listing `type`.",
+  "items": {
+    "enum": [
+      "house",
+      "townhouse",
+      "townhome",
+      "condo",
+      "land",
+      "multiFamily",
+      "mobile",
+      "coOp",
+      "other",
+      "apartment"
+    ],
+    "type": "string"
+  },
+  "type": "array"
+}
    • addedInput schema / properties / listingType[category][]
      Added value: +{
+  "description": "An array of listing categories.",
+  "items": {
+    "enum": [
+      "byAgent",
+      "byOwnerFsbo",
+      "newConstruction",
+      "foreclosures"
+    ],
+    "type": "string"
+  },
+  "type": "array"
+}
    • addedInput schema / properties / listingType[excludeShortSales]
      Added value: +{
+  "description": "If set to true, short sales will be excluded.",
+  "type": "boolean"
+}
    • addedInput schema / properties / listingType[redfinListingsOnly]
      Added value: +{
+  "description": "If set to true, only Redfin-listed properties will be included.",
+  "type": "boolean"
+}
    • addedInput schema / properties / lotSize[max]
      Added value: +{
+  "description": "The maximum lot size.",
+  "enum": [
+    "2000 sqft",
+    "4500 sqft",
+    "6500 sqft",
+    "8000 sqft",
+    "9500 sqft",
+    "0.25 acres",
+    "0.5 acres",
+    "1 acres",
+    "2 acres",
+    "3 acres",
+    "4 acres",
+    "5 acres",
+    "10 acres",
+    "20 acres",
+    "40 acres",
+    "100 acres"
+  ],
+  "type": "string"
+}
    • addedInput schema / properties / lotSize[min]
      Added value: +{
+  "description": "The minimum lot size.",
+  "enum": [
+    "2000 sqft",
+    "4500 sqft",
+    "6500 sqft",
+    "8000 sqft",
+    "9500 sqft",
+    "0.25 acres",
+    "0.5 acres",
+    "1 acres",
+    "2 acres",
+    "3 acres",
+    "4 acres",
+    "5 acres",
+    "10 acres",
+    "20 acres",
+    "40 acres",
+    "100 acres"
+  ],
+  "type": "string"
+}
    • addedInput schema / properties / monthlyPayment[downPaymentAmount]
      Added value: +{
+  "description": "The down payment as an absolute amount.",
+  "type": "number"
+}
    • addedInput schema / properties / monthlyPayment[downPaymentPercent]
      Added value: +{
+  "description": "The down payment as a percentage of the home price.",
+  "type": "number"
+}
    • addedInput schema / properties / monthlyPayment[insuranceRate]
      Added value: +{
+  "description": "The home insurance rate (percent) used to calculate the monthly payment.",
+  "type": "number"
+}
    • addedInput schema / properties / monthlyPayment[interestRate]
      Added value: +{
+  "description": "The mortgage interest rate (percent) used to calculate the monthly payment.",
+  "type": "number"
+}
    • addedInput schema / properties / monthlyPayment[max]
      Added value: +{
+  "description": "The maximum monthly payment.",
+  "type": "number"
+}
    • addedInput schema / properties / monthlyPayment[min]
      Added value: +{
+  "description": "The minimum monthly payment.",
+  "type": "number"
+}
    • addedInput schema / properties / monthlyPayment[mortgageTerm]
      Added value: +{
+  "description": "The mortgage term used to calculate the monthly payment.",
+  "enum": [
+    "fixed15Years",
+    "fixed20Years",
+    "fixed30Years",
+    "fixed30YearsFha",
+    "fixed30YearsVa",
+    "fixed30YearsJumbo"
+  ],
+  "type": "string"
+}
    • addedInput schema / properties / moveInDate
      Added value: +{
+  "description": "The desired move-in date in MM/DD/YYYY format.",
+  "type": "string"
+}
    • addedInput schema / properties / onlyWithDealOrPromotion
      Added value: +{
+  "description": "If set to true, only listings with a deal or promotion will be included.",
+  "type": "boolean"
+}
    • addedInput schema / properties / openHouseAndTour[openHouse]
      Added value: +{
+  "description": "Filter listings with an open house.",
+  "enum": [
+    "thisWeekend",
+    "anytime"
+  ],
+  "type": "string"
+}
    • addedInput schema / properties / openHouseAndTour[videoTour]
      Added value: +{
+  "description": "If set to true, only listings with a video tour will be included.",
+  "type": "boolean"
+}
    • addedInput schema / properties / pets[]
      Added value: +{
+  "description": "An array of pet types allowed.",
+  "items": {
+    "enum": [
+      "dogsAllowed",
+      "catsAllowed"
+    ],
+    "type": "string"
+  },
+  "type": "array"
+}
    • addedInput schema / properties / price[max]
      Added value: +{
+  "description": "The maximum price of the listing.",
+  "type": "number"
+}
    • addedInput schema / properties / price[min]
      Added value: +{
+  "description": "The minimum price of the listing.",
+  "type": "number"
+}
    • addedInput schema / properties / rentalAmenities[]
      Added value: +{
+  "description": "An array of rental amenities to filter the listings.",
+  "items": {
+    "enum": [
+      "airConditioning",
+      "dishwasher",
+      "inUnitWasherDryer",
+      "parkingAllowed",
+      "utilitiesIncluded",
+      "attFiber",
+      "furnished",
+      "laundryFacility",
+      "pool",
+      "washerDryerHookup"
+    ],
+    "type": "string"
+  },
+  "type": "array"
+}
    • addedInput schema / properties / rentalOtherTerms[]
      Added value: +{
+  "description": "An array of additional rental terms.",
+  "items": {
+    "enum": [
+      "incomeRestricted",
+      "student",
+      "shortTerm",
+      "seniorLiving",
+      "military"
+    ],
+    "type": "string"
+  },
+  "type": "array"
+}
    • addedInput schema / properties / schools[greatSchoolRating]
      Added value: +{
+  "description": "The minimum GreatSchools rating (1-10).",
+  "type": "number"
+}
    • addedInput schema / properties / schools[includeUnratedSchools]
      Added value: +{
+  "description": "If set to true, unrated schools will be included.",
+  "type": "boolean"
+}
    • addedInput schema / properties / schools[schoolType][]
      Added value: +{
+  "description": "An array of school types.",
+  "items": {
+    "enum": [
+      "elementary",
+      "middle",
+      "high"
+    ],
+    "type": "string"
+  },
+  "type": "array"
+}
    • addedInput schema / properties / soldWithinOption
      Added value: +{
+  "description": "Filter sold listings by how recently they were sold.",
+  "enum": [
+    "lastOneWeek",
+    "lastOneMonth",
+    "lastThreeMonth",
+    "lastSixMonth",
+    "lastYear",
+    "lastTwoYear",
+    "lastThreeYear",
+    "lastFiveYear"
+  ],
+  "type": "string"
+}
    • addedInput schema / properties / sort
      Added value: +{
+  "description": "The sorting option for the search results.",
+  "enum": [
+    "recommended",
+    "newest",
+    "oldest",
+    "priceLowToHigh",
+    "priceHighToLow",
+    "minSquareFeet",
+    "maxSquareFeet",
+    "bedrooms",
+    "bathrooms",
+    "lotSize",
+    "squareFeetPrice",
+    "mostRecentlySold"
+  ],
+  "type": "string"
+}
    • addedInput schema / properties / statusOptions[]
      Added value: +{
+  "description": "An array of listing statuses.",
+  "items": {
+    "enum": [
+      "active",
+      "comingSoon",
+      "contingentPending"
+    ],
+    "type": "string"
+  },
+  "type": "array"
+}
    • addedInput schema / properties / stories[max]
      Added value: +{
+  "description": "The maximum number of stories.",
+  "enum": [
+    "1",
+    "2",
+    "3",
+    "4",
+    "5",
+    "10",
+    "15",
+    "20"
+  ],
+  "type": "string"
+}
    • addedInput schema / properties / stories[min]
      Added value: +{
+  "description": "The minimum number of stories.",
+  "enum": [
+    "1",
+    "2",
+    "3",
+    "4",
+    "5",
+    "10",
+    "15",
+    "20"
+  ],
+  "type": "string"
+}
    • addedInput schema / properties / timeOnRedfin
      Added value: +{
+  "description": "How long the listing has been on Redfin.",
+  "enum": [
+    "newListing",
+    "lessThan3Days",
+    "lessThan7Days",
+    "lessThan14Days",
+    "lessThan30Days",
+    "moreThan7Days",
+    "moreThan14Days",
+    "moreThan30Days",
+    "moreThan45Days",
+    "moreThan60Days",
+    "moreThan90Days",
+    "moreThan180Days"
+  ],
+  "type": "string"
+}
    • addedInput schema / properties / transportScores[bikeScore]
      Added value: +{
+  "description": "The minimum bike score (1-100).",
+  "type": "number"
+}
    • addedInput schema / properties / transportScores[transitScore]
      Added value: +{
+  "description": "The minimum transit score (1-100).",
+  "type": "number"
+}
    • addedInput schema / properties / transportScores[walkScore]
      Added value: +{
+  "description": "The minimum walk score (1-100).",
+  "type": "number"
+}
    • addedInput schema / properties / yearBuilt[max]
      Added value: +{
+  "description": "The maximum year the property was built.",
+  "enum": [
+    "2026",
+    "2025",
+    "2024",
+    "2023",
+    "2022",
+    "2021",
+    "2020",
+    "2019",
+    "2018",
+    "2017",
+    "2016",
+    "2015",
+    "2010",
+    "2005",
+    "2000",
+    "1990",
+    "1980",
+    "1970",
+    "1960",
+    "1950",
+    "1940",
+    "1920",
+    "1900"
+  ],
+  "type": "string"
+}
    • addedInput schema / properties / yearBuilt[min]
      Added value: +{
+  "description": "The minimum year the property was built.",
+  "enum": [
+    "2026",
+    "2025",
+    "2024",
+    "2023",
+    "2022",
+    "2021",
+    "2020",
+    "2019",
+    "2018",
+    "2017",
+    "2016",
+    "2015",
+    "2010",
+    "2005",
+    "2000",
+    "1990",
+    "1980",
+    "1970",
+    "1960",
+    "1950",
+    "1940",
+    "1920",
+    "1900"
+  ],
+  "type": "string"
+}
  4. First observed

TDQS

A4.2/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the disclosure burden. It discloses pagination, the accepted keyword forms, the full set of returned listing fields, and the important behavioral exception that an address/building returns a single property card and ignores `type`. Rate-limit and error behavior are absent, but the core behavioral surface is well covered.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Four dense, front-loaded sentences with no filler: action and pagination first, then location semantics, return fields/exception, and use cases. It is well sized for a 59-parameter tool because the schema carries the detailed filter documentation.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Despite no output schema and no annotations, the description compensates by naming the main returned fields and explaining the single-property-card case. For a large search tool, the use cases and sibling routing make it reasonably complete, though it omits pagination-count/default behavior and error-handling expectations.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the baseline is 3. The narrative mostly re-states the `keyword` semantics and the `type` exception that already exist in the schema, and it adds no new information about `page`, `sort`, or the other filter parameters. It therefore earns no bonus beyond the well-documented schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description opens with a specific, verb-driven statement: 'Searches Redfin for-sale, for-rent, or sold listings with pagination,' and enumerates the location forms and return fields. This makes the listing-search scope unmistakable and differentiates it from the single-property sibling endpoint.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It gives concrete use cases ('real-estate market research, lead generation for agents, price/DOM trend analysis') and points to the 'Redfin Property endpoint' for deep-dive details, effectively routing an agent to the sibling after this search step. It does not phrase this as a hard when-not-to-use rule, but the guidance is unambiguous enough.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All HasData toolsInspect
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources