UK Property Data

Calculate UK Stamp Duty Land Tax for a residential property purchase. Returns SDLT total, effective rate, and band-by-band breakdown.

Find the planning portal URL for a UK postcode. Returns council info and portal search URLs. Does not scrape planning applications -- use the returned URLs to search directly.

Search Companies House by company name. Returns a list of matches. For a direct lookup by company number, use the company://{company_number} resource instead (e.g. read_resource("company://00445790")).

Energy Performance Certificate data for a UK property or postcode area. With address: returns the matched certificate for that specific property. Without address: returns all certificates at the postcode with area aggregation — rating distribution, floor area range, property type breakdown. Use the area mode for postcode-level views rather than a single-property lookup.

Browse all EPC certificates at a postcode — use when you have no house number. Returns a slim list of every certificate at the postcode. Each entry contains: address, rating, score, floor_area (sqm), property_type, floor_level, habitable_rooms, inspection_date, lmk_key. Workflow for Rightmove listings where the house number is not shown: 1. Call rightmove_listing to obtain floor_area_sqm, property_type, and any floor-level signals in the description (e.g. "top floor", "ground floor"). 2. Call epc_search(postcode) to retrieve the full cert list. 3. You MUST cross-reference each cert's floor_area against the listing's floor_area_sqm (accept within ±5 sqm) AND property_type must match. Also use floor_level and habitable_rooms where available. 4. If a single cert matches, call epc_certificate(lmk_key) for the full detail. 5. If multiple certs match equally, present all candidates — do not guess. If floor_area is unavailable on the listing, filter by property_type only and return all candidates. Returns None if no certificates exist for the postcode.

Fetch a single EPC certificate by its lmk_key (certificate hash). Use after epc_search has identified the correct cert — this is faster than epc_lookup(postcode, address) as it makes a direct lookup with no fuzzy matching or postcode re-fetch. lmk_key is returned in every epc_search result. Returns the full EPC certificate or None if not found.

Search Rightmove property listings by postcode. Builds a search URL, fetches the first page of results, and returns listing summaries with a median price.

Identify buildings with multiple flat sales — block-buy opportunities. Groups Land Registry transactions by building (PAON/street) and returns blocks where at least min_transactions units sold in the lookback window. Useful for spotting investor exits, new-build releases, or portfolio bulk transfers.

Raw Land Registry Price Paid transactions for a postcode. Returns every recorded transaction at the postcode, unfiltered (includes category-B bulk transfers and commercial sales). For clean residential comparable sales, use property_comps instead.

Comparable sales from Land Registry Price Paid Data. Defaults return the standard residential set: - property_type=None means residential (F+D+S+T). Pass "F"/"D"/"S"/"T"/"O" for a single type, or "ALL" to disable type filtering (firehose). - transaction_category defaults to "A" (standard sales). Pass None to include category-B (bulk transfers, non-standard conveyances). - filter_outliers=False by default; set True for IQR-trimmed stats AND transaction list (1.5*IQR rule, needs >=4 prices). limit caps returned transactions (max 200). enrich_epc attaches EPC floor area and price-per-sqft to each transaction — slower but richer.

Gross rental yield for a UK postcode. Combines Land Registry sale comps (median sale price) with Rightmove rental listings (median monthly rent) to produce a gross yield percentage. Args: postcode: UK postcode (e.g. "NG1 2NS"). months: PPD sale lookback period (default 24). search_level: PPD search granularity — "postcode", "sector" (default), or "district". property_type: Filter sales by type. None (default) = residential set (F+D+S+T). Pass "F"/"D"/"S"/"T"/"O" for one type, "ALL" for firehose. auto_escalate: Widen the PPD search area on thin markets — postcode→ sector→district. Default True. Set False for strict-locality only. Returns: median_sale_price, median_monthly_rent, gross_yield_pct, sale_count, rental_count, thin_market. Yield fields are null when sample is too thin or rental data is unavailable.

Rental market analysis and achievable rent estimate. auto_escalate widens the search area when fewer than 5 listings are found (thin market). Response includes thin_market, escalated_from, escalated_to fields when escalation occurs.

Energy Performance Certificate data for a UK property or postcode area. With address: returns the matched EPC certificate for that specific property. Without address: returns an aggregated summary of every certificate at the postcode — count, rating distribution, property-type breakdown, floor-area range — plus a hint to call again with an address for single-property detail. Returns None if no certificates exist for the postcode at all.

Browse all EPC certificates at a postcode — use when you have no house number. Returns a slim list of every certificate at the postcode. Each entry contains: address, rating, score, floor_area (sqm), property_type, floor_level, habitable_rooms, inspection_date, lmk_key. Workflow for Rightmove listings where the house number is not shown: 1. Call rightmove_listing to obtain floor_area_sqm, property_type, and any floor-level signals in the description (e.g. "top floor", "ground floor"). 2. Call property_epc_search(postcode) to retrieve the full cert list. 3. You MUST cross-reference each cert's floor_area against the listing's floor_area_sqm (accept within ±5 sqm) AND property_type must match. Also use floor_level and habitable_rooms where available. 4. If a single cert matches, call epc_certificate(lmk_key) for the full detail. 5. If multiple certs match equally, present all candidates — do not guess. If floor_area is unavailable on the listing, filter by property_type only and return all candidates. Returns None if no certificates exist for the postcode.

Full detail for a single Rightmove listing (URL or numeric ID). include_images fetches and embeds photos and floorplans as MCP image content. max_images caps the number of property photos (default 3); floorplans always included.

Analyse rental market for a UK postcode. Returns listing count, median/average rent, rent range, and optional gross yield if purchase_price is provided.

Show rental market analysis as an interactive dashboard. Displays rental listing stats, rent range, market depth, and optional gross yield if a purchase price is provided.

Search comparable property sales for a UK postcode. Returns transaction count, median/percentile stats, and individual transactions within the lookback period. Defaults are residential-only: standard sales (category A) of flats, detached, semi, and terraced properties. Use property_type='ALL' and transaction_category=None for the unfiltered Land Registry firehose.

Show comparable property sales as an interactive dashboard. Fetches Land Registry transactions and displays stats, price distribution chart, and transaction list with property type badges.

Show Rightmove property listings as a visual dashboard with images. Searches Rightmove for sale or rent listings and displays them as cards with property photos, prices, and key details.

Show a unified property dashboard combining sales, yield, and rental data. Fetches Land Registry transactions, Rightmove rental listings, and calculates gross yield — all in one view with interactive controls.

Analyse gross rental yield for a UK postcode. Returns median sale price, median monthly rent, gross yield percentage, yield assessment label, and data quality classification.

Show rental yield analysis as an interactive dashboard. Combines Land Registry sale prices with Rightmove rental listings to calculate gross yield, with assessment and data quality indicators.