MCP Server
Query 29 million UK properties directly from Claude, Cursor, Windsurf, or any AI tool that supports the
Model Context Protocol.
One npx command. 16 tools. No wrapper code needed.
Two editions, both published
Node: npx -y homedata-mcp.
Python: pip install homedata-mcp.
Both ship the same homedata CLI. You'll need an
API key.
What is MCP?
The Model Context Protocol lets AI assistants call external tools — like our property data API — directly in conversation. Ask "What's the flood risk for 10 Downing Street?" and Claude handles the address lookup, UPRN resolution, and risk query automatically.
Quick Start
Three steps: get an API key, add one config block, ask Claude about a property.
Add the MCP server to your AI tool
Edit ~/.claude/claude_desktop_config.json
and add the homedata entry:
{
"mcpServers": {
"homedata": {
"command": "npx",
"args": ["-y", "homedata-mcp"],
"env": {
"HOMEDATA_API_KEY": "your_api_key_here"
}
}
}
}
Restart Claude Desktop after saving. You'll see a hammer icon in the chat input — that's your 16 tools ready to use.
Ask about a property
Claude handles address lookup → UPRN resolution → data queries automatically.
Available Tools
16 tools covering address search, property lookup (single and batch), EPC, council tax, flood risk, sale history, comparables, listings, planning, schools, crime, demographics, transport, broadband and postcode profiles. Both editions of homedata-mcp expose the same 16 tools, whichever you install.
Address & geo
| Tool | What it does |
|---|---|
| search_address | Free-text address search across the UK address base. Returns candidate addresses with their UPRNs — the first step for everything else. |
| get_transport | Transport nodes near a property: rail, tube and bus stops. |
Property & area data
| Tool | What it does |
|---|---|
| lookup_property | The canonical property record for one UPRN: address, geometry, council, tenure and the base attributes. |
| batch_property_lookup | Up to 50 UPRNs in one round-trip. Use this instead of looping the single lookup. |
| lookup_epc | The latest Energy Performance Certificate for a UPRN: current and potential efficiency. |
| lookup_council_tax | Council tax band and billing authority for a UPRN. Marked in development in the package. |
| lookup_flood_risk | Environment Agency flood risk for a property: bands for rivers and sea, and for surface water. |
| get_property_sales | Full Land Registry sale history for a property: date, price and transaction type per event. |
| get_comparables | Recently sold properties near a subject property, nearest first — the evidence set for valuation work. |
| search_property_listings | Live and historic sale or letting listings linked to a UPRN, with asking price and status. |
| get_planning_applications | Planning applications at or near a UPRN: reference, decision and decision date. |
Area intelligence
| Tool | What it does |
|---|---|
| get_schools | Schools within a radius of a property, with Ofsted ratings, phase and distance. |
| get_crime | Police UK crime counts and categories for a postcode, optionally for a given month. |
| get_demographics | Census 2021 profile for a postcode: population, age bands and household composition. |
| get_broadband | Ofcom broadband availability for a postcode: maximum download and upload speeds, and technology. |
| get_postcode_profile | One-shot rollup for a postcode: headline demographics, crime, broadband and average sale price. |
Anything without a tool is still a REST call away. Valuations, amenities, healthcare, fuel stations, price trends and price growth aren't exposed as MCP tools, so call them through the REST API. Broadband coverage is limited: see the Broadband endpoint docs.
What it looks like in practice
Claude calls tools automatically — you just ask the question in plain English.
"Give me a full due diligence report on Flat 3, 42 Riverside Drive, Bristol BS1 4RB"
Claude calls: search_address → lookup_property → lookup_epc → lookup_flood_risk → get_property_sales → get_comparables → get_planning_applications (7 calls)
Returns a structured report: 2-bed flat, EPC C (72/100), floor area 68m², last sold £320,000 in 2021. Flood risk: low for rivers and sea, low for surface water. 5 comparables within 0.3 miles sold between £295k and £340k. Planning: no applications on record for the property.
"What's 42 Riverside Drive worth? Show me what sold nearby, what's on the market, and what the area looks like."
Claude calls: search_address → get_comparables → search_property_listings → get_postcode_profile (4 calls)
Returns the nearest comparable sales with prices and dates, any live or past listings for the property itself, and an area rollup: headline demographics, crime, broadband and average sale price.
"I have a CSV of 50 UPRNs. Look up EPC data for each and write the results to enriched_data.csv"
Cursor reads your CSV, calls lookup_epc for each UPRN, writes results — 50 calls total
50 enriched rows with EPC ratings, efficiency scores, floor areas, and inspection dates. Cursor writes the output file automatically.
Configuration
| Environment variable | Required | Default | Description |
|---|---|---|---|
| HOMEDATA_API_KEY | Yes | — | Your API key from the developer dashboard |
| HOMEDATA_API_URL | No | https://api.homedata.co.uk/api | Override for self-hosted or staging environments |
Where to find your API key
Your key is in the developer dashboard
under API Keys. It looks like PREFIX.SECRET.
Keep it out of version control — use an environment variable or your OS keychain.
# Add to ~/.zshrc or ~/.bashrc export HOMEDATA_API_KEY="your_api_key_here" # Then reference it in your MCP config # "env": { "HOMEDATA_API_KEY": "${HOMEDATA_API_KEY}" }
vs PropertyData MCP
PropertyData also offers an MCP server. Key differences:
| Feature | PropertyData | Homedata |
|---|---|---|
| Risk data | Flood only | 7 risk types in one call |
| Live listings | — | UK-wide coverage |
Ready to start?
Get an API key, add the config block, ask Claude about a property. Takes about 2 minutes.
Integrate into your own product
Pay as you goThe Homedata MCP server gives any AI assistant direct access to 29M UK properties — address lookup, EPC, risks, comparables, planning, schools, broadband, crime, and live listings — without writing a single line of wrapper code.
Structured as JSON · queryable by UPRN or postcode · ready to embed in any application
Exact measurements
Real values — distances, concentrations, counts — not rounded ratings
29 million UK properties covered
Every address queryable by UPRN or postcode
REST API
JSON responses, OpenAPI docs, sandbox — first call in under 5 minutes
Pay as you go: 100 tokens = £1 across every endpoint, no subscription needed. Bonus tokens with an optional monthly subscription, and your first top-up matched 100%. See pricing →
Sources
Further reading
All 40+ endpoints · Code examples · Authentication · Getting Started