@rubytech/create-realagent-code 0.1.24 → 0.1.27

package/payload/platform/plugins/loop/mcp/src/__tests__/swagger-write-coverage.test.ts

@@ -0,0 +1,153 @@
+/**
+ * Anti-regression: every Loop V2 swagger write endpoint maps to a
+ * registered MCP tool whose source file references the path's stable
+ * prefix. Catches three drift modes pre-publish:
+ *
+ *   1. Loop adds a new POST/PUT/PATCH/DELETE → no mapping → test fails
+ *      and names the orphan endpoint.
+ *   2. A tool's `server.tool("…")` registration is renamed or removed →
+ *      the name lookup against `index.ts` source fails.
+ *   3. A tool's source file is refactored such that the swagger path
+ *      family no longer appears literally → the path-fragment lookup
+ *      against the source file fails.
+ *
+ * The vendored snapshot at `loop-swagger.snapshot.json` was fetched on
+ * 2026-04-28 from `https://api.loop.software/swagger/v2/swagger.json`
+ * (32 write endpoints across 8 tags). Refresh by re-downloading and
+ * extending ENDPOINT_MAP — the test is the single source of truth for
+ * what coverage means.
+ */
+
+import { describe, expect, it } from 'vitest';
+import { readFileSync } from 'node:fs';
+import { resolve, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const PLUGIN_SRC = resolve(__dirname, '..');
+const SWAGGER = JSON.parse(
+  readFileSync(resolve(__dirname, 'loop-swagger.snapshot.json'), 'utf-8'),
+) as { paths: Record<string, Record<string, unknown>> };
+
+const WRITE_METHODS = ['post', 'put', 'patch', 'delete'] as const;
+
+interface EndpointMapping {
+  method: typeof WRITE_METHODS[number];
+  path: string;
+  tool: string;
+  source: string;
+  fragment: string;
+}
+
+// One entry per swagger write op. `fragment` is the literal substring
+// (typically the stable prefix before any `${...}` template variable)
+// that must appear in the source file — the path's family signature.
+const ENDPOINT_MAP: EndpointMapping[] = [
+  // Customer (1)
+  { method: 'post', path: '/customer/preferences/{personCode}', tool: 'loop-customer-preferences', source: 'tools/customer-preferences.ts', fragment: '/customer/preferences/' },
+  // Feedback (2)
+  { method: 'post', path: '/feedback/residential/sales/viewings/{id}/feedback', tool: 'loop-feedback-submit', source: 'tools/feedback.ts', fragment: '/feedback/residential/' },
+  { method: 'post', path: '/feedback/residential/lettings/viewings/{id}/feedback', tool: 'loop-feedback-submit', source: 'tools/feedback.ts', fragment: '/feedback/residential/' },
+  // Marketing — match-batch PUT (2)
+  { method: 'put', path: '/marketing/matching/other-matches', tool: 'loop-marketing-match-batch', source: 'tools/marketing-match-batch.ts', fragment: '/matching/other-matches' },
+  { method: 'put', path: '/marketing/rentals/matching/other-matches', tool: 'loop-marketing-match-batch', source: 'tools/marketing-match-batch.ts', fragment: '/matching/other-matches' },
+  // Marketing — match-request POST × {sales,lettings} × {viewing,information,callback} (6)
+  { method: 'post', path: '/marketing/matching/{id}/viewing', tool: 'loop-marketing-match-request', source: 'tools/marketing-match-request.ts', fragment: '/matching/' },
+  { method: 'post', path: '/marketing/rentals/matching/{id}/viewing', tool: 'loop-marketing-match-request', source: 'tools/marketing-match-request.ts', fragment: '/marketing/rentals' },
+  { method: 'post', path: '/marketing/matching/{id}/information', tool: 'loop-marketing-match-request', source: 'tools/marketing-match-request.ts', fragment: '/matching/' },
+  { method: 'post', path: '/marketing/rentals/matching/{id}/information', tool: 'loop-marketing-match-request', source: 'tools/marketing-match-request.ts', fragment: '/marketing/rentals' },
+  { method: 'post', path: '/marketing/matching/{id}/callback', tool: 'loop-marketing-match-request', source: 'tools/marketing-match-request.ts', fragment: '/matching/' },
+  { method: 'post', path: '/marketing/rentals/matching/{id}/callback', tool: 'loop-marketing-match-request', source: 'tools/marketing-match-request.ts', fragment: '/marketing/rentals' },
+  // Marketing — enquiries (4)
+  { method: 'post', path: '/marketing/enquiries/seller', tool: 'loop-marketing-enquiry', source: 'tools/marketing-enquiry.ts', fragment: '/marketing/enquiries/seller' },
+  { method: 'put', path: '/marketing/enquiries/auto-responder/{id}/answers/{key}', tool: 'loop-marketing-enquiry', source: 'tools/marketing-enquiry.ts', fragment: '/marketing/enquiries/auto-responder/' },
+  { method: 'put', path: '/marketing/enquiries/auto-responder/{id}/details/{key}', tool: 'loop-marketing-enquiry', source: 'tools/marketing-enquiry.ts', fragment: '/marketing/enquiries/auto-responder/' },
+  { method: 'put', path: '/marketing/enquiries/auto-responder/{id}/refer/{key}', tool: 'loop-marketing-enquiry', source: 'tools/marketing-enquiry.ts', fragment: '/marketing/enquiries/auto-responder/' },
+  // Property (6)
+  { method: 'post', path: '/property/residential/sales/{id}/viewing', tool: 'loop-property-request', source: 'tools/property-request.ts', fragment: '/property/residential/' },
+  { method: 'post', path: '/property/residential/sales/{id}/call-back', tool: 'loop-property-request', source: 'tools/property-request.ts', fragment: '/property/residential/' },
+  { method: 'post', path: '/property/residential/sales/{id}/information', tool: 'loop-property-request', source: 'tools/property-request.ts', fragment: '/property/residential/' },
+  { method: 'post', path: '/property/residential/lettings/{id}/viewing', tool: 'loop-property-request', source: 'tools/property-request.ts', fragment: '/property/residential/' },
+  { method: 'post', path: '/property/residential/lettings/{id}/call-back', tool: 'loop-property-request', source: 'tools/property-request.ts', fragment: '/property/residential/' },
+  { method: 'post', path: '/property/residential/lettings/{id}/information', tool: 'loop-property-request', source: 'tools/property-request.ts', fragment: '/property/residential/' },
+  // Supplier (3)
+  { method: 'post', path: '/supplier/maintenance/{code}/{jobid}/complete', tool: 'loop-supplier', source: 'tools/supplier.ts', fragment: '/supplier/maintenance/' },
+  { method: 'put', path: '/supplier/maintenance/{code}/{quoteid}/quote-for-job', tool: 'loop-supplier', source: 'tools/supplier.ts', fragment: '/quote-for-job' },
+  { method: 'post', path: '/supplier/board-contractor/{code}/{jobid}/complete', tool: 'loop-supplier', source: 'tools/supplier.ts', fragment: '/supplier/board-contractor/' },
+  // Viewing — sales (4)
+  { method: 'post', path: '/residential/sales/viewings', tool: 'loop-viewing-create', source: 'tools/viewing-create.ts', fragment: '/residential/' },
+  { method: 'post', path: '/residential/sales/viewings/{id}/buyer-feedback', tool: 'loop-viewing-update', source: 'tools/viewing-update.ts', fragment: '/residential/' },
+  { method: 'post', path: '/residential/sales/viewings/{id}/note', tool: 'loop-viewing-update', source: 'tools/viewing-update.ts', fragment: '/residential/' },
+  { method: 'post', path: '/residential/sales/viewings/{id}/seller-feedback', tool: 'loop-viewing-update', source: 'tools/viewing-update.ts', fragment: '/residential/' },
+  // RentalViewing — lettings (4)
+  { method: 'post', path: '/residential/lettings/viewings', tool: 'loop-viewing-create', source: 'tools/viewing-create.ts', fragment: '/residential/' },
+  { method: 'post', path: '/residential/lettings/viewings/{id}/renter-feedback', tool: 'loop-viewing-update', source: 'tools/viewing-update.ts', fragment: '/residential/' },
+  { method: 'post', path: '/residential/lettings/viewings/{id}/note', tool: 'loop-viewing-update', source: 'tools/viewing-update.ts', fragment: '/residential/' },
+  { method: 'post', path: '/residential/lettings/viewings/{id}/landlord-feedback', tool: 'loop-viewing-update', source: 'tools/viewing-update.ts', fragment: '/residential/' },
+];
+
+// Lazily cache source files so multiple per-endpoint tests don't re-read.
+const sourceCache = new Map<string, string>();
+function readSource(rel: string): string {
+  let cached = sourceCache.get(rel);
+  if (cached) return cached;
+  cached = readFileSync(resolve(PLUGIN_SRC, rel), 'utf-8');
+  sourceCache.set(rel, cached);
+  return cached;
+}
+
+const indexSrc = readSource('index.ts');
+
+describe('Loop swagger write coverage', () => {
+  // 1. Every write op in the snapshot has a mapping (catches new endpoints).
+  it('every swagger write op has a mapping in ENDPOINT_MAP', () => {
+    const swaggerOps: { method: string; path: string }[] = [];
+    for (const [path, item] of Object.entries(SWAGGER.paths)) {
+      for (const m of WRITE_METHODS) {
+        if (item[m]) swaggerOps.push({ method: m, path });
+      }
+    }
+    const mapped = new Set(ENDPOINT_MAP.map(e => `${e.method.toUpperCase()} ${e.path}`));
+    const orphans = swaggerOps.filter(o => !mapped.has(`${o.method.toUpperCase()} ${o.path}`));
+    if (orphans.length > 0) {
+      const lines = orphans.map(o => `  ${o.method.toUpperCase()} ${o.path}`).join('\n');
+      throw new Error(
+        `${orphans.length} swagger write endpoint(s) lack a mapping in ENDPOINT_MAP — Loop has added new write ops since the last snapshot:\n${lines}\n\nUpdate ENDPOINT_MAP to map each new endpoint to its tool, source, and path fragment.`,
+      );
+    }
+    expect(swaggerOps.length).toBe(ENDPOINT_MAP.length);
+  });
+
+  // 2. Every mapping's tool is registered in index.ts (catches deregistration).
+  //    Match by quoted tool name in proximity to a `server.tool(` call —
+  //    each registration is `server.tool(\n  "<name>", ...)` or single-line.
+  //    A tool name that appears only in a comment or unrelated string doesn't
+  //    match because we require it to be the first non-whitespace argument
+  //    of a server.tool( invocation within ~32 chars.
+  it.each(ENDPOINT_MAP)('$method $path → tool $tool registered in index.ts', ({ tool }) => {
+    const registrationRe = new RegExp(`server\\.tool\\(\\s*"${tool.replace(/[.*+?^${}()|[\\\]\\\\]/g, '\\\\$&')}"`);
+    const isRegistered = registrationRe.test(indexSrc);
+    expect(isRegistered, `tool "${tool}" not registered as server.tool("${tool}", ...) in src/index.ts`).toBe(true);
+  });
+
+  // 3. Every mapping's path fragment appears in the named source file
+  //    (catches refactor that drops the path family).
+  it.each(ENDPOINT_MAP)('$method $path → fragment "$fragment" present in $source', ({ source, fragment }) => {
+    const src = readSource(source);
+    expect(
+      src.includes(fragment),
+      `expected fragment "${fragment}" in ${source} (path family for the swagger op)`,
+    ).toBe(true);
+  });
+
+  // 4. Reverse coverage: every distinct tool in the mapping appears
+  //    registered (catches dead mappings).
+  it('every tool referenced by ENDPOINT_MAP is registered', () => {
+    const tools = new Set(ENDPOINT_MAP.map(e => e.tool));
+    const missing: string[] = [];
+    for (const tool of tools) {
+      if (!indexSrc.includes(`"${tool}"`)) missing.push(tool);
+    }
+    expect(missing).toEqual([]);
+  });
+});

package/payload/platform/plugins/loop/mcp/src/index.ts

@@ -0,0 +1,444 @@
+import { initStderrTee } from "../../../../../../platform/lib/mcp-stderr-tee/dist/index.js";
+initStderrTee("loop");
+
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { keyRegister } from "./tools/key-register.js";
+import { keyDeregister } from "./tools/key-deregister.js";
+import { keyList } from "./tools/key-list.js";
+import { propertySearch } from "./tools/property-search.js";
+import { propertyDetail } from "./tools/property-detail.js";
+import { propertyListed } from "./tools/property-listed.js";
+import { propertyRequest } from "./tools/property-request.js";
+import { peopleSearch } from "./tools/people-search.js";
+import { peopleDetail } from "./tools/people-detail.js";
+import { viewingSearch } from "./tools/viewing-search.js";
+import { viewingDetail } from "./tools/viewing-detail.js";
+import { viewingCreate } from "./tools/viewing-create.js";
+import { viewingUpdate } from "./tools/viewing-update.js";
+import { feedbackGet, feedbackSubmit } from "./tools/feedback.js";
+import { teamInfo } from "./tools/team-info.js";
+import { teamAvailability } from "./tools/team-availability.js";
+import { marketingMatchDetail } from "./tools/marketing-match.js";
+import { marketingMatchBatch } from "./tools/marketing-match-batch.js";
+import { marketingMatchRequest } from "./tools/marketing-match-request.js";
+import { marketingEnquiry } from "./tools/marketing-enquiry.js";
+import { customerPreferences } from "./tools/customer-preferences.js";
+import { supplier } from "./tools/supplier.js";
+import { closeDriver } from "./lib/neo4j.js";
+
+const accountId = process.env.ACCOUNT_ID;
+if (!accountId) {
+  throw new Error("ACCOUNT_ID environment variable is required");
+}
+
+const server = new McpServer({
+  name: "maxy-loop",
+  version: "0.2.0",
+});
+
+const ALL_PERMISSIONS = z.enum([
+  "properties", "people", "viewings", "feedback", "team",
+  "marketing", "customer", "supplier",
+]);
+
+console.error(`[loop] server started, account=${accountId}`);
+
+// Helper: wrap a tool function in standard error handling
+function toolHandler(fn: (p: Record<string, unknown>) => Promise<string>) {
+  return async (params: Record<string, unknown>) => {
+    try {
+      const text = await fn({ ...params, accountId });
+      return { content: [{ type: "text" as const, text }] };
+    } catch (err) {
+      return {
+        content: [{
+          type: "text" as const,
+          text: `Error: ${err instanceof Error ? err.message : String(err)}`,
+        }],
+        isError: true,
+      };
+    }
+  };
+}
+
+// ─────────────────────────────────────────────────────────────────
+// Key Management Tools (3)
+// ─────────────────────────────────────────────────────────────────
+
+server.tool(
+  "loop-key-register",
+  "Register a Loop CRM API key for a team. Validates the key against Loop's API, encrypts it, and stores it in the graph. Each key maps to one team.",
+  {
+    teamName: z.string().min(1).describe("Human-readable name for this team (e.g. 'Muvin Main Office')"),
+    apiKey: z.string().min(10).describe("Loop API key (X-Api-Key header value)"),
+    permissions: z
+      .array(ALL_PERMISSIONS)
+      .optional()
+      .describe("Endpoint groups this key can access (default: all 8 groups)"),
+  },
+  async (params) => {
+    try {
+      const result = await keyRegister({ ...params, accountId });
+      let text = `Team "${params.teamName}" registered successfully.`;
+      if (result.warning) text += `\n\nWarning: ${result.warning}`;
+      return { content: [{ type: "text" as const, text }] };
+    } catch (err) {
+      return {
+        content: [{
+          type: "text" as const,
+          text: `Failed to register key: ${err instanceof Error ? err.message : String(err)}`,
+        }],
+        isError: true,
+      };
+    }
+  }
+);
+
+server.tool(
+  "loop-key-deregister",
+  "Remove a registered Loop CRM team key. The key is permanently deleted from the graph.",
+  { teamName: z.string().min(1).describe("Name of the team to remove") },
+  async ({ teamName }) => {
+    try {
+      await keyDeregister({ teamName, accountId });
+      return { content: [{ type: "text" as const, text: `Team "${teamName}" deregistered.` }] };
+    } catch (err) {
+      return {
+        content: [{
+          type: "text" as const,
+          text: `Failed to deregister: ${err instanceof Error ? err.message : String(err)}`,
+        }],
+        isError: true,
+      };
+    }
+  }
+);
+
+server.tool(
+  "loop-key-list",
+  "List all registered Loop CRM teams for this account. Shows team names, addresses, and permissions. Never reveals API key values.",
+  {},
+  toolHandler(async (p) => keyList({ accountId: p.accountId as string }))
+);
+
+// ─────────────────────────────────────────────────────────────────
+// People Tools (2) — permission: people
+// ─────────────────────────────────────────────────────────────────
+
+server.tool(
+  "loop-people-search",
+  "Search people in Loop CRM. Without a role, searches all contacts. With a role (buyers/sellers/renters/landlords), returns role-specific results with rich filters.",
+  {
+    role: z.enum(["buyers", "sellers", "renters", "landlords"]).optional().describe("Role to search (omit for all people)"),
+    searchTerm: z.string().optional().describe("Name or contact search"),
+    maxPrice: z.number().optional().describe("Max price (buyers) or max price filter (sellers)"),
+    minPrice: z.number().optional().describe("Min price (sellers)"),
+    minBeds: z.number().optional().describe("Min bedrooms (buyers/renters)"),
+    maxRent: z.number().optional().describe("Max rent (renters only)"),
+    searchAreas: z.string().optional().describe("Comma-separated outcodes e.g. 'SN7,OX12' (buyers/renters)"),
+    propertyTypes: z.string().optional().describe("Comma-separated property types (buyers/renters)"),
+    startDate: z.string().optional().describe("Start date filter (sellers/landlords)"),
+    endDate: z.string().optional().describe("End date filter (sellers/landlords)"),
+    teamName: z.string().optional().describe("Query a specific team only"),
+    limit: z.number().int().optional().describe("Max results (default 200)"),
+  },
+  toolHandler(async (p) => peopleSearch(p as Parameters<typeof peopleSearch>[0]))
+);
+
+server.tool(
+  "loop-people-detail",
+  "Get full details for a specific person by ID. Optionally specify a role (buyers/sellers/renters/landlords) for role-specific detail.",
+  {
+    personId: z.number().int().describe("Person ID"),
+    role: z.enum(["buyers", "sellers", "renters", "landlords"]).optional().describe("Role for role-specific detail view"),
+    teamName: z.string().optional().describe("Query a specific team only"),
+  },
+  toolHandler(async (p) => peopleDetail(p as Parameters<typeof peopleDetail>[0]))
+);
+
+// ─────────────────────────────────────────────────────────────────
+// Property Tools (4) — permission: properties
+// ─────────────────────────────────────────────────────────────────
+
+server.tool(
+  "loop-property-search",
+  "Search properties in Loop CRM. Queries /property/residential/sales and /property/residential/lettings. Use department to narrow to one type.",
+  {
+    department: z.enum(["sales", "lettings", "both"]).optional().describe("Department (default: both)"),
+    searchTerm: z.string().optional().describe("Address or keyword search"),
+    minPrice: z.number().optional().describe("Minimum price"),
+    maxPrice: z.number().optional().describe("Maximum price"),
+    minBedrooms: z.number().int().optional().describe("Minimum bedrooms"),
+    maxBedrooms: z.number().int().optional().describe("Maximum bedrooms"),
+    propertyStatuses: z.string().optional().describe("Comma-separated statuses (e.g. 'forSale,underOffer')"),
+    propertyTypes: z.string().optional().describe("Comma-separated property types"),
+    teamName: z.string().optional().describe("Query a specific team only"),
+    limit: z.number().int().optional().describe("Max results (default 200)"),
+  },
+  toolHandler(async (p) => propertySearch(p as Parameters<typeof propertySearch>[0]))
+);
+
+server.tool(
+  "loop-property-detail",
+  "Get full details for a specific property by ID and department. Optionally include a preview hash for the public preview.",
+  {
+    propertyId: z.number().int().describe("Property ID"),
+    department: z.enum(["sales", "lettings"]).describe("sales or lettings"),
+    previewHash: z.number().int().optional().describe("Preview hash for public preview URL"),
+    teamName: z.string().optional().describe("Query a specific team only"),
+  },
+  toolHandler(async (p) => propertyDetail(p as Parameters<typeof propertyDetail>[0]))
+);
+
+server.tool(
+  "loop-property-listed",
+  "Get properties listed on a specific channel (Rightmove, Zoopla, OnTheMarket, website). Optionally include sold properties.",
+  {
+    channel: z.enum(["rightmove", "onTheMarket", "zoopla", "website"]).describe("Listing channel"),
+    department: z.enum(["sales", "lettings", "both"]).optional().describe("Department (default: both)"),
+    includeSold: z.boolean().optional().describe("Include sold gallery (default: false)"),
+    teamName: z.string().optional().describe("Query a specific team only"),
+    limit: z.number().int().optional().describe("Max results (default 200)"),
+  },
+  toolHandler(async (p) => propertyListed(p as Parameters<typeof propertyListed>[0]))
+);
+
+server.tool(
+  "loop-property-request",
+  "Submit a viewing, callback, or information request for a property. Requires a specific team.",
+  {
+    teamName: z.string().min(1).describe("Team to submit the request through"),
+    propertyId: z.number().int().describe("Property ID"),
+    department: z.enum(["sales", "lettings"]).describe("sales or lettings"),
+    action: z.enum(["viewing", "call-back", "information"]).describe("Request type"),
+    name: z.string().optional().describe("Requester name"),
+    email: z.string().optional().describe("Requester email"),
+    phone: z.string().optional().describe("Requester phone"),
+    message: z.string().optional().describe("Additional message"),
+  },
+  toolHandler(async (p) => propertyRequest(p as Parameters<typeof propertyRequest>[0]))
+);
+
+// ─────────────────────────────────────────────────────────────────
+// Viewing Tools (4) — permission: viewings
+// ─────────────────────────────────────────────────────────────────
+
+server.tool(
+  "loop-viewing-search",
+  "Search viewings in Loop CRM. Queries /residential/sales/viewings and /residential/lettings/viewings.",
+  {
+    department: z.enum(["sales", "lettings", "both"]).optional().describe("Department (default: both)"),
+    searchTerm: z.string().optional().describe("Search viewings"),
+    appointmentStartDate: z.string().optional().describe("Filter from date (ISO format)"),
+    appointmentEndDate: z.string().optional().describe("Filter to date (ISO format)"),
+    status: z.string().optional().describe("Viewing status filter"),
+    teamName: z.string().optional().describe("Query a specific team only"),
+    limit: z.number().int().optional().describe("Max results (default 200)"),
+  },
+  toolHandler(async (p) => viewingSearch(p as Parameters<typeof viewingSearch>[0]))
+);
+
+server.tool(
+  "loop-viewing-detail",
+  "Get full details for a specific viewing by ID and department.",
+  {
+    viewingId: z.number().int().describe("Viewing ID"),
+    department: z.enum(["sales", "lettings"]).describe("sales or lettings"),
+    teamName: z.string().optional().describe("Query a specific team only"),
+  },
+  toolHandler(async (p) => viewingDetail(p as Parameters<typeof viewingDetail>[0]))
+);
+
+server.tool(
+  "loop-viewing-create",
+  "Create a new viewing in Loop CRM. Creates the viewing and associated buyer/renter record.",
+  {
+    teamName: z.string().min(1).describe("Team to create the viewing for"),
+    department: z.enum(["sales", "lettings"]).describe("sales or lettings"),
+    propertyId: z.number().int().describe("Property ID"),
+    date: z.string().describe("Viewing date (YYYY-MM-DD)"),
+    time: z.string().describe("Viewing time (HH:mm)"),
+    attendeeName: z.string().describe("Attendee full name"),
+    attendeeEmail: z.string().optional().describe("Attendee email"),
+    attendeePhone: z.string().optional().describe("Attendee phone"),
+  },
+  toolHandler(async (p) => viewingCreate(p as Parameters<typeof viewingCreate>[0]))
+);
+
+server.tool(
+  "loop-viewing-update",
+  "Add a note or record feedback for a viewing. For feedback, specify the party: buyer/seller (sales) or renter/landlord (lettings).",
+  {
+    teamName: z.string().min(1).describe("Team that owns the viewing"),
+    viewingId: z.number().int().describe("Viewing ID"),
+    department: z.enum(["sales", "lettings"]).describe("sales or lettings"),
+    action: z.enum(["note", "feedback"]).describe("note or feedback"),
+    text: z.string().describe("Note text or feedback content"),
+    feedbackParty: z.enum(["buyer", "seller", "renter", "landlord"]).optional().describe("Required for feedback: whose feedback"),
+  },
+  toolHandler(async (p) => viewingUpdate(p as Parameters<typeof viewingUpdate>[0]))
+);
+
+// ─────────────────────────────────────────────────────────────────
+// Feedback Tools (2) — permission: feedback
+// ─────────────────────────────────────────────────────────────────
+
+server.tool(
+  "loop-feedback-get",
+  "Get feedback for a specific viewing. Reads from /feedback/residential/{department}/viewings/{id}.",
+  {
+    teamName: z.string().min(1).describe("Team that owns the viewing"),
+    viewingId: z.number().int().describe("Viewing ID"),
+    department: z.enum(["sales", "lettings"]).describe("sales or lettings"),
+  },
+  toolHandler(async (p) => feedbackGet(p as Parameters<typeof feedbackGet>[0]))
+);
+
+server.tool(
+  "loop-feedback-submit",
+  "Submit feedback for a viewing. Writes to /feedback/residential/{department}/viewings/{id}/feedback.",
+  {
+    teamName: z.string().min(1).describe("Team that owns the viewing"),
+    viewingId: z.number().int().describe("Viewing ID"),
+    department: z.enum(["sales", "lettings"]).describe("sales or lettings"),
+    feedback: z.string().describe("Feedback text"),
+  },
+  toolHandler(async (p) => feedbackSubmit(p as Parameters<typeof feedbackSubmit>[0]))
+);
+
+// ─────────────────────────────────────────────────────────────────
+// Team Tools (2) — permission: team
+// ─────────────────────────────────────────────────────────────────
+
+server.tool(
+  "loop-team-info",
+  "Get team details from Loop CRM. Returns team name, address, phone, and email.",
+  {
+    teamName: z.string().optional().describe("Query a specific team only (omit for all teams)"),
+  },
+  toolHandler(async (p) => teamInfo(p as Parameters<typeof teamInfo>[0]))
+);
+
+server.tool(
+  "loop-team-availability",
+  "Get available time slots for a specific agent on a given date.",
+  {
+    agentId: z.string().describe("Agent GUID identifier"),
+    searchDate: z.string().describe("Date to check availability (YYYY-MM-DD)"),
+    teamName: z.string().optional().describe("Query a specific team only"),
+  },
+  toolHandler(async (p) => teamAvailability(p as Parameters<typeof teamAvailability>[0]))
+);
+
+// ─────────────────────────────────────────────────────────────────
+// Marketing Tools (4) — permission: marketing
+// ─────────────────────────────────────────────────────────────────
+
+server.tool(
+  "loop-marketing-match",
+  "Get matching property detail and optionally the team profile for that match.",
+  {
+    propertyId: z.number().int().describe("Property ID"),
+    department: z.enum(["sales", "lettings"]).describe("sales or lettings"),
+    includeTeamProfile: z.boolean().optional().describe("Include the team profile for this match (default: false)"),
+    teamName: z.string().optional().describe("Query a specific team only"),
+  },
+  toolHandler(async (p) => marketingMatchDetail(p as Parameters<typeof marketingMatchDetail>[0]))
+);
+
+server.tool(
+  "loop-marketing-match-batch",
+  "Get batch matching results for multiple property IDs.",
+  {
+    propertyIds: z.array(z.number().int()).describe("Array of property IDs to match"),
+    department: z.enum(["sales", "lettings"]).describe("sales or lettings"),
+    teamName: z.string().optional().describe("Query a specific team only"),
+  },
+  toolHandler(async (p) => marketingMatchBatch(p as Parameters<typeof marketingMatchBatch>[0]))
+);
+
+server.tool(
+  "loop-marketing-match-request",
+  "Submit a viewing, information, or callback request for a matching property.",
+  {
+    teamName: z.string().min(1).describe("Team to submit the request through"),
+    propertyId: z.number().int().describe("Matching property ID"),
+    department: z.enum(["sales", "lettings"]).describe("sales or lettings"),
+    action: z.enum(["viewing", "information", "callback"]).describe("Request type"),
+    name: z.string().optional().describe("Requester name"),
+    email: z.string().optional().describe("Requester email"),
+    phone: z.string().optional().describe("Requester phone"),
+    message: z.string().optional().describe("Additional message"),
+  },
+  toolHandler(async (p) => marketingMatchRequest(p as Parameters<typeof marketingMatchRequest>[0]))
+);
+
+server.tool(
+  "loop-marketing-enquiry",
+  "Marketing enquiry operations: submit seller enquiries, manage auto-responder interactions.",
+  {
+    teamName: z.string().min(1).describe("Team to submit through"),
+    action: z.enum([
+      "seller-enquiry", "autoresponder-get", "autoresponder-answers",
+      "autoresponder-details", "autoresponder-refer",
+    ]).describe("Enquiry action"),
+    sellerEnquiryData: z.record(z.string(), z.unknown()).optional().describe("Seller enquiry request body (for seller-enquiry)"),
+    autoResponderId: z.number().int().optional().describe("Auto-responder enquiry ID"),
+    autoResponderKey: z.string().optional().describe("Auto-responder key (UUID)"),
+    answers: z.array(z.unknown()).optional().describe("Auto-responder answers array"),
+    details: z.record(z.string(), z.unknown()).optional().describe("Auto-responder details object"),
+  },
+  toolHandler(async (p) => marketingEnquiry(p as Parameters<typeof marketingEnquiry>[0]))
+);
+
+// ─────────────────────────────────────────────────────────────────
+// Customer Tools (1) — permission: customer
+// ─────────────────────────────────────────────────────────────────
+
+server.tool(
+  "loop-customer-preferences",
+  "Read or write customer preferences for a person. Action 'read' returns current preferences, 'write' updates them.",
+  {
+    teamName: z.string().min(1).describe("Team for this operation"),
+    personCode: z.number().int().describe("Person code (ID)"),
+    action: z.enum(["read", "write"]).describe("read or write"),
+    preferences: z.record(z.string(), z.unknown()).optional().describe("Preferences object (required for write)"),
+  },
+  toolHandler(async (p) => customerPreferences(p as Parameters<typeof customerPreferences>[0]))
+);
+
+// ─────────────────────────────────────────────────────────────────
+// Supplier Tools (1) — permission: supplier
+// ─────────────────────────────────────────────────────────────────
+
+server.tool(
+  "loop-supplier",
+  "Supplier operations: maintenance jobs, quotes, board contractor jobs. Supports listing, completing, and quoting.",
+  {
+    teamName: z.string().min(1).describe("Team for this operation"),
+    action: z.enum([
+      "maintenance-jobs", "maintenance-complete", "maintenance-quotes",
+      "maintenance-submit-quote", "board-jobs", "board-complete",
+    ]).describe("Supplier action"),
+    code: z.string().describe("Unique code assigned to the contractor"),
+    jobId: z.number().int().optional().describe("Job ID (required for all actions except maintenance-submit-quote)"),
+    quoteId: z.number().int().optional().describe("Quote ID (for maintenance-submit-quote)"),
+    quoteData: z.record(z.string(), z.unknown()).optional().describe("Quote data (for maintenance-submit-quote)"),
+    completionData: z.record(z.string(), z.unknown()).optional().describe("Completion data (for board-complete)"),
+  },
+  toolHandler(async (p) => supplier(p as Parameters<typeof supplier>[0]))
+);
+
+// ─────────────────────────────────────────────────────────────────
+// Lifecycle
+// ─────────────────────────────────────────────────────────────────
+
+process.on("SIGINT", async () => {
+  await closeDriver();
+  process.exit(0);
+});
+
+const transport = new StdioServerTransport();
+await server.connect(transport);