HasData MCP Server

Official

Overview Schema Source Related Servers Discussions Admin

redfin_listing: GET /

hasdata_redfin_listing_getRealEstateListings

Search Redfin for-sale, for-rent, or sold listings by zipcode, city, neighborhood, school, or address. Returns price, beds, baths, square footage, status, and coordinates for market research and lead generation.

Instructions

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

Name	Required	Description
`page`	No	The page number of the results to retrieve.
`sort`	No	The sorting option for the search results.
`type`	Yes	The type of listing.
`baths`	No	The minimum number of bathrooms.
`pets__`	No	An array of pet types allowed.
`keyword`	Yes	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.
`beds_max_`	No	The maximum number of bedrooms.
`beds_min_`	No	The minimum number of bedrooms.
`cost_hoa_`	No	The maximum monthly Homeowners Association (HOA) fee.
`moveInDate`	No	The desired move-in date in MM/DD/YYYY format.
`price_max_`	No	The maximum price of the listing.
`price_min_`	No	The minimum price of the listing.
`homeTypes__`	No	An array of home types to filter the listings. Allowed values depend on the listing `type`.
`lotSize_max_`	No	The maximum lot size.
`lotSize_min_`	No	The minimum lot size.
`stories_max_`	No	The maximum number of stories.
`stories_min_`	No	The minimum number of stories.
`timeOnRedfin`	No	How long the listing has been on Redfin.
`yearBuilt_max_`	No	The maximum year the property was built.
`yearBuilt_min_`	No	The minimum year the property was built.
`statusOptions__`	No	An array of listing statuses.
`soldWithinOption`	No	Filter sold listings by how recently they were sold.
`rentalAmenities__`	No	An array of rental amenities to filter the listings.
`cost_priceReduced_`	No	Filter listings by when the price was reduced.
`rentalOtherTerms__`	No	An array of additional rental terms.
`monthlyPayment_max_`	No	The maximum monthly payment.
`monthlyPayment_min_`	No	The minimum monthly payment.
`schools_schoolType___`	No	An array of school types.
`forSaleSquareFeet_max_`	No	The maximum square footage for for-sale listings.
`forSaleSquareFeet_min_`	No	The minimum square footage for for-sale listings.
`homeFeatures_basement_`	No	The basement type.
`homeFeatures_poolType_`	No	The type of pool.
`cost_acceptedFinancing_`	No	The accepted financing type.
`cost_excludeLandLeases_`	No	If set to true, listings with land leases will be excluded.
`cost_pricePerSqft__max_`	No	The maximum price per square foot.
`cost_pricePerSqft__min_`	No	The minimum price per square foot.
`homeFeatures_options___`	No	An array of home feature flags to filter the listings.
`listingType_category___`	No	An array of listing categories.
`onlyWithDealOrPromotion`	No	If set to true, only listings with a deal or promotion will be included.
`exclude55PlusCommunities`	No	If set to true, 55+ communities will be excluded.
`forRentSquareFootage_max_`	No	The maximum square footage for for-rent listings.
`forRentSquareFootage_min_`	No	The minimum square footage for for-rent listings.
`schools_greatSchoolRating_`	No	The minimum GreatSchools rating (1-10).
`transportScores_bikeScore_`	No	The minimum bike score (1-100).
`transportScores_walkScore_`	No	The minimum walk score (1-100).
`cost_maxPropertyTaxPerYear_`	No	The maximum property tax per year.
`homeFeatures_keywordSearch_`	No	A free-text keyword search applied to listing descriptions.
`openHouseAndTour_openHouse_`	No	Filter listings with an open house.
`openHouseAndTour_videoTour_`	No	If set to true, only listings with a video tour will be included.
`homeFeatures_garageSpotsMin_`	No	The minimum number of garage spots.
`monthlyPayment_interestRate_`	No	The mortgage interest rate (percent) used to calculate the monthly payment.
`monthlyPayment_mortgageTerm_`	No	The mortgage term used to calculate the monthly payment.
`monthlyPayment_insuranceRate_`	No	The home insurance rate (percent) used to calculate the monthly payment.
`transportScores_transitScore_`	No	The minimum transit score (1-100).
`listingType_excludeShortSales_`	No	If set to true, short sales will be excluded.
`schools_includeUnratedSchools_`	No	If set to true, unrated schools will be included.
`listingType_redfinListingsOnly_`	No	If set to true, only Redfin-listed properties will be included.
`monthlyPayment_downPaymentAmount_`	No	The down payment as an absolute amount.
`monthlyPayment_downPaymentPercent_`	No	The down payment as a percentage of the home price.

Schema Changelog

Changes observed during successful MCP inspections.

Changed57 schema fields changedv1.0.2Sep 11, 2026

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"
+}

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."

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"
+}

Addedv1.0.0Apr 28, 2026

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.

Deploy Server

redfin_listing: GET /

Instructions

Input Schema

Schema Changelog

TDQS

Other Tools