@rubytech/create-realagent-code 0.1.24 → 0.1.27

package/payload/platform/plugins/loop/mcp/src/tools/people-detail.ts

@@ -0,0 +1,245 @@
+import {
+  aggregateAcrossTeams,
+  formatAggregationResult,
+  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;
+  title?: string;
+  firstName?: string;
+  lastName?: 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;
+  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;
+}
+
+type PeopleRole = "buyers" | "sellers" | "renters" | "landlords";
+
+export async function peopleDetail(params: {
+  accountId: string;
+  personId: number;
+  role?: PeopleRole;
+  teamName?: string;
+}): Promise<string> {
+  const { accountId, personId, role, teamName } = params;
+
+  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<Record<string, unknown>>(apiKey, path, "loop-people-detail", team);
+      if (data && typeof data === "object" && !Array.isArray(data)) {
+        return [data];
+      }
+      return [];
+    },
+    { teamName }
+  );
+
+  return formatAggregationResult(
+    result,
+    (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/platform/plugins/loop/mcp/src/tools/people-search.ts

@@ -0,0 +1,180 @@
+import {
+  aggregateAcrossTeams,
+  formatAggregationResult,
+  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;
+  title?: string;
+  firstName?: string;
+  lastName?: 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;
+}
+
+type PeopleRole = "buyers" | "sellers" | "renters" | "landlords";
+
+export async function peopleSearch(params: {
+  accountId: string;
+  role?: PeopleRole;
+  searchTerm?: string;
+  // Role-specific filters (buyers)
+  maxPrice?: number;
+  minBeds?: number;
+  searchAreas?: string;
+  propertyTypes?: string;
+  // Role-specific filters (sellers/landlords)
+  startDate?: string;
+  endDate?: string;
+  minPrice?: number;
+  // Role-specific filters (renters)
+  maxRent?: number;
+  teamName?: string;
+  limit?: number;
+}): Promise<string> {
+  const {
+    accountId, role, searchTerm,
+    maxPrice, minBeds, searchAreas, propertyTypes,
+    startDate, endDate, minPrice, maxRent,
+    teamName, limit,
+  } = params;
+
+  // 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",
+    async (apiKey, team) => {
+      const qp: string[] = [];
+      if (searchTerm) qp.push(`SearchTerm=${encodeURIComponent(searchTerm)}`);
+
+      if (role === "buyers") {
+        if (maxPrice != null) qp.push(`MaxPrice=${maxPrice}`);
+        if (minBeds != null) qp.push(`MinBeds=${minBeds}`);
+        if (searchAreas) qp.push(`SearchAreas=${encodeURIComponent(searchAreas)}`);
+        if (propertyTypes) qp.push(`PropertyTypes=${encodeURIComponent(propertyTypes)}`);
+      } else if (role === "sellers" || role === "landlords") {
+        if (startDate) qp.push(`StartDate=${encodeURIComponent(startDate)}`);
+        if (endDate) qp.push(`EndDate=${encodeURIComponent(endDate)}`);
+        if (minPrice != null) qp.push(`MinPrice=${minPrice}`);
+        if (maxPrice != null) qp.push(`MaxPrice=${maxPrice}`);
+      } else if (role === "renters") {
+        if (maxRent != null) qp.push(`MaxRent=${maxRent}`);
+        if (minBeds != null) qp.push(`MinBeds=${minBeds}`);
+        if (searchAreas) qp.push(`SearchAreas=${encodeURIComponent(searchAreas)}`);
+        if (propertyTypes) qp.push(`PropertyTypes=${encodeURIComponent(propertyTypes)}`);
+      } else {
+        // Generic /people endpoint
+        if (startDate) qp.push(`StartDate=${encodeURIComponent(startDate)}`);
+        if (endDate) qp.push(`EndDate=${encodeURIComponent(endDate)}`);
+      }
+
+      const query = qp.length > 0 ? `?${qp.join("&")}` : "";
+      const basePath = role ? `/people/${role}` : "/people";
+      const path = `${basePath}${query}`;
+      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 }
+  );
+
+  const entityName = role ?? "people";
+  return formatAggregationResult(
+    result,
+    (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/platform/plugins/loop/mcp/src/tools/property-detail.ts

@@ -0,0 +1,145 @@
+import {
+  aggregateAcrossTeams,
+  formatAggregationResult,
+  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;
+  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;
+  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;
+  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;
+}
+
+type Department = "sales" | "lettings";
+
+export async function propertyDetail(params: {
+  accountId: string;
+  propertyId: number;
+  department: Department;
+  previewHash?: number;
+  teamName?: string;
+}): Promise<string> {
+  const { accountId, propertyId, department, previewHash, teamName } = params;
+
+  const result = await aggregateAcrossTeams<LoopPropertyDetail>(
+    accountId,
+    "properties",
+    "loop-property-detail",
+    async (apiKey, team) => {
+      const path = previewHash
+        ? `/property/residential/${department}/${propertyId}/preview/${previewHash}`
+        : `/property/residential/${department}/${propertyId}`;
+      const data = await loopGet<LoopPropertyDetail>(apiKey, path, "loop-property-detail", team);
+      if (data && typeof data === "object" && !Array.isArray(data)) {
+        return [data];
+      }
+      return [];
+    },
+    { teamName }
+  );
+
+  return formatAggregationResult(
+    result,
+    (p) => {
+      // 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.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/platform/plugins/loop/mcp/src/tools/property-listed.ts

@@ -0,0 +1,88 @@
+import {
+  aggregateAcrossTeams,
+  formatAggregationResult,
+  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 {
+  listingId?: number;
+  propertyId?: number;
+  propertyRefId?: string;
+  channel?: string;
+  propertyAddress?: string;
+  displayAddress?: string;
+  status?: string;
+  propertyType?: string;
+  dateLaunched?: string;
+  price?: number;
+  priceQualifier?: string;
+  bedrooms?: number;
+  bathrooms?: number;
+  receptionRooms?: number;
+  shortDescription?: string;
+  features?: string[];
+  images?: { url: string }[];
+  [key: string]: unknown;
+}
+
+type Department = "sales" | "lettings" | "both";
+type Channel = "rightmove" | "onTheMarket" | "zoopla" | "website";
+
+export async function propertyListed(params: {
+  accountId: string;
+  channel: Channel;
+  department?: Department;
+  includeSold?: boolean;
+  teamName?: string;
+  limit?: number;
+}): Promise<string> {
+  const { accountId, channel, department = "both", includeSold = false, teamName, limit } = params;
+
+  const result = await aggregateAcrossTeams<LoopPropertyListing>(
+    accountId,
+    "properties",
+    "loop-property-listed",
+    async (apiKey, team) => {
+      const all: LoopPropertyListing[] = [];
+      const depts: string[] =
+        department === "both" ? ["sales", "lettings"] : [department];
+
+      for (const dept of depts) {
+        const path = `/property/residential/${dept}/listed/${channel}`;
+        const data = await loopGet<LoopPropertyListing[]>(apiKey, path, "loop-property-listed", team);
+        if (Array.isArray(data)) all.push(...data);
+      }
+
+      if (includeSold) {
+        const soldPath = `/property/residential/sold/${channel}`;
+        const soldData = await loopGet<LoopPropertyListing[]>(apiKey, soldPath, "loop-property-listed", team);
+        if (Array.isArray(soldData)) all.push(...soldData);
+      }
+
+      return all;
+    },
+    { teamName, limitPerTeam: limit ?? 50, limitTotal: limit ?? 200 }
+  );
+
+  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}]` : "";
+      const photos = p.images?.length ? ` ${p.images.length} photo${p.images.length !== 1 ? "s" : ""}` : "";
+      return `- ${addr}${id}${price}${beds}${propType}${status}${photos}`;
+    },
+    `${channel} listings`
+  );
+}