@sfranalytics/mcp 0.6.0

package/dist/tools/plr/borrowerSearch.js

@@ -0,0 +1,128 @@
+import { z } from "zod";
+import { structuredResult, markdownTable, truncatedJson, fmtDollars } from "../formatters.js";
+import { registerToolSafe } from "../registerToolSafe.js";
+import { autoFillPlrDates } from "../dateHelper.js";
+import { action } from "../nextActions.js";
+const Input = z.object({
+    search: z.string().optional().describe("Search text for borrower name"),
+    states: z.string().optional().describe("Filter by entity registration state (where the LLC is registered, NOT where they do deals). Comma-separated, e.g. 'AZ,TX'. Use MSA filter for geographic activity."),
+    msas: z.string().optional().describe("Semicolon-separated MSA names (use ; because MSA names contain commas), e.g. 'Los Angeles-Long Beach-Anaheim, CA; Dallas-Fort Worth-Arlington, TX'. When user says a city like 'LA' or 'Phoenix', use the full MSA name."),
+    minLoans: z.coerce.number().optional().describe("Minimum total loan count"),
+    maxLoans: z.coerce.number().optional().describe("Maximum total loan count"),
+    minBridgeLoans: z.coerce.number().optional().describe("Minimum bridge loan count"),
+    minDscrLoans: z.coerce.number().optional().describe("Minimum DSCR loan count"),
+    hasPhone: z.boolean().optional().describe("Require phone number"),
+    hasEmail: z.boolean().optional().describe("Require email address"),
+    verifiedPhone: z.boolean().optional().describe("Require verified phone number"),
+    startDate: z.string().optional().describe("Start date for activity window, e.g. '2024-01-01'"),
+    endDate: z.string().optional().describe("End date for activity window"),
+    nextDueStart: z.string().optional().describe("Earliest loan maturity date, e.g. '2025-01-01'. Filters borrowers whose next maturing loan is on or after this date."),
+    nextDueEnd: z.string().optional().describe("Latest loan maturity date, e.g. '2025-12-31'. Filters borrowers whose next maturing loan is on or before this date. Use with nextDueStart for 'maturing in next 6 months' queries."),
+    ordering: z.string().optional().describe("Sort field: 'num_loans', 'borrower_name', or 'most_recent_recording_date'. Prefix with - for descending, e.g. '-num_loans'"),
+    page: z.coerce.number().default(1),
+    pageSize: z.coerce.number().default(25).describe("Results per page (default 25, max 25)"),
+});
+export function registerBorrowerSearchTool(server, plr) {
+    registerToolSafe(server, "plr_borrower_search", {
+        title: "Build targeted borrower lists with advanced filters (PLR)",
+        description: "The most flexible borrower search — filter by loan count (min/max), loan type (bridge/DSCR), " +
+            "geography (state/MSA), contact availability (phone/email/verified), activity window, " +
+            "and loan maturity dates (nextDueStart/nextDueEnd for 'loans maturing soon' queries). " +
+            "Best for 'top borrowers in [city/MSA]' queries and building targeted outreach lists. " +
+            "Defaults to last 1 year if no dates provided. " +
+            "Different from plr_borrower_rankings (growth trends) and plr_top_borrowers (nationwide only, no MSA). " +
+            "CHAIN: borrower names -> plr_borrower_loans (lender details) -> plr_borrower_contacts (phone/email/principals).",
+        inputSchema: Input,
+    }, async (args) => {
+        const body = {
+            page: args.page,
+            page_size: Math.min(args.pageSize, 25),
+        };
+        if (args.search)
+            body.search = args.search;
+        if (args.states)
+            body.states = args.states.split(",").map((s) => s.trim());
+        if (args.msas)
+            body.msas = args.msas.split(";").map((s) => s.trim());
+        if (args.minLoans !== undefined)
+            body.min_loans = args.minLoans;
+        if (args.maxLoans !== undefined)
+            body.max_loans = args.maxLoans;
+        if (args.minBridgeLoans !== undefined)
+            body.min_bridge_loans = args.minBridgeLoans;
+        if (args.minDscrLoans !== undefined)
+            body.min_dscr_loans = args.minDscrLoans;
+        if (args.hasPhone !== undefined)
+            body.has_phone = args.hasPhone;
+        if (args.hasEmail !== undefined)
+            body.has_email = args.hasEmail;
+        if (args.verifiedPhone !== undefined)
+            body.verified_phone = args.verifiedPhone;
+        if (args.startDate)
+            body.start_date = args.startDate;
+        if (args.endDate)
+            body.end_date = args.endDate;
+        if (args.nextDueStart)
+            body.next_due_start = args.nextDueStart;
+        if (args.nextDueEnd)
+            body.next_due_end = args.nextDueEnd;
+        if (args.ordering)
+            body.ordering = args.ordering;
+        autoFillPlrDates(body);
+        const data = await plr.borrowerListBuilder(body);
+        const items = data?.results ?? data?.data ?? (Array.isArray(data) ? data : []);
+        const total = data?.count ?? items.length;
+        const lines = [
+            `## Borrower Search Results`,
+            `**Total:** ${total} borrowers | **Page:** ${args.page} | **Showing:** ${items.length}`,
+            "",
+        ];
+        if (items.length > 0) {
+            const rows = items.slice(0, 25).map((b) => [
+                b.borrower_name ?? "—",
+                b.state ?? "—",
+                b.num_loans ?? "—",
+                b.bridge_loans ?? "—",
+                b.dscr_loans ?? "—",
+                fmtDollars(b.total_volume ?? b.volume),
+                b.first_phone ? "Y" : "N",
+                b.first_email ? "Y" : "N",
+                b.most_recent_recording_date ?? b.last_recording_date ?? "—",
+            ]);
+            lines.push(markdownTable(["Borrower", "Entity State", "Loans", "Bridge", "DSCR", "Volume", "Phone", "Email", "Last Active"], rows));
+        }
+        else {
+            lines.push("_No borrowers found matching criteria._ " +
+                "Try relaxing filters: lower minBridgeLoans, widen date range, or check MSA name spelling. " +
+                "Use plr_msa_rankings to discover correct PLR MSA names (different from SFR MSA names).");
+            if (typeof data === "object" && !Array.isArray(data)) {
+                lines.push("```json");
+                lines.push(truncatedJson(data, 2000));
+                lines.push("```");
+            }
+        }
+        // Slim items for structured output — raw API items contain huge MSA/zip/address arrays
+        const slimItems = items.slice(0, 25).map((b) => ({
+            borrower_name: b.borrower_name,
+            state: b.state,
+            num_loans: b.num_loans,
+            bridge_loans: b.bridge_loans,
+            dscr_loans: b.dscr_loans,
+            has_phone: !!b.first_phone,
+            has_email: !!b.first_email,
+            total_volume: b.total_volume ?? b.volume ?? undefined,
+            verified_phone: b.has_good_phone ?? false,
+            last_active: b.most_recent_recording_date ?? b.last_recording_date,
+            most_active_msa: b.most_active_msa,
+            owner_name: b.owner_name,
+        }));
+        const firstName = items[0]?.borrower_name;
+        const actions = [
+            ...(firstName ? [action("plr_borrower_profile", "Full profile for top result", { borrowerName: firstName })] : []),
+            ...(firstName ? [action("plr_borrower_loans", "Loan history for top result", { borrowerNames: firstName })] : []),
+            ...(firstName ? [action("plr_borrower_contacts", "Contact info for top result", { borrowerNames: firstName })] : []),
+        ];
+        return structuredResult(lines.join("\n"), { items: slimItems, total, page: args.page }, actions);
+    });
+}
+//# sourceMappingURL=borrowerSearch.js.map

