npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

homedata-mcp

v0.1.0

Published

MCP server + CLI for the Homedata UK property data API — 29M UK properties (EPC, flood risk, planning, comparables, demographics, schools, broadband) for Claude, Cursor, Codex and other AI coding assistants.

Vulnerabilities

Powered byPowered by Snyk
  • 0High
  • 0Medium
  • 0Low

Links

Git

Maintainers

homecohomeco

Keywords

mcpmodel-context-protocolhomedatauk-propertyproperty-dataclaudecursorcodexwindsurfepcflood-riskplanninguprn

Readme

Homedata MCP — Node.js / npm

The official Homedata MCP server and CLI for the Model Context Protocol. Brings 29M UK addresses with EPC, sale history, planning applications, flood risk, comparables, demographics, crime, schools, broadband and transport into any MCP-compatible AI tool — Claude Desktop, Claude Code, Cursor, Codex, Cline, Continue.dev, Windsurf, Zed and more.

Behaviour is identical to the Python edition (homedata-mcp) — same tools, same data, same env-var auth. Pick the one that matches your stack.

Data sourced from Home.co.uk's 30-year panel of partners, the Environment Agency, ONS Census 2021, the Valuation Office Agency, Ofcom, Ofsted, data.police.uk and HM Land Registry.

Install

npm install -g homedata-mcp

Or run on demand with npx:

npx homedata-mcp        # starts the MCP server (stdio)
npx homedata --help     # CLI

Get a free Homedata API key at homedata.co.uk/developer — no card required to start.

export HOMEDATA_API_KEY=hd_live_xxx

Wire it into Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "homedata": {
      "command": "npx",
      "args": ["-y", "homedata-mcp"],
      "env": {
        "HOMEDATA_API_KEY": "your_api_key_here"
      }
    }
  }
}

Restart Claude Desktop and ask "what's the EPC rating for UPRN 100021421083?". Same pattern works for Cursor, Codex, Cline, Continue.dev, Windsurf, and Zed — see homedata.co.uk/mcp for per-client guides.

CLI

The package also installs a homedata command for shell use, scripting, and CI:

homedata property 100021421083
homedata epc 100021421083 --field current_energy_efficiency
homedata search "10 downing street" --postcode SW1A2AA
homedata flood 100021421083 --compact
homedata batch 100021421083 100022121211

Pass --field <dotted.path> to extract a single value (good for shell pipelines) and --compact for single-line JSON.

Tools

| Tool | Description | |---|---| | lookup_property(uprn) | Property attributes + EPC summary + last sold price | | lookup_epc(uprn) | Full Energy Performance Certificate | | lookup_flood_risk(uprn) | Flood risk assessment | | get_property_sales(uprn) | Historical sales (HMLR) | | search_property_listings(uprn) | Past + current listing events | | get_comparables(uprn, count?) | Nearest N comparable properties | | get_planning_applications(uprn) | Planning applications near a UPRN | | get_schools(uprn, radius_m?) | Schools near a UPRN | | get_transport(uprn, radius_m?) | Transport options near a UPRN | | get_crime(postcode, date?) | Recorded crime in the postcode | | get_demographics(postcode) | ONS Census 2021 profile | | get_broadband(postcode) | Ofcom broadband availability | | get_postcode_profile(postcode) | Aggregated postcode profile | | search_address(query, postcode?) | Free-text address search | | batch_property_lookup(uprns) | Batch lookup (max 50) | | lookup_council_tax(uprn) | In development — currently returns a 503 stub |

Privacy

The MCP server runs locally on your machine. Your queries go directly from your machine to api.homedata.co.uk — your AI vendor never sees the property data.

Links

License

MIT