Propbar

by propbar

334 downloads
Not rated
GitHub

About

UK property data for AI assistants: crime statistics, school Ofsted ratings, ONS census demographics, automated valuations (AVM), and comparable sales from Land Registry. Access 30M+ UK properties with sales history, EPC ratings, and market analysis. Build your own AVM with 56 fi

Details

Author
propbar
Downloads
334
Categories
Productivity, Other

- 10 tools covering property search, crime, schools, demographics, and comparables
- get_comparables offers 56 filterable fields for building AVM models
- Accepts both areaCode and latitude/longitude inputs for most area tools
- Streamable HTTP transport (MCP 2025-03-26) with OAuth 2.1 authentication
- Data from Propbar, Police UK, Get Information About Schools, and UK Census 2021

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Propbar
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Add the server URL https://mcp.propbar.co.uk to your MCP client configuration (e.g., claude_desktop_config.json). You will be prompted to authenticate via OAuth 2.1 (Supabase) on first connection. After connecting, call any of the provided tools – such as search_areas, get_crime_stats, or get_comparables – using standard MCP tool invocation. For programmatic access, use the MCP SDK with a bearer token.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "propbar": {
            "propbar": {
                "url": "https://mcp.propbar.co.uk"
            }
        }
    }
}

McpServers

{
    "propbar": {
        "url": "https://mcp.propbar.co.uk"
    }
}

Propbar MCP Server

MCP Registry
UK Property Data

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 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 | Description |
|-------|-------------|
| listings.
| Full listing data (nested) |
| listings.publishedDate | When listed |
| listings.removedDate | When removed |
| listings.priceChange | Price change history |

</details>

Connection

Endpoint: https://mcp.propbar.co.uk

Transport: Streamable HTTP (MCP 2025-03-26)

Authentication: OAuth 2.1 via Supabase

Requirements

- Subscription: Pro or Plus subscription required
- Account: Sign up at propbar.co.uk

Quick Start

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "propbar": {
      "url": "https://mcp.propbar.co.uk"
    }
  }
}

You'll be prompted to authenticate via OAuth when first connecting.

Programmatic Access

import { Client } from '@modelcontextprotocol/sdk/client/index.js'
import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js'

const transport = new StreamableHTTPClientTransport(
new URL('https://mcp.propbar.co.uk'),
{
requestInit: {
headers: {
Authorization: Bearer ${accessToken},
},
},
}
)

const client = new Client({ name: 'my-app', version: '1.0.0' })
await client.connect(transport)

// Get comparables for valuation
const result = await client.callTool('get_comparables', {
coordinates: { latitude: 51.5074, longitude: -0.1278 },
propertyType: 'flat',
bedrooms: 2,
radiusKm: 1,
transactionType: 'sale'
})

Tool Workflow

┌─────────────────────┐     ┌─────────────────────┐
│   search_areas      │     │  search_properties  │
│   (get areaCode)    │     │  (get propertyId)   │
└─────────┬───────────┘     └──────────┬──────────┘
          │                            │
          ▼                            ▼
┌─────────────────────┐     ┌─────────────────────┐
│  Area Tools:        │     │  Property Tools:    │
│  • get_crime_stats  │     │  • get_property_   │
│  • get_schools      │     │  • get_comparables  │
│  • get_demographics │     │                     │
└─────────────────────┘     └─────────────────────┘

Flexible inputs: Most tools accept EITHER areaCode OR latitude/longitude coordinates.

Example Usage

Get comparables for valuation

{
  "tool": "get_comparables",
  "arguments": {
    "coordinates": { "latitude": 51.5074, "longitude": -0.1278 },
    "propertyType": "flat",
    "bedrooms": 2,
    "radiusKm": 1,
    "transactionType": "sale"
  }
}

Returns: Recent sales, SSTC properties, and current listings with prices, dates, floor areas, EPC ratings, and portal links.

Check area safety

{
  "tool": "get_crime_stats",
  "arguments": {
    "latitude": 53.958,
    "longitude": -1.080
  }
}

Find nearby schools

{
  "tool": "get_schools",
  "arguments": {
    "latitude": 53.9583,
    "longitude": -1.0803,
    "radiusMetres": 2000
  }
}

Get demographics

{
  "tool": "get_demographics",
  "arguments": {
    "areaCode": "E06000014",
    "topics": ["ageBands", "ethnicGroup", "tenure"]
  }
}

OAuth Discovery

Protected Resource Metadata (RFC 9728):

https://mcp.propbar.co.uk/.well-known/oauth-protected-resource

Data Sources

- Property Data: Propbar - 30M+ UK properties with sales history, listings, EPC data
- Crime Statistics: Police UK - Monthly crime data by location
- Schools: Get Information About Schools - Ofsted ratings, school types
- Demographics: UK Census 2021 - Population, households, tenure

Related Products

- Need automated marketing? EverySignal.ai - AI-powered property marketing automation
- Need consulting, enterprise solutions, or direct API access? Vepler.com - UK property data consulting & enterprise platform

Support

- Website: propbar.co.uk
- Email: hello@propbar.co.uk
- GitHub: Propbar/mcp

License

Proprietary - Requires active Propbar subscription.

---

Keywords: UK property API, automated valuation model, AVM, property comparables, house price data, EPC ratings, UK house prices, property market analysis, MCP server, AI property tools, land registry data

UK property research and valuation tools for AI assistants.*

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.