package/dist/tools/plr/borrowerSearch.js.map

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

package/dist/tools/plr/churnedBorrowers.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { PlrClient } from "../../services/plr.js";
+export declare function registerChurnedBorrowersTool(server: McpServer, plr: PlrClient): void;

package/dist/tools/plr/churnedBorrowers.js

@@ -0,0 +1,86 @@
+import { z } from "zod";
+import { structuredResult, markdownTable, fmtDollars } from "../formatters.js";
+import { registerToolSafe } from "../registerToolSafe.js";
+import { action } from "../nextActions.js";
+const Input = z.object({
+    lenders: z
+        .string()
+        .describe("Comma-separated lender names. Use short names from the 'lender' field (e.g. 'Dominion'), not display 'clean_name' (e.g. 'Dominion Financial Services')"),
+    search: z.string().optional().describe("Search within churned borrower names"),
+    page: z.coerce.number().default(1).describe("Page number (default 1)"),
+    pageSize: z.coerce.number().default(25).describe("Results per page (default 25, max 25)"),
+});
+export function registerChurnedBorrowersTool(server, plr) {
+    registerToolSafe(server, "plr_churned_borrowers", {
+        title: "Find churned borrowers (PLR)",
+        description: "Find borrowers who have LEFT a specific lender (churned to a competitor). " +
+            "Returns their current lender, loan recency (1/2/3yr), contact info, and owner names. " +
+            "Essential for competitive intelligence and win-back campaigns. " +
+            "For current borrowers, use plr_lender_borrowers instead. " +
+            "CHAIN: To check if churned borrowers are in distress, pass names as owner_name to sfr_distress_search.",
+        inputSchema: Input,
+    }, async (args) => {
+        const body = {
+            lenders: args.lenders.split(",").map((s) => s.trim()),
+            page: args.page,
+            page_size: Math.min(args.pageSize, 25),
+        };
+        if (args.search)
+            body.search = args.search;
+        const data = await plr.churnedBorrowers(body);
+        const items = data?.results ?? data?.data ?? (Array.isArray(data) ? data : []);
+        const total = data?.count ?? items.length;
+        const lines = [
+            `## Churned Borrowers — ${args.lenders}`,
+            `**Total:** ${total} | **Page:** ${args.page} | **Showing:** ${items.length}`,
+            "",
+        ];
+        if (items.length > 0) {
+            const rows = items.slice(0, 25).map((b) => [
+                b.borrower ?? b.borrower_name ?? "—",
+                b.last_lender ?? "—",
+                b.total_number_of_loans ?? "—",
+                fmtDollars(b.total_origination_volume),
+                b.loans_in_last_1_year ?? "—",
+                b.loans_in_last_2_years ?? "—",
+                b.loans_in_last_3_years ?? "—",
+                b.first_phone ? "Y" : "N",
+                b.first_email ? "Y" : "N",
+            ]);
+            lines.push(markdownTable(["Borrower", "Current Lender", "Loans", "Volume", "1yr", "2yr", "3yr", "Phone", "Email"], rows));
+        }
+        else {
+            lines.push("_No churned borrowers found._ " +
+                "Verify the lender name uses the short 'lender' field format (e.g. 'Kiavi' not 'Kiavi Funding Inc'). " +
+                "Use plr_lender_rankings to discover correct lender names.");
+        }
+        // Slim items — raw API has 5 owner_name fields, 3 phone fields, 3 email fields
+        const slimItems = items.slice(0, 25).map((b) => {
+            const owners = [b.owner_name_1, b.owner_name_2, b.owner_name_3, b.owner_name_4, b.owner_name_5]
+                .filter(Boolean);
+            return {
+                borrower: b.borrower ?? b.borrower_name,
+                last_lender: b.last_lender,
+                total_loans: b.total_number_of_loans,
+                total_volume: b.total_origination_volume,
+                last_origination_date: b.last_origination_date,
+                loans_1yr: b.loans_in_last_1_year,
+                loans_2yr: b.loans_in_last_2_years,
+                loans_3yr: b.loans_in_last_3_years,
+                lenders_used: b.lenders_used,
+                owners: owners.length > 0 ? owners : undefined,
+                phone: b.first_phone || undefined,
+                verified_phone: b.has_good_phone_transform ?? false,
+                email: b.first_email || undefined,
+            };
+        });
+        const firstName = items[0]?.borrower ?? items[0]?.borrower_name;
+        const actions = [
+            ...(firstName ? [action("plr_borrower_profile", "Profile top churned borrower", { borrowerName: firstName })] : []),
+            ...(firstName ? [action("plr_borrower_contacts", "Contact info for outreach", { borrowerNames: firstName })] : []),
+            action("plr_lender_borrowers", "Current borrowers for comparison", { lenders: args.lenders }),
+        ];
+        return structuredResult(lines.join("\n"), { items: slimItems, total, page: args.page }, actions);
+    });
+}
+//# sourceMappingURL=churnedBorrowers.js.map

