Skip to main content
29M UK properties, one API call. Get an API key →
Agent MCP

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.

Copy this to your agent

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

Agent sessionhomedata connected
Is 63 Harvey Lane, Norwich a good fit for a family? Check energy, flood risk and schools.
property_discovery("63 Harvey Lane, Norwich")1 match · UPRN 100090904564
property_core(100090904564)Semi-detached · 4 bed · 145 m²
attr_epc(100090904564)EPC D, 63 · potential B
risks(100090904564, "flood")Flood zone 3: not detected
schools("NR7 0AG")20 nearby · closest St William's
Plenty of room: a four-bed semi, 145 m². Energy is the weak spot, EPC D now with a route to B. Outside flood zone 3, and 20 schools nearby.
Sample session5 tool calls

Ask it anything

The questions you already have. Answered from the records.

Real questions, and the lookups your agent makes to answer each one.

Is this flat in a flood zone? property_discoveryrisks
What would it take to get this house to EPC C? property_discoveryattr_epcattr_epc_renovations
Which schools near NR7 are rated Outstanding? schools
How have asking prices moved in SW11 this year? price_trendsprice_growth
Has anyone applied to build next door? property_discoveryplanning
What council tax band is 14 Elm Row? property_discoverycouncil_tax
Is the broadband fast enough to work from home? broadband
How much stamp duty on a £425,000 first home? calc_stamp_duty
Where is the nearest GP and pharmacy? property_discoveryhealthcare_gpshealthcare_pharmacies
Could solar panels pay for themselves here? property_discoverysolar

Coverage

Every home in England and Wales. One question away.

property_discovery
attr_epc
Sample records · Example UPRNs · illustrative identifiers

Give your agent a key.

100 tokens = £1 · Top up from £20 · First payment matched 100%.

How it works

No config files. Just ask.

01 · Key

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.

02 · Hand it over

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.

03 · Ask

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 UPRNproperty_address

    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.

  • The essentialsproperty_base

    The house-hunter view of a property: address, rooms, EPC rating, last sale, construction, dimensions, garden, parking and title basics, in one call.

  • The full pictureproperty_core

    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.

  • Everything we holdproperty_complete

    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.

  • Just the parts you chooseproperty_custom

    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.

  • Rooms and bedroomsattr_rooms

    Room counts for a property: bedrooms, bathrooms, habitable rooms and heated rooms.

  • Floor areaattr_dimensions

    Measurements for a property: footprint area in square metres, building height, estimated volume and predicted floor area.

  • Age and constructionattr_construction

    How a property was built: construction age band, main construction material, and whether it has a basement.

  • Roofattr_roof

    A property's roof: material, shape, and whether solar panels are fitted.

  • Gardenattr_garden

    Whether a property has a garden, and of what kind.

  • Parkingattr_parking

    Whether a property has parking, and of what kind: driveway, off-street, garage and so on.

  • Land areaattr_land

    Plot 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 titleproperty_lr_titles

    Land Registry title records for a property: tenure, title number and registered owner where held.

Energy and risk6
  • EPC ratingattr_epc

    Energy 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 EPCattr_epc_renovations

    Improvements recommended by a property's EPC assessment, each with estimated minimum and maximum cost.

  • Flood and environmental riskrisks

    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.

  • Solar potentialsolar

    Solar potential for a property: usable roof area, estimated yearly generation, savings, payback period and carbon saved.

  • Listed buildings nearbylisted_buildings

    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.

  • Planning applicationsplanning

    Planning applications near a postcode or coordinates: type, status, description and decision date, with filters for recency, type and status.

