New • PyPI • homedata-mcp v0.2.0

Property data MCP for every AI coding tool — Claude, Cursor, Codex, Windsurf, Cline, Continue and Zed

Name: homedata-mcp
Author: Homedata

Install the Homedata MCP in any AI coding assistant and let it query 29 million UK properties — EPC, flood risk, planning, schools, transport — without leaving the chat. pip install homedata-mcp, paste your API key, restart your tool.

Get a key See all AI tools ↓

Works with Claude Desktop, Claude Code, Cursor, Codex CLI, Windsurf, Cline, Continue.dev and Zed.

bash

pip install homedata-mcp

Pick your AI tool

Every supported AI coding tool has its own install snippet, config path and FAQ. Pick yours.

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 →

Windsurf

Codeium's agentic IDE built for flow.

Install in Windsurf →

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 →

How property data MCPs work

Drop a small config block into your AI tool, paste your API key, restart. The MCP server runs locally and exposes typed tools to your assistant — every supported tool gets the same property data.

Generic JSON config

Same shape used by Claude, Cursor, Windsurf, Cline, Zed. Codex and Continue.dev use a TOML/YAML equivalent.

{
  "mcpServers": {
    "homedata": {
      "command": "homedata-mcp",
      "env": {
        "HOMEDATA_API_KEY": "your_api_key_here"
      }
    }
  }
}

1. Install the server

Any recent Python 3 install with pip. The homedata-mcp command is added to your PATH.

pip install homedata-mcp

2. Drop in your API key

3. Restart your AI tool

Your assistant now has typed property-data tools — ask it about any UK address.

What your AI can ask about

Typed tools your AI assistant gains the moment the MCP is connected. Each one maps to a documented Homedata endpoint.

search_address Free

Type-ahead UK address search across all 29 million properties — find a UPRN in milliseconds.

lookup_property Included

Pull the full property record for any UK UPRN — characteristics, tenure, build period and more.

lookup_epc Included

Energy performance certificate rating, score and recommendations from the official EPC register.

lookup_flood_risk Included

River, sea, surface and groundwater flood risk for any UK address — sourced from the Environment Agency.

get_planning_applications Included

Recent planning applications for a postcode or local authority — applicant, description, status, decision dates.

get_crime Included

Crime statistics for the surrounding area, broken down by category and month.

get_schools Included

Nearby state and independent schools with Ofsted rating, type and distance.

get_transport Included

Closest rail, tube and tram stations with walking distance and line information.

get_postcode_profile Included

Aggregated profile for any UK postcode — sales activity, average prices, area scores.

batch_property_lookup Included

Look up multiple properties at once — pass a list of UPRNs, get back full property records for each.

search_property_listings Paid plans

Live UK property listings from Home.co.uk — for sale, to rent, sold STC, price changes.

get_property_sales Paid plans

Land Registry sale history for a property — every transaction since 1995 with price and date.

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. Sales, listings and comparables are surfaced for customers on higher-tier plans — see plans.

Which AI tools support MCP

MCP is an open protocol from Anthropic. Adoption is broad and growing — Homedata works with the major coding-focused clients today.

Claude Desktop

Setup guide →

Anthropic's official desktop app for Claude.

~/Library/Application Support/Claude/claude_desktop_config.json

Claude Code

Setup guide →

Anthropic's terminal-native coding agent.

~/.config/claude-code/mcp.json

Cursor

Setup guide →

AI-first code editor built on VS Code.

~/.cursor/mcp.json

Codex CLI

Setup guide →

OpenAI's terminal-native coding agent.

~/.codex/config.toml

Windsurf

Setup guide →

Codeium's agentic IDE built for flow.

~/.codeium/windsurf/mcp_config.json

Cline

Setup guide →

VS Code extension by the Cline team — autonomous coding inside your editor.

VS Code → Cline → MCP Servers → Edit MCP Settings

Continue.dev

Setup guide →

Open-source AI assistant for VS Code and JetBrains.

~/.continue/config.yaml

Zed

Setup guide →

High-performance, multiplayer code editor.

~/.config/zed/settings.json

Frequently asked questions about the Homedata MCP

Common questions about installing, supported AI tools and underlying data sources.

What is the Model Context Protocol (MCP)?

MCP is an open standard from Anthropic that lets AI assistants like Claude, Cursor, Codex and Windsurf talk to external tools and data sources. When you install the Homedata MCP, your AI gains typed tools for querying UK property data — addresses, EPC, flood risk, planning, schools, transport and more — directly from your normal chat or coding workflow.

Which AI tools support the Homedata MCP?

Claude Desktop, Claude Code, Cursor, Codex CLI, Windsurf, Cline (VS Code), Continue.dev and Zed all ship with first-class MCP support. The same homedata-mcp Python package works in every one of them — pick the dedicated subpage above for setup instructions tailored to your tool. Any other MCP-compatible client will work too.

How does the Homedata MCP work?

When you install homedata-mcp and configure your AI client with your Homedata API key, the assistant gains a set of typed property-data tools. Ask it a question about a UK address and the assistant decides which tools to invoke, makes the request via the MCP server running locally on your machine, and uses the structured response to answer you. The MCP server runs locally — your AI vendor never sees the property data.

What property data is available through the MCP?

The MCP exposes typed tools for 29 million UK properties — address search, full property records, EPC ratings, flood and environmental risk, planning applications, crime statistics, Ofsted school data, transport links and aggregated postcode profiles. Sales history and live listings are available on higher-tier plans.

How do I install the Homedata MCP?

Pip install the package, then drop a small JSON or TOML block into your AI tool's config file with your Homedata API key. Each AI client has its own config path — pick the dedicated subpage above for the exact snippet and location for your tool.

Is the Homedata MCP open source?

Yes — the source lives on GitHub and the package is published on PyPI under MIT. You can read every tool definition, fork it, contribute new tools and pin a specific version if you need stability across deploys.

Why is UK property data hard?

UK property data is fragmented across dozens of separate registers — Land Registry for sales, the EPC register for energy, the Environment Agency for flood, local authorities for planning, ONS for census, Ofsted for schools, Home.co.uk for live listings. Homedata aggregates them into a single typed API. The MCP wraps that API so an AI assistant can query any of those sources without the developer learning each one.

How do I get help or report a bug?

Open an issue on the public GitHub repository linked at the bottom of this page, or email support@homedata.co.uk. The MCP is open-source under MIT and PRs are welcome.

Plug 29 million UK properties into your AI assistant

Works with every major AI coding tool. Install in under sixty seconds.

Get a key Read API docs View on GitHub

Latest release: homedata-mcp v0.2.0 on PyPI@if($githubStars) · ★ 0 on GitHub@endif