uk.co.propbar/research
UK property research tools - crime stats, schools, demographics, valuations for AI.
Open source Repository Open in the app JSON README (API)
About
UK property research tools - crime stats, schools, demographics, valuations for AI.
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- uk.co.propbar
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 1.1.0
- Stars
- 2
- Last push
- 2026-02-02T05:35:41Z
- Repository state
- ativo
- Added
- 2026-08-29 04:01:56
- Updated
- 2026-08-29 04:01:56
- Origin id
uk.co.propbar/research
README
# Propbar MCP Server
[](https://registry.modelcontextprotocol.io)
[](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 | 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](https://propbar.co.uk)
## Quick Start
### Claude Desktop
Add to your `claude_desktop_config.json`:
```json
{
"mcpServers": {
"propbar": {
"url": "https://mcp.propbar.co.uk"
}
}
}
```
You'll be prompted to authenticate via OAuth when first connecting.
### Programmatic Access
```typescript
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
```json
{
"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
```json
{
"tool": "get_crime_stats",
"arguments": {
"latitude": 53.958,
"longitude": -1.080
}
}
```
### Find nearby schools
```json
{
"tool": "get_schools",
"arguments": {
"latitude": 53.9583,
"longitude": -1.0803,
"radiusMetres": 2000
}
}
```
### Get demographics
```json
{
"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](https://propbar.co.uk) - 30M+ UK properties with sales history, listings, EPC data
- **Crime Statistics:** [Police UK](https://data.police.uk/) - Monthly crime data by location
- **Schools:** [Get Information About Schools](https://get-information-schools.service.gov.uk/) - Ofsted ratings, school types
- **Demographics:** [UK Census 2021](https://census.gov.uk/) - Population, households, tenure
## Related Products
- **Need automated marketing?** [EverySignal.ai](https://everysignal.ai) - AI-powered property marketing automation
- **Need consulting, enterprise solutions, or direct API access?** [Vepler.com](https://vepler.com) - UK property data consulting & enterprise platform
## Support
- **Website:** [propbar.co.uk](https://propbar.co.uk)
- **Email:** hello@propbar.co.uk
- **GitHub:** [Propbar/mcp](https://github.com/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.*