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.
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.
Get a free API key
Sign up at homedata.co.uk — no credit card required. 100 API calls/month on the free tier. Address find costs 2 calls, retrieve costs 5 — transparent weighted billing.
Get free API key →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. Three are free — the rest cost 1 API call each. No credit multipliers, no variable pricing.
Free Free tools — don't count against your quota
| 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. |
Starter Data tools — 1 API call each (Starter plan, £49/mo)
| 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. |
Growth Advanced tools — requires Growth plan (£149/mo)
| Tool | What it does |
|---|---|
| valuation | Automated property valuation (AVM) by UPRN — estimated sale or rental value with confidence score and comparable evidence. |
Most tools cost exactly 1 API call. Address search is free. EPC, comparables, environmental risk, planning, and council tax tools are coming in the next release. See pricing →
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 |
|---|---|---|
| UPRN lookup | 10 credits per lookup | Free — always |
| Pricing model | Variable credits (1–50 per call) | Transparent weighted billing — most endpoints 1 call |
| Free tier | 14-day trial only | Permanent (100 calls/month) |
| Risk data | Flood only | 7 risk types in one call |
| Planning applications | Per-result billing | Flat 1 call |
| Live listings | — | ✓ UK-wide coverage |
Ready to start?
Get a free API key, add the config block, ask Claude about any UK property. Takes about 2 minutes.