---
name: realtydataapi
description: Official Model Context Protocol (MCP) server and AI Agent Skill for RealtyData API (https://realtydataapi.com). Real-time US & Canada MLS listings, Zillow & Realtor.com property valuations (AVM), rent estimates, gross cap-rate dossiers, 37-photo comps, Redfin parcel & building records, location autocomplete, and broker directories — Zero Bridge Approval Needed, $0.20 / 1,000 requests ($0.08–$0.20 / 1,000 on volume tiers, $0.0002/call). Includes $1.20 instant free credits (12,000 credits) on signup + $2.00 Sandbox Streak bonus.
version: 1.1.0
homepage: https://realtydataapi.com
mcp_url: https://mcp.realtydataapi.com/mcp
mcp_apikey_url: https://api.realtydataapi.com/mcp
mcp_page: https://realtydataapi.com/mcp
documentation: https://realtydataapi.com/docs
pricing: https://realtydataapi.com/pricing
signup: https://realtydataapi.com/signup
openapi: https://realtydataapi.com/openapi.json
apis_json: https://realtydataapi.com/apis.json
llms_txt: https://realtydataapi.com/llms.txt
llms_full_txt: https://realtydataapi.com/llms-full.txt
status_page: https://realtydataapi.com/status
license: MIT
author: RealtyData API (https://realtydataapi.com)
tags:
  - mcp
  - claude-skill
  - agent-skill
  - zillow-api-alternative
  - real-estate-api
  - realtor-api
  - redfin-api
  - mls-listings-api
  - property-valuation-api
  - cap-rate-calculator
  - proptech
---

# RealtyData API — Official Remote MCP Server & AI Agent Skill (`realtydataapi`)

Connect **Claude Code**, **Claude Desktop**, **Cursor**, **Windsurf**, **Cline**, **ChatGPT Connectors**, **LangChain**, and **n8n** directly to **[RealtyData API (`https://realtydataapi.com`)](https://realtydataapi.com)** — the real-time US & Canada real estate & PropTech valuation gateway unifying **Zillow / Realtor.com MLS Listings, AVM Valuations, Monthly Rent & Gross Cap-Rate Dossiers, Redfin Parcels, and Broker Directories** with **zero Bridge approval waiting**.

## Pricing & Instant Free Trial

- **Standard Pay-As-You-Go Rate**: **`$0.20 / 1,000 requests`** (`$0.0002 / call` · 2 Credits per search item/call, where `$1.00 = 10,000 Credits`)
- **Volume & Subscription Rate**: **`$0.08–$0.20 / 1,000`** (`$9` Indie Starter Pack, `$19/mo` Starter, `$69/mo` Growth, `$199/mo` Scale — plus **+5% bonus** on 0%-fee Crypto top-ups)
- **Zero-Charge Guarantee**: `HTTP 200` empty results or upstream errors strictly charge **`0` credits**
- **Instant Free Trial (`$1.20` Free Credits)**: Claim **`$1.20` instant free credits** (`12,000` credits = `6,000` property/parcel searches, no card required) + up to **`+$2.00`** Developer Sandbox Streak (`32,000` free credits total) at **[https://realtydataapi.com/signup](https://realtydataapi.com/signup)**

## Key Discovery & Documentation Links

- **Website & Live Property Valuation Terminal**: [https://realtydataapi.com](https://realtydataapi.com)
- **Instant Free API Key (`$1.20` Free Credits)**: [https://realtydataapi.com/signup](https://realtydataapi.com/signup)
- **Remote Streamable HTTP MCP Endpoint (OAuth 2.1 PKCE)**: `https://mcp.realtydataapi.com/mcp`
- **API-Key Streamable HTTP MCP Endpoint**: `https://api.realtydataapi.com/mcp`
- **Interactive API Reference**: [https://realtydataapi.com/docs](https://realtydataapi.com/docs)
- **Pricing & Credit Calculator**: [https://realtydataapi.com/pricing](https://realtydataapi.com/pricing)
- **OpenAPI 3.1 Specification**: [https://realtydataapi.com/openapi.json](https://realtydataapi.com/openapi.json)
- **APIs.json Manifest**: [https://realtydataapi.com/apis.json](https://realtydataapi.com/apis.json)
- **Well-Known Agent Skill**: [https://realtydataapi.com/.well-known/skills/default/SKILL.md](https://realtydataapi.com/.well-known/skills/default/SKILL.md)

---

## One-Click Installation: Claude Code, Cursor & Agent Skills

### 1. Claude Code CLI — OAuth 2.1 Browser Sign-In (Zero Key Copy)

```bash
claude mcp add --transport http realtydataapi https://mcp.realtydataapi.com/mcp
```

### 2. Claude Code CLI — Direct API Key Header

```bash
claude mcp add --transport http realtydataapi https://api.realtydataapi.com/mcp \
  --header "x-api-key: rl_live_your_api_key_here"
```

### 3. Cursor (`.cursor/mcp.json`) / Windsurf / Claude Desktop

```json
{
  "mcpServers": {
    "realtydataapi": {
      "url": "https://mcp.realtydataapi.com/mcp",
      "headers": {
        "x-api-key": "rl_live_your_api_key_here"
      }
    }
  }
}
```

### 4. Agent Skills CLI Auto-Install (`/.well-known/skills/default/SKILL.md`)

```bash
npx skills add https://realtydataapi.com
```

---

## Direct REST `curl` Examples (Zillow / Realtor.com / Redfin Unified)

### 1. MLS & Realtor.com / Zillow For-Sale Search (`/v1/properties/search` & `/v1/realtor/search`)

Automatically normalizes 5-digit US ZIP codes (`78701`) and `City, ST` (`Austin, TX`) queries, returning normalized listing price, AVM valuation, instant equity delta, estimated monthly rent, and gross cap rate:

```bash
# Canonical endpoint
curl -sS "https://api.realtydataapi.com/v1/properties/search?location=78701&status=for_sale&limit=20" \
  -H "x-api-key: rl_live_your_api_key_here"

# Drop-in Realtor.com / Zillow migration alias (/v1/realtor/search & /v1/zillow/search)
curl -sS "https://api.realtydataapi.com/v1/realtor/search?location=Austin,+TX&status=for_sale&limit=20" \
  -H "x-api-key: rl_live_your_api_key_here"
```

### 2. Full 37-Photo Property Valuation, Tax & Comps Dossier (`/v1/properties/detail` & `/v1/realtor/property`)

```bash
# Canonical property valuation & comps dossier
curl -sS "https://api.realtydataapi.com/v1/properties/detail?property_id=M9482710563" \
  -H "x-api-key: rl_live_your_api_key_here"

# Drop-in Realtor.com / Zillow property detail alias (/v1/realtor/property & /v1/zillow/property)
curl -sS "https://api.realtydataapi.com/v1/realtor/property?property_id=M9482710563" \
  -H "x-api-key: rl_live_your_api_key_here"
```

### 3. Redfin Parcel, HOA, APN & Multi-Unit Building Search (`/v1/redfin/search`)

```bash
curl -sS "https://api.realtydataapi.com/v1/redfin/search?location=78701&limit=20" \
  -H "x-api-key: rl_live_your_api_key_here"
```

### 4. Location Boundary Autocomplete & Active Broker Directory

```bash
# Low-latency ZIP, city, neighborhood & street address autocomplete
curl -sS "https://api.realtydataapi.com/v1/locations/autocomplete?query=78701" \
  -H "x-api-key: rl_live_your_api_key_here"

# Active real estate agents & brokerages by ZIP or city
curl -sS "https://api.realtydataapi.com/v1/agents/search?location=78701&page=1" \
  -H "x-api-key: rl_live_your_api_key_here"
```

---

## Core Endpoints, Aliases & Unit Credit Pricing (`$0.20 / 1,000 requests` PAYG · `$0.08–$0.20 / 1,000` Tiers)

| MCP Tool Name | Canonical REST Endpoint & Drop-In Aliases | Credit Cost | Effective USD Rate | Description |
| :--- | :--- | :--- | :--- | :--- |
| `search_properties` | `GET /v1/properties/search` (`/v1/realtor/search`, `/v1/zillow/search`) | **2 Credits / property** (`0` if empty) | `$0.20 / 1,000 requests` (`$0.08–$0.20 / 1,000`) | Search US & Canada MLS listings (`for_sale`, `for_rent`, `sold`) by ZIP or city with AVM value, rent estimate & gross cap rate. |
| `get_property_detail` | `GET /v1/properties/detail` (`/v1/realtor/property`, `/v1/zillow/property`) | **10 Credits / property** (`0` on 404) | `$0.40–$1.00 / 1,000 details` | Full 37-photo property valuation dossier, county tax/deed history, HOA fees, and assigned school ratings. |
| `search_redfin_parcels` | `GET /v1/redfin/search` (`/v1/redfin/properties`) | **2 Credits / parcel** (`0` if empty) | `$0.20 / 1,000 requests` (`$0.08–$0.20 / 1,000`) | Streamlined Redfin parcel inventory (APN, HOA dues, MLS ID, DOM, coordinates) + multi-unit building rollups. |
| `autocomplete_locations` | `GET /v1/locations/autocomplete` (`/v1/autocomplete`) | **2 Credits / call** (`0` if empty) | `$0.20 / 1,000 requests` (`$0.08–$0.20 / 1,000`) | Low-latency city, ZIP code, neighborhood, county & street address boundary autocomplete. |
| `search_real_estate_agents` | `GET /v1/agents/search` (`/v1/realtors/search`) | **2 Credits / agent** (`0` if empty) | `$0.20 / 1,000 requests` (`$0.08–$0.20 / 1,000`) | Active real estate agents & brokerages by ZIP or city with 12-month sold volume, ratings & contact info. |
| `estimate_rental_cap_rate` | `GET /v1/properties/detail` | **10 Credits / dossier** | `$0.40–$1.00 / 1,000 dossiers` | Compute monthly rent, gross cap rate, net operating income (NOI), HOA & tax burden for investment underwriting. |
| `compare_zip_market_comps` | `GET /v1/properties/search` | **2 Credits / comp** | `$0.20 / 1,000 requests` (`$0.08–$0.20 / 1,000`) | Pull median $/sqft, days on market, and instant equity comps across target US ZIP codes. |

---

## Engineering Guides & Free PropTech Browser Utilities

- **Engineering Guides**:
  - [Zillow API Alternative (2026): Instant MLS, Valuation & Rent JSON Without Bridge Approval](https://realtydataapi.com/guides/zillow-api-alternative)
  - [Real Estate API Developer Guide (2026): Unified US & Canada Listings, AVM & Comps](https://realtydataapi.com/guides/real-estate-api-guide)
  - [Realtor.com API Alternative: Dual-Rail MLS Search, 37-Photo Details & Agent Directories](https://realtydataapi.com/guides/realtor-com-api-alternative)
  - [Redfin API & Parcel Data Guide: Streamlined MLS, HOA & Building JSON](https://realtydataapi.com/guides/redfin-api-scraper-guide)
  - [Rental Yield & Cap-Rate API Guide: Automating PropTech Underwriting & AI Deal Screening](https://realtydataapi.com/guides/rental-yield-cap-rate-api)
- **Free Developer Tools**:
  - [US Rental Yield, Gross/Net Cap Rate & Cash-Flow Calculator](https://realtydataapi.com/tools/rental-cap-rate-calculator)
  - [Real Estate & MLS API Cost Calculator](https://realtydataapi.com/tools/real-estate-api-cost-calculator)
  - [Bulk Property URL, ZPID, MLS ID & ZIP Token Normalizer](https://realtydataapi.com/tools/property-id-address-normalizer)

## Support & Contact

- **Signup (`$1.20` Instant Free Credits)**: [https://realtydataapi.com/signup](https://realtydataapi.com/signup)
- **Documentation**: [https://realtydataapi.com/docs](https://realtydataapi.com/docs)
- **Engineering Support**: `support@realtydataapi.com`
