# Property Comps MCP Server

An MCP (Model Context Protocol) server that gives AI agents access to comparable sales data and property transactions across 16 markets in 6 countries. 43M+ records sourced from government open data registries -- not estimates, not listings.

Works with Claude Desktop, Claude Code, and any MCP-compatible AI client.

**Built by [New Way Capital Advisory](https://nwc-advisory.com)** | [API Docs](https://api.nwc-advisory.com/docs) | [Portfolio X-Ray](https://nwc-advisory.com/xray)

[![Available on RapidAPI](https://img.shields.io/badge/RapidAPI-Property%20Comps%20API-blue?logo=rapidapi)](https://rapidapi.com/NWCA/api/property-comparable-sales) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)

## What It Does

Ask your AI assistant questions like:
- "What are comparable sales near 10001 in NYC?"
- "What's the median property price in Dubai Marina?"
- "Show me recent sales near SW1A1DA in London"
- "Compare Seattle vs Phoenix house prices"
- "What sold near 80202 in Denver last 6 months?"

The server queries official government property registries and returns real transaction data — not estimates.

## Markets

| Market | Transactions | Source | Currency | Web App |
|--------|-------------|--------|----------|---------|
| United Kingdom | 31,000,000 | HM Land Registry | GBP | [property.nwc-advisory.com](https://property.nwc-advisory.com) |
| France | 8,300,000 | DVF (data.gouv.fr) | EUR | [property-fr.nwc-advisory.com](https://property-fr.nwc-advisory.com) |
| Dubai | 1,006,000 | Dubai Land Department | AED | [property-dxb.nwc-advisory.com](https://property-dxb.nwc-advisory.com) |
| Singapore | 973,000 | Housing & Development Board | SGD | [property-sg.nwc-advisory.com](https://property-sg.nwc-advisory.com) |
| Phoenix | 841,000 | Maricopa County Assessor | USD | [property-us.nwc-advisory.com](https://property-us.nwc-advisory.com) |
| Seattle | 803,000 | King County Assessor | USD | [property-us.nwc-advisory.com](https://property-us.nwc-advisory.com) |
| Taiwan | 669,000 | Ministry of Interior | TWD | [property-tw.nwc-advisory.com](https://property-tw.nwc-advisory.com) |
| New York City | 505,000 | NYC Dept of Finance | USD | [property-nyc.nwc-advisory.com](https://property-nyc.nwc-advisory.com) |
| Pittsburgh | 288,000 | Allegheny County | USD | [property-us.nwc-advisory.com](https://property-us.nwc-advisory.com) |
| Miami | 284,000 | Miami-Dade County | USD | [property-miami.nwc-advisory.com](https://property-miami.nwc-advisory.com) |
| Connecticut | 282,000 | Office of Policy & Management | USD | [property-ct.nwc-advisory.com](https://property-ct.nwc-advisory.com) |
| Chicago | 282,000 | Cook County Assessor | USD | [property-chi.nwc-advisory.com](https://property-chi.nwc-advisory.com) |
| Washington DC | 256,000 | OTR CAMA | USD | [property-dc.nwc-advisory.com](https://property-dc.nwc-advisory.com) |
| Philadelphia | 240,000 | Office of Property Assessment | USD | [property-phl.nwc-advisory.com](https://property-phl.nwc-advisory.com) |
| Ireland | 230,000 | Property Price Register | EUR | [property-ie.nwc-advisory.com](https://property-ie.nwc-advisory.com) |
| Denver | 53,000 | Denver County Assessor | USD | [property-us.nwc-advisory.com](https://property-us.nwc-advisory.com) |

## Tools

| Tool | Description |
|------|-------------|
| `search_property_comps` | Search comparable sales by location and radius. Returns prices, dates, addresses, property types, and statistics. |
| `get_area_stats` | Get area price statistics: median, average, min, max, broken down by property type. |
| `list_markets` | List all 16 available markets with transaction counts and examples. |

## Installation

```bash
pip install mcp httpx
```

## Setup — Claude Desktop

Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "property-comps": {
      "command": "python",
      "args": ["path/to/mcp_server.py"]
    }
  }
}
```

On macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
On Windows: `%APPDATA%\Claude\claude_desktop_config.json`

## Setup — Claude Code

```bash
claude mcp add property-comps python /path/to/mcp_server.py
```

## How It Works

The server auto-detects the market from your location format:

| Input | Detected Market |
|-------|----------------|
| `SW1A1DA` | UK (postcode pattern) |
| `10001` | NYC (ZIP code range) |
| `75001` | France (postal code range) |
| `310093` | Singapore (6-digit code) |
| `Dubai Marina` | Dubai (area name) |
| `20001` | Washington DC (ZIP range) |
| `98115` | Seattle (ZIP range) |
| `85004` | Phoenix (ZIP range) |
| `80202` | Denver (ZIP range) |
| `15222` | Pittsburgh (ZIP range) |
| `Greenwich` | Connecticut (town name) |
| `Dublin` | Ireland (county name) |
| `Taipei` | Taiwan (city name) |

You can also specify the market explicitly: `market="uk"`, `market="nyc"`, etc.

## Example

**User:** "What are recent property sales near 10001 in NYC?"

**AI Response:**
```
New York City - 42 comparable sales found near 10001

Statistics: Median: USD 515,000 | Average: USD 892,000 | Range: USD 185,000 - USD 3,200,000

1. USD 515,000 | 2025-12-23 | Condo | 123 W 23rd St, Manhattan
2. USD 1,250,000 | 2025-11-15 | Condo | 45 W 25th St, Manhattan
3. USD 375,000 | 2025-10-30 | 1-Family | 310 E 23rd St, Manhattan

Data source: New York City government property registry
```

## Data

All comparable sales data comes from official government open data registries. Updated monthly. Every result is an actual recorded property transaction — not an estimate, not a listing price. The same government sources that banks and surveyors rely on for valuations.

## Also Available on RapidAPI

Don't need MCP? The same comparable sales data is available as a standard REST API on **RapidAPI**, listed under **"Property Comps API"** in the Real Estate category.

- **RapidAPI Listing:** [Property Comparable Sales API](https://rapidapi.com/NWCA/api/property-comparable-sales)
- **4 pricing tiers:** Free (50 req/mo), Pro ($29), Ultra ($99), Mega ($299)
- **No API key needed for MCP** — the MCP server connects directly to the backend

## API

This MCP server connects to the [Property Comps API](https://api.nwc-advisory.com/docs). The same API powers the RapidAPI listing and all 16 market-specific web apps.

- **API Documentation:** https://api.nwc-advisory.com/docs
- **OpenAPI Spec:** https://api.nwc-advisory.com/openapi.json
- **RapidAPI Marketplace:** [Property Comparable Sales API](https://rapidapi.com/NWCA/api/property-comparable-sales)
- **All Markets:** https://api.nwc-advisory.com/markets

## US Markets -- Unified Platform

The 10 US cities are also available through a single unified interface at [property-us.nwc-advisory.com](https://property-us.nwc-advisory.com) -- one login, one search across NYC, Chicago, Miami, Philadelphia, DC, Seattle, Phoenix, Denver, Pittsburgh, and Connecticut.

## Other Tools

- [Portfolio X-Ray](https://nwc-advisory.com/xray) -- Free fund look-through analysis (Morningstar X-Ray alternative)
- [Portfolio Consolidation](https://nwc-advisory.com/portfolio/consolidation) -- Multi-custodian portfolio merging with bilingual PDF reports
- [Market Risk API](https://nwc-advisory.com) -- 7-signal regime detection with full audit trail

## License

MIT