uk.co.propbar/research

Install

Config snippet generator goes here (5 client tabs)

README

# Propbar MCP Server

[![MCP Registry](https://img.shields.io/badge/MCP-Registry-blue)](https://registry.modelcontextprotocol.io)
[![UK Property Data](https://img.shields.io/badge/UK-Property%20Data-green)](https://propbar.co.uk)

MCP server providing **UK property research tools** for AI assistants. Enables Claude, GPT, and other LLMs to search properties, analyse area safety, find nearby schools, explore demographics, and **build automated valuation models (AVMs)**.

Powered by [Propbar's](https://propbar.co.uk) comprehensive UK property database covering **30+ million properties**.

## Use Cases

### Build Your Own AVM

The `get_comparables` tool provides access to a **comprehensive property search** with 50+ filterable fields - perfect for building automated valuation models:

- **Transaction Data**: Sale history with dates and amounts, current asking prices
- **Market Status**: For sale, SSTC, under offer, reserved, back on market dates
- **Property Attributes**: Type, beds, baths, floor area, construction age
- **EPC Data**: Energy ratings (A-G), efficiency scores, potential ratings
- **Tenure & Charges**: Freehold/leasehold, lease years remaining, service charges, ground rent
- **Pricing Metrics**: Price per sqm, price per sqft, price changes over time
- **Listing Intelligence**: Days on market, price reductions, portal links

**Example AVM workflow:**
```
1. get_comparables({ latitude, longitude, propertyType: "flat", bedrooms: 2 })
2. Filter by sale date (last 12 months) and distance
3. Adjust for differences (floor area, EPC rating, condition)
4. Calculate £/sqft and apply to subject property
```

### Property Research for Buyers

Help users make informed decisions with comprehensive area data:

- **Crime & Safety** - Is this area safe? How does it compare?
- **Schools** - What schools are nearby? Ofsted ratings?
- **Demographics** - Who lives here? Age, tenure, household types?
- **Market Analysis** - What are similar properties selling for?

## Available Tools

| Tool | Description | Input |
|------|-------------|-------|
| `search_areas` | Search UK areas by name or postcode | query |
| `search_properties` | Search UK properties by address | query |
| `get_area_details` | Get coordinates and area codes | areaCode or path |
| `get_crime_stats` | Crime statistics and safety rating | areaCode OR lat/lng |
| `get_schools` | Schools with Ofsted ratings | areaCode OR lat/lng |
| `get_demographics` | Census demographics | areaCode OR lat/lng |
| `get_property_basic` | Basic property details | propertyId |
| `get_property_full` | Full property with history | propertyId |
| `get_comparables` | **Comparable properties for valuation** | lat/lng + filters |

## Comparables Search Fields

The `get_comparables` tool queries an Elasticsearch index with **56 filterable fields**:

<details>
<summary><strong>Property Attributes</strong></summary>

| Field | Description |
|-------|-------------|
| `build.propertyType` | Detached, semi, terrace, flat, etc. |
| `roomDetails.beds` | Number of bedrooms |
| `roomDetails.baths` | Number of bathrooms |
| `build.totalFloorArea` | Total floor area (sqm) |
| `build.constructionAge.*` | Year built / construction period |
| `tenure.type` | Freehold, leasehold, share of freehold |
| `councilTax.taxBand` | Council tax band (A-H) |

</details>

<details>
<summary><strong>Pricing & Sales</strong></summary>

| Field | Description |
|-------|-------------|
| `pricing.currentSale` | Current asking price (sales) |
| `pricing.currentRent` | Current asking rent (pcm) |
| `saleHistory.date` | Historical sale dates |
| `saleHistory.amount` | Historical sale prices |
| `marketStatus.pricePerSqm` | Price per square metre |
| `marketStatus.pricePerSqft` | Price per square foot |

</details>

<details>
<summary><strong>Market Status</strong></summary>

| Field | Description |
|-------|-------------|
| `marketStatus.forSale` | Currently listed for sale |
| `marketStatus.forRent` | Currently listed for rent |
| `marketStatus.sstcDate` | Sold subject to contract date |
| `marketStatus.underOfferDate` | Under offer date |
| `marketStatus.reservedDate` | Reserved date (rentals) |
| `marketStatus.lastOTM` | Last on the market date |
| `marketStatus.backOTM` | Back on market flag |

</details>

<details>
<summary><strong>EPC & Energy</strong></summary>

| Field | Description |
|-------|-------------|
| `epc.currentRating` | Current EPC rating (A-G) |
| `epc.potentialRating` | Potential EPC rating |
| `epc.currentEfficiency` | Current efficiency score (1-100) |
| `epc.potentialEfficiency` | Potential efficiency score |

</details>

<details>
<summary><strong>Leasehold & Charges</strong></summary>

| Field | Description |
|-------|-------------|
| `leaseYearsRemaining` | Years remaining on lease |
| `charges.serviceCharge.current` | Annual service charge |
| `charges.groundRent.current` | Annual ground rent |

</details>

<details>
<summary><strong>Listings & Intelligence</strong></summary>

| Field