UK Property Data
A comprehensive UK property research tool aggregating data from Land Registry, EPC Register, Rightmove, Companies House, and more.
property_report: Full property report combining sales history, area comps, EPC rating, rental market, sales listings, yield, and price range — all in one call.property_comps: Land Registry Price Paid Data for a postcode with optional EPC enrichment (floor area, price/sqft) and auto-escalation to wider area if results are sparse.ppd_transactions: Search Land Registry sold price records by postcode, address, date range, or price filters.property_yield: Calculate gross rental yield by combining Land Registry sales data with live Rightmove rental listings.rental_analysis: Get median/average rent, listing count, and rent range for a postcode, with optional yield calculation from a given purchase price.property_epc: Retrieve EPC data for a specific property (energy rating, floor area, construction age, heating costs) or area-level aggregation.rightmove_search: Search current Rightmove listings for sale or rent, with filters for price, bedrooms, building type, and sort order.rightmove_listing: Fetch full details for a specific listing including tenure, lease years, service charge, ground rent, council tax band, floor area, and floorplans.property_blocks: Identify buildings with multiple recent flat sales to spot investor exits or bulk-buy opportunities.stamp_duty: Calculate UK SDLT with support for additional property surcharge, first-time buyer relief, and non-resident surcharge.planning_search: Find the local council planning portal URL for any UK postcode.company_search: Search Companies House by company name.company_profile: Retrieve a full Companies House record by company number, including address, status, incorporation date, officers, and filing history.
Environment configuration for API keys including EPC Register credentials, Companies House API key, Rightmove rate limiting, and OpenAI API key for planning portal scraping.
Provides HTTP API wrapper for property data services with endpoints for comparable sales, rental analysis, Rightmove searches, stamp duty calculations, and property reports.
Deployment platform for hosting the property data service with API endpoints and MCP server accessible via HTTP transport.
Source code repository hosting the property-shared project with MCP server implementation and deployment configuration.
Uses OpenAI's vision API for automated planning portal scraping to extract planning application data from UK local council websites.
Testing framework used for both mocked unit tests and live integration tests with real network calls to property data sources.
Core library implementation providing business logic for property data analysis including Land Registry PPD, EPC certificates, Rightmove listings, and yield calculations.
CLI interface for property data tools enabling command-line access to comparable sales, rental yield analysis, stamp duty calculations, and Rightmove searches.
Property Shared
UK property data in one package. Pulls Land Registry sales, EPC certificates, Rightmove listings, rental yields, stamp duty calculations, planning portal links, and Companies House records.
Use it as a Python library, CLI, HTTP API, or MCP server.
What You Get
Data Source | What It Returns |
Land Registry PPD | Sold prices, dates, property types, area comps with median/percentiles |
EPC Register | Energy ratings, floor area, construction age, heating costs |
Rightmove | Current listings (sale + rent), prices, agents, listing details |
Yield Analysis | Gross yield from PPD sales + Rightmove rentals combined |
Stamp Duty | SDLT calculation with April 2025 bands, BTL surcharge, FTB relief |
Block Analyzer | Groups flat sales by building to spot investor exits |
Planning | Local council planning portal lookup (99 verified councils, stdio only) |
Companies House | Company search and lookup by name or number |
Skills & Plugins
Property and Legal packs coming soon. Please get in contact if you have working experiance or expert knowledge in UK property investing, UK Estate Agents, Property and Conveyencing and would like to help shape this. paul@bouch.dev
Use as MCP Server
No install required — paste the URL into your MCP client config and go.
Claude Code, Cursor, any MCP client:
{
"mcpServers": {
"property-shared": {
"type": "http",
"url": "https://property-shared.fly.dev/mcp"
}
}
}Install
pip install property-shared
# or with uv
uv add property-sharedExtras: [cli] for CLI, [api] for HTTP server, [dev] for tests.
pip install property-shared[cli]
# or
uv add property-shared --extra cliUse as a Python Library
from property_core import PPDService, calculate_yield, calculate_stamp_duty
# Get comparable sales for a postcode
comps = PPDService().comps("SW1A 1AA", months=24, property_type="F")
print(f"Median flat price: {comps.median:,}")
# Calculate rental yield
import asyncio
result = asyncio.run(calculate_yield("NG1 1AA", property_type="F"))
print(f"Gross yield: {result.gross_yield_pct}%")
# Stamp duty
sdlt = calculate_stamp_duty(250000, additional_property=True)
print(f"SDLT: {sdlt.total_sdlt:,.0f} ({sdlt.effective_rate}%)")All models are available at top level:
from property_core import (
PPDTransaction, PPDCompsResponse, EPCData,
RightmoveListing, RightmoveListingDetail,
PropertyReport, YieldAnalysis, RentalAnalysis,
BlockAnalysisResponse, CompanyRecord, StampDutyResult,
)Interpretation helpers (core returns numbers, you decide how to label them):
from property_core import classify_yield, classify_data_quality, generate_insightsUse as CLI
pip install property-shared[cli] # or: uv add property-shared --extra cli
# Comparable sales
property-cli ppd comps "SW1A 1AA" --months 24 --property-type F
# Rental yield
property-cli analysis yield "NG1 1AA" --property-type F
# Stamp duty
property-cli calc stamp-duty 300000
# Rightmove search (with sort)
property-cli rightmove search-url "NG1 1AA" --sort-by most_reduced
# Full property report
property-cli report generate "10 Downing Street, SW1A 2AA" --property-type FAdd --api-url http://localhost:8000 to any command to route through the HTTP API instead of calling core directly.
Use as HTTP API
pip install property-shared[api] # or: uv add property-shared --extra api
property-api # starts on port 8000Interactive docs at http://localhost:8000/docs.
Key endpoints:
GET /v1/ppd/comps?postcode=SW1A+1AA&property_type=F&enrich_epc=trueGET /v1/analysis/yield?postcode=NG1+1AA&property_type=FGET /v1/analysis/rental?postcode=NG1+1AA&purchase_price=200000GET /v1/rightmove/search-url?postcode=NG1+1AA&sort_by=newestGET /v1/calculators/stamp-duty?price=300000&additional_property=truePOST /v1/property/reportwith{ "address": "10 Downing Street, SW1A 2AA" }
Full endpoint list in USER_GUIDE.md.
Environment Variables
Copy .env.example to .env. Key variables:
Variable | Required For | Description |
| EPC lookups | Free key from EPC Register |
| EPC lookups | Paired with email above |
| Company search | Free key from Companies House |
| No (default 0.6s) | Rate limit delay for Rightmove scraping |
| Planning scraper | Vision-guided planning portal scraper |
Land Registry PPD and Rightmove work without credentials.
Development
# Install with dev extras
uv sync --extra dev
# Run API with reload
uv run uvicorn app.main:app --reload
# Run tests (mocked, no network)
uv run --extra dev pytest -v
# Run live integration tests (real network calls)
RUN_LIVE_TESTS=1 uv run --extra dev pytest -vDeployed at https://property-shared.fly.dev with API docs at /docs and MCP endpoint at /mcp.
Maintenance
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/paulieb89/property-shared'
If you have feedback or need assistance with the MCP directory API, please join our Discord server