UK property data MCP server for Windsurf
Codeium's agentic IDE built for flow. Install the Homedata MCP and Windsurf gains typed tools for 29 million UK properties — EPC, flood risk, planning, schools, transport — answered straight from your chat or agent. Ships as a Python package or a Node package; pick whichever fits Windsurf best.
How do I install the Homedata MCP in Windsurf?
Three steps: install the homedata-mcp package (Python or Node), drop in the config block, restart Windsurf.
Add to
~/.codeium/windsurf/mcp_config.json
Windsurf picks up new MCP servers on relaunch.
Recommended for Windsurf — runs via npx, no global install needed. Node 18+ required.
{
"mcpServers": {
"homedata": {
"command": "npx",
"args": ["-y", "homedata-mcp"],
"env": {
"HOMEDATA_API_KEY": "your_api_key_here"
}
}
}
}
Best for Python-embedding tools. Requires pip install homedata-mcp.
{
"mcpServers": {
"homedata": {
"command": "homedata-mcp",
"env": {
"HOMEDATA_API_KEY": "your_api_key_here"
}
}
}
}
Either edition exposes the same MCP tools and the same homedata CLI.
Pick Node if you want zero-install via npx; pick Python if your AI client already embeds Python.
1. Install the server
Pick the runtime that fits Windsurf:
pip install homedata-mcp
npm install -g homedata-mcp
# or zero-install via npx:
npx -y homedata-mcp
2. Get your API key
Sign up and copy your key from the developer dashboard. Paste it into HOMEDATA_API_KEY.
3. Restart Windsurf
Restart Windsurf after saving. The Cascade panel shows the homedata tools alongside built-in ones.
CLI quickstart — homedata commands for Windsurf users
The same package ships a homedata CLI on your PATH. Useful for one-off lookups, shell scripts, or piping property data back into Windsurf as context.
Install the CLI
Same homedata command in both editions.
Python (pip)
pip install homedata-mcp
Node (npm)
npm install -g homedata-mcp
Or run once, no install
npx -y homedata-mcp homedata --help
HOMEDATA_API_KEY in your shell before running any command — same key as the MCP server.
Common commands
Pipe into jq, fzf or feed straight back into Windsurf.
homedata search '10 downing street'
Type-ahead address search — get a UPRN for an address in Great Britain from your shell.
homedata property 100023336956
Full property record by UPRN. Pipe into jq, fzf or your editor.
homedata epc 100023336956 --field current_energy_efficiency
EPC rating, score and recommendations from the official register.
homedata flood-risk 100023336956
Environment Agency flood risk — river, sea, surface and groundwater.
homedata planning --postcode "SW1A 1AA" --days 365
Recent planning applications for a postcode or local authority in England and Wales.
What can Windsurf ask about UK property?
Typed tools Windsurf gains the moment the Homedata MCP is connected. Each tool has its own anchor — link directly to #tool-lookup-epc, #tool-lookup-flood-risk and the rest.
Find UK addresses from free text: an address, a postcode or a place name. Returns matching addresses with their UPRN, which every property tool takes.
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.
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.
The house-hunter view of a property: address, rooms, EPC rating, last sale, construction, dimensions, garden, parking and title basics, in one call.
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.
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.
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.
Room counts for a property: bedrooms, bathrooms, habitable rooms and heated rooms.
A property's roof: material, shape, and whether solar panels are fitted.
Whether a property has a garden, and of what kind.
Whether a property has parking, and of what kind: driveway, off-street, garage and so on.
Improvements recommended by a property's EPC assessment, each with estimated minimum and maximum cost.
Measurements for a property: footprint area in square metres, building height, estimated volume and predicted floor area.
Plot size in square metres for a property. Houses only: flats and maisonettes have no plot, and those return an error with nothing charged.
How a property was built: construction age band, main construction material, and whether it has a basement.
Energy Performance Certificate headline for a property: current and potential efficiency rating, EPC floor area and the date of the last assessment.
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.
Index of Multiple Deprivation scores for a postcode, across income, employment, education, health, crime, housing and environment. England only.
Average property prices over time for an outcode area.
How property prices are spread across an outcode area: percentiles, median and transaction counts by property type.
List every registered address at a UK postcode, with the UPRN for each one.
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.
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.
Land Registry title records for a property: tenure, title number and registered owner where held.
Search UK administrative areas by name and get their boundary id, for tools that take one.
Planning applications near a postcode or coordinates: type, status, description and decision date, with filters for recency, type and status.
Recorded crime near a postcode or coordinates, by category and month, from Police UK.
Solar potential for a property: usable roof area, estimated yearly generation, savings, payback period and carbon saved.
One-call summary of a postcode: deprivation, crime, average property price, nearby schools, transport and broadband. Cheaper than calling those tools separately.
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.
Schools near a postcode, with Ofsted rating, phase, pupil numbers and distance, from the Department for Education register. England only.
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.
Every amenity group near a property in one response: food, education, healthcare, financial, civic, worship, culture, convenience, green spaces, transport and shops.
Places to eat and drink near a property: cafes, restaurants, pubs, bars, takeaways.
Education near a property: schools, nurseries, colleges, universities, childcare and libraries. For Ofsted ratings and pupil numbers use schools.
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.
Banks, cash machines and money services near a property.
Civic places near a property: post offices, town halls, courthouses, fire and police stations, community centres.
Places of worship near a property.
Culture and leisure near a property: theatres, cinemas, music venues, museums, galleries and attractions.
Everyday conveniences near a property: public toilets, charging points, parcel lockers and similar.
Green space near a property: parks, playgrounds, gardens, nature reserves, commons and sports pitches.
Transport stops near a property: bus stops, railway stations, tram stops and ferry terminals.
Shops near a property, from supermarkets to specialist retailers.
Petrol stations and EV charging points near a property, each tagged with which it is.
Petrol stations near a property.
EV charging points near a property.
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.
Registered GP practices near a property, with name, address, postcode, region, distance and a link to the official register record. England only.
Registered dental practices near a property, with name, address, postcode, region, distance and a link to the official register record. England only.
Pharmacies near a property, with name, address, phone and website where known.
Registered hospitals near a property, with name, address, postcode, region, distance and a link to the official register record. England only.
Census 2021 profile for the area around a postcode: population, tenure, age bands, ethnicity, occupation, household size and car ownership, plus deprivation where available.
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.
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.
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.
Tools call the same endpoints documented on /docs/endpoints. Property data sourced from Home.co.uk, Land Registry, EPC register, Environment Agency, ONS, Ofsted and other authoritative UK sources.
What developers build with Windsurf and Homedata
Concrete jobs the Homedata MCP unlocks inside Windsurf.
Pipe UK property data into Cascade — let Windsurf write valuation tooling against live EPC, planning and risk data.
Build a property report feature in your stack while Windsurf queries 29M UK properties in the same conversation.
Windsurf + Homedata MCP — frequently asked questions
How do I install the Homedata MCP in Windsurf?
Does the MCP work with Windsurf on macOS, Windows and Linux?
Can I see which tool Cascade is calling?
Does the Homedata MCP work on a pay-as-you-go account?
Should I install the Python or Node edition for Windsurf?
How does the homedata CLI differ from the MCP server?
Other MCP clients
The Homedata MCP works with every major MCP-compatible client. Same Python and Node packages, different install path.
Claude Desktop
Anthropic's official desktop app for Claude.
Install in Claude Desktop →Claude Code
Anthropic's terminal-native coding agent.
Install in Claude Code →Cursor
AI-first code editor built on VS Code.
Install in Cursor →Codex CLI
OpenAI's terminal-native coding agent.
Install in Codex CLI →Cline
VS Code extension by the Cline team — autonomous coding inside your editor.
Install in Cline →Continue.dev
Open-source AI assistant for VS Code and JetBrains.
Install in Continue.dev →Zed
High-performance, multiplayer code editor.
Install in Zed →Or head back to the MCP hub for the full overview and the Python vs Node comparison.
Plug 29 million UK properties into Windsurf
Install in under sixty seconds. Pay as you go; sales, listings and comparables are included for every account.
Latest releases: PyPI v0.2.0 · npm v0.1.0