UK property data for Claude, Codex and every agent.
Ask about any home in plain English. Your agent finds the address, checks the records and answers, with the source for every fact: energy, flood risk, schools, prices, planning.
Install the Homedata MCP server (npx -y homedata-mcp) with my API key, YOUR_API_KEY, then find 63 Harvey Lane, Norwich to check it works.
Works as is in agents that can set themselves up, like Claude Code, Codex and Cursor. Using Claude Desktop? Two-minute setup.
Works with Claude Desktop · Claude Code · Cursor · Codex CLI · Windsurf · Cline · Continue.dev · Gemini CLI · Zed
Ask it anything
The questions you already have. Answered from the records.
Real questions, and the lookups your agent makes to answer each one.
property_discoveryrisks
property_discoveryattr_epcattr_epc_renovations
schools
price_trendsprice_growth
property_discoveryplanning
property_discoverycouncil_tax
broadband
calc_stamp_duty
property_discoveryhealthcare_gpshealthcare_pharmacies
property_discoverysolar
Coverage
Every home in England and Wales. One question away.
property_discoveryattr_epcGive your agent a key.
100 tokens = £1 · Top up from £20 · First payment matched 100%.
How it works
No config files. Just ask.
Get your API key
Sign up with your email and your key is ready in the dashboard. Top up from £20. Every self-serve endpoint is on every account, except full listings history, which is licensed separately for accounts opened from 16 September 2026.
Paste one message
Give your agent the message above with your key in it. It installs the Homedata server on your machine and connects it. No files to edit, no terminal.
Talk about property
Ask in plain English. Your agent picks the lookups it needs and answers from the records, citing the property it used.
What it can look up
60 tools in the package. One key.
Everything about a home and the street around it, in words you would use. Open a group to see each lookup and the name your agent calls it by.
The home itself13
- Address and UPRN
property_addressAddress-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.
- The essentials
property_baseThe house-hunter view of a property: address, rooms, EPC rating, last sale, construction, dimensions, garden, parking and title basics, in one call.
- The full picture
property_coreThe 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.
- Everything we hold
property_completeEverything 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.
- Just the parts you choose
property_customBuild 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.
- Rooms and bedrooms
attr_roomsRoom counts for a property: bedrooms, bathrooms, habitable rooms and heated rooms.
- Floor area
attr_dimensionsMeasurements for a property: footprint area in square metres, building height, estimated volume and predicted floor area.
- Age and construction
attr_constructionHow a property was built: construction age band, main construction material, and whether it has a basement.
- Roof
attr_roofA property's roof: material, shape, and whether solar panels are fitted.
- Garden
attr_gardenWhether a property has a garden, and of what kind.
- Parking
attr_parkingWhether a property has parking, and of what kind: driveway, off-street, garage and so on.
- Land area
attr_landPlot size in square metres for a property. Houses only: flats and maisonettes have no plot, and those return an error with nothing charged.
- Land Registry title
property_lr_titlesLand Registry title records for a property: tenure, title number and registered owner where held.
Energy and risk6
- EPC rating
attr_epcEnergy Performance Certificate headline for a property: current and potential efficiency rating, EPC floor area and the date of the last assessment.
- What would improve the EPC
attr_epc_renovationsImprovements recommended by a property's EPC assessment, each with estimated minimum and maximum cost.
- Flood and environmental risk
risksEnvironmental 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.
- Solar potential
solarSolar potential for a property: usable roof area, estimated yearly generation, savings, payback period and carbon saved.
- Listed buildings nearby
listed_buildingsListed 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.
- Planning applications
planningPlanning applications near a postcode or coordinates: type, status, description and decision date, with filters for recency, type and status.
The neighbourhood26
- Schools and Ofsted
schoolsSchools near a postcode, with Ofsted rating, phase, pupil numbers and distance, from the Department for Education register. England only.
- Crime
crimeRecorded crime near a postcode or coordinates, by category and month, from Police UK.
- Broadband speed
broadbandBroadband 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.
- Who lives here
demographicsCensus 2021 profile for the area around a postcode: population, tenure, age bands, ethnicity, occupation, household size and car ownership, plus deprivation where available.
- Deprivation
deprivationIndex of Multiple Deprivation scores for a postcode, across income, employment, education, health, crime, housing and environment. England only.
- The postcode at a glance
postcode_profileOne-call summary of a postcode: deprivation, crime, average property price, nearby schools, transport and broadband. Cheaper than calling those tools separately.
- Everything nearby
amenities_allEvery amenity group near a property in one response: food, education, healthcare, financial, civic, worship, culture, convenience, green spaces, transport and shops.
- Transport
amenities_transportTransport stops near a property: bus stops, railway stations, tram stops and ferry terminals.
- Shops
amenities_shopsShops near a property, from supermarkets to specialist retailers.
- Food and drink
amenities_foodPlaces to eat and drink near a property: cafes, restaurants, pubs, bars, takeaways.
- Education
amenities_educationEducation near a property: schools, nurseries, colleges, universities, childcare and libraries. For Ofsted ratings and pupil numbers use schools.
- Health places
amenities_healthcareHealth 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.
- Parks and green space
amenities_green_spacesGreen space near a property: parks, playgrounds, gardens, nature reserves, commons and sports pitches.
- Culture
amenities_cultureCulture and leisure near a property: theatres, cinemas, music venues, museums, galleries and attractions.
- Banks and cash
amenities_financialBanks, cash machines and money services near a property.
- Civic
amenities_civicCivic places near a property: post offices, town halls, courthouses, fire and police stations, community centres.
- Places of worship
amenities_worshipPlaces of worship near a property.
- Conveniences
amenities_convenienceEveryday conveniences near a property: public toilets, charging points, parcel lockers and similar.
- All healthcare
healthcare_allHealth 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.
- GPs
healthcare_gpsRegistered GP practices near a property, with name, address, postcode, region, distance and a link to the official register record. England only.
- Dentists
healthcare_dentistsRegistered dental practices near a property, with name, address, postcode, region, distance and a link to the official register record. England only.
- Pharmacies
healthcare_pharmaciesPharmacies near a property, with name, address, phone and website where known.
- Hospitals
healthcare_hospitalsRegistered hospitals near a property, with name, address, postcode, region, distance and a link to the official register record. England only.
- Fuel stations
fuel_stations_allPetrol stations and EV charging points near a property, each tagged with which it is.
- Petrol
fuel_stations_petrolPetrol stations near a property.
- EV chargers
fuel_stations_evEV charging points near a property.
Money7
- Asking price trends
price_trendsAverage property prices over time for an outcode area.
- How prices spread
price_distributionsHow property prices are spread across an outcode area: percentiles, median and transaction counts by property type.
- Price growth
price_growthCapital 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.
- Council tax band
council_taxCouncil 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.
- Council tax, full charges
council_tax_fullThe 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.
- Stamp duty
calc_stamp_dutyWork 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.
- Mortgage repayments
calc_mortgageWork out a mortgage from price, deposit, rate and term: monthly payment, total repayment, total interest, and loan-to-value and loan-to-income ratios.
Find the home3
- What is known about a home
property_discoveryThe 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.
- Every address at a postcode
address_postcodeList every registered address at a UK postcode, with the UPRN for each one.
- Towns, areas and boundaries
boundariesSearch UK administrative areas by name and get their boundary id, for tools that take one.
Each one is a tool your agent can call by name. You never need to: ask the question and it chooses.
What agents do with it
Give it a job. It picks the tools.
Three examples of the work people hand over. Each is one request; the agent decides which calls to make.
Screen a purchase
- property_discovery → UPRN
- property_core → the record
- risks → flood, radon, mining
- planning → applications nearby
A short brief with the risks, the planning history and anything worth asking the seller.
Check a portfolio
- property_discovery × 40 → UPRNs
- attr_epc × 40 → ratings
- attr_epc_renovations → what would lift them
The flats below C, sorted by how far off they are, with the improvements each certificate suggests.
Size up a postcode
- postcode_profile × 2
- schools × 2 → Ofsted ratings
- price_trends × 2 → prices over time
- crime × 2
A side-by-side of schools, prices and crime, and a plain recommendation.
Where it runs
Wherever your agents already work.
Agents that can run commands set themselves up from the message. The rest take a two-minute setup, and each guide has the exact steps.
For developers
Rather wire it yourself? Two editions, identical tools.
Node v1.0.1
Best for Claude Desktop, Cursor, Codex, Windsurf, Cline, Continue and Zed. npx runs it with nothing installed globally.
$ npx -y homedata-mcphomedata search '10 downing street'Type-ahead address search: get a UPRN for an address in Great Britain from your shell.homedata property 100023336956Full property record by UPRN. Pipe into jq, fzf or your editor.homedata epc 100023336956 --field current_energy_efficiencyEPC rating, score and recommendations from the official register.homedata flood-risk 100023336956Environment Agency flood risk: river, sea, surface and groundwater.homedata planning --postcode "SW1A 1AA" --days 365Recent planning applications for a postcode or local authority in England and Wales.Questions
About the Homedata MCP.
How do I give Claude UK property data?
Get a Homedata API key, then paste one message into Claude Code: "Install the Homedata MCP server (npx -y homedata-mcp) with my API key, then find 63 Harvey Lane, Norwich." It installs and connects itself. In Claude Desktop you add the server to the app's settings once; the two-minute guide is at homedata.co.uk/mcp/claude-desktop. Then ask Claude about any address in England and Wales.
Can I use Homedata with ChatGPT?
The ChatGPT app connects to MCP servers hosted on the web, and the Homedata MCP runs on your own machine, so it does not plug into the ChatGPT app today. Codex, OpenAI's coding agent, does run it: paste the setup message into Codex with your key and it connects the server for you.
Do I need to be a developer to use it?
No. If your agent can run commands on your computer, as Claude Code, Codex and Cursor can, it sets itself up from one message. You need a Homedata API key and a top-up from £20. After that you ask questions in plain English and the agent chooses which records to look up.
What is the Model Context Protocol (MCP)?
MCP is an open standard, started by Anthropic, that lets AI assistants such as Claude, Cursor, Codex and Windsurf use external tools and data. Install the Homedata MCP and your assistant gains typed tools for UK property: addresses, EPC, flood risk, planning, schools, transport and more, right inside your normal chat or coding workflow.
Which AI tools support the Homedata MCP?
Claude Desktop, Claude Code, Cursor, Codex CLI, Windsurf, Cline (VS Code), Continue.dev and Zed all support MCP. The Homedata MCP ships as a Python package (pip install homedata-mcp) and a Node package (npx -y homedata-mcp), so it fits every one of them. Each tool has its own setup page with the exact config.
How does the Homedata MCP work?
Install homedata-mcp and give your AI client your Homedata API key. Ask about a UK address and the assistant chooses which tools to call, the MCP server running on your machine makes the requests, and the assistant answers from the structured responses. The server runs locally, so your AI vendor never holds your API key.
Should I install the Python or Node edition of homedata-mcp?
Both expose the same MCP tools and the same homedata CLI, so pick whichever runtime is easier on your machine. Node suits most AI clients because npx runs it with no global install. Python suits Claude Code and any tool that already embeds Python.
What UK property data is available through MCP?
Full property records, EPC ratings, flood and environmental risk, planning applications, crime, Ofsted school data, broadband, amenities, demographics, price trends and postcode profiles. Every property tool takes a UPRN. Resolve a submitted address and postcode through the address match REST endpoint first if you need a UPRN.
How do I install the Homedata MCP?
Pick an edition: `pip install homedata-mcp` for Python, or `npx -y homedata-mcp` for Node. Then add a short JSON or TOML block to your AI tool's config file with your Homedata API key, and restart the tool. Each client keeps its config in a different place; its setup page has the exact path and snippet.
How does the homedata CLI differ from the MCP server?
The MCP server is for AI assistants: it speaks the Model Context Protocol so Claude, Cursor and others can call typed tools. The homedata CLI is for people: it ships in the same package and gives you commands such as homedata property, homedata epc and homedata planning to run in a terminal, pipe into jq or use from scripts.
Is the Homedata MCP open source?
Yes. Both editions are MIT licensed. The Python source is at github.com/wehomemove/homedata-mcp and the Node source at github.com/wehomemove/homedata-mcp-node. Read every tool definition, fork either repo, contribute tools or pin a version.
Why is UK property data hard to work with?
It is spread across separate registers: HM Land Registry for sales, the EPC register for energy, the Environment Agency for flood, local authorities for planning, the ONS for census data and Ofsted for schools. Homedata joins them on the UPRN behind one API, and the MCP lets an agent use all of it without anyone learning each source.
How do I get help or report a bug?
Open an issue on the GitHub repository (homedata-mcp or homedata-mcp-node), or email [email protected]. Pull requests are welcome.