The neighbourhood26
  • Schools and Ofstedschools

    Schools near a postcode, with Ofsted rating, phase, pupil numbers and distance, from the Department for Education register. England only.

  • Crimecrime

    Recorded crime near a postcode or coordinates, by category and month, from Police UK.

  • Broadband speedbroadband

    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.

  • Who lives heredemographics

    Census 2021 profile for the area around a postcode: population, tenure, age bands, ethnicity, occupation, household size and car ownership, plus deprivation where available.

  • Deprivationdeprivation

    Index of Multiple Deprivation scores for a postcode, across income, employment, education, health, crime, housing and environment. England only.

  • The postcode at a glancepostcode_profile

    One-call summary of a postcode: deprivation, crime, average property price, nearby schools, transport and broadband. Cheaper than calling those tools separately.

  • Everything nearbyamenities_all

    Every amenity group near a property in one response: food, education, healthcare, financial, civic, worship, culture, convenience, green spaces, transport and shops.

  • Transportamenities_transport

    Transport stops near a property: bus stops, railway stations, tram stops and ferry terminals.

  • Shopsamenities_shops

    Shops near a property, from supermarkets to specialist retailers.

  • Food and drinkamenities_food

    Places to eat and drink near a property: cafes, restaurants, pubs, bars, takeaways.

  • Educationamenities_education

    Education near a property: schools, nurseries, colleges, universities, childcare and libraries. For Ofsted ratings and pupil numbers use schools.

  • Health placesamenities_healthcare

    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.

  • Parks and green spaceamenities_green_spaces

    Green space near a property: parks, playgrounds, gardens, nature reserves, commons and sports pitches.

  • Cultureamenities_culture

    Culture and leisure near a property: theatres, cinemas, music venues, museums, galleries and attractions.

  • Banks and cashamenities_financial

    Banks, cash machines and money services near a property.

  • Civicamenities_civic

    Civic places near a property: post offices, town halls, courthouses, fire and police stations, community centres.

  • Places of worshipamenities_worship

    Places of worship near a property.

  • Conveniencesamenities_convenience

    Everyday conveniences near a property: public toilets, charging points, parcel lockers and similar.

  • All healthcarehealthcare_all

    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.

  • GPshealthcare_gps

    Registered GP practices near a property, with name, address, postcode, region, distance and a link to the official register record. England only.

  • Dentistshealthcare_dentists

    Registered dental practices near a property, with name, address, postcode, region, distance and a link to the official register record. England only.

  • Pharmacieshealthcare_pharmacies

    Pharmacies near a property, with name, address, phone and website where known.

  • Hospitalshealthcare_hospitals

    Registered hospitals near a property, with name, address, postcode, region, distance and a link to the official register record. England only.

  • Fuel stationsfuel_stations_all

    Petrol stations and EV charging points near a property, each tagged with which it is.

  • Petrolfuel_stations_petrol

    Petrol stations near a property.

  • EV chargersfuel_stations_ev

    EV charging points near a property.

Money7
  • Asking price trendsprice_trends

    Average property prices over time for an outcode area.

  • How prices spreadprice_distributions

    How property prices are spread across an outcode area: percentiles, median and transaction counts by property type.

  • Price growthprice_growth

    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.

  • Council tax bandcouncil_tax

    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.

  • Council tax, full chargescouncil_tax_full

    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.

  • Stamp dutycalc_stamp_duty

    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.

  • Mortgage repaymentscalc_mortgage

    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.

Find the home3
  • What is known about a homeproperty_discovery

    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.

  • Every address at a postcodeaddress_postcode

    List every registered address at a UK postcode, with the UPRN for each one.

  • Towns, areas and boundariesboundaries

    Search 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.

Due diligence

Screen a purchase

Anything on 14 Elm Row I should know before we offer?
  1. property_discovery → UPRN
  2. property_core → the record
  3. risks → flood, radon, mining
  4. planning → applications nearby

A short brief with the risks, the planning history and anything worth asking the seller.

Lettings

Check a portfolio

Which of these 40 flats fall below EPC C?
  1. property_discovery × 40 → UPRNs
  2. attr_epc × 40 → ratings
  3. attr_epc_renovations → what would lift them

The flats below C, sorted by how far off they are, with the improvements each certificate suggests.

Area research

Size up a postcode

Compare NR7 and NR2 for a young family.
  1. postcode_profile × 2
  2. schools × 2 → Ofsted ratings
  3. price_trends × 2 → prices over time
  4. crime × 2

A side-by-side of schools, prices and crime, and a plain recommendation.

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-mcp

npm · GitHub

Python v1.0.1

Best for Claude Code and anything that already runs Python. Installs the MCP server and the homedata CLI together.

$ pip install homedata-mcp

PyPI · GitHub

homedata 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.

Give your agents a key.

Get an API key