# Real Estate MCP (`themineworks/real-estate-mcp`) Actor

The Zillow API that doesn't exist — listings, solds, rentals, comps, Redfin, Realtor.com and Airbnb supply behind one MCP endpoint. No result, no charge.

- **URL**: https://apify.com/themineworks/real-estate-mcp.md
- **Developed by:** [The Mine Works](https://apify.com/themineworks) (community)
- **Categories:** MCP servers, Real estate
- **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $50.00 / 1,000 for-sale listings

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## Real Estate MCP

**The Zillow API that doesn't exist — listings, solds, rentals, and comps for AI agents.**

Eight tools behind one MCP endpoint, across Zillow, Redfin, Realtor.com, and Airbnb. Ask for a market, get the whole picture in one call.

Built by [The Mine Works](https://apify.com/themineworks).

### Tools

| Tool | What it returns | Price |
|---|---|---|
| `search_listings` | Homes for sale on Zillow, with price/bed/type filters | $0.05 / 25 listings |
| `recently_sold` | Recent solds — the comps you price against | $0.05 / 25 listings |
| `rental_listings` | Rentals with rent range and bedroom filters | $0.05 / 25 listings |
| `property_details` | Zestimate, price history, tax history, schools | $0.08 |
| `redfin_search` | Redfin for-sale or sold listings — a second opinion | $0.06 / 25 listings |
| `realtor_search` | Realtor.com listings, for sale or sold | $0.06 / 25 listings |
| `str_market` | Airbnb short-term rental supply, prices, ratings | $0.08 / 25 listings |
| `market_report` | For-sale + sold + rentals + STR for one location | **$0.16** complete · $0.10 partial · $0.04/section · $0 nothing found |

**The market report always costs less than calling the tools one by one.**

### Worked example

Ask your agent: *"Should I buy a rental in 78701? What do comps and Airbnb supply look like?"*

```json
// tools/call → market_report
{ "location": "78701", "per_source": 25 }
```

Returns `for_sale`, `recently_sold`, `rentals`, and `short_term_rentals` in one object — enough for an agent to reason about yield without four separate integrations.

### Setup

```json
{
  "mcpServers": {
    "real-estate": {
      "url": "https://themineworks--real-estate-mcp.apify.actor/mcp",
      "headers": { "Authorization": "Bearer YOUR_APIFY_TOKEN" }
    }
  }
}
```

Works in Claude Desktop, Claude Code, Cursor, and Windsurf. Cold start ~9s.

### Billing promise

**No result, no charge. Ever.** A location with no matching listings returns an empty, unbilled answer.

Identical repeat calls within 60 seconds are free. Apify platform usage is billed by Apify on top, as with any Standby actor.

### Honest limits

- **US only.** Every source here is a US property portal.
- **Listing data is a live read, not an MLS feed.** It reflects what the public site shows at that moment; it is not a licensed MLS product and should not be treated as one.
- Very broad locations (a whole state) return slower and may be capped by the portal's own paging.

### More from The Mine Works

Individual scrapers at [apify.com/themineworks](https://apify.com/themineworks). Full MCP suite: [themineworks.com/mcp](https://themineworks.com/mcp).

# Actor input Schema

## `readme` (type: `string`):

This Actor serves Zillow, Redfin and Realtor.com listings, solds, rentals and Airbnb supply to AI agents over the Model Context Protocol.

Connect your MCP client to:
https://themineworks--real-estate-mcp.apify.actor/mcp

with your Apify API token as a Bearer token. Works in Claude Desktop, Claude Code, Cursor and Windsurf — copy-paste config blocks are in the README.

Starting a normal run here does nothing except print this pointer.

## Actor input object example

```json
{
  "readme": "Connect your MCP client to https://themineworks--real-estate-mcp.apify.actor/mcp — see the README."
}
```

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {};

// Run the Actor and wait for it to finish
const run = await client.actor("themineworks/real-estate-mcp").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("themineworks/real-estate-mcp").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{}' |
apify call themineworks/real-estate-mcp --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=themineworks/real-estate-mcp",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/acts/pnHps5OE6M6LcOzs3/builds/Ez7uPBJlSCgeuM1jH/openapi.json