@rubytech/create-maxy 1.0.507 → 1.0.508

package/payload/premium-plugins/real-agency/plugins/real-agency-loop/mcp/src/tools/marketing-enquiry.ts

@@ -2,6 +2,14 @@ import { loopGet, loopPost, loopPut, withTeamKey } from "../lib/loop-api.js";
 
 type EnquiryAction = "seller-enquiry" | "autoresponder-get" | "autoresponder-answers" | "autoresponder-details" | "autoresponder-refer";
 
+// ─── Loop API V2: Marketing Enquiry Endpoints ──────────────────
+// POST /marketing/enquiries/seller — submit seller enquiry
+// GET /marketing/enquiries/auto-responder/{id}/{key} — read enquiry
+// PUT .../auto-responder/{id}/answers/{key} — submit answers
+// PUT .../auto-responder/{id}/details/{key} — update details
+// PUT .../auto-responder/{id}/refer/{key} — refer enquiry
+// Note: auto-responder uses personCode + key (UUID), not personId
+// ────────────────────────────────────────────────────────────────
 interface LoopBooleanResponse {
   success?: boolean;
   [key: string]: unknown;

package/payload/premium-plugins/real-agency/plugins/real-agency-loop/mcp/src/tools/marketing-match-batch.ts

@@ -4,6 +4,11 @@ import {
   loopPut,
 } from "../lib/loop-api.js";
 
+// ─── Loop API V2: PUT /marketing/matching/other-matches ─────────
+// Request body: array of property IDs
+// Response: array of matching property summaries
+// Schema not verified via curl (depends on matching state)
+// ────────────────────────────────────────────────────────────────
 interface LoopMatchingSummary {
   id?: number;
   address?: string;

package/payload/premium-plugins/real-agency/plugins/real-agency-loop/mcp/src/tools/marketing-match-request.ts

@@ -3,6 +3,11 @@ import { loopPost, withTeamKey } from "../lib/loop-api.js";
 type Department = "sales" | "lettings";
 type MatchAction = "viewing" | "information" | "callback";
 
+// ─── Loop API V2: POST /marketing/matching/{id}/{action} ────────
+// Actions: viewing, information, callback
+// Request body: { name?, email?, phone?, message? }
+// Response: boolean success
+// ────────────────────────────────────────────────────────────────
 interface LoopBooleanResponse {
   success?: boolean;
   [key: string]: unknown;

package/payload/premium-plugins/real-agency/plugins/real-agency-loop/mcp/src/tools/marketing-match.ts

@@ -4,6 +4,12 @@ import {
   loopGet,
 } from "../lib/loop-api.js";
 
+// ─── Loop API V2: /marketing/matching/{id} ─────────────────────
+// Returned HTTP 500 for test property 895155 — may require
+// publishedToMatching: true. Exact response schema not verified.
+// Fields below are from Swagger docs; [key: string]: unknown
+// ensures any actual response fields are accessible.
+// ────────────────────────────────────────────────────────────────
 interface LoopMatchingProperty {
   id?: number;
   address?: string;

package/payload/premium-plugins/real-agency/plugins/real-agency-loop/mcp/src/tools/people-detail.ts

@@ -4,17 +4,111 @@ import {
   loopGet,
 } from "../lib/loop-api.js";
 
+// ─── Loop API V2: /people/{id} ─────────────────────────────────
+// Fields: id, title, firstName, lastName, contactNotes,
+//   primaryPhone, primaryPhoneType, primaryEmail, primaryEmailType,
+//   dateCreated, houseNameOrNumber, houseSecondaryNameOrNumber,
+//   street, locality, town, district, county, postcode,
+//   buyerProfiles[], sellerProfiles[], renterIds[], landlordIds[],
+//   gdpr*, communication*
+// ────────────────────────────────────────────────────────────────
 interface LoopPersonDetail {
-  id?: number;
+  id: number;
+  title?: string;
   firstName?: string;
   lastName?: string;
-  email?: string;
-  phone?: string;
-  mobile?: string;
-  type?: string;
-  address?: string;
+  contactNotes?: string;
+  primaryPhone?: string;
+  primaryPhoneType?: string;
+  primaryEmail?: string;
+  primaryEmailType?: string;
+  dateCreated?: string;
+  houseNameOrNumber?: string;
+  houseSecondaryNameOrNumber?: string;
+  street?: string;
+  locality?: string;
+  town?: string;
+  district?: string;
+  county?: string;
   postcode?: string;
-  notes?: string;
+  buyerProfiles?: LoopBuyerProfileRef[];
+  sellerProfiles?: LoopSellerProfileRef[];
+  renterIds?: number[];
+  landlordIds?: number[];
+  [key: string]: unknown;
+}
+
+interface LoopBuyerProfileRef {
+  id: number;
+  buyerGroupName?: string;
+  maxPrice?: number | null;
+  minBeds?: number;
+  viewingCount?: number;
+  offerCount?: number;
+  [key: string]: unknown;
+}
+
+interface LoopSellerProfileRef {
+  id: number;
+  sellerGroupName?: string;
+  propertyId?: number;
+  propertyAddress?: string;
+  price?: number;
+  propertyStatus?: string;
+  [key: string]: unknown;
+}
+
+// ─── Loop API V2: /people/buyers/{id} ──────────────────────────
+// Fields: id, buyerGroupName, buyerIsGroup, maxPrice, minBeds,
+//   position, requirementNotes, sellingPosition, purchaseReason,
+//   financiallyVerified, mortgageOffered, insuranceOffered,
+//   people[] (nested PersonSummary), propertyTypes[], searchAreas[],
+//   viewings[], offers[]
+// ────────────────────────────────────────────────────────────────
+interface LoopBuyerDetail {
+  id: number;
+  buyerGroupName?: string;
+  buyerIsGroup?: boolean;
+  maxPrice?: number | null;
+  minBeds?: number;
+  position?: string;
+  requirementNotes?: string;
+  sellingPosition?: string | null;
+  purchaseReason?: string | null;
+  financiallyVerified?: string | null;
+  mortgageOffered?: string | null;
+  insuranceOffered?: string | null;
+  people?: LoopNestedPerson[];
+  propertyTypes?: string[];
+  searchAreas?: string[];
+  viewings?: Record<string, unknown>[];
+  offers?: Record<string, unknown>[];
+  [key: string]: unknown;
+}
+
+// ─── Loop API V2: /people/sellers/{id} ─────────────────────────
+// Fields: id, sellerGroupName, sellerIsGroup,
+//   people[] (nested PersonSummary), property (nested PropertySummary)
+// ────────────────────────────────────────────────────────────────
+interface LoopSellerDetail {
+  id: number;
+  sellerGroupName?: string;
+  sellerIsGroup?: boolean;
+  people?: LoopNestedPerson[];
+  property?: Record<string, unknown>;
+  [key: string]: unknown;
+}
+
+interface LoopNestedPerson {
+  id: number;
+  title?: string;
+  firstName?: string;
+  lastName?: string;
+  contactNotes?: string;
+  primaryPhone?: string;
+  primaryPhoneType?: string;
+  primaryEmail?: string;
+  primaryEmailType?: string;
   [key: string]: unknown;
 }
 
@@ -28,14 +122,14 @@ export async function peopleDetail(params: {
 }): Promise<string> {
   const { accountId, personId, role, teamName } = params;
 
-  const result = await aggregateAcrossTeams<LoopPersonDetail>(
+  const result = await aggregateAcrossTeams<Record<string, unknown>>(
     accountId,
     "people",
     "loop-people-detail",
     async (apiKey, team) => {
       const basePath = role ? `/people/${role}` : "/people";
       const path = `${basePath}/${personId}`;
-      const data = await loopGet<LoopPersonDetail>(apiKey, path, "loop-people-detail", team);
+      const data = await loopGet<Record<string, unknown>>(apiKey, path, "loop-people-detail", team);
       if (data && typeof data === "object" && !Array.isArray(data)) {
         return [data];
       }
@@ -46,18 +140,106 @@ export async function peopleDetail(params: {
 
   return formatAggregationResult(
     result,
-    (p) => {
-      const name = [p.firstName, p.lastName].filter(Boolean).join(" ") || "Unknown";
-      const lines = [`**${name}**`];
-      if (p.type) lines.push(`Type: ${p.type}`);
-      if (p.email) lines.push(`Email: ${p.email}`);
-      if (p.phone) lines.push(`Phone: ${p.phone}`);
-      if (p.mobile) lines.push(`Mobile: ${p.mobile}`);
-      if (p.address) lines.push(`Address: ${p.address}`);
-      if (p.postcode) lines.push(`Postcode: ${p.postcode}`);
-      if (p.notes) lines.push(`Notes: ${p.notes}`);
-      return lines.join("\n");
-    },
+    (record) => formatDetailRecord(record, role),
     "person details"
   );
 }
+
+function formatDetailRecord(record: Record<string, unknown>, role?: PeopleRole): string {
+  if (role === "buyers") {
+    const p = record as unknown as LoopBuyerDetail;
+    const lines = [`**${p.buyerGroupName ?? "Unknown"}** [ID: ${p.id}]`];
+    if (p.maxPrice != null) lines.push(`Max price: £${p.maxPrice.toLocaleString("en-GB")}`);
+    if (p.minBeds) lines.push(`Min beds: ${p.minBeds}`);
+    if (p.position && p.position !== "none") lines.push(`Position: ${p.position}`);
+    if (p.sellingPosition) lines.push(`Selling position: ${p.sellingPosition}`);
+    if (p.purchaseReason) lines.push(`Purchase reason: ${p.purchaseReason}`);
+    if (p.financiallyVerified) lines.push(`Financially verified: ${p.financiallyVerified}`);
+    if (p.mortgageOffered) lines.push(`Mortgage: ${p.mortgageOffered}`);
+    if (p.requirementNotes) lines.push(`Requirements: ${p.requirementNotes}`);
+    if (p.propertyTypes?.length) lines.push(`Property types: ${p.propertyTypes.join(", ")}`);
+    if (p.searchAreas?.length) lines.push(`Search areas: ${p.searchAreas.join(", ")}`);
+    if (p.viewings?.length) lines.push(`Viewings: ${p.viewings.length}`);
+    if (p.offers?.length) lines.push(`Offers: ${p.offers.length}`);
+
+    if (p.people?.length) {
+      lines.push(`\n**Contacts (${p.people.length}):**`);
+      for (const person of p.people) {
+        const name = [person.firstName, person.lastName].filter(Boolean).join(" ");
+        const phone = person.primaryPhone ?? "";
+        const email = person.primaryEmail ?? "";
+        const contact = [phone, email].filter(Boolean).join(" | ");
+        lines.push(`  - ${name} [ID: ${person.id}]${contact ? ` — ${contact}` : ""}`);
+      }
+    }
+    return lines.join("\n");
+  }
+
+  if (role === "sellers" || role === "landlords") {
+    const p = record as unknown as LoopSellerDetail;
+    const lines = [`**${p.sellerGroupName ?? "Unknown"}** [ID: ${p.id}]`];
+
+    if (p.property) {
+      const prop = p.property;
+      if (prop.propertyAddress) lines.push(`Property: ${prop.propertyAddress}`);
+      if (prop.price != null) lines.push(`Price: £${Number(prop.price).toLocaleString("en-GB")}`);
+      if (prop.status) lines.push(`Status: ${prop.status}`);
+      if (prop.propertyType) lines.push(`Type: ${prop.propertyType}`);
+      if (prop.propertyId || prop.id) lines.push(`Property ID: ${prop.propertyId ?? prop.id}`);
+    }
+
+    if (p.people?.length) {
+      lines.push(`\n**Contacts (${p.people.length}):**`);
+      for (const person of p.people) {
+        const name = [person.firstName, person.lastName].filter(Boolean).join(" ");
+        const phone = person.primaryPhone ?? "";
+        const email = person.primaryEmail ?? "";
+        const contact = [phone, email].filter(Boolean).join(" | ");
+        lines.push(`  - ${name} [ID: ${person.id}]${contact ? ` — ${contact}` : ""}`);
+      }
+    }
+    return lines.join("\n");
+  }
+
+  // Generic /people/{id} — PersonDetail schema
+  const p = record as unknown as LoopPersonDetail;
+  const title = p.title?.trim() ? `${p.title.trim()} ` : "";
+  const name = [p.firstName, p.lastName].filter(Boolean).join(" ") || "Unknown";
+  const lines = [`**${title}${name}** [ID: ${p.id}]`];
+
+  if (p.primaryEmail) lines.push(`Email: ${p.primaryEmail}`);
+  if (p.primaryPhone) lines.push(`Phone: ${p.primaryPhone}`);
+  if (p.dateCreated) lines.push(`Created: ${p.dateCreated.split("T")[0]}`);
+
+  // Build address from components
+  const addrParts = [
+    p.houseSecondaryNameOrNumber,
+    p.houseNameOrNumber,
+    p.street,
+    p.locality,
+    p.town,
+    p.postcode,
+  ].filter(Boolean);
+  if (addrParts.length) lines.push(`Address: ${addrParts.join(", ")}`);
+
+  if (p.contactNotes) lines.push(`Notes: ${p.contactNotes}`);
+
+  if (p.buyerProfiles?.length) {
+    lines.push(`\n**Buyer profiles (${p.buyerProfiles.length}):**`);
+    for (const bp of p.buyerProfiles) {
+      const bpName = bp.buyerGroupName ?? `Buyer ${bp.id}`;
+      const price = bp.maxPrice != null ? ` max £${bp.maxPrice.toLocaleString("en-GB")}` : "";
+      lines.push(`  - ${bpName} [ID: ${bp.id}]${price}`);
+    }
+  }
+  if (p.sellerProfiles?.length) {
+    lines.push(`\n**Seller profiles (${p.sellerProfiles.length}):**`);
+    for (const sp of p.sellerProfiles) {
+      const spName = sp.sellerGroupName ?? `Seller ${sp.id}`;
+      const addr = sp.propertyAddress ? ` — ${sp.propertyAddress}` : "";
+      lines.push(`  - ${spName} [ID: ${sp.id}]${addr}`);
+    }
+  }
+
+  return lines.join("\n");
+}

package/payload/premium-plugins/real-agency/plugins/real-agency-loop/mcp/src/tools/people-search.ts

@@ -4,13 +4,69 @@ import {
   loopGet,
 } from "../lib/loop-api.js";
 
+// ─── Loop API V2: /people ──────────────────────────────────────
+// Fields: id, title, firstName, lastName, contactNotes,
+//   primaryPhone, primaryPhoneType, primaryPhoneNotes,
+//   primaryEmail, primaryEmailType, primaryEmailNotes,
+//   gdprGeneralMarketing, gdprPropertyMatching, gdprThirdParties,
+//   communicationCall, communicationEmail, communicationPost, communicationText
+// ────────────────────────────────────────────────────────────────
 interface LoopPersonSummary {
-  id?: number;
+  id: number;
+  title?: string;
   firstName?: string;
   lastName?: string;
-  email?: string;
-  phone?: string;
-  type?: string;
+  contactNotes?: string;
+  primaryPhone?: string;
+  primaryPhoneType?: string;
+  primaryEmail?: string;
+  primaryEmailType?: string;
+  [key: string]: unknown;
+}
+
+// ─── Loop API V2: /people/buyers ───────────────────────────────
+// Fields: id, buyerGroupName, buyerIsGroup, maxPrice, minBeds,
+//   position, sellingPosition, purchaseReason, financiallyVerified,
+//   mortgageOffered, insuranceOffered, offerCount, acceptedOfferCount,
+//   viewingCount, upcomingViewingCount
+// ────────────────────────────────────────────────────────────────
+interface LoopBuyerSummary {
+  id: number;
+  buyerGroupName?: string;
+  buyerIsGroup?: boolean;
+  maxPrice?: number | null;
+  minBeds?: number;
+  position?: string;
+  sellingPosition?: string | null;
+  purchaseReason?: string | null;
+  financiallyVerified?: string | null;
+  mortgageOffered?: string | null;
+  insuranceOffered?: string | null;
+  offerCount?: number;
+  acceptedOfferCount?: number;
+  viewingCount?: number;
+  upcomingViewingCount?: number;
+  [key: string]: unknown;
+}
+
+// ─── Loop API V2: /people/sellers ──────────────────────────────
+// Fields: id, sellerGroupName, sellerIsGroup, propertyId,
+//   propertyStatus, propertyType, propertyAddress, price,
+//   offerCount, acceptedOfferCount, viewingCount, upcomingViewingCount
+// ────────────────────────────────────────────────────────────────
+interface LoopSellerSummary {
+  id: number;
+  sellerGroupName?: string;
+  sellerIsGroup?: boolean;
+  propertyId?: number;
+  propertyStatus?: string;
+  propertyType?: string;
+  propertyAddress?: string;
+  price?: number;
+  offerCount?: number;
+  acceptedOfferCount?: number;
+  viewingCount?: number;
+  upcomingViewingCount?: number;
   [key: string]: unknown;
 }
 
@@ -41,7 +97,9 @@ export async function peopleSearch(params: {
     teamName, limit,
   } = params;
 
-  const result = await aggregateAcrossTeams<LoopPersonSummary>(
+  // Role-specific endpoints return different schemas — use a generic record
+  // type for aggregation, then cast per-role in the formatter.
+  const result = await aggregateAcrossTeams<Record<string, unknown>>(
     accountId,
     "people",
     "loop-people-search",
@@ -73,7 +131,7 @@ export async function peopleSearch(params: {
       const query = qp.length > 0 ? `?${qp.join("&")}` : "";
       const basePath = role ? `/people/${role}` : "/people";
       const path = `${basePath}${query}`;
-      const data = await loopGet<LoopPersonSummary[]>(apiKey, path, "loop-people-search", team);
+      const data = await loopGet<Record<string, unknown>[]>(apiKey, path, "loop-people-search", team);
       return Array.isArray(data) ? data : [];
     },
     { teamName, limitPerTeam: limit ?? 50, limitTotal: limit ?? 200 }
@@ -82,12 +140,41 @@ export async function peopleSearch(params: {
   const entityName = role ?? "people";
   return formatAggregationResult(
     result,
-    (p) => {
-      const name = [p.firstName, p.lastName].filter(Boolean).join(" ") || "Unknown";
-      const contact = p.email ?? p.phone ?? "";
-      const type = p.type ? ` (${p.type})` : "";
-      return `- ${name}${contact ? ` <${contact}>` : ""}${type}`;
-    },
+    (record) => formatPersonRecord(record, role),
     entityName
   );
 }
+
+function formatPersonRecord(record: Record<string, unknown>, role?: PeopleRole): string {
+  if (role === "buyers") {
+    const p = record as unknown as LoopBuyerSummary;
+    const name = p.buyerGroupName ?? "Unknown";
+    const id = p.id != null ? ` [ID: ${p.id}]` : "";
+    const price = p.maxPrice != null ? ` — max £${p.maxPrice.toLocaleString("en-GB")}` : "";
+    const beds = p.minBeds ? ` ${p.minBeds}+ beds` : "";
+    const position = p.position && p.position !== "none" ? ` (${p.position})` : "";
+    const viewings = p.viewingCount ? ` | ${p.viewingCount} viewing${p.viewingCount !== 1 ? "s" : ""}` : "";
+    const offers = p.offerCount ? ` | ${p.offerCount} offer${p.offerCount !== 1 ? "s" : ""}` : "";
+    return `- ${name}${id}${price}${beds}${position}${viewings}${offers}`;
+  }
+
+  if (role === "sellers" || role === "landlords") {
+    const p = record as unknown as LoopSellerSummary;
+    const name = p.sellerGroupName ?? "Unknown";
+    const id = p.id != null ? ` [ID: ${p.id}]` : "";
+    const addr = p.propertyAddress ? ` — ${p.propertyAddress}` : "";
+    const price = p.price != null ? ` £${p.price.toLocaleString("en-GB")}` : "";
+    const status = p.propertyStatus ? ` [${p.propertyStatus}]` : "";
+    const viewings = p.viewingCount ? ` | ${p.viewingCount} viewing${p.viewingCount !== 1 ? "s" : ""}` : "";
+    const offers = p.offerCount ? ` | ${p.offerCount} offer${p.offerCount !== 1 ? "s" : ""}` : "";
+    return `- ${name}${id}${addr}${price}${status}${viewings}${offers}`;
+  }
+
+  // Generic /people or /people/renters — uses PersonSummary schema
+  const p = record as unknown as LoopPersonSummary;
+  const name = [p.firstName, p.lastName].filter(Boolean).join(" ") || "Unknown";
+  const id = p.id != null ? ` [ID: ${p.id}]` : "";
+  const contact = p.primaryEmail ?? p.primaryPhone ?? "";
+  const title = p.title?.trim() ? `${p.title.trim()} ` : "";
+  return `- ${title}${name}${id}${contact ? ` <${contact}>` : ""}`;
+}

package/payload/premium-plugins/real-agency/plugins/real-agency-loop/mcp/src/tools/property-detail.ts

@@ -4,20 +4,55 @@ import {
   loopGet,
 } from "../lib/loop-api.js";
 
+// ─── Loop API V2: /property/residential/{dept}/{id} ────────────
+// Fields: id, refId, address_DisplayAddress, address_HouseNameOrNumber,
+//   address_HouseSecondaryNameOrNumber, address_Street, address_Locality,
+//   address_Town, address_Postcode, status, propertyType, dateCreated,
+//   dateInstructed, dateLaunched, dateExchanged, dateCompleted,
+//   dateWithdrawn, shortDescription, fullDescription, bathrooms,
+//   bedrooms, receptionRooms, price, priceQualifier, latitude,
+//   longitude, parking, outsideSpace, councilTaxBand, floorArea,
+//   tenure, serviceCharge, groundRent, features[], images[],
+//   marketingFlag_*, creatingAgentId
+// ────────────────────────────────────────────────────────────────
 interface LoopPropertyDetail {
-  id?: number;
-  address?: string;
-  price?: number;
+  id: number;
+  refId?: string;
+  address_DisplayAddress?: string | null;
+  address_HouseNameOrNumber?: string;
+  address_HouseSecondaryNameOrNumber?: string;
+  address_Street?: string;
+  address_Locality?: string | null;
+  address_Town?: string;
+  address_Postcode?: string;
   status?: string;
-  type?: string;
-  bedrooms?: number;
+  propertyType?: string;
+  dateCreated?: string;
+  dateInstructed?: string | null;
+  dateLaunched?: string | null;
+  dateExchanged?: string | null;
+  dateCompleted?: string | null;
+  dateWithdrawn?: string | null;
+  shortDescription?: string;
+  fullDescription?: string;
   bathrooms?: number;
-  description?: string;
-  receptions?: number;
-  tenure?: string;
-  councilTax?: string;
-  epcRating?: string;
+  bedrooms?: number;
+  receptionRooms?: number;
+  price?: number;
+  priceQualifier?: string;
+  latitude?: number;
+  longitude?: number;
+  parking?: string;
+  outsideSpace?: string;
+  councilTaxBand?: string;
   floorArea?: number;
+  tenure?: string;
+  serviceCharge?: number;
+  groundRent?: number;
+  features?: string[];
+  images?: { url: string; mimeType?: string }[];
+  creatingAgentId?: string;
+  isDirectViewingsEnabled?: boolean;
   [key: string]: unknown;
 }
 
@@ -52,17 +87,57 @@ export async function propertyDetail(params: {
   return formatAggregationResult(
     result,
     (p) => {
-      const lines = [`**${p.address ?? "Unknown address"}**`];
-      if (p.price) lines.push(`Price: £${p.price.toLocaleString("en-GB")}`);
+      // Build display address from components
+      const addr = p.address_DisplayAddress
+        ?? ([
+          p.address_HouseSecondaryNameOrNumber,
+          p.address_HouseNameOrNumber,
+          p.address_Street,
+          p.address_Town,
+          p.address_Postcode,
+        ].filter(Boolean).join(", ") || "Unknown address");
+
+      const lines = [`**${addr}** [ID: ${p.id}]`];
+      if (p.price != null) {
+        const qualifier = p.priceQualifier && p.priceQualifier !== "none" ? ` (${p.priceQualifier})` : "";
+        lines.push(`Price: £${p.price.toLocaleString("en-GB")}${qualifier}`);
+      }
       if (p.status) lines.push(`Status: ${p.status}`);
-      if (p.type) lines.push(`Type: ${p.type}`);
-      if (p.bedrooms) lines.push(`Bedrooms: ${p.bedrooms}`);
-      if (p.bathrooms) lines.push(`Bathrooms: ${p.bathrooms}`);
-      if (p.receptions) lines.push(`Receptions: ${p.receptions}`);
-      if (p.tenure) lines.push(`Tenure: ${p.tenure}`);
-      if (p.councilTax) lines.push(`Council Tax: ${p.councilTax}`);
-      if (p.epcRating) lines.push(`EPC: ${p.epcRating}`);
-      if (p.description) lines.push(`\n${p.description}`);
+      if (p.propertyType) lines.push(`Type: ${p.propertyType}`);
+      if (p.bedrooms != null) lines.push(`Bedrooms: ${p.bedrooms}`);
+      if (p.bathrooms != null) lines.push(`Bathrooms: ${p.bathrooms}`);
+      if (p.receptionRooms != null) lines.push(`Reception rooms: ${p.receptionRooms}`);
+      if (p.floorArea) lines.push(`Floor area: ${p.floorArea} sq ft`);
+      if (p.tenure && p.tenure !== "None") lines.push(`Tenure: ${p.tenure}`);
+      if (p.councilTaxBand) lines.push(`Council Tax: Band ${p.councilTaxBand}`);
+      if (p.parking) lines.push(`Parking: ${p.parking}`);
+      if (p.outsideSpace) lines.push(`Outside: ${p.outsideSpace}`);
+      if (p.serviceCharge) lines.push(`Service charge: £${p.serviceCharge}`);
+      if (p.groundRent) lines.push(`Ground rent: £${p.groundRent}`);
+
+      // Key dates
+      const dates: string[] = [];
+      if (p.dateInstructed) dates.push(`Instructed: ${p.dateInstructed.split("T")[0]}`);
+      if (p.dateLaunched) dates.push(`Launched: ${p.dateLaunched.split("T")[0]}`);
+      if (p.dateExchanged) dates.push(`Exchanged: ${p.dateExchanged.split("T")[0]}`);
+      if (p.dateCompleted) dates.push(`Completed: ${p.dateCompleted.split("T")[0]}`);
+      if (p.dateWithdrawn) dates.push(`Withdrawn: ${p.dateWithdrawn.split("T")[0]}`);
+      if (dates.length) lines.push(dates.join(" | "));
+
+      if (p.features?.length) {
+        lines.push(`Features: ${p.features.join(", ")}`);
+      }
+
+      if (p.images?.length) {
+        lines.push(`Images: ${p.images.length} photo${p.images.length !== 1 ? "s" : ""}`);
+      }
+
+      // Short description — strip HTML tags for readability
+      if (p.shortDescription) {
+        const clean = p.shortDescription.replace(/<[^>]+>/g, "").trim();
+        if (clean) lines.push(`\n${clean}`);
+      }
+
       return lines.join("\n");
     },
     "property details"

package/payload/premium-plugins/real-agency/plugins/real-agency-loop/mcp/src/tools/property-listed.ts

@@ -4,14 +4,31 @@ import {
   loopGet,
 } from "../lib/loop-api.js";
 
+// ─── Loop API V2: /property/residential/{dept}/listed/{channel} ─
+// Returns full property detail enriched with listing metadata:
+//   listingId, propertyId, propertyRefId, channel, displayAddress,
+//   propertyAddress, address_* fields, status, propertyType,
+//   dateLaunched, price, bedrooms, bathrooms, receptionRooms,
+//   shortDescription, features[], images[]
+// ─────────────────────────────────────────────────────────────────
 interface LoopPropertyListing {
-  id?: number;
-  address?: string;
-  price?: number;
+  listingId?: number;
+  propertyId?: number;
+  propertyRefId?: string;
+  channel?: string;
+  propertyAddress?: string;
+  displayAddress?: string;
   status?: string;
-  type?: string;
+  propertyType?: string;
+  dateLaunched?: string;
+  price?: number;
+  priceQualifier?: string;
   bedrooms?: number;
-  listingUrl?: string;
+  bathrooms?: number;
+  receptionRooms?: number;
+  shortDescription?: string;
+  features?: string[];
+  images?: { url: string }[];
   [key: string]: unknown;
 }
 
@@ -57,10 +74,14 @@ export async function propertyListed(params: {
   return formatAggregationResult(
     result,
     (p) => {
+      const addr = p.displayAddress ?? p.propertyAddress ?? "Unknown address";
+      const id = p.propertyId != null ? ` [ID: ${p.propertyId}]` : "";
       const price = p.price ? ` — £${p.price.toLocaleString("en-GB")}` : "";
       const beds = p.bedrooms ? ` ${p.bedrooms}bed` : "";
+      const propType = p.propertyType ? ` (${p.propertyType})` : "";
       const status = p.status ? ` [${p.status}]` : "";
-      return `- ${p.address ?? "Unknown address"}${price}${beds}${status}`;
+      const photos = p.images?.length ? ` ${p.images.length} photo${p.images.length !== 1 ? "s" : ""}` : "";
+      return `- ${addr}${id}${price}${beds}${propType}${status}${photos}`;
     },
     `${channel} listings`
   );

package/payload/premium-plugins/real-agency/plugins/real-agency-loop/mcp/src/tools/property-request.ts

@@ -3,6 +3,11 @@ import { loopPost, withTeamKey } from "../lib/loop-api.js";
 type Department = "sales" | "lettings";
 type RequestAction = "viewing" | "call-back" | "information";
 
+// ─── Loop API V2: POST /property/residential/{dept}/{id}/{action}
+// Actions: viewing, call-back, information
+// Request body: { name?, email?, phone?, message? }
+// Response: boolean success
+// ────────────────────────────────────────────────────────────────
 interface LoopBooleanResponse {
   success?: boolean;
   [key: string]: unknown;