homedata-mcp
This MCP server lets an AI assistant sign up for/check a Homedata API key and query UK property and local-area data.
Start Homedata signup and check whether an API key is configured and working.
Search the UK address base and resolve addresses to UPRNs.
Look up single properties by UPRN, including address, geometry, council, tenure, build characteristics and cross-references, or batch up to 50 UPRNs.
Retrieve EPC data, flood-risk bands and council-tax band (currently a coming-soon stub).
Find sales/lettings listings, Land Registry sale history and comparable nearby sales.
Get planning applications, Census 2021 demographics, crime counts, nearby schools with Ofsted ratings, broadband availability and transport nodes.
Produce a one-call postcode profile bundling headline demographics, crime, broadband, average sale price and school count.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@homedata-mcp look up property 100021421083"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Homedata MCP server
UK property data as tools for AI assistants. Ask Claude, Cursor, Codex or any Model Context Protocol client about an address and it can look up the property record, EPC, council tax, flood and other environmental risks, planning, schools, broadband, crime, local amenities and area price trends through the Homedata API.
The tools are exactly the self-serve endpoints of the Homedata Developer Playground: the same names, the same arguments and the same prices.
Install
Requires Python 3.10 or newer.
pip install homedata-mcpor run it without installing, with uv:
uvx homedata-mcpRelated MCP server: Property Price Search MCP Server
Get an API key
Create an account at homedata.co.uk/register, verify your email, and copy your key from the developer dashboard. Calls are paid for in tokens from a prepaid balance; see homedata.co.uk/pricing. Every tool's description states what it costs, and every call reports what it actually cost (see What a call costs).
Without a key the server still starts, with two helpers,
start_homedata_signup and check_homedata_api_key, so your assistant can
walk you through getting one. Neither helper calls the API.
Connect it to your assistant
Most clients take the same command, arguments and environment. For Claude
Desktop, add this to claude_desktop_config.json and restart the app:
{
"mcpServers": {
"homedata": {
"command": "uvx",
"args": ["homedata-mcp"],
"env": { "HOMEDATA_API_KEY": "your_key" }
}
}
}With pip install homedata-mcp, use "command": "homedata-mcp" and no args.
Claude Code:
claude mcp add homedata --env HOMEDATA_API_KEY=your_key -- uvx homedata-mcpStep-by-step guides for Claude Desktop, Claude Code, Cursor, Codex CLI, Windsurf, Cline, Continue.dev and Zed are at homedata.co.uk/mcp.
Using the tools
Start with address_match to match an address and postcode to a UPRN, then use the
property tools with that UPRN. For a whole property, one tier call is cheaper
than many small ones: property_base, then property_core (the usual full
picture), then property_complete. property_discovery costs 1 token and
shows what a property has before you commit to a tier.
Tool | Tokens | What it returns |
| 5 | Match a submitted UK street address and postcode to a UPRN. A 200 response returns the address-level retrieve body plus address_resolution. |
| 2 | List every registered address at a UK postcode, with the UPRN for each one. |
| 5 | Every amenity group near a property in one response: food, education, healthcare, financial, civic, worship, culture, convenience, green spaces, transport and shops. |
| 1 | Civic places near a property: post offices, town halls, courthouses, fire and police stations, community centres. |
| 1 | Everyday conveniences near a property: public toilets, charging points, parcel lockers and similar. |
| 1 | Culture and leisure near a property: theatres, cinemas, music venues, museums, galleries and attractions. |
| 1 | Education near a property: schools, nurseries, colleges, universities, childcare and libraries. For Ofsted ratings and pupil numbers use schools. |
| 1 | Banks, cash machines and money services near a property. |
| 1 | Places to eat and drink near a property: cafes, restaurants, pubs, bars, takeaways. |
| 1 | Green space near a property: parks, playgrounds, gardens, nature reserves, commons and sports pitches. |
| 1 | Health services near a property as mapped locally: doctors, dentists, clinics, hospitals, pharmacies and care homes. For regulator-registered records use healthcare_all and its per-type tools. |
| 1 | Shops near a property, from supermarkets to specialist retailers. |
| 1 | Transport stops near a property: bus stops, railway stations, tram stops and ferry terminals. |
| 1 | Places of worship near a property. |
| 1 | How a property was built: construction age band, main construction material, and whether it has a basement. |
| 1 | Measurements for a property: footprint area in square metres, building height, estimated volume and predicted floor area. |
| 1 | Energy Performance Certificate headline for a property: current and potential efficiency rating, EPC floor area and the date of the last assessment. |
| 1 | Every EPC certificate held for a property, oldest first: certificate number, lodgement date, current and potential ratings, floor area, main fuel, fabric and heating descriptions, and a flag for withdrawn certificates. A property with no certificate returns 404 and the token is refunded. |
| 1 | Improvements recommended by a property's EPC assessment, each with estimated minimum and maximum cost. |
| 1 | Whether a property has a garden, and of what kind. |
| 1 | Ground stability for one property: trees within root reach (canopy height measured, reach inferred), measured ground movement in millimetres per year from nearby satellite readings, and clay shrink-swell. Includes sources and caveats. |
| 1 | Plot size in square metres for a property. Houses only: flats and maisonettes have no plot, and those return an error with nothing charged. |
| 1 | Ofcom predicted mobile coverage for exactly one address: EE, Three, O2 and Vodafone, each rated 0 to 4 for combined 4G and 5G, with Ofcom's own descriptor and the data date. Never borrowed from a neighbouring address. Ofcom gives no separate 4G, 5G or indoor figures. A null operator means Ofcom holds no record, not zero coverage. Responses carry Ofcom attribution; keep it when you show the data. |
| 1 | Whether a property has parking, and of what kind: driveway, off-street, garage and so on. |
| 1 | A property's roof: material, shape, and whether solar panels are fitted. |
| 1 | Room counts for a property: bedrooms, bathrooms, habitable rooms and heated rooms. |
| 1 | Search UK administrative areas by name and get their boundary id, for tools that take one. |
| 1 | Broadband availability at a postcode: average and maximum download and upload speeds, superfast, ultrafast, gigabit and full-fibre coverage, and how many premises are covered. From Ofcom Connected Nations. |
| free | Work out a mortgage from price, deposit, rate and term: monthly payment, total repayment, total interest, and loan-to-value and loan-to-income ratios. |
| free | Work out Stamp Duty Land Tax for England and Northern Ireland: total tax, effective rate and a band-by-band breakdown, for a main residence, a first-time buyer or an additional property. |
| 3 | Council tax band for a property, with the billing authority name and its official code. For the yearly and monthly charge in pounds, use council_tax_full instead. |
| 5 | The full council tax record for a property: band, billing authority and its official code, this year's yearly and monthly charge in pounds, the 1991 valuation bounds behind the band, and the fiscal year. |
| 1 | Recorded crime near a postcode or coordinates, by category and month, from Police UK. |
| 1 | Census 2021 profile for the area around a postcode: population, tenure, age bands, ethnicity, occupation, household size and car ownership, plus deprivation where available. |
| 1 | Index of Multiple Deprivation scores for a postcode, across income, employment, education, health, crime, housing and environment. England only. |
| 1 | Petrol stations and EV charging points near a property, each tagged with which it is. |
| 1 | EV charging points near a property. |
| 1 | Petrol stations near a property. |
| 3 | Health services near a property: regulator-registered GPs, dentists and hospitals, plus pharmacies. Registered entries carry name, address, postcode, region, distance and a link to the official register record. Registered records cover England. |
| 1 | Registered dental practices near a property, with name, address, postcode, region, distance and a link to the official register record. England only. |
| 1 | Registered GP practices near a property, with name, address, postcode, region, distance and a link to the official register record. England only. |
| 1 | Registered hospitals near a property, with name, address, postcode, region, distance and a link to the official register record. England only. |
| 1 | Pharmacies near a property, with name, address, phone and website where known. |
| 3 | Listed buildings within a radius of a postcode: Grade I, II* and II entries with name, location, listing date and a link to the official record. |
| 20 | Reveal a listing’s UPRN and full address using its listing UUID. |
| 1 | Ofcom predicted mobile coverage for every address in a full UK postcode: EE, Three, O2 and Vodafone, each rated 0 to 4 for combined 4G and 5G, with Ofcom's own descriptor and the data date. Ofcom gives no separate 4G, 5G or indoor figures. A null operator means Ofcom holds no record, not zero coverage. Responses carry Ofcom attribution; keep it when you show the data. A full postcode is required; an outcode is rejected. |
| 5 | Planning applications near a postcode or coordinates: type, status, description and decision date, with filters for recency, type and status. |
| 1 | One-call summary of a postcode: deprivation, crime, average property price, nearby schools, transport and broadband. Cheaper than calling those tools separately. The first call for a postcode is slow, because the parts are gathered and combined when you ask for them; the result is then cached, so asking again for the same postcode is fast. Wait for the first call rather than retrying it — retrying abandons the work already in progress and starts it over. |
| 1 | How property prices are spread across an outcode area: percentiles, median and transaction counts by property type. |
| 1 | Capital growth for an outcode area: annual growth rate, returns over one, three, five and ten years, and a historical price index, from Land Registry sold prices. |
| 1 | Average property prices over time for an outcode area. |
| 5 | Address-only record for a property: full address, postcode, coordinates and the standard address identifiers. The cheapest property tier, for address verification, form pre-fill and matching. |
| 10 | The house-hunter view of a property: address, rooms, EPC rating, last sale, construction, dimensions, garden, parking and title basics, in one call. |
| 50 | Everything held on a property in one call: the Core record plus the full council tax charge, full title, environmental risks, deprivation, planning history and area price trends. |
| 25 | The full listing view of a property: everything in Base plus council tax band, flood risk, schools, broadband, crime, demographics, solar potential, confirmed sales and planning constraints. The usual starting point. |
| 1 + add-ons | Build your own property record: the base record plus only the add-ons you ask for, so you pay for exactly what you use. Call property_discovery first to see which add-ons a property has. |
| 1 | The cheap first call for a property: which data is available for it, what each add-on costs, and the shortcuts to each tier. Also the quickest way to check whether a UPRN is one we hold. |
| 10 | Land Registry title records for a property: tenure, title number and registered owner where held. |
| 20 | Return the event timeline for a sale ID or listing UUID, optionally filtered and ordered. |
| 1000 | Estimate monthly market rent for one home, with a likely range, a confidence tier and comparable rentals with distance, rent and weight. Identify the home by UPRN, address line plus postcode, or latitude and longitude. |
| 1; 5 when | Environmental risk screening for a property: flood, radon, noise, landfill, coal and other mining, invasive plants and air quality. Ask for one hazard, or for all of them in a single response. |
| 1 | Schools near a postcode, with Ofsted rating, phase, pupil numbers and distance, from the Department for Education register. England only. |
| 5 | Solar potential for a property: usable roof area, estimated yearly generation, savings, payback period and carbon saved. |
| none | Get a Homedata API key so the property data tools can be used: returns the sign-up link and the steps to follow. Makes no API call. |
| none | Check whether this server has a Homedata API key configured and what to do next if it has not. Makes no API call, so it never spends anything. |
What a call costs
Each tool's description states its price in tokens. When the API reports what a call actually cost, the tool result carries it in its metadata:
{ "homedata": { "tokens_charged": "25", "tokens_balance": "9975" } }Arguments are checked before anything is sent: a call with a missing, malformed or unknown argument is refused by the server and never reaches the API.
Command line
The package also installs homedata, built from the same tool list:
homedata tools # every tool and its price
homedata address_match --address "10 Downing Street" --postcode "SW1A 2AA"
homedata property_core --uprn 100023336956 --field epc
homedata calc_mortgage --price 300000 --deposit 30000 --rate 4.5 --term 25--field <dotted.path> prints one value, --compact prints one line of JSON,
and the tokens a call cost are printed to stderr. The calculators are free and
need no key.
Configuration
Variable | Required | Default |
| for everything except the calculators and the signup helpers | none |
| no |
|
How the tool list is kept right
homedata_mcp/manifest/tools.json is generated from the Developer Playground
catalogue by scripts/generate-manifest.mjs, and every tool is built from it.
The test suite fails if the server's tools, arguments, requests or stated
prices differ from the manifest, and a weekly check fails if the Playground's
public catalogue has moved on since the manifest was generated. See
CONTRIBUTING.md.
Development
git clone https://github.com/wehomemove/homedata-mcp.git
cd homedata-mcp
python -m venv .venv && . .venv/bin/activate
pip install -e '.[dev]'
pytestLicence
MIT. See LICENSE.
Available Tools
18 toolsbatch_property_lookupA
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.
Inputs: uprns (required). Returns: object
check_homedata_api_keyA
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.
Inputs: no named parameters. Returns: object
get_broadbandA
Return Ofcom broadband availability and speeds for a postcode.
Includes max download / upload speeds, technology (FTTP, FTTC, etc.) and superfast / ultrafast / gigabit availability.
Inputs: postcode (required). Returns: object
get_comparablesA
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.
Inputs: uprn (required), count. Returns: object
get_crimeB
Return data.police.uk crime counts and categories for a postcode.
Inputs: postcode (required), date. Returns: object
get_demographicsA
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.
Inputs: postcode (required). Returns: object
get_planning_applicationsA
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.
Inputs: uprn (required). Returns: object
get_postcode_profileA
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.
Inputs: postcode (required). Returns: object
get_property_salesA
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).
Inputs: uprn (required). Returns: object
get_schoolsB
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.
Inputs: uprn (required), radius_m. Returns: object
get_transportB
Find transport nodes (rail, tube, bus stops) near a property.
Inputs: uprn (required), radius_m. Returns: object
lookup_council_taxA
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.
Inputs: uprn (required). Returns: object
lookup_epcA
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.
Inputs: uprn (required). Returns: object
lookup_flood_riskA
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.
Inputs: uprn (required). Returns: object
lookup_propertyA
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.
Inputs: uprn (required). Returns: object
search_addressA
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.
Inputs: query (required), postcode. Returns: object
search_property_listingsA
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).
Inputs: uprn (required). Returns: object
start_homedata_signupA
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.
Inputs: email. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 18 tools
Each tool targets a distinct resource or action (e.g., demographics, crime, broadband, sales, planning, EPC, flood risk). The only potential overlap is get_postcode_profile bundling multiple data sources, but its purpose is clearly a convenience rollup, not a substitute for individual queries.
All tool names follow a consistent verb_noun pattern in snake_case (e.g., lookup_council_tax, get_broadband, search_address). The use of 'get_' for broad data and 'lookup_' for property-specific records is a subtle but consistent distinction. No mixing of conventions.
With 18 tools, the set is slightly above the ideal 3-15 range but still reasonable for the breadth of UK property data covered. Each tool serves a specific purpose, and none appear redundant.
The tool surface covers the full lifecycle of property data queries: address search, property details, sales, listings, planning, EPC, flood risk, council tax (noted as in development), demographics, crime, broadband, schools, transport, and API management. No obvious gaps for the stated domain.
Maintenance
Related MCP Connectors
UK area & property intelligence for AI agents: reports, EPC, comparables, with source provenance.
UK property research tools - crime stats, schools, demographics, valuations for AI.
UK property data: EPC, flood risk, planning, sale prices, MEES 2030 checks and grants.
UK property data by address, UPRN or UDPRN: attributes, valuation, risk and planning.
Related MCP Servers
- AlicenseCqualityDmaintenanceEnables access to UK property listings, price estimates, agent information, and market data through the Zoopla API for searching properties for sale or rent with detailed filters and analytics.22MIT
- AlicenseAqualityDmaintenanceEnables users to search UK property prices by postcode, street, or city using the HM Land Registry's SPARQL endpoint. It also provides tools for resolving postcodes and finding nearby locations through Ordnance Survey data.22MIT
- AlicenseAqualityDmaintenanceEnables AI agents to perform due diligence on Irish properties by querying public datasets for planning applications, sold prices, flood risk, radon risk, and zoning.149 npm9MIT
- AlicenseNot gradedqualityCmaintenanceEnables querying HM Land Registry Price Paid Data (UK) through natural language, providing access to property transaction records.75 npmMIT