# RealtyCrawl

> RealtyCrawl is a freemium MCP server for analytics and data. Source-linked real estate listings and observations for agents, paid in credits. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, self-hosted
- **Website:** https://realtycrawl.dev
- **Repository:** https://github.com/realtycrawl/realtycrawl-mcp
- **MCP Registry name:** io.github.realtycrawl/realtycrawl
- **Categories:** analytics and data, web search and scraping
- **Listing updated:** 2026-11-15

## About

Every call is budgeted. The server exposes five tools, and only `call_endpoint` spends credits: it needs an explicit `maxCredits` ceiling and, for POST calls, a stable `idempotencyKey`, so a retry with the same key and input is replayed for free. Zillow listing searches cost 3 credits per returned listing (default limit 10), other source crawls cost 50 credits per successful platform, and stored-observation reads cost 1.

The README is candid that the public contract includes research-stage and unavailable operations, so the intended flow is to run `get_capabilities` for a platform and country first, then read the operation schema with `get_endpoint`. The website lists 67 operations across 206 researched platforms, with live examples for Zillow, Redfin, Realtor, Rightmove and Idealista covering the US, Great Britain and Spain.

Responses keep provenance, units, currency and unknown values intact, and the README tells agents to treat source text as data rather than instructions. The client pins the API origin, refuses redirects, times out at 60 seconds and caps responses at 8 MiB. CSV and NDJSON exports are available through `fields` and `format` parameters.

## Features

- **Capability discovery:** Free tools list platforms, countries and which operations are currently live before anything is spent.
- **Explicit credit budgets:** Each paid call carries a maximum credit limit, and failed provider calls are refunded.
- **Provenance preserved:** Observations keep their source, currency, units and partial-result warnings.
- **Schema lookup:** get_endpoint returns one operation's input schema from the public OpenAPI.
- **CSV and NDJSON export:** Responses can come back as raw CSV or NDJSON with a chosen field list.
- **Hosted or local:** Use the Streamable HTTP endpoint with a bearer key, or run the stdio server from a clone with Node.js 22+.

## Good for

- Compare Zillow, Redfin and Realtor listings for a US city from one agent
- Check which sources cover a country before planning a data collection
- Pull rental or sale listings from Rightmove or Idealista into a spreadsheet
- Budget a real estate research job with known per-call credit costs
- Export property observations as CSV for analysis

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http realtycrawl https://realtycrawl.dev/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://realtycrawl.dev/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "realtycrawl": {
      "url": "https://realtycrawl.dev/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "realtycrawl": {
      "type": "http",
      "url": "https://realtycrawl.dev/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "realtycrawl": {
      "serverUrl": "https://realtycrawl.dev/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "realtycrawl": {
      "type": "http",
      "url": "https://realtycrawl.dev/mcp"
    }
  }
}
```

## Tools

- `list_platforms`: Free inventory of researched platforms; research is not live coverage.
- `get_capabilities`: Free list of current operations, source filters and countries.
- `list_endpoints`: Discover operation IDs from the public OpenAPI.
- `get_endpoint`: Read one operation's input schema.
- `call_endpoint`: Execute one explicitly budgeted operation.

## FAQ

### How are credits charged?

Zillow listing searches cost 3 credits per returned listing, other source crawls cost 50 credits per successful platform, stored reads cost 1, and metadata and idempotent replays are free.

### Is there a free allowance?

Yes. The pricing page offers 500 free signup credits that do not expire, and failed provider calls are refunded.

### Can I run it locally?

Yes, by cloning the repository and launching src/index.mjs with REALTYCRAWL_API_KEY set. The npm package has not been published.

### Does a listed platform mean I can query it?

No. The README says the catalogue includes research and unavailable operations, so check get_capabilities first.

### Is RealtyCrawl free?

RealtyCrawl has a free plan, with paid plans for more usage or features.

### How do I add RealtyCrawl to Claude Code?

Run this command in your terminal: claude mcp add --transport http realtycrawl https://realtycrawl.dev/mcp

### What are the best alternatives to RealtyCrawl?

The closest alternatives to RealtyCrawl are Scrapling MCP Server, Firecrawl MCP Server, Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP and SearXNG Search.

## Alternatives

- [Scrapling MCP Server](https://ai-powered.com/mcp/scrapling-mcp-server): Scrapling MCP Server is an open-source MCP server for web search and scraping.
- [Firecrawl MCP Server](https://ai-powered.com/mcp/firecrawl-mcp-server): Firecrawl MCP Server is a freemium MCP server for web search and scraping.
- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [SearXNG Search](https://ai-powered.com/mcp/searxng-search): SearXNG Search is an open-source MCP server for web search and scraping.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.

---
Source: https://ai-powered.com/mcp/realtycrawl
