homedata-mcp 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,14 @@
+# Changelog
+
+All notable changes to the Node.js edition of the Homedata MCP server.
+
+The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.0] - 2026-05-11
+
+### Added
+- Initial release of the Node.js / TypeScript edition.
+- Feature-parity with `homedata-mcp` 0.2.0 on PyPI: same 15 working tools plus the `lookup_council_tax` stub, same env-var auth (`HOMEDATA_API_KEY`), same base URL.
+- Ships both `homedata-mcp` (stdio MCP server) and `homedata` (CLI) binaries from a single package.
+- Built on the official `@modelcontextprotocol/sdk`; communicates over stdio with any MCP-compatible client (Claude Desktop, Claude Code, Cursor, Codex, Cline, Continue.dev, Windsurf, Zed).
+- TypeScript source with full `.d.ts` types — package can be imported as a library too: `import { HomedataClient, tools } from "homedata-mcp"`.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Homedata Ltd
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,111 @@
+# Homedata MCP — Node.js / npm
+
+The official Homedata MCP server and CLI for the [Model Context Protocol](https://modelcontextprotocol.io). 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`)](https://pypi.org/project/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
+
+```bash
+npm install -g homedata-mcp
+```
+
+Or run on demand with `npx`:
+
+```bash
+npx homedata-mcp        # starts the MCP server (stdio)
+npx homedata --help     # CLI
+```
+
+Get a free Homedata API key at [homedata.co.uk/developer](https://homedata.co.uk/developer) — no card required to start.
+
+```bash
+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):
+
+```json
+{
+  "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](https://homedata.co.uk/mcp) for per-client guides.
+
+---
+
+## CLI
+
+The package also installs a `homedata` command for shell use, scripting, and CI:
+
+```bash
+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
+
+* Homedata: <https://homedata.co.uk>
+* Pricing: <https://homedata.co.uk/pricing>
+* Developer dashboard: <https://homedata.co.uk/developer>
+* Python edition: <https://pypi.org/project/homedata-mcp/>
+* Issues: <https://github.com/wehomemove/homedata-mcp-node/issues>
+
+---
+
+## License
+
+MIT

package/dist/cli.d.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+/**
+ * homedata — command line interface mirroring the Python CLI.
+ *
+ * Same data as the MCP server but for human shells, scripting, and CI.
+ * Usage:
+ *   homedata property 100021421083
+ *   homedata epc 100021421083 --field current_energy_efficiency
+ *   homedata search "10 downing street" --postcode SW1A2AA
+ *   homedata batch 100021421083 100022121211
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;GASG"}

package/dist/cli.js

@@ -0,0 +1,171 @@
+#!/usr/bin/env node
+/**
+ * homedata — command line interface mirroring the Python CLI.
+ *
+ * Same data as the MCP server but for human shells, scripting, and CI.
+ * Usage:
+ *   homedata property 100021421083
+ *   homedata epc 100021421083 --field current_energy_efficiency
+ *   homedata search "10 downing street" --postcode SW1A2AA
+ *   homedata batch 100021421083 100022121211
+ */
+import { HomedataClient, HomedataError } from "./client.js";
+import * as t from "./tools.js";
+import { VERSION } from "./index.js";
+function parseArgv(argv) {
+    const out = { positional: [], flags: {} };
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (a.startsWith("--")) {
+            const key = a.slice(2);
+            const next = argv[i + 1];
+            if (next === undefined || next.startsWith("--")) {
+                out.flags[key] = true;
+            }
+            else {
+                out.flags[key] = next;
+                i++;
+            }
+        }
+        else if (!out.command) {
+            out.command = a;
+        }
+        else {
+            out.positional.push(a);
+        }
+    }
+    return out;
+}
+function printHelp() {
+    console.log(`homedata ${VERSION} — UK property data CLI
+
+Usage: homedata <command> [args] [--field PATH] [--compact]
+
+Commands:
+  property <uprn>                       Look up a property by UPRN.
+  epc <uprn>                            Get EPC for a UPRN.
+  flood <uprn>                          Get flood risk for a UPRN.
+  sales <uprn>                          Historical sales (HMLR).
+  listings <uprn>                       Past + current listings.
+  comparables <uprn> [--count N]        Nearest N comparables (default 20).
+  planning <uprn>                       Planning applications near a UPRN.
+  schools <uprn> [--radius N]           Schools near a UPRN (default 1000m).
+  transport <uprn> [--radius N]         Transport near a UPRN (default 800m).
+  crime <postcode> [--date YYYY-MM]     Recorded crime in a postcode.
+  demographics <postcode>               ONS Census 2021 profile.
+  broadband <postcode>                  Ofcom broadband availability.
+  postcode <postcode>                   Aggregated postcode profile.
+  search <query> [--postcode PC]        Free-text address search.
+  batch <uprn> <uprn> ...               Batch property lookup (max 50).
+
+Flags:
+  --field <dotted.path>   Extract a single value from the response (e.g. last_sold_price).
+  --compact               Single-line JSON output (good for jq, pipes).
+  --version               Show version.
+  --help                  Show this help.
+
+Set HOMEDATA_API_KEY in your environment. Get a free key at https://homedata.co.uk/developer.`);
+}
+function format(data, compact, field) {
+    if (field) {
+        let cursor = data;
+        for (const part of field.split(".")) {
+            if (cursor && typeof cursor === "object" && part in cursor) {
+                cursor = cursor[part];
+            }
+            else {
+                return "";
+            }
+        }
+        if (cursor && typeof cursor === "object")
+            return JSON.stringify(cursor, null, compact ? 0 : 2);
+        return String(cursor);
+    }
+    return JSON.stringify(data, null, compact ? 0 : 2);
+}
+async function run(args) {
+    if (args.flags["help"] || args.flags["h"] || !args.command) {
+        printHelp();
+        return 0;
+    }
+    if (args.flags["version"] || args.flags["v"]) {
+        console.log(`homedata ${VERSION}`);
+        return 0;
+    }
+    let client;
+    try {
+        client = HomedataClient.fromEnv(VERSION);
+    }
+    catch (err) {
+        if (err instanceof HomedataError) {
+            console.error(`error: ${err.message}`);
+            return 2;
+        }
+        throw err;
+    }
+    const p = args.positional;
+    let data;
+    switch (args.command) {
+        case "property":
+            data = await t.lookup_property(client, p[0]);
+            break;
+        case "epc":
+            data = await t.lookup_epc(client, p[0]);
+            break;
+        case "flood":
+            data = await t.lookup_flood_risk(client, p[0]);
+            break;
+        case "sales":
+            data = await t.get_property_sales(client, p[0]);
+            break;
+        case "listings":
+            data = await t.search_property_listings(client, p[0]);
+            break;
+        case "planning":
+            data = await t.get_planning_applications(client, p[0]);
+            break;
+        case "comparables":
+            data = await t.get_comparables(client, p[0], Number(args.flags["count"] ?? 20));
+            break;
+        case "schools":
+            data = await t.get_schools(client, p[0], Number(args.flags["radius"] ?? 1000));
+            break;
+        case "transport":
+            data = await t.get_transport(client, p[0], Number(args.flags["radius"] ?? 800));
+            break;
+        case "crime":
+            data = await t.get_crime(client, p[0], args.flags["date"]);
+            break;
+        case "demographics":
+            data = await t.get_demographics(client, p[0]);
+            break;
+        case "broadband":
+            data = await t.get_broadband(client, p[0]);
+            break;
+        case "postcode":
+            data = await t.get_postcode_profile(client, p[0]);
+            break;
+        case "search":
+            data = await t.search_address(client, p[0], args.flags["postcode"]);
+            break;
+        case "batch":
+            data = await t.batch_property_lookup(client, p);
+            break;
+        default:
+            console.error(`unknown command: ${args.command}`);
+            printHelp();
+            return 2;
+    }
+    console.log(format(data, args.flags["compact"] === true, args.flags["field"]));
+    if (data && typeof data === "object" && "error" in data) {
+        return 1;
+    }
+    return 0;
+}
+run(parseArgv(process.argv.slice(2)))
+    .then((code) => process.exit(code))
+    .catch((err) => {
+    console.error("[homedata] fatal:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/client.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Thin HTTP client for the Homedata API (Loki).
+ * Mirrors the Python implementation 1:1 so both packages have identical behaviour.
+ */
+export declare class HomedataError extends Error {
+}
+export interface HomedataResponse {
+    [key: string]: unknown;
+}
+export declare class HomedataClient {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly timeoutMs;
+    private readonly userAgent;
+    constructor(opts: {
+        apiKey: string;
+        baseUrl?: string;
+        timeoutMs?: number;
+        version?: string;
+    });
+    static fromEnv(version?: string): HomedataClient;
+    get(path: string, params?: Record<string, string | number | undefined>): Promise<HomedataResponse>;
+    post(path: string, body: unknown): Promise<HomedataResponse>;
+    private _request;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,qBAAa,aAAc,SAAQ,KAAK;CAAG;AAE3C,MAAM,WAAW,gBAAgB;IAE/B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE;IAY5F,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,cAAc;IAM1C,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAYlG,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,gBAAgB,CAAC;YAIpD,QAAQ;CAyCvB"}

package/dist/client.js

@@ -0,0 +1,87 @@
+/**
+ * Thin HTTP client for the Homedata API (Loki).
+ * Mirrors the Python implementation 1:1 so both packages have identical behaviour.
+ */
+const DEFAULT_BASE_URL = "https://api.homedata.co.uk";
+const DEFAULT_TIMEOUT_MS = 10_000;
+export class HomedataError extends Error {
+}
+export class HomedataClient {
+    apiKey;
+    baseUrl;
+    timeoutMs;
+    userAgent;
+    constructor(opts) {
+        if (!opts.apiKey) {
+            throw new HomedataError("HOMEDATA_API_KEY is required. Get a key at https://homedata.co.uk/developer");
+        }
+        this.apiKey = opts.apiKey;
+        this.baseUrl = (opts.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+        this.timeoutMs = opts.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+        this.userAgent = `homedata-mcp-node/${opts.version ?? "0.1.0"}`;
+    }
+    static fromEnv(version) {
+        const apiKey = (process.env.HOMEDATA_API_KEY ?? "").trim();
+        const baseUrl = (process.env.HOMEDATA_BASE_URL ?? "").trim() || undefined;
+        return new HomedataClient({ apiKey, baseUrl, version });
+    }
+    async get(path, params) {
+        const url = new URL(this.baseUrl + path);
+        if (params) {
+            for (const [k, v] of Object.entries(params)) {
+                if (v !== undefined && v !== null) {
+                    url.searchParams.set(k, String(v));
+                }
+            }
+        }
+        return this._request("GET", url.toString());
+    }
+    async post(path, body) {
+        return this._request("POST", this.baseUrl + path, body);
+    }
+    async _request(method, url, body) {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+        try {
+            const resp = await fetch(url, {
+                method,
+                headers: {
+                    Authorization: `Api-Key ${this.apiKey}`,
+                    Accept: "application/json",
+                    "User-Agent": this.userAgent,
+                    ...(body ? { "Content-Type": "application/json" } : {}),
+                },
+                body: body ? JSON.stringify(body) : undefined,
+                signal: controller.signal,
+            });
+            let parsed;
+            try {
+                parsed = await resp.json();
+            }
+            catch {
+                parsed = await resp.text().catch(() => "");
+            }
+            if (!resp.ok) {
+                return { error: "api_error", status_code: resp.status, detail: parsed };
+            }
+            if (typeof parsed === "object" && parsed !== null && !Array.isArray(parsed)) {
+                return parsed;
+            }
+            return { data: parsed };
+        }
+        catch (err) {
+            if (err.name === "AbortError") {
+                return {
+                    error: "timeout",
+                    status_code: 504,
+                    detail: `Homedata API did not respond within ${this.timeoutMs}ms`,
+                };
+            }
+            return { error: "network_error", status_code: 0, detail: String(err) };
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Public API of the package — re-exports the client and tool functions
+ * so users can `import { HomedataClient, lookup_property } from "homedata-mcp"`
+ * if they want to integrate the data layer directly into their own code.
+ */
+export { HomedataClient, HomedataError } from "./client.js";
+export type { HomedataResponse } from "./client.js";
+export * as tools from "./tools.js";
+export declare const VERSION = "0.1.0";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5D,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC;AAEpC,eAAO,MAAM,OAAO,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+/**
+ * Public API of the package — re-exports the client and tool functions
+ * so users can `import { HomedataClient, lookup_property } from "homedata-mcp"`
+ * if they want to integrate the data layer directly into their own code.
+ */
+export { HomedataClient, HomedataError } from "./client.js";
+export * as tools from "./tools.js";
+export const VERSION = "0.1.0";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5D,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC;AAEpC,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+/**
+ * MCP server entry point.
+ *
+ * Wires the Homedata tools into the official @modelcontextprotocol/sdk
+ * server, communicates over stdio with the host AI client (Claude Desktop,
+ * Cursor, Codex, Cline, Continue.dev, Windsurf, Zed, etc.).
+ *
+ * Auth: reads HOMEDATA_API_KEY from the environment. The MCP runs locally
+ * on the user's machine — their property-data queries never go through
+ * the AI vendor.
+ */
+export {};
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";AACA;;;;;;;;;;GAUG"}

package/dist/server.js

@@ -0,0 +1,143 @@
+#!/usr/bin/env node
+/**
+ * MCP server entry point.
+ *
+ * Wires the Homedata tools into the official @modelcontextprotocol/sdk
+ * server, communicates over stdio with the host AI client (Claude Desktop,
+ * Cursor, Codex, Cline, Continue.dev, Windsurf, Zed, etc.).
+ *
+ * Auth: reads HOMEDATA_API_KEY from the environment. The MCP runs locally
+ * on the user's machine — their property-data queries never go through
+ * the AI vendor.
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { z } from "zod";
+import { HomedataClient, HomedataError } from "./client.js";
+import * as t from "./tools.js";
+import { VERSION } from "./index.js";
+const uprnSchema = z.object({ uprn: z.string().describe("UPRN (Unique Property Reference Number)") });
+const postcodeSchema = z.object({ postcode: z.string().describe("UK postcode, e.g. 'SW1A 2AA'") });
+const uprnRadiusSchema = z.object({
+    uprn: z.string(),
+    radius_m: z.number().int().min(100).max(10_000).optional(),
+});
+const comparablesSchema = z.object({
+    uprn: z.string(),
+    count: z.number().int().min(1).max(200).default(20),
+});
+const crimeSchema = z.object({
+    postcode: z.string(),
+    date: z.string().optional().describe("Optional YYYY-MM month filter."),
+});
+const searchSchema = z.object({
+    query: z.string().describe("Address fragment, e.g. '10 downing street'"),
+    postcode: z.string().optional(),
+});
+const batchSchema = z.object({
+    uprns: z.array(z.string()).min(1).max(50),
+});
+const TOOL_DEFS = [
+    { name: "lookup_property", description: "Look up a UK property by UPRN. Returns property type, EPC summary, last sold price, and core attributes.", schema: uprnSchema },
+    { name: "lookup_epc", description: "Get the Energy Performance Certificate for a UPRN — current and potential ratings, floor area, fuel type.", schema: uprnSchema },
+    { name: "lookup_flood_risk", description: "Get flood risk assessment for a UPRN.", schema: uprnSchema },
+    { name: "get_property_sales", description: "Historical sales for a UPRN (HM Land Registry).", schema: uprnSchema },
+    { name: "search_property_listings", description: "Past and current listings (sales and rentals) for a UPRN.", schema: uprnSchema },
+    { name: "get_comparables", description: "The N nearest comparable properties to a UPRN by geographic proximity.", schema: comparablesSchema },
+    { name: "get_planning_applications", description: "Planning applications near a UPRN.", schema: uprnSchema },
+    { name: "get_schools", description: "Schools near a UPRN within the given radius.", schema: uprnRadiusSchema },
+    { name: "get_transport", description: "Transport (rail, tube, bus) near a UPRN.", schema: uprnRadiusSchema },
+    { name: "get_crime", description: "Recorded crime in the area of the given postcode.", schema: crimeSchema },
+    { name: "get_demographics", description: "ONS Census 2021 demographic profile for the given postcode.", schema: postcodeSchema },
+    { name: "get_broadband", description: "Ofcom broadband availability for the given postcode.", schema: postcodeSchema },
+    { name: "get_postcode_profile", description: "Aggregated profile for a postcode — demographics, broadband, schools, transport, crime.", schema: postcodeSchema },
+    { name: "search_address", description: "Search for an address by free text.", schema: searchSchema },
+    { name: "batch_property_lookup", description: "Look up multiple UPRNs in one request (max 50).", schema: batchSchema },
+    { name: "lookup_council_tax", description: "Council tax band for a UPRN (in development — currently returns a 503 stub).", schema: uprnSchema },
+];
+async function main() {
+    let client;
+    try {
+        client = HomedataClient.fromEnv(VERSION);
+    }
+    catch (err) {
+        if (err instanceof HomedataError) {
+            console.error(err.message);
+            process.exit(1);
+        }
+        throw err;
+    }
+    const server = new Server({ name: "homedata", version: VERSION }, { capabilities: { tools: {} } });
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: TOOL_DEFS.map((t) => ({
+            name: t.name,
+            description: t.description,
+            inputSchema: zodToJsonSchema(t.schema),
+        })),
+    }));
+    server.setRequestHandler(CallToolRequestSchema, async (req) => {
+        const args = req.params.arguments ?? {};
+        const result = await dispatch(req.params.name, args, client);
+        return {
+            content: [{ type: "text", text: JSON.stringify(result) }],
+        };
+    });
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+async function dispatch(name, args, c) {
+    switch (name) {
+        case "lookup_property": return t.lookup_property(c, String(args.uprn));
+        case "lookup_epc": return t.lookup_epc(c, String(args.uprn));
+        case "lookup_flood_risk": return t.lookup_flood_risk(c, String(args.uprn));
+        case "get_property_sales": return t.get_property_sales(c, String(args.uprn));
+        case "search_property_listings": return t.search_property_listings(c, String(args.uprn));
+        case "get_comparables": return t.get_comparables(c, String(args.uprn), Number(args.count ?? 20));
+        case "get_planning_applications": return t.get_planning_applications(c, String(args.uprn));
+        case "get_schools": return t.get_schools(c, String(args.uprn), Number(args.radius_m ?? 1000));
+        case "get_transport": return t.get_transport(c, String(args.uprn), Number(args.radius_m ?? 800));
+        case "get_crime": return t.get_crime(c, String(args.postcode), args.date ? String(args.date) : undefined);
+        case "get_demographics": return t.get_demographics(c, String(args.postcode));
+        case "get_broadband": return t.get_broadband(c, String(args.postcode));
+        case "get_postcode_profile": return t.get_postcode_profile(c, String(args.postcode));
+        case "search_address": return t.search_address(c, String(args.query), args.postcode ? String(args.postcode) : undefined);
+        case "batch_property_lookup": return t.batch_property_lookup(c, args.uprns ?? []);
+        case "lookup_council_tax": return t.lookup_council_tax(c, String(args.uprn));
+        default: return { error: "unknown_tool", detail: name };
+    }
+}
+// Minimal Zod → JSON Schema converter — sufficient for our flat objects.
+// We could pull in zod-to-json-schema if our shapes get more complex.
+function zodToJsonSchema(s) {
+    if (s instanceof z.ZodObject) {
+        const properties = {};
+        const required = [];
+        for (const [key, value] of Object.entries(s.shape)) {
+            properties[key] = zodLeaf(value);
+            if (!(value instanceof z.ZodOptional) && !(value instanceof z.ZodDefault)) {
+                required.push(key);
+            }
+        }
+        return { type: "object", properties, ...(required.length ? { required } : {}) };
+    }
+    return zodLeaf(s);
+}
+function zodLeaf(s) {
+    const desc = s.description;
+    const meta = desc ? { description: desc } : {};
+    if (s instanceof z.ZodOptional || s instanceof z.ZodDefault)
+        return zodLeaf(s._def.innerType);
+    if (s instanceof z.ZodString)
+        return { type: "string", ...meta };
+    if (s instanceof z.ZodNumber)
+        return { type: "number", ...meta };
+    if (s instanceof z.ZodArray)
+        return { type: "array", items: zodLeaf(s.element), ...meta };
+    return meta;
+}
+main().catch((err) => {
+    console.error("[homedata-mcp] fatal:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/tools.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Tool implementations shared by the MCP server and the CLI.
+ * Each function takes a HomedataClient and the relevant inputs, returns a
+ * structured response. No MCP-specific dependencies — both surfaces import these.
+ */
+import type { HomedataClient, HomedataResponse } from "./client.js";
+export declare const lookup_property: (c: HomedataClient, uprn: string) => Promise<HomedataResponse>;
+export declare const lookup_epc: (c: HomedataClient, uprn: string) => Promise<HomedataResponse>;
+export declare const lookup_flood_risk: (c: HomedataClient, uprn: string) => Promise<HomedataResponse>;
+export declare const get_property_sales: (c: HomedataClient, uprn: string) => Promise<HomedataResponse>;
+export declare const search_property_listings: (c: HomedataClient, uprn: string) => Promise<HomedataResponse>;
+export declare const get_comparables: (c: HomedataClient, uprn: string, count?: number) => Promise<HomedataResponse>;
+export declare const get_planning_applications: (c: HomedataClient, uprn: string) => Promise<HomedataResponse>;
+export declare const get_schools: (c: HomedataClient, uprn: string, radius_m?: number) => Promise<HomedataResponse>;
+export declare const get_transport: (c: HomedataClient, uprn: string, radius_m?: number) => Promise<HomedataResponse>;
+export declare const get_crime: (c: HomedataClient, postcode: string, date?: string) => Promise<HomedataResponse>;
+export declare const get_demographics: (c: HomedataClient, postcode: string) => Promise<HomedataResponse>;
+export declare const get_broadband: (c: HomedataClient, postcode: string) => Promise<HomedataResponse>;
+export declare const get_postcode_profile: (c: HomedataClient, postcode: string) => Promise<HomedataResponse>;
+export declare const search_address: (c: HomedataClient, query: string, postcode?: string) => Promise<HomedataResponse>;
+export declare const batch_property_lookup: (c: HomedataClient, uprns: string[]) => Promise<HomedataResponse>;
+export declare const lookup_council_tax: (_c: HomedataClient, _uprn: string) => Promise<HomedataResponse>;
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpE,eAAO,MAAM,eAAe,GAAI,GAAG,cAAc,EAAE,MAAM,MAAM,8BACR,CAAC;AAExD,eAAO,MAAM,UAAU,GAAI,GAAG,cAAc,EAAE,MAAM,MAAM,8BACF,CAAC;AAEzD,eAAO,MAAM,iBAAiB,GAAI,GAAG,cAAc,EAAE,MAAM,MAAM,8BAC5B,CAAC;AAEtC,eAAO,MAAM,kBAAkB,GAAI,GAAG,cAAc,EAAE,MAAM,MAAM,8BACzB,CAAC;AAE1C,eAAO,MAAM,wBAAwB,GAAI,GAAG,cAAc,EAAE,MAAM,MAAM,8BAC5B,CAAC;AAE7C,eAAO,MAAM,eAAe,GAAI,GAAG,cAAc,EAAE,MAAM,MAAM,EAAE,cAAU,8BACR,CAAC;AAEpE,eAAO,MAAM,yBAAyB,GAAI,GAAG,cAAc,EAAE,MAAM,MAAM,8BAC/B,CAAC;AAE3C,eAAO,MAAM,WAAW,GAAI,GAAG,cAAc,EAAE,MAAM,MAAM,EAAE,iBAAe,8BAChC,CAAC;AAE7C,eAAO,MAAM,aAAa,GAAI,GAAG,cAAc,EAAE,MAAM,MAAM,EAAE,iBAAc,8BAC/B,CAAC;AAE/C,eAAO,MAAM,SAAS,GAAI,GAAG,cAAc,EAAE,UAAU,MAAM,EAAE,OAAO,MAAM,8BAClC,CAAC;AAE3C,eAAO,MAAM,gBAAgB,GAAI,GAAG,cAAc,EAAE,UAAU,MAAM,8BACzB,CAAC;AAE5C,eAAO,MAAM,aAAa,GAAI,GAAG,cAAc,EAAE,UAAU,MAAM,8BACzB,CAAC;AAEzC,eAAO,MAAM,oBAAoB,GAAI,GAAG,cAAc,EAAE,UAAU,MAAM,8BACzB,CAAC;AAEhD,eAAO,MAAM,cAAc,GAAI,GAAG,cAAc,EAAE,OAAO,MAAM,EAAE,WAAW,MAAM,8BAC7B,CAAC;AAEtD,eAAO,MAAM,qBAAqB,GAAI,GAAG,cAAc,EAAE,OAAO,MAAM,EAAE,8BAC7B,CAAC;AAE5C,eAAO,MAAM,kBAAkB,GAAI,IAAI,cAAc,EAAE,OAAO,MAAM,KAAG,OAAO,CAAC,gBAAgB,CAO3F,CAAC"}

package/dist/tools.js

@@ -0,0 +1,29 @@
+/**
+ * Tool implementations shared by the MCP server and the CLI.
+ * Each function takes a HomedataClient and the relevant inputs, returns a
+ * structured response. No MCP-specific dependencies — both surfaces import these.
+ */
+export const lookup_property = (c, uprn) => c.get(`/api/properties/${encodeURIComponent(uprn)}/`);
+export const lookup_epc = (c, uprn) => c.get(`/api/epc-checker/${encodeURIComponent(uprn)}/`);
+export const lookup_flood_risk = (c, uprn) => c.get(`/api/flood-risk/`, { uprn });
+export const get_property_sales = (c, uprn) => c.get(`/api/property_sales/`, { uprn });
+export const search_property_listings = (c, uprn) => c.get(`/api/property_listings/`, { uprn });
+export const get_comparables = (c, uprn, count = 20) => c.get(`/api/comparables/${encodeURIComponent(uprn)}/`, { count });
+export const get_planning_applications = (c, uprn) => c.get(`/api/planning/search/`, { uprn });
+export const get_schools = (c, uprn, radius_m = 1000) => c.get(`/api/schools/`, { uprn, radius_m });
+export const get_transport = (c, uprn, radius_m = 800) => c.get(`/api/transport/`, { uprn, radius_m });
+export const get_crime = (c, postcode, date) => c.get(`/api/crime/`, { postcode, date });
+export const get_demographics = (c, postcode) => c.get(`/api/demographics/`, { postcode });
+export const get_broadband = (c, postcode) => c.get(`/api/broadband/`, { postcode });
+export const get_postcode_profile = (c, postcode) => c.get(`/api/postcode-profile/`, { postcode });
+export const search_address = (c, query, postcode) => c.get(`/api/address/find/`, { q: query, postcode });
+export const batch_property_lookup = (c, uprns) => c.post(`/api/property/batch/`, { uprns });
+export const lookup_council_tax = (_c, _uprn) => 
+// Short-circuit — endpoint is documented "coming soon" and 404s today.
+// Matches the Python 0.1.1 fix; keeps behaviour aligned across SDKs.
+Promise.resolve({
+    error: "in_development",
+    status_code: 503,
+    detail: "Council tax band is in development. See https://homedata.co.uk/changelog",
+});
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "homedata-mcp",
+  "version": "0.1.0",
+  "description": "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.",
+  "type": "module",
+  "bin": {
+    "homedata-mcp": "dist/server.js",
+    "homedata": "dist/cli.js"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepare": "npm run build",
+    "test": "node --test dist/test/*.js"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "homedata",
+    "uk-property",
+    "property-data",
+    "claude",
+    "cursor",
+    "codex",
+    "windsurf",
+    "epc",
+    "flood-risk",
+    "planning",
+    "uprn"
+  ],
+  "homepage": "https://homedata.co.uk/mcp",
+  "bugs": {
+    "url": "https://github.com/wehomemove/homedata-mcp-node/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/wehomemove/homedata-mcp-node.git"
+  },
+  "license": "MIT",
+  "author": "Homedata <hello@homedata.co.uk> (https://homedata.co.uk)",
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.5.0"
+  }
+}