Begin a Homedata signup so the user can get an API key for UK property data.

Homedata is the UK property data API: 29M UK addresses with UPRNs, EPC, sale history, planning, flood risk, council tax, demographics, crime, schools, broadband, and transport. Free tier is 100 calls per month with no credit card required.

This tool returns the signup URL and the exact steps the user needs to take. After signing up + verifying their email, they copy their API key from the dashboard and set HOMEDATA_API_KEY in their environment — at which point all 16 data tools become available.

Check whether the user's HOMEDATA_API_KEY is set + working.

Use this:

• before recommending Homedata data tools, to know if they're available

• after the user runs start_homedata_signup, to confirm they've completed verification + set the env var (after MCP server restart)

• if a data tool returned an unauthorised / quota error, to diagnose

Returns a structured status the AI agent can reason about. NO API key material is returned — only a 6-character prefix for diagnostic purposes.

Look up the canonical Homedata property record for a single UPRN.

Returns address, geometry, council, tenure, build characteristics and cross-reference identifiers (LR title, USRN, postcode). Use this as the entry point when you need ground-truth metadata for a property.

Look up multiple properties in a single round-trip (max 50 UPRNs).

Use this in preference to looping lookup_property when you have more than 2-3 UPRNs - it is significantly cheaper in API credits.

Fetch the latest EPC (Energy Performance Certificate) for a UPRN.

Returns current/potential efficiency rating (A-G), CO2 emissions, floor area, primary heating, glazing, walls, roof, insulation, and the assessment date. Returns {"error": ...} if no EPC exists.

Get Environment Agency flood risk classification for a property.

Returns risk bands for rivers/sea and surface water (Very Low, Low, Medium, High), plus distance to nearest watercourse where available.

Get the VOA council tax band (A-H) and billing authority for a UPRN.

NOTE: Council tax lookup is in development and not yet production-ready. This tool returns a clear "coming soon" response without hitting the API so callers do not consume credits on an unavailable endpoint.

Find live and historic sales/lettings listings linked to a UPRN.

Returns asking price, status (is_live), agent details, listing date, and marketing description. Sourced from Home.co.uk's panel of portal partners (30+ years of data).

Return the full HM Land Registry sale history for a property.

Each event includes sale date, price, transaction type (full / additional / standard) and category (residential / commercial).

Find comparable recently-sold properties near a subject property.

Useful for valuation work - returns nearest sales with price, date and property characteristics for triangulating a market value. The endpoint uses geographic proximity (PostGIS spatial query) rather than a fixed radius, and returns the count closest properties with either a sold date or a first-listing date in the past year.

Search planning applications associated with (or near) a UPRN.

Returns reference, decision, decision date, application type and a description summary. Aggregated from local authority planning portals.

Return ONS Census 2021 demographic profile for a postcode.

Includes population, age bands, household composition, ethnicity, tenure, occupation and qualifications - all keyed to the postcode's output area.

Return data.police.uk crime counts and categories for a postcode.

Find schools within a radius of a property, with Ofsted ratings.

Returns name, phase (primary/secondary/special), age range, distance, Ofsted grade and last inspection date.

Return Ofcom broadband availability and speeds for a postcode.

Includes max download / upload speeds, technology (FTTP, FTTC, etc.) and superfast / ultrafast / gigabit availability.

Find transport nodes (rail, tube, bus stops) near a property.

Free-text address search across the full 29M-record UK address base.

Returns candidate addresses with their UPRN - use the UPRN with the other lookup_* / get_* tools.

Return a one-shot rollup for a postcode.

Bundles headline demographics, crime rate, broadband, average sale price and school count for quick area appraisals - cheaper than calling each tool individually.