package/dist/tools/plr/churnedBorrowers.js.map

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

package/dist/tools/plr/lenderBorrowers.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { PlrClient } from "../../services/plr.js";
+export declare function registerLenderBorrowersTool(server: McpServer, plr: PlrClient): void;

package/dist/tools/plr/lenderBorrowers.js

@@ -0,0 +1,71 @@
+import { z } from "zod";
+import { structuredResult, markdownTable, fmtDollars } from "../formatters.js";
+import { registerToolSafe } from "../registerToolSafe.js";
+import { autoFillPlrDates } from "../dateHelper.js";
+import { action } from "../nextActions.js";
+const Input = z.object({
+    lenders: z.string().describe("Comma-separated lender names. Use short names from 'lender' field (e.g. 'Kiavi,Lima One'), not display 'clean_name'"),
+    search: z.string().optional().describe("Search within borrower names"),
+    states: z.string().optional().describe("Comma-separated state filter (filters by entity registration state, not loan geography — results may include entities registered in a state but doing deals elsewhere)"),
+    startDate: z.string().optional().describe("Start date, e.g. '2024-01-01'"),
+    endDate: z.string().optional().describe("End date"),
+    page: z.coerce.number().default(1).describe("Page number (default 1)"),
+    pageSize: z.coerce.number().default(25).describe("Results per page (default 25, max 25)"),
+});
+export function registerLenderBorrowersTool(server, plr) {
+    registerToolSafe(server, "plr_lender_borrowers", {
+        title: "Borrowers of a specific lender (PLR)",
+        description: "Find all borrowers who have taken loans from specific lenders. " +
+            "Returns borrower names, loan counts, and amounts for each lender's customer base. " +
+            "Complementary to plr_churned_borrowers (which shows borrowers who LEFT a lender). " +
+            "CHAIN: To find borrowers in distress, pass names as owner_name to sfr_distress_search.",
+        inputSchema: Input,
+    }, async (args) => {
+        const body = {
+            lenders: args.lenders.split(",").map((s) => s.trim()),
+            page: args.page,
+            page_size: Math.min(args.pageSize, 25),
+        };
+        if (args.search)
+            body.search = args.search;
+        if (args.states)
+            body.states = args.states.split(",").map((s) => s.trim());
+        if (args.startDate)
+            body.start_date = args.startDate;
+        if (args.endDate)
+            body.end_date = args.endDate;
+        autoFillPlrDates(body);
+        const data = await plr.lenderBorrowers(body);
+        const items = data?.results ?? data?.data ?? (Array.isArray(data) ? data : []);
+        const total = data?.count ?? items.length;
+        const filters = [args.states, args.search].filter(Boolean);
+        const filterLabel = filters.length > 0 ? ` (${filters.join(", ")})` : "";
+        const lines = [
+            `## Lender Borrowers — ${args.lenders}${filterLabel}`,
+            `**Total:** ${total} | **Page:** ${args.page} | **Showing:** ${items.length}`,
+            "",
+        ];
+        if (items.length > 0) {
+            const rows = items.slice(0, 25).map((b) => [
+                b.buyer_borrower1_name ?? b.borrower_name ?? "—",
+                b.num_loans ?? b.loan_count ?? "—",
+                fmtDollars(b.volume),
+            ]);
+            lines.push(markdownTable(["Borrower", "Loans", "Volume"], rows));
+        }
+        else {
+            lines.push("_No borrowers found for these lenders._ " +
+                "Verify the lender name uses the short 'lender' field format (e.g. 'Kiavi' not 'Kiavi Funding Inc'). " +
+                "Use plr_lender_rankings to discover correct lender names. " +
+                "Note: the states filter applies to entity registration state, not loan geography.");
+        }
+        const firstName = items[0]?.buyer_borrower1_name ?? items[0]?.borrower_name;
+        const actions = [
+            ...(firstName ? [action("plr_borrower_profile", "Profile top borrower", { borrowerName: firstName })] : []),
+            ...(firstName ? [action("plr_borrower_contacts", "Contact info for top borrower", { borrowerNames: firstName })] : []),
+            action("plr_churned_borrowers", "Borrowers who left this lender", { lenders: args.lenders }),
+        ];
+        return structuredResult(lines.join("\n"), { items, total, page: args.page }, actions);
+    });
+}
+//# sourceMappingURL=lenderBorrowers.js.map

