# Redfin Mcp > MCP server for Redfin: search for-sale, for-rent and sold listings with the full filter set, and read one property page in full. No MLS licence. 1,000 free credits every month. - **Type:** MCP server - **Install:** `agentstack add mcp-hasdata-redfin-mcp` - **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior - **Seller:** [HasData](https://agentstack.voostack.com/s/hasdata) - **Installs:** 0 - **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml) - **Latest version:** 0.1.0 - **License:** MIT - **Upstream author:** [HasData](https://github.com/HasData) - **Source:** https://github.com/HasData/redfin-mcp - **Website:** https://hasdata.com/apis/redfin-api ## Install ```sh agentstack add mcp-hasdata-redfin-mcp ``` Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent. ## About # Redfin MCP Server A hosted Model Context Protocol (MCP) server that gives Claude, Cursor, Windsurf and any other MCP client two read-only Redfin tools. Search for-sale, for-rent and sold listings with the filter set Redfin shows a visitor, and read one property page in full, both as structured JSON, with no MLS licence and nothing to host. It reads public Redfin pages that a signed-out visitor can see. **1,000 free credits every month, no card required**, which is 200 Redfin calls at the 5-credit rate. ``` https://mcp.hasdata.com/api/mcp?apis=redfin ``` [](https://glama.ai/mcp/servers/HasData/redfin-mcp) [](https://github.com/HasData/redfin-mcp/actions/workflows/contract.yml) [](https://mcp.hasdata.com/api/mcp?apis=redfin) [](#tools) [](https://www.npmjs.com/package/@hasdata/redfin-mcp) [](https://pypi.org/project/hasdata-redfin-mcp/) [](LICENSE) ## Contents - [What you need](#what-you-need) - [Quick start](#quick-start) - [Example prompts](#example-prompts) - [Tools](#tools) - [Errors and failure paths](#errors-and-failure-paths) - [Pricing, free tier and limits](#pricing-free-tier-and-limits) - [Tool selection](#tool-selection) - [How it compares](#how-it-compares) - [FAQ](#faq) - [HasData links](#hasdata-links) - [Development](#development) - [Contributing](#contributing) - [License](#license) ## What you need An MCP client and a HasData API key from the [dashboard](https://app.hasdata.com/sign-up?utm_source=github&utm_medium=syndication&utm_campaign=redfin-mcp), free to create with no card, and the free tier covers about 200 calls a month at the 5-credit rate. This is a remote server, so the simplest path is a URL and an `x-api-key` header, with no container to run. A client that only speaks stdio reaches it through a thin launcher, published as `@hasdata/redfin-mcp` on npm and `hasdata-redfin-mcp` on PyPI, shown below. ## Quick start The server URL is the same for every client. We run it hands-on in Claude Code and Claude Desktop. The other blocks follow each client's own documented format for a remote server. | Field | Value | | :--- | :--- | | URL | `https://mcp.hasdata.com/api/mcp?apis=redfin` | | Transport | HTTP, streamable | | Auth header | `x-api-key: HASDATA_API_KEY` | Clients with OAuth support can add the same URL as a connector and sign in without putting a key in a config file. Claude Code ```bash claude mcp add --transport http redfin "https://mcp.hasdata.com/api/mcp?apis=redfin" \ --header "x-api-key: HASDATA_API_KEY" ``` Claude Desktop Settings, then Connectors, then Add custom connector, then paste `https://mcp.hasdata.com/api/mcp?apis=redfin` and sign in. For the config-file route, Claude Desktop loads only local (stdio) servers, so it reaches a remote server through a stdio launcher. The `@hasdata/redfin-mcp` package is that launcher, and it reads the key from the environment. Add this to `claude_desktop_config.json`: ```json { "mcpServers": { "redfin": { "command": "npx", "args": ["-y", "@hasdata/redfin-mcp"], "env": { "HASDATA_API_KEY": "YOUR_KEY" } } } } ``` For Python instead of Node, swap the launcher for the PyPI package, which `uvx` runs without a manual install: ```json { "mcpServers": { "redfin": { "command": "uvx", "args": ["hasdata-redfin-mcp"], "env": { "HASDATA_API_KEY": "YOUR_KEY" } } } } ``` Cursor `~/.cursor/mcp.json` for every project, or `.cursor/mcp.json` for one: ```json { "mcpServers": { "redfin": { "url": "https://mcp.hasdata.com/api/mcp?apis=redfin", "headers": { "x-api-key": "HASDATA_API_KEY" } } } } ``` Windsurf `~/.codeium/windsurf/mcp_config.json`. Windsurf calls the field `serverUrl`, not `url`: ```json { "mcpServers": { "redfin": { "serverUrl": "https://mcp.hasdata.com/api/mcp?apis=redfin", "headers": { "x-api-key": "HASDATA_API_KEY" } } } } ``` VS Code `.vscode/mcp.json` in the workspace: ```json { "servers": { "redfin": { "type": "http", "url": "https://mcp.hasdata.com/api/mcp?apis=redfin", "headers": { "x-api-key": "HASDATA_API_KEY" } } } } ``` ## Example prompts Each of these lands on one tool, or on two in sequence when the second needs the URL the first returns. - Find three-bedroom houses for sale in 78741 under $500,000 and sort them by price per square foot. - What sold in Austin in the last three months, and how does that compare with what is listed now? - Pull the full property page for this Redfin URL and summarise the condition from the description. - Which rentals in Austin allow dogs and include in-unit laundry? - Show me for-sale homes in the Austin Independent School District where the assigned elementary school rates 8 or better. - Find fixer-uppers built before 1970 in this zipcode that have been on Redfin more than 30 days. A prompt that names a market goes to the search tool. A prompt that hands you a Redfin URL goes straight to the property tool. Searching for a full street address is a third case, covered below, because it answers with one property rather than a list. ## Tools | Tool | What it returns | | --- | --- | | `hasdata_redfin_listing_getRealEstateListings` | 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…. 5 credits a call | | `hasdata_redfin_property_getPropertyDetails` | Address, list/sold price, price history, Redfin Estimate, beds/baths, square footage, lot size, year built, property type, HOA, days on market, school ratings, tax…. 5 credits a call | Two tools, 5 credits per successful call. ### Get Redfin real estate listings [`hasdata_redfin_listing_getRealEstateListings`](https://docs.hasdata.com/apis/redfin/listing?utm_source=github&utm_medium=syndication&utm_campaign=redfin-mcp) A page of listings for a location, or one property when the location is a single address. Two parameters are required, and the rest of the schema mirrors Redfin's own filter panel. | Parameter | Type | Required | Notes | | :--- | :--- | :--- | :--- | | `keyword` | string | yes | A zipcode, city, neighborhood, school, school district, apartment building name, or a full street address | | `type` | string | yes | `forSale`, `forRent` or `sold` | | `sort` | string | | `recommended`, `newest`, `oldest`, `priceLowToHigh`, `priceHighToLow`, `bedrooms`, `bathrooms`, `lotSize`, `squareFeetPrice` and more | | `page` | number | | Result page, starting at 1 | The filters are named after the nested structure Redfin uses internally, flattened with underscores, so they have to be passed exactly as the schema spells them. `price_min_` and `price_max_` are the price band, `beds_min_` and `beds_max_` the bedroom count, `monthlyPayment_interestRate_` a mortgage assumption. A doubled underscore marks an array. The ones worth knowing: | Parameter | Type | Notes | | :--- | :--- | :--- | | `price_min_` / `price_max_` | number | Price band | | `beds_min_` / `beds_max_` | number | Bedroom count | | `baths` | string | Minimum baths, `one` through `four`, plus `oneAndHalf` and `twoAndHalf` | | `homeTypes__` | array | `house`, `townhouse`, `townhome`, `condo`, `land`, `multiFamily`, `mobile`, `coOp`, `apartment`, `other`. Which values apply depends on `type` | | `statusOptions__` | array | `active`, `comingSoon`, `contingentPending` | | `listingType_category___` | array | `byAgent`, `byOwnerFsbo`, `newConstruction`, `foreclosures` | | `timeOnRedfin` | string | `newListing` through `moreThan45Days` | | `soldWithinOption` | string | Sold window, from `lastOneWeek` to `lastFiveYear`. See the warning below | | `yearBuilt_min_` / `yearBuilt_max_` | string | A year from a fixed ladder, `1940` through `2026` | | `forSaleSquareFeet_min_` / `_max_` | string | Floor area from a fixed ladder, `750` through `10000` | | `lotSize_min_` / `lotSize_max_` | string | `2000 sqft` through `100 acres`, as written | | `cost_hoa_` | number | Maximum monthly HOA fee | | `cost_priceReduced_` | string | `inTheLastDay` through `moreThan120Days` | | `homeFeatures_options___` | array | `waterfront`, `hasAView`, `fireplace`, `fixerUpper`, `guestHouse`, `elevator`, `greenHome`, `accessibleHome` and more | | `homeFeatures_poolType_` | string | `privatePool`, `communityPool`, `privateOrCommunityPool`, `noPrivatePool` | | `homeFeatures_keywordSearch_` | string | Free text against the listing description | | `schools_greatSchoolRating_` | number | Minimum GreatSchools rating, 1 to 10 | | `transportScores_walkScore_` | number | Minimum walk score, 1 to 100 | | `rentalAmenities__` | array | `inUnitWasherDryer`, `parkingAllowed`, `utilitiesIncluded`, `furnished`, `pool` and more | | `pets__` | array | `dogsAllowed`, `catsAllowed` | | `moveInDate` | string | `MM/DD/YYYY` | A market search returns `searchInformation` with `totalResults`, a `properties` array of 40, and `pagination` with `currentPage`, `nextPage` and an `otherPages` map. A for-sale or sold property carries `id`, `mlsId`, `url`, `homeType`, `status`, `price`, `beds`, `baths`, `area`, `yearBuilt`, `daysOnSite`, `addressRaw`, a parsed `address`, `latitude`, `longitude`, `description`, `atAGlanceFacts` and `photos`. ```json { "id": 31625298, "mlsId": "2190201772333567097", "url": "https://www.redfin.com/TX/Austin/1721-Deerfield-Dr-78741/home/31625298", "homeType": "House", "status": "FOR_SALE", "price": 675000, "beds": 3, "baths": 2, "area": 1667, "yearBuilt": 1963, "daysOnSite": 0, "addressRaw": "1721 Deerfield Dr, Austin, TX 78741", "address": { "street": "1721 Deerfield Dr", "city": "Austin", "state": "TX", "zipcode": "78741" }, "latitude": 30.231372, "longitude": -97.734893, "atAGlanceFacts": [ { "factLabel": "Property Type", "factValue": "Single-family" }, { "factLabel": "Year Built", "factValue": "1963" }, { "factLabel": "Price/Sq.Ft.", "factValue": "$405" } ] } ``` A rental is a building rather than a home, so `type: forRent` returns a different shape. `price`, `beds`, `baths` and `area` each become a `{ min, max }` object across the available units, and the entry adds `propertyName`, `availableUnits`, `agentEmail` and `agentPhone` while dropping `mlsId`, `homeType`, `yearBuilt` and `daysOnSite`. ```json { "id": "31510362", "propertyName": "The Sonata", "status": "FOR_RENT", "availableUnits": 12, "price": { "min": 745, "max": 1300 }, "beds": { "min": 1, "max": 2 }, "baths": { "min": 1, "max": 2 }, "area": { "min": 474, "max": 976 }, "addressRaw": "1070 Mearns Meadow Blvd, Austin, TX 78758" } ``` ### Get Redfin property details [`hasdata_redfin_property_getPropertyDetails`](https://docs.hasdata.com/apis/redfin/property?utm_source=github&utm_medium=syndication&utm_campaign=redfin-mcp) One property page in full, by its Redfin URL. | Parameter | Type | Required | Notes | | :--- | :--- | :--- | :--- | | `url` | string | yes | The Redfin property URL, as the search tool returns it | Returns a `property` object. On top of everything the search result carries, it adds `propertyDetails`, `schools`, `nearby`, `agentInfo`, `viewsActivity`, `openHouseSchedule`, `updatedAt`, a `geo` object and the full `photos` collection, which ran to 61 images on the property below. `propertyDetails` is the specification block, grouped into `parking`, `interior`, `exterior`, `utilities` and `publicFacts`. Each group is an array of labelled sections, and each section is an array of `label` and `value` pairs, so it reads as the page presents it rather than as a typed object. Look up a fact by its label instead of by position. `schools.assignedSchools` carries the catchment schools with `greatSchoolsRating`, `parentRating`, `distanceInMiles` and a `servesHome` flag, which is the field that says whether the school actually serves this address. ```json { "id": 31625298, "homeType": "Single Family Residential", "status": "COMING SOON", "price": 675000, "beds": 3, "baths": 2, "area": 1667, "yearBuilt": 1963, "geo": { "latitude": 30.231372, "longitude": -97.734893 }, "updatedAt": "Sep 9, 2026 4:04 AM", "viewsActivity": { "views": 98, "favorites": 5 }, "agentInfo": { "agentName": "Lilly Rockwell", "agentPhoneNumber": "512-413-1975", "brokerName": "Compass", "brokerPhoneNumber": "" }, "propertyDetails": { "parking": [{ "parkingInformation": [{ "label": "Has Garage", "value": "yes" }] }], "utilities": [{ "utilitiesInformation": [{ "label": "Has Air Conditioning", "value": "yes" }] }] }, "schools": { "assignedSchools": [{ "greatSchoolsRating": 6, "parentRating": 5, "servesHome": true }] } } ``` ## Errors and failure paths Plan for these rather than assuming a happy path. **`soldWithinOption` is currently broken and silently returns for-sale homes labelled `SOLD`.** Passing any of its values puts the value straight into the Redfin filter, Redfin does not recognise it, and the response is the active for-sale list with `status` stamped as `SOLD`. Every listing came back identical to the plain for-sale search in our checks. Leave the parameter off. `type: sold` on its own works correctly and covers the last three months, which is Redfin's own default window. **The search tool returns three different shapes, and which one you get depends on the keyword.** A market keyword answers with `searchInformation`, `properties` and `pagination`. A full street address or a named building answers with a single `property` object and no `properties` array, no `searchInformation` and no `pagination`. A rental search answers with the range-shaped entries shown above. Branch on the presence of `properties` before you iterate it. **`totalResults` tops out at 350, and that is a ceiling rather than a count.** Austin and New York both report 350 while a single zipcode reports 168 and a small town 57. Pagination stops at nine pages of 40. To enumerate a large market, slice it by zipcode, price band or home type instead of paging, because there is no page ten. **Sold search does not give you sold prices as a separate field.** `price` holds whatever the page shows for that status, so a for-sale price and a sold price arrive in the same field. Read `status` alongside it every time. **There is no price history, tax history or Redfin Estimate in the property response.** Those sit on the page but are not in what the tool returns today. What you get instead is `propertyDetails.publicFacts`, which carries the assessor-style facts as label and value pairs. **`nearby.pointsOfInterest` is nearby places, not comparable sales.** Its `categories` come from a third-party places dataset and are frequently wrong, so a title loan office can arrive tagged as a bar. Use the names and coordinates, and do not trust the category. **`openHouseSchedule` can be an array holding an empty object** when the page has the section but no dates in it. Test the contents, not the length. **`brokerPhoneNumber` and other agent fields come back as empty strings rather than null.** Treat empty string as absent. Results that carry data also carry a `requestMetadata.id` worth quoting in support. ## Pricing, free tier and limits Each Redfin tool costs **5 credits per successful call**. Response size does not change the price, so a 40-listing page and a single property cost the same. The free tier is **1,000 credits every month with no card**, which is 200 Redfin calls at the base rate. It renews with the billing cycle, so a low-volume agent runs on the free tier indefinitely. Paid plans start at **$49 a month** for 200,000 credits, which is 40,000 calls. The unit price falls with volume, from **$1.23 per 1,000 calls** on the entry plan to **$0.50** on Business, **$0.42** on Growth and **$0.37** on the largest [high-volume plans](https://hasdata.com/prices?utm_source=github&utm_medium=syndication&utm_campaign=redfin-mcp). Your plan also sets concurrency. The free tier allows 1 reque … ## Source & license This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code. - **Author:** [HasData](https://github.com/HasData) - **Source:** [HasData/redfin-mcp](https://github.com/HasData/redfin-mcp) - **License:** MIT - **Homepage:** https://hasdata.com/apis/redfin-api Install and usage instructions live in the source repository linked above. ## Pricing - **Free** — Free ## Security capabilities Automated source analysis of v0.1.0 — what this tool can access: - **Network access:** no - **Filesystem access:** no - **Shell / process execution:** no - **Environment & secrets:** no - **Dynamic code execution:** no *"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.* ## Versions - **0.1.0** — security scan: passed — Imported from the upstream source. ## Links - Listing page: https://agentstack.voostack.com/l/mcp-hasdata-redfin-mcp - Seller: https://agentstack.voostack.com/s/hasdata - Browse the marketplace: https://agentstack.voostack.com/browse --- Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.