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. 11 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 11 tools ready to use.
Ask about any UK property
Claude handles address lookup → UPRN resolution → data queries automatically.
Available Tools
11 tools covering address lookup, property data, schools, crime, broadband, live listings, price growth, demographics, postcode profiles, and valuations.
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, environmental risk, planning, council tax, and AVM valuations tools are coming in the next release. 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 38 endpoints · Code examples · Authentication · Getting Started