HasData Redfin

Redfin MCP Server

A hosted Redfin 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 100 Redfin calls at the 10-credit rate.

https://mcp.hasdata.com/mcp?apis=redfin

• Prompts and resources

Contents

• What you need
• Quick start
• Example prompts
• Tools
• Errors and failure paths
• Pricing, free tier and limits
• Tool selection
• How it compares
• FAQ
• HasData links
• Development
• Contributing
• License

What you need

An MCP client and a HasData API key from the dashboard, free to create with no card, and the free tier covers about 100 calls a month at the 10-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.

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

claude mcp add --transport http redfin "https://mcp.hasdata.com/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/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:

{

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

{

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

{

"mcpServers": { "redfin": { "url": "https://mcp.hasdata.com/mcp?apis=redfin", "headers": { "x-api-key": "HASDATA_API_KEY" } } } }

Windsurf

~/.codeium/windsurf/mcp_config.json. Windsurf calls the field serverUrl, not url:

{

"mcpServers": { "redfin": { "serverUrl": "https://mcp.hasdata.com/mcp?apis=redfin", "headers": { "x-api-key": "HASDATA_API_KEY" } } } }

VS Code

.vscode/mcp.json in the workspace:

{

"servers": { "redfin": { "type": "http", "url": "https://mcp.hasdata.com/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

Two tools, 10 credits per successful call.

Get Redfin real estate listings

hasdata_redfin_listing_getRealEstateListings

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.

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:

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.

atAGlanceFacts has two shapes. On a search row it is a list of selling-point strings, and on the property response it is a list of factLabel and factValue pairs, so code that reads one shape breaks on the other.

{

"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": ["Hill country views", "2020 roof", "Stainless appliances"] }

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.

{

"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

One property page