package/dist/tools/plr/lenderBorrowers.js.map

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

package/dist/tools/plr/lenderRankings.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { PlrClient } from "../../services/plr.js";
+export declare function registerLenderRankingsTool(server: McpServer, plr: PlrClient): void;

package/dist/tools/plr/lenderRankings.js

@@ -0,0 +1,74 @@
+import { z } from "zod";
+import { structuredResult, markdownTable, truncatedJson, fmtDollars } from "../formatters.js";
+import { registerToolSafe } from "../registerToolSafe.js";
+import { autoFillPlrDates } from "../dateHelper.js";
+import { action } from "../nextActions.js";
+const Input = z.object({
+    search: z.string().optional().describe("Search text for lender name (matches both short 'lender' and display 'clean_name')"),
+    startDate: z.string().optional().describe("Start date, e.g. '2024-01-01'"),
+    endDate: z.string().optional().describe("End date"),
+    loanTypes: z.string().optional().describe("Loan types filter: 'DSCR', 'Bridge', 'Unknown'"),
+    ordering: z.string().optional().describe("Sort field, e.g. '-current_count'"),
+    page: z.coerce.number().default(1).describe("Page number (default 1)"),
+    pageSize: z.coerce.number().default(25).describe("Results per page (default 25, max 25)"),
+});
+export function registerLenderRankingsTool(server, plr) {
+    registerToolSafe(server, "plr_lender_rankings", {
+        title: "Rank lenders by loan COUNT — nationwide only (PLR)",
+        description: "Rank private lenders NATIONWIDE by number of loans originated. " +
+            "Filters: loan type, date range, and search text only — NO geographic filters. " +
+            "For lender rankings WITH geographic filters (state/MSA), use plr_top_lenders instead. " +
+            "Returns lender names, loan counts, volumes, avg loan size, and HQ location. " +
+            "To see a lender's borrowers, use plr_lender_borrowers.",
+        inputSchema: Input,
+    }, async (args) => {
+        const body = {
+            page: args.page,
+            page_size: Math.min(args.pageSize, 25),
+        };
+        if (args.search)
+            body.search = args.search;
+        if (args.startDate)
+            body.start_date = args.startDate;
+        if (args.endDate)
+            body.end_date = args.endDate;
+        if (args.loanTypes)
+            body.loan_types = args.loanTypes.split(",").map((s) => s.trim());
+        if (args.ordering)
+            body.ordering = args.ordering;
+        autoFillPlrDates(body);
+        const data = await plr.lenderRankings(body);
+        const items = data?.results ?? data?.data ?? (Array.isArray(data) ? data : []);
+        const total = data?.count ?? items.length;
+        const lines = [
+            `## Lender Rankings`,
+            `**Total:** ${total} lenders | **Page:** ${args.page}`,
+            "",
+        ];
+        if (items.length > 0) {
+            const rows = items.slice(0, 25).map((l, i) => [
+                i + 1 + (args.page - 1) * args.pageSize,
+                l.clean_name ?? l.lender ?? "—",
+                l.loan_count != null ? Number(l.loan_count).toLocaleString() : "—",
+                fmtDollars(l.total_volume),
+                fmtDollars(l.avg_loan_amount),
+                l.headquarters_location ?? "—",
+            ]);
+            lines.push(markdownTable(["#", "Lender", "Loans", "Volume", "Avg Loan", "HQ"], rows));
+        }
+        else {
+            lines.push("_No lenders found._");
+            lines.push("```json");
+            lines.push(truncatedJson(data, 2000));
+            lines.push("```");
+        }
+        const firstName = items[0]?.lender ?? items[0]?.clean_name;
+        const actions = [
+            ...(firstName ? [action("plr_lender_borrowers", "Borrowers of top lender", { lenders: firstName })] : []),
+            ...(firstName ? [action("plr_churned_borrowers", "Churned borrowers from top lender", { lenders: firstName })] : []),
+            action("plr_top_lenders", "Rank by volume (with geo filters)", {}),
+        ];
+        return structuredResult(lines.join("\n"), { items, total, page: args.page }, actions);
+    });
+}
+//# sourceMappingURL=lenderRankings.js.map

