{
  "markdown": "# Propbar MCP Server\n\n[![MCP Registry](https://img.shields.io/badge/MCP-Registry-blue)](https://registry.modelcontextprotocol.io)\n[![UK Property Data](https://img.shields.io/badge/UK-Property%20Data-green)](https://propbar.co.uk)\n\nMCP 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)**.\n\nPowered by [Propbar's](https://propbar.co.uk) comprehensive UK property database covering **30+ million properties**.\n\n## Use Cases\n\n### Build Your Own AVM\n\nThe `get_comparables` tool provides access to a **comprehensive property search** with 50+ filterable fields - perfect for building automated valuation models:\n\n- **Transaction Data**: Sale history with dates and amounts, current asking prices\n- **Market Status**: For sale, SSTC, under offer, reserved, back on market dates\n- **Property Attributes**: Type, beds, baths, floor area, construction age\n- **EPC Data**: Energy ratings (A-G), efficiency scores, potential ratings\n- **Tenure & Charges**: Freehold/leasehold, lease years remaining, service charges, ground rent\n- **Pricing Metrics**: Price per sqm, price per sqft, price changes over time\n- **Listing Intelligence**: Days on market, price reductions, portal links\n\n**Example AVM workflow:**\n```\n1. get_comparables({ latitude, longitude, propertyType: \"flat\", bedrooms: 2 })\n2. Filter by sale date (last 12 months) and distance\n3. Adjust for differences (floor area, EPC rating, condition)\n4. Calculate £/sqft and apply to subject property\n```\n\n### Property Research for Buyers\n\nHelp users make informed decisions with comprehensive area data:\n\n- **Crime & Safety** - Is this area safe? How does it compare?\n- **Schools** - What schools are nearby? Ofsted ratings?\n- **Demographics** - Who lives here? Age, tenure, household types?\n- **Market Analysis** - What are similar properties selling for?\n\n## Available Tools\n\n| Tool | Description | Input |\n|------|-------------|-------|\n| `search_areas` | Search UK areas by name or postcode | query |\n| `search_properties` | Search UK properties by address | query |\n| `get_area_details` | Get coordinates and area codes | areaCode or path |\n| `get_crime_stats` | Crime statistics and safety rating | areaCode OR lat/lng |\n| `get_schools` | Schools with Ofsted ratings | areaCode OR lat/lng |\n| `get_demographics` | Census demographics | areaCode OR lat/lng |\n| `get_property_basic` | Basic property details | propertyId |\n| `get_property_full` | Full property with history | propertyId |\n| `get_comparables` | **Comparable properties for valuation** | lat/lng + filters |\n\n## Comparables Search Fields\n\nThe `get_comparables` tool queries an Elasticsearch index with **56 filterable fields**:\n\n<details>\n<summary><strong>Property Attributes</strong></summary>\n\n| Field | Description |\n|-------|-------------|\n| `build.propertyType` | Detached, semi, terrace, flat, etc. |\n| `roomDetails.beds` | Number of bedrooms |\n| `roomDetails.baths` | Number of bathrooms |\n| `build.totalFloorArea` | Total floor area (sqm) |\n| `build.constructionAge.*` | Year built / construction period |\n| `tenure.type` | Freehold, leasehold, share of freehold |\n| `councilTax.taxBand` | Council tax band (A-H) |\n\n</details>\n\n<details>\n<summary><strong>Pricing & Sales</strong></summary>\n\n| Field | Description |\n|-------|-------------|\n| `pricing.currentSale` | Current asking price (sales) |\n| `pricing.currentRent` | Current asking rent (pcm) |\n| `saleHistory.date` | Historical sale dates |\n| `saleHistory.amount` | Historical sale prices |\n| `marketStatus.pricePerSqm` | Price per square metre |\n| `marketStatus.pricePerSqft` | Price per square foot |\n\n</details>\n\n<details>\n<summary><strong>Market Status</strong></summary>\n\n| Field | Description |\n|-------|-------------|\n| `marketStatus.forSale` | Currently listed for sale |\n| `marketStatus.forRent` | Currently listed for rent |\n| `marketStatus.sstcDate` | Sold subject to contract date |\n| `marketStatus.underOfferDate` | Under offer date |\n| `marketStatus.reservedDate` | Reserved date (rentals) |\n| `marketStatus.lastOTM` | Last on the market date |\n| `marketStatus.backOTM` | Back on market flag |\n\n</details>\n\n<details>\n<summary><strong>EPC & Energy</strong></summary>\n\n| Field | Description |\n|-------|-------------|\n| `epc.currentRating` | Current EPC rating (A-G) |\n| `epc.potentialRating` | Potential EPC rating |\n| `epc.currentEfficiency` | Current efficiency score (1-100) |\n| `epc.potentialEfficiency` | Potential efficiency score |\n\n</details>\n\n<details>\n<summary><strong>Leasehold & Charges</strong></summary>\n\n| Field | Description |\n|-------|-------------|\n| `leaseYearsRemaining` | Years remaining on lease |\n| `charges.serviceCharge.current` | Annual service charge |\n| `charges.groundRent.current` | Annual ground rent |\n\n</details>\n\n<details>\n<summary><strong>Listings & Intelligence</strong></summary>\n\n| Field | Description |\n|-------|-------------|\n| `listings.*` | Full listing data (nested) |\n| `listings.publishedDate` | When listed |\n| `listings.removedDate` | When removed |\n| `listings.priceChange` | Price change history |\n\n</details>\n\n## Connection\n\n**Endpoint:** `https://mcp.propbar.co.uk`\n\n**Transport:** Streamable HTTP (MCP 2025-03-26)\n\n**Authentication:** OAuth 2.1 via Supabase\n\n## Requirements\n\n- **Subscription:** Pro or Plus subscription required\n- **Account:** [Sign up at propbar.co.uk](https://propbar.co.uk)\n\n## Quick Start\n\n### Claude Desktop\n\nAdd to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"propbar\": {\n      \"url\": \"https://mcp.propbar.co.uk\"\n    }\n  }\n}\n```\n\nYou'll be prompted to authenticate via OAuth when first connecting.\n\n### Programmatic Access\n\n```typescript\nimport { Client } from '@modelcontextprotocol/sdk/client/index.js'\nimport { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js'\n\nconst transport = new StreamableHTTPClientTransport(\n  new URL('https://mcp.propbar.co.uk'),\n  {\n    requestInit: {\n      headers: {\n        Authorization: `Bearer ${accessToken}`,\n      },\n    },\n  }\n)\n\nconst client = new Client({ name: 'my-app', version: '1.0.0' })\nawait client.connect(transport)\n\n// Get comparables for valuation\nconst result = await client.callTool('get_comparables', {\n  coordinates: { latitude: 51.5074, longitude: -0.1278 },\n  propertyType: 'flat',\n  bedrooms: 2,\n  radiusKm: 1,\n  transactionType: 'sale'\n})\n```\n\n## Tool Workflow\n\n```\n┌─────────────────────┐     ┌─────────────────────┐\n│   search_areas      │     │  search_properties  │\n│   (get areaCode)    │     │  (get propertyId)   │\n└─────────┬───────────┘     └──────────┬──────────┘\n          │                            │\n          ▼                            ▼\n┌─────────────────────┐     ┌─────────────────────┐\n│  Area Tools:        │     │  Property Tools:    │\n│  • get_crime_stats  │     │  • get_property_*   │\n│  • get_schools      │     │  • get_comparables  │\n│  • get_demographics │     │                     │\n└─────────────────────┘     └─────────────────────┘\n```\n\n**Flexible inputs:** Most tools accept EITHER `areaCode` OR `latitude`/`longitude` coordinates.\n\n## Example Usage\n\n### Get comparables for valuation\n```json\n{\n  \"tool\": \"get_comparables\",\n  \"arguments\": {\n    \"coordinates\": { \"latitude\": 51.5074, \"longitude\": -0.1278 },\n    \"propertyType\": \"flat\",\n    \"bedrooms\": 2,\n    \"radiusKm\": 1,\n    \"transactionType\": \"sale\"\n  }\n}\n```\n\n**Returns:** Recent sales, SSTC properties, and current listings with prices, dates, floor areas, EPC ratings, and portal links.\n\n### Check area safety\n```json\n{\n  \"tool\": \"get_crime_stats\",\n  \"arguments\": {\n    \"latitude\": 53.958,\n    \"longitude\": -1.080\n  }\n}\n```\n\n### Find nearby schools\n```json\n{\n  \"tool\": \"get_schools\",\n  \"arguments\": {\n    \"latitude\": 53.9583,\n    \"longitude\": -1.0803,\n    \"radiusMetres\": 2000\n  }\n}\n```\n\n### Get demographics\n```json\n{\n  \"tool\": \"get_demographics\",\n  \"arguments\": {\n    \"areaCode\": \"E06000014\",\n    \"topics\": [\"ageBands\", \"ethnicGroup\", \"tenure\"]\n  }\n}\n```\n\n## OAuth Discovery\n\nProtected Resource Metadata (RFC 9728):\n```\nhttps://mcp.propbar.co.uk/.well-known/oauth-protected-resource\n```\n\n## Data Sources\n\n- **Property Data:** [Propbar](https://propbar.co.uk) - 30M+ UK properties with sales history, listings, EPC data\n- **Crime Statistics:** [Police UK](https://data.police.uk/) - Monthly crime data by location\n- **Schools:** [Get Information About Schools](https://get-information-schools.service.gov.uk/) - Ofsted ratings, school types\n- **Demographics:** [UK Census 2021](https://census.gov.uk/) - Population, households, tenure\n\n## Related Products\n\n- **Need automated marketing?** [EverySignal.ai](https://everysignal.ai) - AI-powered property marketing automation\n- **Need consulting, enterprise solutions, or direct API access?** [Vepler.com](https://vepler.com) - UK property data consulting & enterprise platform\n\n## Support\n\n- **Website:** [propbar.co.uk](https://propbar.co.uk)\n- **Email:** hello@propbar.co.uk\n- **GitHub:** [Propbar/mcp](https://github.com/Propbar/mcp)\n\n## License\n\nProprietary - Requires active Propbar subscription.\n\n---\n\n**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\n\n*UK property research and valuation tools for AI assistants.*\n",
  "bytes": 9496,
  "sha": "2d59ed916ea074001791f9eb260f15310297196bafde8e04c7431fd3ede13df0",
  "repo_slug": "propbar/mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_uk_co_propbar_research_b4a7f783/readme"
}