urbitools-mcp 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,35 @@
-# Temporary Holding Version
+# urbitools-mcp
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Free MCP server for UK employment calculators from [urbitools.com](https://urbitools.com), using 2026/27 statutory rates. It lets any MCP-compatible assistant run the calculations directly.
+
+## Tools
+
+| Tool | What it does |
+|---|---|
+| `calculate_redundancy_pay` | Statutory redundancy pay: age bands, 20-year cap, 2-year eligibility, £751 (GB) / £783 (NI) weekly cap, optional enhanced multiplier |
+| `calculate_paternity_pay` | Paternity leave and pay eligibility, weekly rate (£194.32 or 90% of earnings), total and claim deadline |
+| `calculate_notice_pay` | PILON: higher of statutory and contractual notice, uncapped weekly pay, net estimate |
+
+Results are estimates, not legal, tax or financial advice. Calculations run locally and nothing you enter is sent anywhere.
+
+## Use with Claude Desktop / Claude Code
+
+```json
+{
+  "mcpServers": {
+    "urbitools": { "command": "npx", "args": ["-y", "urbitools-mcp"] }
+  }
+}
+```
+
+Claude Code: `claude mcp add urbitools -- npx -y urbitools-mcp`
+
+## Develop
+
+```bash
+npm install
+npm test          # builds and runs the smoke test over stdio
+node dist/http.js # optional: stateless Streamable HTTP on :3000/mcp (PORT to change)
+```
+
+The calculation code is shared with the website (`../lib/calc-*.ts`) and bundled at build time.

package/dist/http.js

@@ -0,0 +1,315 @@
+// src/http.ts
+import { createServer as createHttp } from "node:http";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+
+// src/server.ts
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+
+// ../lib/calc-redundancy.ts
+var REDUNDANCY_CAPS = { gb: 751, ni: 783 };
+function parseLocalDate(s) {
+  const [y, m, d] = s.split("-").map(Number);
+  return new Date(y, m - 1, d);
+}
+function fullYears(from, to) {
+  let y = to.getFullYear() - from.getFullYear();
+  const m = to.getMonth() - from.getMonth();
+  if (m < 0 || m === 0 && to.getDate() < from.getDate()) y--;
+  return y;
+}
+function addYears(d, n) {
+  const x = new Date(d);
+  x.setFullYear(x.getFullYear() + n);
+  return x;
+}
+function formatGBDate(d) {
+  return d.toLocaleDateString("en-GB", { day: "numeric", month: "short", year: "numeric" });
+}
+function calculateRedundancy(input) {
+  const { dob, start, end, weeklyPay, jurisdiction, multiplier } = input;
+  if (!dob || !start) return { ok: false, error: "Please enter your date of birth and employment start date." };
+  if (!isFinite(weeklyPay) || weeklyPay <= 0) return { ok: false, error: "Please enter your gross weekly pay." };
+  const dobD = parseLocalDate(dob);
+  const startD = parseLocalDate(start);
+  const endD = end ? parseLocalDate(end) : /* @__PURE__ */ new Date();
+  endD.setHours(0, 0, 0, 0);
+  if (endD < startD) return { ok: false, error: "Employment end date can't be before the start date." };
+  if (dobD >= endD) return { ok: false, error: "Date of birth must be before the employment end date." };
+  const cap = REDUNDANCY_CAPS[jurisdiction];
+  const cappedPay = Math.min(weeklyPay, cap);
+  const serviceYears = Math.min(fullYears(startD, endD), 20);
+  if (serviceYears < 2) {
+    return {
+      ok: true,
+      eligible: false,
+      serviceYears: fullYears(startD, endD),
+      countedYears: 0,
+      cap,
+      cappedPay,
+      rows: [],
+      total: 0,
+      enhanced: 0,
+      multiplier,
+      capped: weeklyPay > cap
+    };
+  }
+  const rows = [];
+  let total = 0;
+  let counted = 0;
+  for (let i = 0; i < serviceYears; i++) {
+    const yearEnd = addYears(endD, -i);
+    const age = fullYears(dobD, yearEnd);
+    if (age < 18) continue;
+    counted++;
+    let weeks;
+    let band;
+    if (age >= 41) {
+      weeks = 1.5;
+      band = "41+ \xB7 1.5 weeks";
+    } else if (age >= 22) {
+      weeks = 1;
+      band = "22\u201340 \xB7 1 week";
+    } else {
+      weeks = 0.5;
+      band = "18\u201321 \xB7 0.5 weeks";
+    }
+    const amount = weeks * cappedPay;
+    total += amount;
+    rows.push({
+      year: i + 1,
+      fromLabel: formatGBDate(addYears(yearEnd, -1)),
+      toLabel: formatGBDate(yearEnd),
+      age,
+      band,
+      weeks,
+      amount
+    });
+  }
+  return {
+    ok: true,
+    eligible: true,
+    serviceYears,
+    countedYears: counted,
+    cap,
+    cappedPay,
+    rows,
+    total,
+    enhanced: total * Math.max(1, multiplier || 1),
+    multiplier: Math.max(1, multiplier || 1),
+    capped: weeklyPay > cap
+  };
+}
+
+// ../lib/calc-paternity.ts
+var SPP_RATE = 194.32;
+var SPP_LEL = 129;
+var DAY_ONE_LEAVE = "2026-04-06";
+function parseLocalDate2(s) {
+  const [y, m, d] = s.split("-").map(Number);
+  return new Date(y, m - 1, d);
+}
+function addDays(d, n) {
+  const x = new Date(d);
+  x.setDate(x.getDate() + n);
+  return x;
+}
+function weekStart(x) {
+  const y = new Date(x);
+  y.setDate(y.getDate() - y.getDay());
+  y.setHours(0, 0, 0, 0);
+  return y;
+}
+function formatGBDate2(d) {
+  return d.toLocaleDateString("en-GB", { day: "numeric", month: "short", year: "numeric" });
+}
+function calculatePaternity(input) {
+  const { due, start, averageWeeklyEarnings, leaveWeeks } = input;
+  if (!due || !start) return { ok: false, error: "Please enter the due date and your employment start date." };
+  if (!isFinite(averageWeeklyEarnings) || averageWeeklyEarnings < 0)
+    return { ok: false, error: "Please enter your average weekly earnings." };
+  const dueD = parseLocalDate2(due);
+  const startD = parseLocalDate2(start);
+  if (startD > dueD) return { ok: false, error: "Employment start date can't be after the due date." };
+  const ewc = weekStart(dueD);
+  const qualWeekStart = addDays(ewc, -15 * 7);
+  const qualWeekEnd = addDays(qualWeekStart, 6);
+  const serviceCutoff = addDays(qualWeekEnd, -26 * 7 + 1);
+  const serviceOK = startD <= serviceCutoff;
+  const earnOK = averageWeeklyEarnings >= SPP_LEL;
+  const payOK = serviceOK && earnOK;
+  const dayOneApplies = dueD >= parseLocalDate2(DAY_ONE_LEAVE);
+  const leaveOK = dayOneApplies ? true : serviceOK;
+  const weeklyRate = Math.min(SPP_RATE, averageWeeklyEarnings * 0.9);
+  const total = payOK ? weeklyRate * leaveWeeks : 0;
+  return {
+    ok: true,
+    leaveEligible: leaveOK,
+    payEligible: payOK,
+    weeklyRate,
+    total,
+    qualifyingWeekStart: formatGBDate2(qualWeekStart),
+    qualifyingWeekEnd: formatGBDate2(qualWeekEnd),
+    claimDeadline: formatGBDate2(addDays(dueD, -15 * 7)),
+    belowCap: averageWeeklyEarnings * 0.9 < SPP_RATE,
+    dayOneApplies
+  };
+}
+
+// ../lib/calc-notice.ts
+function calculateNotice(input) {
+  const { annualSalary, yearsService, contractualWeeks, workedWeeks, taxRate } = input;
+  if (!isFinite(annualSalary) || annualSalary <= 0)
+    return { ok: false, error: "Please enter your gross annual salary." };
+  if (!isFinite(yearsService) || yearsService < 0)
+    return { ok: false, error: "Please enter your complete years of service." };
+  if (!isFinite(workedWeeks) || workedWeeks < 0)
+    return { ok: false, error: "Weeks already worked can't be negative." };
+  if (contractualWeeks != null && (!isFinite(contractualWeeks) || contractualWeeks < 0))
+    return { ok: false, error: "Contractual notice weeks can't be negative." };
+  const noStatutoryMinimum = yearsService < 1;
+  const statutoryWeeks = noStatutoryMinimum ? 0 : Math.min(12, Math.max(1, Math.floor(yearsService)));
+  const applicableWeeks = Math.max(statutoryWeeks, contractualWeeks ?? 0);
+  const unworkedWeeks = Math.max(0, applicableWeeks - workedWeeks);
+  const weeklyPay = annualSalary / 52;
+  const gross = weeklyPay * unworkedWeeks;
+  const tax = gross * taxRate;
+  const net = gross - tax;
+  return {
+    ok: true,
+    statutoryWeeks,
+    contractualWeeks,
+    applicableWeeks,
+    workedWeeks,
+    unworkedWeeks,
+    weeklyPay,
+    gross,
+    tax,
+    net,
+    taxRate,
+    noStatutoryMinimum
+  };
+}
+
+// src/server.ts
+var SITE = "https://urbitools.com";
+var DISCLAIMER = "Estimate only, not legal, tax or financial advice. Rates are for the 2026/27 tax year.";
+var date = z.string().regex(/^\d{4}-\d{2}-\d{2}$/, "Use YYYY-MM-DD");
+function reply(result, page, summary) {
+  if (!result.ok) {
+    return { isError: true, content: [{ type: "text", text: result.error ?? "Calculation failed." }] };
+  }
+  const text = `${summary(result)}
+
+Full working and an interactive version: ${SITE}${page}
+${DISCLAIMER}`;
+  return {
+    content: [{ type: "text", text }],
+    structuredContent: { ...result, source: `${SITE}${page}`, disclaimer: DISCLAIMER }
+  };
+}
+var gbp = (n) => "\xA3" + n.toLocaleString("en-GB", { minimumFractionDigits: 2, maximumFractionDigits: 2 });
+function createServer() {
+  const server = new McpServer({ name: "urbitools", version: "0.1.0" });
+  server.registerTool(
+    "calculate_redundancy_pay",
+    {
+      title: "UK statutory redundancy pay",
+      description: "Calculate UK statutory redundancy pay (2026/27): age-band formula (0.5/1/1.5 weeks' pay per year), 20-year cap, 2-year eligibility, weekly pay cap of \xA3751 (GB) or \xA3783 (NI), with a year-by-year breakdown and optional enhanced-scheme multiplier. Source: urbitools.com.",
+      inputSchema: {
+        date_of_birth: date.describe("Employee date of birth, YYYY-MM-DD"),
+        employment_start: date.describe("Employment start date, YYYY-MM-DD"),
+        employment_end: date.optional().describe("Last day of employment, YYYY-MM-DD. Defaults to today."),
+        weekly_pay: z.number().positive().describe("Gross weekly pay in GBP (before tax)"),
+        jurisdiction: z.enum(["gb", "ni"]).default("gb").describe("gb = Great Britain, ni = Northern Ireland"),
+        enhanced_multiplier: z.number().min(1).default(1).describe("1 = statutory minimum; e.g. 2 for a scheme paying double")
+      },
+      annotations: { readOnlyHint: true, openWorldHint: false }
+    },
+    async (a) => reply(
+      calculateRedundancy({
+        dob: a.date_of_birth,
+        start: a.employment_start,
+        end: a.employment_end ?? null,
+        weeklyPay: a.weekly_pay,
+        jurisdiction: a.jurisdiction,
+        multiplier: a.enhanced_multiplier
+      }),
+      "/redundancy-pay-calculator",
+      (r) => r.eligible ? `Statutory redundancy pay: ${gbp(r.total)} (${r.countedYears} counted years, weekly pay used ${gbp(r.cappedPay)}${r.capped ? `, capped at ${gbp(r.cap)}` : ""}).` + (r.multiplier !== 1 ? ` With a ${r.multiplier}x enhanced scheme: ${gbp(r.enhanced)}.` : "") + ` Statutory redundancy pay is normally tax-free within the \xA330,000 termination-payments allowance.` : "Not eligible for statutory redundancy pay: it needs at least 2 years' continuous service."
+    )
+  );
+  server.registerTool(
+    "calculate_paternity_pay",
+    {
+      title: "UK statutory paternity pay",
+      description: "Check UK paternity leave and pay eligibility and calculate statutory paternity pay (2026/27): \xA3194.32/week or 90% of average weekly earnings if lower, \xA3129/week lower earnings limit, 26 weeks' service by the 15th week before the due date. Source: urbitools.com.",
+      inputSchema: {
+        due_date: date.describe("Baby's due date, YYYY-MM-DD"),
+        employment_start: date.describe("Employment start date, YYYY-MM-DD"),
+        average_weekly_earnings: z.number().min(0).describe("Average gross weekly earnings in GBP"),
+        leave_weeks: z.union([z.literal(1), z.literal(2)]).default(2).describe("Weeks of paternity leave: 1 or 2")
+      },
+      annotations: { readOnlyHint: true, openWorldHint: false }
+    },
+    async (a) => reply(
+      calculatePaternity({
+        due: a.due_date,
+        start: a.employment_start,
+        averageWeeklyEarnings: a.average_weekly_earnings,
+        leaveWeeks: a.leave_weeks
+      }),
+      "/paternity-pay-calculator",
+      (r) => `Paternity leave eligible: ${r.leaveEligible ? "yes" : "no"}. Paternity pay eligible: ${r.payEligible ? "yes" : "no"}.` + (r.payEligible ? ` Weekly rate ${gbp(r.weeklyRate)}${r.belowCap ? " (90% of earnings, below the flat rate)" : ""}, total ${gbp(r.total)}. Claim deadline ${r.claimDeadline}.` : "")
+    )
+  );
+  server.registerTool(
+    "calculate_notice_pay",
+    {
+      title: "UK notice pay / PILON",
+      description: "Estimate UK payment in lieu of notice (PILON): uses the higher of statutory notice (1 week per complete year, max 12) and contractual notice, uncapped weekly pay (salary / 52), with a net estimate. PILON is fully taxable as earnings; the \xA330,000 allowance does not apply. Source: urbitools.com.",
+      inputSchema: {
+        annual_salary: z.number().positive().describe("Gross annual salary in GBP"),
+        years_service: z.number().min(0).describe("Complete years of service"),
+        contractual_notice_weeks: z.number().min(0).optional().describe("Contractual notice in weeks, if any"),
+        weeks_already_worked: z.number().min(0).default(0).describe("Notice weeks already worked"),
+        marginal_tax_rate: z.union([z.literal(0.2), z.literal(0.4), z.literal(0.45)]).default(0.2).describe("Marginal income tax rate for the net estimate")
+      },
+      annotations: { readOnlyHint: true, openWorldHint: false }
+    },
+    async (a) => reply(
+      calculateNotice({
+        annualSalary: a.annual_salary,
+        yearsService: a.years_service,
+        contractualWeeks: a.contractual_notice_weeks ?? null,
+        workedWeeks: a.weeks_already_worked,
+        taxRate: a.marginal_tax_rate
+      }),
+      "/notice-pay-calculator",
+      (r) => `Notice period applying: ${r.applicableWeeks} weeks (statutory ${r.statutoryWeeks}${r.contractualWeeks != null ? `, contractual ${r.contractualWeeks}` : ""}). Unworked: ${r.unworkedWeeks} weeks at ${gbp(r.weeklyPay)}/week. PILON gross ${gbp(r.gross)}, estimated tax ${gbp(r.tax)}, net ${gbp(r.net)}.` + (r.noStatutoryMinimum ? " Note: under 1 year of service may mean no statutory minimum notice." : "")
+    )
+  );
+  return server;
+}
+
+// src/http.ts
+createHttp(async (req, res) => {
+  if (req.url?.split("?")[0] !== "/mcp") {
+    res.writeHead(404).end("Not found");
+    return;
+  }
+  if (req.method !== "POST") {
+    res.writeHead(405, { Allow: "POST" }).end("Method not allowed");
+    return;
+  }
+  const chunks = [];
+  for await (const c of req) chunks.push(c);
+  const transport = new StreamableHTTPServerTransport({ sessionIdGenerator: void 0 });
+  const server = createServer();
+  res.on("close", () => {
+    transport.close();
+    server.close();
+  });
+  await server.connect(transport);
+  await transport.handleRequest(req, res, JSON.parse(Buffer.concat(chunks).toString() || "{}"));
+}).listen(Number(process.env.PORT ?? 3e3));

package/dist/stdio.js

@@ -0,0 +1,297 @@
+#!/usr/bin/env node
+
+// src/stdio.ts
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+
+// src/server.ts
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+
+// ../lib/calc-redundancy.ts
+var REDUNDANCY_CAPS = { gb: 751, ni: 783 };
+function parseLocalDate(s) {
+  const [y, m, d] = s.split("-").map(Number);
+  return new Date(y, m - 1, d);
+}
+function fullYears(from, to) {
+  let y = to.getFullYear() - from.getFullYear();
+  const m = to.getMonth() - from.getMonth();
+  if (m < 0 || m === 0 && to.getDate() < from.getDate()) y--;
+  return y;
+}
+function addYears(d, n) {
+  const x = new Date(d);
+  x.setFullYear(x.getFullYear() + n);
+  return x;
+}
+function formatGBDate(d) {
+  return d.toLocaleDateString("en-GB", { day: "numeric", month: "short", year: "numeric" });
+}
+function calculateRedundancy(input) {
+  const { dob, start, end, weeklyPay, jurisdiction, multiplier } = input;
+  if (!dob || !start) return { ok: false, error: "Please enter your date of birth and employment start date." };
+  if (!isFinite(weeklyPay) || weeklyPay <= 0) return { ok: false, error: "Please enter your gross weekly pay." };
+  const dobD = parseLocalDate(dob);
+  const startD = parseLocalDate(start);
+  const endD = end ? parseLocalDate(end) : /* @__PURE__ */ new Date();
+  endD.setHours(0, 0, 0, 0);
+  if (endD < startD) return { ok: false, error: "Employment end date can't be before the start date." };
+  if (dobD >= endD) return { ok: false, error: "Date of birth must be before the employment end date." };
+  const cap = REDUNDANCY_CAPS[jurisdiction];
+  const cappedPay = Math.min(weeklyPay, cap);
+  const serviceYears = Math.min(fullYears(startD, endD), 20);
+  if (serviceYears < 2) {
+    return {
+      ok: true,
+      eligible: false,
+      serviceYears: fullYears(startD, endD),
+      countedYears: 0,
+      cap,
+      cappedPay,
+      rows: [],
+      total: 0,
+      enhanced: 0,
+      multiplier,
+      capped: weeklyPay > cap
+    };
+  }
+  const rows = [];
+  let total = 0;
+  let counted = 0;
+  for (let i = 0; i < serviceYears; i++) {
+    const yearEnd = addYears(endD, -i);
+    const age = fullYears(dobD, yearEnd);
+    if (age < 18) continue;
+    counted++;
+    let weeks;
+    let band;
+    if (age >= 41) {
+      weeks = 1.5;
+      band = "41+ \xB7 1.5 weeks";
+    } else if (age >= 22) {
+      weeks = 1;
+      band = "22\u201340 \xB7 1 week";
+    } else {
+      weeks = 0.5;
+      band = "18\u201321 \xB7 0.5 weeks";
+    }
+    const amount = weeks * cappedPay;
+    total += amount;
+    rows.push({
+      year: i + 1,
+      fromLabel: formatGBDate(addYears(yearEnd, -1)),
+      toLabel: formatGBDate(yearEnd),
+      age,
+      band,
+      weeks,
+      amount
+    });
+  }
+  return {
+    ok: true,
+    eligible: true,
+    serviceYears,
+    countedYears: counted,
+    cap,
+    cappedPay,
+    rows,
+    total,
+    enhanced: total * Math.max(1, multiplier || 1),
+    multiplier: Math.max(1, multiplier || 1),
+    capped: weeklyPay > cap
+  };
+}
+
+// ../lib/calc-paternity.ts
+var SPP_RATE = 194.32;
+var SPP_LEL = 129;
+var DAY_ONE_LEAVE = "2026-04-06";
+function parseLocalDate2(s) {
+  const [y, m, d] = s.split("-").map(Number);
+  return new Date(y, m - 1, d);
+}
+function addDays(d, n) {
+  const x = new Date(d);
+  x.setDate(x.getDate() + n);
+  return x;
+}
+function weekStart(x) {
+  const y = new Date(x);
+  y.setDate(y.getDate() - y.getDay());
+  y.setHours(0, 0, 0, 0);
+  return y;
+}
+function formatGBDate2(d) {
+  return d.toLocaleDateString("en-GB", { day: "numeric", month: "short", year: "numeric" });
+}
+function calculatePaternity(input) {
+  const { due, start, averageWeeklyEarnings, leaveWeeks } = input;
+  if (!due || !start) return { ok: false, error: "Please enter the due date and your employment start date." };
+  if (!isFinite(averageWeeklyEarnings) || averageWeeklyEarnings < 0)
+    return { ok: false, error: "Please enter your average weekly earnings." };
+  const dueD = parseLocalDate2(due);
+  const startD = parseLocalDate2(start);
+  if (startD > dueD) return { ok: false, error: "Employment start date can't be after the due date." };
+  const ewc = weekStart(dueD);
+  const qualWeekStart = addDays(ewc, -15 * 7);
+  const qualWeekEnd = addDays(qualWeekStart, 6);
+  const serviceCutoff = addDays(qualWeekEnd, -26 * 7 + 1);
+  const serviceOK = startD <= serviceCutoff;
+  const earnOK = averageWeeklyEarnings >= SPP_LEL;
+  const payOK = serviceOK && earnOK;
+  const dayOneApplies = dueD >= parseLocalDate2(DAY_ONE_LEAVE);
+  const leaveOK = dayOneApplies ? true : serviceOK;
+  const weeklyRate = Math.min(SPP_RATE, averageWeeklyEarnings * 0.9);
+  const total = payOK ? weeklyRate * leaveWeeks : 0;
+  return {
+    ok: true,
+    leaveEligible: leaveOK,
+    payEligible: payOK,
+    weeklyRate,
+    total,
+    qualifyingWeekStart: formatGBDate2(qualWeekStart),
+    qualifyingWeekEnd: formatGBDate2(qualWeekEnd),
+    claimDeadline: formatGBDate2(addDays(dueD, -15 * 7)),
+    belowCap: averageWeeklyEarnings * 0.9 < SPP_RATE,
+    dayOneApplies
+  };
+}
+
+// ../lib/calc-notice.ts
+function calculateNotice(input) {
+  const { annualSalary, yearsService, contractualWeeks, workedWeeks, taxRate } = input;
+  if (!isFinite(annualSalary) || annualSalary <= 0)
+    return { ok: false, error: "Please enter your gross annual salary." };
+  if (!isFinite(yearsService) || yearsService < 0)
+    return { ok: false, error: "Please enter your complete years of service." };
+  if (!isFinite(workedWeeks) || workedWeeks < 0)
+    return { ok: false, error: "Weeks already worked can't be negative." };
+  if (contractualWeeks != null && (!isFinite(contractualWeeks) || contractualWeeks < 0))
+    return { ok: false, error: "Contractual notice weeks can't be negative." };
+  const noStatutoryMinimum = yearsService < 1;
+  const statutoryWeeks = noStatutoryMinimum ? 0 : Math.min(12, Math.max(1, Math.floor(yearsService)));
+  const applicableWeeks = Math.max(statutoryWeeks, contractualWeeks ?? 0);
+  const unworkedWeeks = Math.max(0, applicableWeeks - workedWeeks);
+  const weeklyPay = annualSalary / 52;
+  const gross = weeklyPay * unworkedWeeks;
+  const tax = gross * taxRate;
+  const net = gross - tax;
+  return {
+    ok: true,
+    statutoryWeeks,
+    contractualWeeks,
+    applicableWeeks,
+    workedWeeks,
+    unworkedWeeks,
+    weeklyPay,
+    gross,
+    tax,
+    net,
+    taxRate,
+    noStatutoryMinimum
+  };
+}
+
+// src/server.ts
+var SITE = "https://urbitools.com";
+var DISCLAIMER = "Estimate only, not legal, tax or financial advice. Rates are for the 2026/27 tax year.";
+var date = z.string().regex(/^\d{4}-\d{2}-\d{2}$/, "Use YYYY-MM-DD");
+function reply(result, page, summary) {
+  if (!result.ok) {
+    return { isError: true, content: [{ type: "text", text: result.error ?? "Calculation failed." }] };
+  }
+  const text = `${summary(result)}
+
+Full working and an interactive version: ${SITE}${page}
+${DISCLAIMER}`;
+  return {
+    content: [{ type: "text", text }],
+    structuredContent: { ...result, source: `${SITE}${page}`, disclaimer: DISCLAIMER }
+  };
+}
+var gbp = (n) => "\xA3" + n.toLocaleString("en-GB", { minimumFractionDigits: 2, maximumFractionDigits: 2 });
+function createServer() {
+  const server = new McpServer({ name: "urbitools", version: "0.1.0" });
+  server.registerTool(
+    "calculate_redundancy_pay",
+    {
+      title: "UK statutory redundancy pay",
+      description: "Calculate UK statutory redundancy pay (2026/27): age-band formula (0.5/1/1.5 weeks' pay per year), 20-year cap, 2-year eligibility, weekly pay cap of \xA3751 (GB) or \xA3783 (NI), with a year-by-year breakdown and optional enhanced-scheme multiplier. Source: urbitools.com.",
+      inputSchema: {
+        date_of_birth: date.describe("Employee date of birth, YYYY-MM-DD"),
+        employment_start: date.describe("Employment start date, YYYY-MM-DD"),
+        employment_end: date.optional().describe("Last day of employment, YYYY-MM-DD. Defaults to today."),
+        weekly_pay: z.number().positive().describe("Gross weekly pay in GBP (before tax)"),
+        jurisdiction: z.enum(["gb", "ni"]).default("gb").describe("gb = Great Britain, ni = Northern Ireland"),
+        enhanced_multiplier: z.number().min(1).default(1).describe("1 = statutory minimum; e.g. 2 for a scheme paying double")
+      },
+      annotations: { readOnlyHint: true, openWorldHint: false }
+    },
+    async (a) => reply(
+      calculateRedundancy({
+        dob: a.date_of_birth,
+        start: a.employment_start,
+        end: a.employment_end ?? null,
+        weeklyPay: a.weekly_pay,
+        jurisdiction: a.jurisdiction,
+        multiplier: a.enhanced_multiplier
+      }),
+      "/redundancy-pay-calculator",
+      (r) => r.eligible ? `Statutory redundancy pay: ${gbp(r.total)} (${r.countedYears} counted years, weekly pay used ${gbp(r.cappedPay)}${r.capped ? `, capped at ${gbp(r.cap)}` : ""}).` + (r.multiplier !== 1 ? ` With a ${r.multiplier}x enhanced scheme: ${gbp(r.enhanced)}.` : "") + ` Statutory redundancy pay is normally tax-free within the \xA330,000 termination-payments allowance.` : "Not eligible for statutory redundancy pay: it needs at least 2 years' continuous service."
+    )
+  );
+  server.registerTool(
+    "calculate_paternity_pay",
+    {
+      title: "UK statutory paternity pay",
+      description: "Check UK paternity leave and pay eligibility and calculate statutory paternity pay (2026/27): \xA3194.32/week or 90% of average weekly earnings if lower, \xA3129/week lower earnings limit, 26 weeks' service by the 15th week before the due date. Source: urbitools.com.",
+      inputSchema: {
+        due_date: date.describe("Baby's due date, YYYY-MM-DD"),
+        employment_start: date.describe("Employment start date, YYYY-MM-DD"),
+        average_weekly_earnings: z.number().min(0).describe("Average gross weekly earnings in GBP"),
+        leave_weeks: z.union([z.literal(1), z.literal(2)]).default(2).describe("Weeks of paternity leave: 1 or 2")
+      },
+      annotations: { readOnlyHint: true, openWorldHint: false }
+    },
+    async (a) => reply(
+      calculatePaternity({
+        due: a.due_date,
+        start: a.employment_start,
+        averageWeeklyEarnings: a.average_weekly_earnings,
+        leaveWeeks: a.leave_weeks
+      }),
+      "/paternity-pay-calculator",
+      (r) => `Paternity leave eligible: ${r.leaveEligible ? "yes" : "no"}. Paternity pay eligible: ${r.payEligible ? "yes" : "no"}.` + (r.payEligible ? ` Weekly rate ${gbp(r.weeklyRate)}${r.belowCap ? " (90% of earnings, below the flat rate)" : ""}, total ${gbp(r.total)}. Claim deadline ${r.claimDeadline}.` : "")
+    )
+  );
+  server.registerTool(
+    "calculate_notice_pay",
+    {
+      title: "UK notice pay / PILON",
+      description: "Estimate UK payment in lieu of notice (PILON): uses the higher of statutory notice (1 week per complete year, max 12) and contractual notice, uncapped weekly pay (salary / 52), with a net estimate. PILON is fully taxable as earnings; the \xA330,000 allowance does not apply. Source: urbitools.com.",
+      inputSchema: {
+        annual_salary: z.number().positive().describe("Gross annual salary in GBP"),
+        years_service: z.number().min(0).describe("Complete years of service"),
+        contractual_notice_weeks: z.number().min(0).optional().describe("Contractual notice in weeks, if any"),
+        weeks_already_worked: z.number().min(0).default(0).describe("Notice weeks already worked"),
+        marginal_tax_rate: z.union([z.literal(0.2), z.literal(0.4), z.literal(0.45)]).default(0.2).describe("Marginal income tax rate for the net estimate")
+      },
+      annotations: { readOnlyHint: true, openWorldHint: false }
+    },
+    async (a) => reply(
+      calculateNotice({
+        annualSalary: a.annual_salary,
+        yearsService: a.years_service,
+        contractualWeeks: a.contractual_notice_weeks ?? null,
+        workedWeeks: a.weeks_already_worked,
+        taxRate: a.marginal_tax_rate
+      }),
+      "/notice-pay-calculator",
+      (r) => `Notice period applying: ${r.applicableWeeks} weeks (statutory ${r.statutoryWeeks}${r.contractualWeeks != null ? `, contractual ${r.contractualWeeks}` : ""}). Unworked: ${r.unworkedWeeks} weeks at ${gbp(r.weeklyPay)}/week. PILON gross ${gbp(r.gross)}, estimated tax ${gbp(r.tax)}, net ${gbp(r.net)}.` + (r.noStatutoryMinimum ? " Note: under 1 year of service may mean no statutory minimum notice." : "")
+    )
+  );
+  return server;
+}
+
+// src/stdio.ts
+await createServer().connect(new StdioServerTransport());

package/package.json

@@ -1,6 +1,18 @@
 {
   "name": "urbitools-mcp",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Free MCP server for UK employment calculators (statutory redundancy pay, paternity pay, notice pay/PILON) with 2026/27 rates, from urbitools.com",
+  "type": "module",
+  "bin": { "urbitools-mcp": "dist/stdio.js" },
+  "files": ["dist", "README.md"],
+  "scripts": {
+    "build": "esbuild src/stdio.ts src/http.ts --bundle --platform=node --format=esm --target=node18 --outdir=dist --packages=external && chmod +x dist/stdio.js",
+    "test": "npm run build && node test/smoke.mjs"
+  },
+  "keywords": ["mcp", "uk", "redundancy", "paternity", "notice", "pilon", "calculator"],
+  "license": "MIT",
+  "homepage": "https://urbitools.com",
+  "engines": { "node": ">=18" },
+  "dependencies": { "@modelcontextprotocol/sdk": "^1.0.0", "zod": "^3.23.0" },
+  "devDependencies": { "esbuild": "^0.25.0", "@types/node": "latest", "typescript": "latest" }
+}