package/dist/tools/plr/lenderRankings.js.map

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

package/dist/tools/plr/loansNearby.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { PlrClient } from "../../services/plr.js";
+export declare function registerLoansNearbyTool(server: McpServer, plr: PlrClient): void;

package/dist/tools/plr/loansNearby.js

@@ -0,0 +1,113 @@
+import { z } from "zod";
+import { structuredResult, markdownTable } from "../formatters.js";
+import { registerToolSafe } from "../registerToolSafe.js";
+import { autoFillPlrDates } from "../dateHelper.js";
+import { action } from "../nextActions.js";
+const Input = z.object({
+    propertyAddress: z
+        .string()
+        .describe("Full property address, e.g. '123 Main St, Phoenix, AZ 85004'"),
+    radius: z.coerce.number().default(1).describe("Search radius in miles (default 1)"),
+    limit: z.coerce.number().default(25).describe("Maximum results (default 25)"),
+    startDate: z.string().optional().describe("Start date, e.g. '2023-01-01'"),
+    endDate: z.string().optional().describe("End date"),
+});
+export function registerLoansNearbyTool(server, plr) {
+    registerToolSafe(server, "plr_loans_nearby", {
+        title: "Find loans near address (PLR)",
+        description: "Geospatial search: find private lender loans within a radius of an address. " +
+            "Returns each loan with distance, lender, borrower, amount, date, and type. " +
+            "Includes subject property details (AVM, owner, distress flags) when available. " +
+            "Great for understanding local lending activity. " +
+            "For a specific property's lending history, use plr_transaction_history.",
+        inputSchema: Input,
+    }, async (args) => {
+        const query = {
+            property_address: args.propertyAddress,
+            radius: args.radius,
+            limit: args.limit,
+        };
+        if (args.startDate)
+            query.start_date = args.startDate;
+        if (args.endDate)
+            query.end_date = args.endDate;
+        autoFillPlrDates(query);
+        const data = await plr.loansNearby(query);
+        const rawItems = data?.results ?? data?.data ?? (Array.isArray(data) ? data : []);
+        // Deduplicate: API returns duplicate rows (same lender+borrower+address+amount+date)
+        const seen = new Set();
+        const items = rawItems.filter((l) => {
+            const key = `${l.lender}|${l.buyer_borrower1_name}|${l.full_street_address}|${l.mtg_amt ?? l.loan_amount}|${l.recording_date}`;
+            if (seen.has(key))
+                return false;
+            seen.add(key);
+            return true;
+        });
+        const lines = [
+            `## Loans Nearby — ${args.propertyAddress}`,
+            `**Radius:** ${args.radius} mi | **Found:** ${items.length}`,
+            "",
+        ];
+        // Distinguish "address not geocoded" from "no loans in area"
+        if (items.length === 0 && data?.property_details === null) {
+            lines.push("_Could not geocode this address — the property was not found in the SFR database. " +
+                "Try a nearby address or use plr_borrower_search with geographic filters instead._");
+            return structuredResult(lines.join("\n"), { items, total: items.length, page: 1 });
+        }
+        if (items.length > 0) {
+            const fmt$ = (v) => v != null && Number(v) > 0 ? `$${Number(v).toLocaleString()}` : "—";
+            const rows = items.slice(0, 25).map((l) => [
+                l.full_street_address ?? l.address ?? "—",
+                `${l.city ?? ""}, ${l.state ?? ""}`.replace(/^, |, $/, "") || "—",
+                l.lender ?? "—",
+                l.buyer_borrower1_name ?? l.borrower ?? "—",
+                fmt$(l.loan_amount ?? l.mtg_amt),
+                l.recording_date ?? "—",
+            ]);
+            lines.push(markdownTable(["Address", "Location", "Lender", "Borrower", "Amount", "Date"], rows));
+            // Show subject property details if available at top level
+            if (data?.property_details) {
+                lines.push("");
+                lines.push("### Subject Property Details");
+                const pd = data.property_details;
+                const detailLines = [
+                    pd.avm_value ? `**AVM:** $${Number(pd.avm_value).toLocaleString()}` : null,
+                    pd.market_value ? `**Market Value:** $${Number(pd.market_value).toLocaleString()}` : null,
+                    pd.owner ? `**Owner:** ${pd.owner}` : null,
+                    pd.owner_occupied != null ? `**Owner Occupied:** ${pd.owner_occupied}` : null,
+                    pd.pfc_flag ? `**Pre-Foreclosure:** Yes (${pd.pfc_recording_date ?? ""})` : null,
+                    pd.vacant_flag ? `**Vacant:** Yes` : null,
+                ].filter(Boolean);
+                lines.push(detailLines.join(" | "));
+            }
+        }
+        else {
+            lines.push("_No loans found within radius._");
+        }
+        // Slim items for structured output
+        const slimItems = items.slice(0, 25).map((l) => ({
+            address: l.full_street_address,
+            city: l.city,
+            state: l.state,
+            zip: l.zip_code,
+            lender: l.lender,
+            borrower: l.buyer_borrower1_name,
+            amount: l.mtg_amt ?? l.loan_amount,
+            recording_date: l.recording_date,
+            loan_type: l.loan_type ?? l.land_use_category,
+        }));
+        const firstBorrower = items[0]?.buyer_borrower1_name ?? items[0]?.borrower;
+        const actions = [
+            ...(firstBorrower ? [action("plr_borrower_profile", "Profile nearest borrower", { borrowerName: firstBorrower })] : []),
+            action("sfr_get_property", "Full property details", { address: args.propertyAddress }),
+            action("plr_transaction_history", "Property lending history", { propertyAddress: args.propertyAddress }),
+        ];
+        return structuredResult(lines.join("\n"), {
+            items: slimItems,
+            total: items.length,
+            deduped: rawItems.length - items.length > 0 ? rawItems.length - items.length : undefined,
+            page: 1,
+        }, actions);
+    });
+}
+//# sourceMappingURL=loansNearby.js.map

package/dist/tools/plr/loansNearby.js.map

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

package/dist/tools/plr/marketTrends.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { PlrClient } from "../../services/plr.js";
+export declare function registerMarketTrendsTool(server: McpServer, plr: PlrClient): void;