Skip to main content
Glama

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

or run it without installing, with uv:

uvx homedata-mcp

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

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

address_match

5

Match a submitted UK street address and postcode to a UPRN. A 200 response returns the address-level retrieve body plus address_resolution.

address_postcode

2

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

amenities_all

5

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

amenities_civic

1

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

amenities_convenience

1

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

amenities_culture

1

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

amenities_education

1

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

amenities_financial

1

Banks, cash machines and money services near a property.

amenities_food

1

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

amenities_green_spaces

1

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

amenities_healthcare

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.

amenities_shops

1

Shops near a property, from supermarkets to specialist retailers.

amenities_transport

1

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

amenities_worship

1

Places of worship near a property.

attr_construction

1

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

attr_dimensions

1

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

attr_epc

1

Energy Performance Certificate headline for a property: current and potential efficiency rating, EPC floor area and the date of the last assessment.

attr_epc_history

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.

attr_epc_renovations

1

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

attr_garden

1

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

attr_ground_stability

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.

attr_land

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.

attr_mobile_coverage

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.

attr_parking

1

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

attr_roof

1

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

attr_rooms

1

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

boundaries

1

Search UK administrative areas by name and get their boundary id, for tools that take one.

broadband

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.

calc_mortgage

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.

calc_stamp_duty

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.

council_tax

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.

council_tax_full

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.

crime

1

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

demographics

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.

deprivation

1

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

fuel_stations_all

1

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

fuel_stations_ev

1

EV charging points near a property.

fuel_stations_petrol

1

Petrol stations near a property.

healthcare_all

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.

healthcare_dentists

1

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

healthcare_gps

1

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

healthcare_hospitals

1

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

healthcare_pharmacies

1

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

listed_buildings

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.

listing_address

20

Reveal a listing’s UPRN and full address using its listing UUID.

mobile_coverage

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.

planning

5

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

postcode_profile

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.

price_distributions

1

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

price_growth

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.

price_trends

1

Average property prices over time for an outcode area.

property_address

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.

property_base

10

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

property_complete

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.

property_core

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.

property_custom

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.

property_discovery

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.

property_lr_titles

10

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

property_sale_events

20

Return the event timeline for a sale ID or listing UUID, optionally filtered and ordered.

rental_appraisal

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.

risks

1; 5 when risk_type is all

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.

schools

1

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

solar

5

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

start_homedata_signup

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.

check_homedata_api_key

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

HOMEDATA_API_KEY

for everything except the calculators and the signup helpers

none

HOMEDATA_BASE_URL

no

https://api.homedata.co.uk

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]'
pytest

Licence

MIT. See LICENSE.

Available Tools

18 tools
batch_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

    A4/5.0

    Scored across 18 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count4/5

    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.

    Completeness5/5

    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

    ActivityActive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      C
      quality
      D
      maintenance
      Enables 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.
      22
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables 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.
      2
      2
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables AI agents to perform due diligence on Irish properties by querying public datasets for planning applications, sold prices, flood risk, radon risk, and zoning.
      1
      49 npm
      9
      MIT