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 data tools (plus 2 sign-up tools). No wrapper code needed.
Coming soon — sign up for early access
The @homedata/mcp-server npm package is not yet published.
Sign up to be notified when it goes live.
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 any UK 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-server"],
"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 data tools (plus 2 sign-up tools) ready to use.
Ask about any UK property
Claude handles address lookup → UPRN resolution → data queries automatically.
Available Tools
16 data tools (plus 2 sign-up tools) covering address lookup, the property tiers (discover / base / core / complete + batch), EPC, comparables, property sales, live listings, council tax (band + full), planning, flood risk, crime, demographics, schools, transport, broadband, and postcode profiles.
Address & geo
| Tool | What it does |
|---|---|
| address_search | Search UK addresses by text query. Returns matching addresses with UPRNs. Useful as the first step to find a UPRN. |
| address_by_postcode | List all addresses within a postcode with their UPRNs. |
| broadband | Broadband download/upload speeds (Ofcom Connected Nations data). Coverage type: full fibre, superfast, ultrafast, basic. |
Property & area data
| Tool | What it does |
|---|---|
| property_lookup | Full property record by UPRN — 60+ fields: address, type, bedrooms, bathrooms, floor area, construction age, EPC summary, tenure. |
| schools_nearby | Schools near a postcode or lat/lng — name, phase (Primary/Secondary), Ofsted rating, pupil numbers, distance. DfE GIAS (~27,000 schools). |
| crime_nearby | Street-level crime near a postcode or location. Counts by category (burglary, vehicle crime, violence, etc.) from Police UK. |
| price_growth | Year-on-year property price growth for an outward postcode (e.g. SW1A, E1). Compares median sold prices over current vs prior 12 months. |
| postcode_profile | Area intelligence in one call: deprivation scores, broadband speeds, median sold prices, schools summary, transport stops, Census 2021 data. |
| demographics | Census 2021 demographics for a postcode — population, age distribution, tenure split (owned/rented/social), economic activity. |
| live_listings | Current UK property listings — filter by postcode, bedrooms, price range, property type (Sale or Rent). Live data. |
Valuation
| Tool | What it does |
|---|---|
| valuation | Automated property valuation (AVM) by UPRN — estimated sale or rental value with confidence score and comparable evidence. |
EPC, comparables, flood risk, planning and council tax are all live as MCP tools today. AVM valuations and the amenities / NHS healthcare / fuel endpoints aren't exposed as MCP tools yet — call them directly via the REST API in the meantime. Broadband coverage is currently limited — see the Broadband endpoint docs for details.
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: address_search → property_lookup → epc_check → environmental_risks → sold_prices → comparables (6 calls)
Returns a structured report: 2-bed flat, EPC C (72/100), floor area 68m², last sold £320,000 in 2021. Flood risk: low. Radon: low. 5 comparables in 0.3 miles sold between £295k–£340k in last 18 months. Planning: no applications within 500m in last 2 years.
"Search for 2-bed flats for sale in Hackney under £500k. Then show me price trends for E8 and E9."
Claude calls: boundary_search("Hackney") → live_listings → price_trends("E8") → price_trends("E9") (4 calls)
Returns live listings filtered by criteria, then a side-by-side price trend comparison: E8 median £425k (+4.2% YoY), E9 median £395k (+6.1% YoY). E9 growing faster but slightly cheaper.
"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 epc_check 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 any UK property. Takes about 2 minutes.
Integrate into your own product
Free to startThe 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
29M+ UK properties
Every address queryable by UPRN or postcode
REST API
JSON responses, OpenAPI docs, sandbox — first call in under 5 minutes
Free tier: 100 API calls/month across all endpoints, no credit card required. Paid plans from £29/month for production use. Compare plans →
Further reading
All 50+ endpoints · Code examples · Authentication · Getting Started