@sfranalytics/mcp 0.6.0

package/dist/tools/plr/borrowerContacts.js

@@ -0,0 +1,73 @@
+import { z } from "zod";
+import { structuredResult, markdownTable, truncatedJson } from "../formatters.js";
+import { registerToolSafe } from "../registerToolSafe.js";
+import { action } from "../nextActions.js";
+const Input = z.object({
+    borrowerNames: z.string().describe("Comma-separated borrower entity names — use EXACT names from search results (typically UPPERCASE, e.g. 'VAPA INVESTMENTS LLC')"),
+    state: z.string().optional().describe("Optional state filter"),
+    page: z.coerce.number().default(1),
+    pageSize: z.coerce.number().default(10).describe("Results per page (default 10, max 25)"),
+});
+export function registerBorrowerContactsTool(server, plr) {
+    registerToolSafe(server, "plr_borrower_contacts", {
+        title: "Borrower contact information (PLR)",
+        description: "Get contact information (phone, email, principal names) for specific borrowers. " +
+            "Returns verified phone numbers, email addresses, and up to 5 associated principals/owners. " +
+            "Use after plr_borrower_search or plr_borrower_loans for outreach details. " +
+            "Accepts multiple comma-separated borrower names for batch lookups.",
+        inputSchema: Input,
+    }, async (args) => {
+        // API requires borrower_names as a JSON-encoded array in query param
+        const names = args.borrowerNames.split(",").map((s) => s.trim());
+        const query = {
+            borrower_names: JSON.stringify(names),
+            page: args.page,
+            page_size: Math.min(args.pageSize, 25),
+        };
+        if (args.state)
+            query.state = args.state;
+        const data = await plr.borrowerContacts(query);
+        const items = data?.results ?? data?.data ?? (Array.isArray(data) ? data : []);
+        const lines = [
+            `## Borrower Contacts — ${args.borrowerNames}`,
+            `**Results:** ${items.length}`,
+            "",
+        ];
+        if (items.length > 0) {
+            const rows = items.slice(0, 20).map((c) => [
+                c.buyer_borrower1_name ?? c.borrower_name ?? "—",
+                c.owner_name ?? "—",
+                c.first_phone ?? "—",
+                c.has_good_phone ? "Verified" : "—",
+                c.first_email ?? "—",
+                c.most_active_msa ?? "—",
+            ]);
+            lines.push(markdownTable(["Borrower", "Owner/Principal", "Phone", "Phone Status", "Email", "Most Active MSA"], rows));
+            // Show social links if available
+            for (const c of items.slice(0, 5)) {
+                const socials = [];
+                if (c.linkedin_urls?.length)
+                    socials.push(`LinkedIn: ${c.linkedin_urls[0]}`);
+                if (c.facebook_urls?.length)
+                    socials.push(`Facebook: ${c.facebook_urls[0]}`);
+                if (c.instagram_urls?.length)
+                    socials.push(`Instagram: ${c.instagram_urls[0]}`);
+                if (socials.length > 0) {
+                    lines.push(`\n**${c.buyer_borrower1_name ?? "—"} socials:** ${socials.join(" | ")}`);
+                }
+            }
+        }
+        else {
+            lines.push("```json");
+            lines.push(truncatedJson(data, 3000));
+            lines.push("```");
+        }
+        const firstName = args.borrowerNames.split(",")[0].trim();
+        const actions = [
+            action("plr_borrower_profile", "Full borrower profile", { borrowerName: firstName }),
+            action("plr_borrower_loans", "Loan history", { borrowerNames: firstName }),
+        ];
+        return structuredResult(lines.join("\n"), { items: items, total: items.length, page: args.page }, actions);
+    });
+}
+//# sourceMappingURL=borrowerContacts.js.map

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

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

package/dist/tools/plr/borrowerLoans.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 registerBorrowerLoansTool(server: McpServer, plr: PlrClient): void;

package/dist/tools/plr/borrowerLoans.js

@@ -0,0 +1,115 @@
+import { z } from "zod";
+import { structuredResult, markdownTable, truncatedJson } from "../formatters.js";
+import { registerToolSafe } from "../registerToolSafe.js";
+import { action } from "../nextActions.js";
+const Input = z.object({
+    borrowerNames: z.string().describe("Comma-separated borrower entity names — use EXACT names from search results (typically UPPERCASE, e.g. 'VAPA INVESTMENTS LLC')"),
+    states: z.string().optional().describe("Comma-separated state filter"),
+    outstandingOnly: z.boolean().optional().describe("Filter to only outstanding (active) loans. Useful for current exposure analysis."),
+    maturityDateBefore: z.string().optional().describe("Filter loans with maturity date before this date, e.g. '2026-12-31'"),
+    maturityDateAfter: z.string().optional().describe("Filter loans with maturity date after this date, e.g. '2026-01-01'"),
+    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 registerBorrowerLoansTool(server, plr) {
+    registerToolSafe(server, "plr_borrower_loans", {
+        title: "Loans for specific borrower(s) (PLR)",
+        description: "Get individual loan records for one or more borrowers. Returns each loan with " +
+            "lender, amount, property address, recording date, loan type, maturity date, and outstanding status. " +
+            "Use after plr_borrower_search to see which lenders a borrower uses. " +
+            "Filter to active loans only with outstandingOnly=true, and by maturity window with maturityDateBefore/maturityDateAfter. " +
+            "For contact info (phone/email), chain to plr_borrower_contacts.",
+        inputSchema: Input,
+    }, async (args) => {
+        const body = {
+            borrower_names: args.borrowerNames.split(",").map((s) => s.trim()),
+            page: args.page,
+            page_size: Math.min(args.pageSize, 25),
+        };
+        if (args.states)
+            body.states = args.states.split(",").map((s) => s.trim());
+        const columnFilters = [];
+        if (args.outstandingOnly) {
+            columnFilters.push({ type: "boolean", column: "is_loan_outstanding", operator: "is true" });
+        }
+        if (args.maturityDateBefore) {
+            columnFilters.push({
+                type: "date",
+                column: "first_mtg_due_date",
+                operator: "is before",
+                value: args.maturityDateBefore,
+            });
+        }
+        if (args.maturityDateAfter) {
+            columnFilters.push({
+                type: "date",
+                column: "first_mtg_due_date",
+                operator: "is after",
+                value: args.maturityDateAfter,
+            });
+        }
+        if (columnFilters.length > 0) {
+            body.column_filters = {
+                filters: columnFilters,
+                operators: Array(Math.max(0, columnFilters.length - 1)).fill("AND"),
+            };
+        }
+        const data = await plr.borrowerLoans(body);
+        const items = data?.results ?? data?.data ?? (Array.isArray(data) ? data : []);
+        const total = data?.count ?? items.length;
+        const lines = [
+            `## Borrower Loans — ${args.borrowerNames}`,
+            `**Total:** ${total} | **Page:** ${args.page} | **Showing:** ${items.length}`,
+            "",
+        ];
+        if (items.length > 0) {
+            const rows = items.slice(0, 25).map((l) => [
+                l.full_street_address ?? l.address ?? "—",
+                l.city ?? "—",
+                l.state ?? "—",
+                l.lender ?? "—",
+                l.mtg_amt ? `$${Number(l.mtg_amt).toLocaleString()}` : "—",
+                (l.mtg_amt && l.sale_amt && Number(l.sale_amt) > 0) ? ((Number(l.mtg_amt) / Number(l.sale_amt)) * 100).toFixed(1) + "%" : "—",
+                l.recording_date ?? "—",
+                l.loan_type ?? "—",
+            ]);
+            lines.push(markdownTable(["Address", "City", "State", "Lender", "Amount", "LTC", "Date", "Type"], rows));
+            // Average LTC ratio
+            const loansWithLtc = items.slice(0, 25).filter((l) => l.mtg_amt && l.sale_amt && Number(l.sale_amt) > 0);
+            if (loansWithLtc.length > 0) {
+                const avgLtc = loansWithLtc.reduce((sum, l) => sum + Number(l.mtg_amt) / Number(l.sale_amt), 0) / loansWithLtc.length;
+                lines.push("", `**Avg LTC:** ${(avgLtc * 100).toFixed(1)}% (across ${loansWithLtc.length} loans with both amounts)`);
+            }
+        }
+        else {
+            lines.push("```json");
+            lines.push(truncatedJson(data, 3000));
+            lines.push("```");
+        }
+        // Slim items — raw API has 25+ fields, most null (resale, refi, assignment, etc.)
+        const slimItems = items.slice(0, 25).map((l) => ({
+            address: l.full_street_address ?? l.address,
+            city: l.city,
+            state: l.state,
+            zip: l.zip_code,
+            msa: l.msa,
+            lender: l.lender,
+            amount: l.mtg_amt,
+            recording_date: l.recording_date,
+            loan_type: l.loan_type,
+            is_outstanding: l.is_loan_outstanding ?? undefined,
+            maturity_date: l.first_mtg_due_date ?? undefined,
+            sale_amt: l.sale_amt ?? undefined,
+            ltc_ratio: (l.mtg_amt && l.sale_amt && Number(l.sale_amt) > 0) ? +(Number(l.mtg_amt) / Number(l.sale_amt)).toFixed(3) : undefined,
+        }));
+        const firstName = args.borrowerNames.split(",")[0].trim();
+        const firstAddr = items[0] ? `${items[0].full_street_address ?? items[0].address}, ${items[0].city}, ${items[0].state} ${items[0].zip_code}` : undefined;
+        const actions = [
+            action("plr_borrower_profile", "Full borrower profile", { borrowerName: firstName }),
+            action("plr_borrower_contacts", "Contact information", { borrowerNames: firstName }),
+            ...(firstAddr ? [action("sfr_get_property", "Property details for first loan", { address: firstAddr })] : []),
+        ];
+        return structuredResult(lines.join("\n"), { items: slimItems, total, page: args.page }, actions);
+    });
+}
+//# sourceMappingURL=borrowerLoans.js.map

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

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

package/dist/tools/plr/borrowerProfile.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 registerBorrowerProfileTool(server: McpServer, plr: PlrClient): void;

package/dist/tools/plr/borrowerProfile.js

@@ -0,0 +1,201 @@
+import { z } from "zod";
+import { structuredResult, markdownTable, kvSummary, fmtDollars } from "../formatters.js";
+import { registerToolSafe } from "../registerToolSafe.js";
+import { action } from "../nextActions.js";
+const Input = z.object({
+    borrowerName: z.string().describe("Borrower entity name — use EXACT name from search results (typically UPPERCASE, e.g. 'VAPA INVESTMENTS LLC')"),
+    state: z.string().optional().describe("Optional state filter, e.g. 'CA'"),
+});
+export function registerBorrowerProfileTool(server, plr) {
+    registerToolSafe(server, "plr_borrower_profile", {
+        title: "Comprehensive borrower profile — loans, lenders & contacts (PLR)",
+        description: "Get a comprehensive profile of a private lending borrower by name. " +
+            "Returns loan history, lender relationships, geographic activity, contact info, " +
+            "and loan type breakdowns (bridge/DSCR). " +
+            "Use plr_borrower_search first to discover borrower names." +
+            " See plr_borrower_loans for detailed loan list and plr_borrower_contacts for contact information.",
+        inputSchema: Input,
+    }, async (args) => {
+        const query = {
+            borrower_name: args.borrowerName,
+        };
+        if (args.state)
+            query.state = args.state;
+        const data = await plr.borrowerProfile(query);
+        // If the profile API succeeds, format normally
+        if (!data?.error) {
+            return formatProfileResponse(args, data);
+        }
+        // Profile API has a known backend bug — fall back to loans + contacts
+        return compositeFallback(plr, args);
+    });
+}
+/** Format a successful profile API response */
+function formatProfileResponse(args, data) {
+    const items = data?.results ?? [];
+    const total = data?.count ?? items.length;
+    const lines = [`## Borrower Profile — ${args.borrowerName}`, ""];
+    lines.push(`**Total Loan Records:** ${total}`);
+    lines.push(`**Borrower:** ${data?.borrower ?? args.borrowerName}`);
+    lines.push("");
+    if (items.length > 0) {
+        const fmt$ = (v) => v != null ? `$${Number(v).toLocaleString()}` : "—";
+        const rows = items.slice(0, 15).map((r) => [
+            r.recording_date ?? r.max_recording_date ?? "—",
+            r.lender ?? "—",
+            fmt$(r.mortgage_amt),
+            r.num_properties ?? "—",
+            r.first_mtg_term ? `${r.first_mtg_term}mo` : "—",
+        ]);
+        lines.push(markdownTable(["Date", "Lender", "Amount", "Properties", "Term"], rows));
+    }
+    else {
+        lines.push("_No loan records found for this borrower._");
+    }
+    const actions = [
+        action("plr_borrower_loans", "Full loan history", { borrowerNames: args.borrowerName }),
+        action("plr_borrower_contacts", "Contact information", { borrowerNames: args.borrowerName }),
+    ];
+    const structured = {
+        borrower: data?.borrower ?? args.borrowerName,
+        count: total,
+        results: items.slice(0, 15).map((r) => ({
+            recording_date: r.recording_date ?? r.max_recording_date,
+            lender: r.lender,
+            mortgage_amt: r.mortgage_amt,
+            num_properties: r.num_properties,
+            first_mtg_term: r.first_mtg_term,
+        })),
+    };
+    return structuredResult(lines.join("\n"), structured, actions);
+}
+/** Build a composite profile from borrowerLoans + borrowerContacts */
+async function compositeFallback(plr, args) {
+    const name = args.borrowerName;
+    const loansBody = {
+        borrower_names: [name],
+        page: 1,
+        page_size: 100,
+    };
+    if (args.state)
+        loansBody.states = [args.state];
+    // Fetch loans and contacts in parallel
+    const [loansData, contactsData] = await Promise.all([
+        plr.borrowerLoans(loansBody),
+        plr.borrowerContacts({
+            borrower_names: JSON.stringify([name]),
+        }),
+    ]);
+    const loans = loansData?.results ?? [];
+    const totalLoans = loansData?.count ?? loans.length;
+    const contact = (contactsData?.results ?? [])[0];
+    if (totalLoans === 0 && !contact) {
+        const lines = [
+            `## Borrower Profile — ${name}`,
+            "",
+            "_No data found for this borrower. Check spelling or use plr_borrower_search to find similar names._",
+        ];
+        return structuredResult(lines.join("\n"), { borrower: name, error: "not_found" });
+    }
+    // Aggregate stats from loan records
+    const lenderSet = new Set();
+    const stateSet = new Set();
+    const msaSet = new Set();
+    let bridgeCount = 0;
+    let dscrCount = 0;
+    let totalVolume = 0;
+    for (const l of loans) {
+        if (l.lender)
+            lenderSet.add(l.lender);
+        if (l.state)
+            stateSet.add(l.state);
+        if (l.msa)
+            msaSet.add(l.msa);
+        if (l.loan_type === "Bridge")
+            bridgeCount++;
+        if (l.loan_type === "DSCR")
+            dscrCount++;
+        totalVolume += Number(l.mtg_amt) || 0;
+    }
+    const lenders = [...lenderSet];
+    const states = [...stateSet].sort();
+    const msas = [...msaSet].sort();
+    const lines = [`## Borrower Profile — ${name}`, ""];
+    lines.push(kvSummary([
+        ["Total Loans", totalLoans],
+        ["Bridge Loans", bridgeCount || undefined],
+        ["DSCR Loans", dscrCount || undefined],
+        ["Total Volume (sampled)", totalVolume > 0 ? fmtDollars(totalVolume) : undefined],
+        ["Lenders Used", lenders.length > 0 ? `${lenders.length} (${lenders.slice(0, 5).join(", ")}${lenders.length > 5 ? "..." : ""})` : undefined],
+        ["States", states.join(", ") || undefined],
+    ]));
+    lines.push("");
+    // Contact info
+    if (contact) {
+        const contactPairs = [];
+        if (contact.owner_name)
+            contactPairs.push(["Owner", contact.owner_name]);
+        if (contact.first_phone)
+            contactPairs.push(["Phone", `${contact.first_phone}${contact.has_good_phone ? " (verified)" : ""}`]);
+        if (contact.second_phone)
+            contactPairs.push(["Phone 2", contact.second_phone]);
+        if (contact.first_email)
+            contactPairs.push(["Email", contact.first_email]);
+        if (contact.most_active_msa)
+            contactPairs.push(["Primary MSA", contact.most_active_msa]);
+        if (contactPairs.length > 0) {
+            lines.push("### Contact");
+            lines.push(kvSummary(contactPairs));
+            lines.push("");
+        }
+    }
+    // Recent loans table
+    if (loans.length > 0) {
+        lines.push("### Recent Loans");
+        const fmt$ = (v) => v != null ? `$${Number(v).toLocaleString()}` : "—";
+        const rows = loans.slice(0, 10).map((l) => [
+            l.recording_date ?? "—",
+            l.lender ?? "—",
+            fmt$(l.mtg_amt),
+            l.loan_type ?? "—",
+            [l.city, l.state].filter(Boolean).join(", ") || "—",
+        ]);
+        lines.push(markdownTable(["Date", "Lender", "Amount", "Type", "Location"], rows));
+    }
+    if (msas.length > 0) {
+        lines.push(`**MSAs:** ${msas.slice(0, 10).join(", ")}${msas.length > 10 ? "..." : ""}`);
+    }
+    const structured = {
+        borrower_name: name,
+        total_loans: totalLoans,
+        bridge_loans: bridgeCount,
+        dscr_loans: dscrCount,
+        total_volume_sampled: totalVolume,
+        lenders,
+        states,
+        msas: msas.slice(0, 20),
+        contact: contact ? {
+            owner: contact.owner_name,
+            phone: contact.first_phone,
+            verified_phone: contact.has_good_phone,
+            email: contact.first_email,
+            primary_msa: contact.most_active_msa,
+        } : null,
+        recent_loans: loans.slice(0, 10).map((l) => ({
+            date: l.recording_date,
+            lender: l.lender,
+            amount: l.mtg_amt,
+            type: l.loan_type,
+            city: l.city,
+            state: l.state,
+        })),
+        source: "composite_fallback",
+    };
+    const actions = [
+        action("plr_borrower_loans", "Full loan history", { borrowerNames: name }),
+        action("plr_borrower_contacts", "Contact information", { borrowerNames: name }),
+        ...(lenders.length > 0 ? [action("plr_lender_borrowers", "Other borrowers of same lender", { lenders: lenders[0] })] : []),
+    ];
+    return structuredResult(lines.join("\n"), structured, actions);
+}
+//# sourceMappingURL=borrowerProfile.js.map

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

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

package/dist/tools/plr/borrowerRankings.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 registerBorrowerRankingsTool(server: McpServer, plr: PlrClient): void;

package/dist/tools/plr/borrowerRankings.js

@@ -0,0 +1,123 @@
+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({
+    search: z.string().optional().describe("Search text for borrower name"),
+    states: z.string().optional().describe("Filter by entity registration state (where LLC is registered). Comma-separated, e.g. 'CA,TX'. Use MSA filter for geographic activity."),
+    msas: z.string().optional().describe("Semicolon-separated MSA names (use ; because MSA names contain commas), e.g. 'Phoenix-Mesa-Chandler, AZ; Dallas-Fort Worth-Arlington, TX'"),
+    startDate: z.string().optional().describe("Start date, e.g. '2024-01-01'"),
+    endDate: z.string().optional().describe("End date"),
+    loanTypes: z.string().optional().describe("Comma-separated: 'Bridge', 'DSCR', 'Unknown'"),
+    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 registerBorrowerRankingsTool(server, plr) {
+    registerToolSafe(server, "plr_borrower_rankings", {
+        title: "Rank borrowers with period-over-period growth (PLR)",
+        description: "Rank borrowers by loan count and volume, showing GROWTH vs. the prior period. " +
+            "Filter by geography (state/MSA), loan type, and date range. " +
+            "Best for 'which borrowers are growing/declining?' — use when growth trends matter. " +
+            "For a simple borrower list by activity (without growth metrics), use plr_borrower_search. " +
+            "Different from plr_top_borrowers which is nationwide-only. " +
+            "CHAIN: Pass borrower names to sfr_distress_search (as owner_name + state) to find distressed properties they own.",
+        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.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());
+        autoFillPlrDates(body);
+        const data = await plr.borrowerRankings(body);
+        const rawItems = data?.results ?? data?.data ?? (Array.isArray(data) ? data : []);
+        // Deduplicate: API returns one row per owner, causing duplicate borrower entries.
+        // Group by borrower name, merge owner names, keep highest loan count row.
+        const seen = new Map();
+        for (const item of rawItems) {
+            const name = item.borrower ?? "";
+            const existing = seen.get(name);
+            if (!existing) {
+                seen.set(name, { ...item, _owners: item.owner_name ? [item.owner_name] : [] });
+            }
+            else {
+                // Merge owner name
+                if (item.owner_name && !existing._owners.includes(item.owner_name)) {
+                    existing._owners.push(item.owner_name);
+                }
+                // Keep the row with more loans
+                if ((item.num_loans ?? 0) > (existing.num_loans ?? 0)) {
+                    const owners = existing._owners;
+                    Object.assign(existing, item);
+                    existing._owners = owners;
+                }
+            }
+        }
+        const items = [...seen.values()];
+        const total = data?.count ?? rawItems.length;
+        const deduped = rawItems.length - items.length;
+        const lines = [
+            `## Borrower Rankings`,
+            `**Total:** ${total} | **Page:** ${args.page} | **Showing:** ${items.length}${deduped > 0 ? ` (${deduped} duplicate owner rows merged)` : ""}`,
+            "",
+        ];
+        if (items.length > 0) {
+            const rows = items.slice(0, 25).map((b, i) => [
+                i + 1 + (args.page - 1) * args.pageSize,
+                b.borrower ?? "—",
+                b.num_loans ?? "—",
+                fmtDollars(b.mortgage_amt),
+                b.num_properties ?? "—",
+                b.last_loan_type ?? "—",
+                Array.isArray(b.states) ? [...new Set(b.states)].join(", ") : "—",
+            ]);
+            lines.push(markdownTable(["#", "Borrower", "Loans", "Volume", "Properties", "Type", "States"], rows));
+        }
+        else {
+            lines.push("_No borrowers found._ " +
+                "Try widening the date range, removing the loanTypes filter, or checking MSA name spelling. " +
+                "Use plr_msa_rankings to discover correct PLR MSA names.");
+        }
+        // Slim items for structured output — cap large arrays (addresses, cities, zips)
+        const capArray = (arr, max = 5) => {
+            if (!Array.isArray(arr))
+                return arr;
+            const unique = [...new Set(arr)];
+            if (unique.length <= max)
+                return unique;
+            return [...unique.slice(0, max), `...and ${unique.length - max} more`];
+        };
+        const slimItems = items.slice(0, 25).map((b) => ({
+            borrower: b.borrower,
+            num_loans: b.num_loans,
+            mortgage_amt: b.mortgage_amt,
+            num_properties: b.num_properties,
+            last_loan_type: b.last_loan_type,
+            states: capArray(b.states),
+            msas: capArray(b.msas),
+            addresses: capArray(b.addresses, 3),
+            cities: capArray(b.cities),
+            owners: b._owners?.length > 0 ? b._owners : undefined,
+        }));
+        const firstName = items[0]?.borrower;
+        const actions = [
+            ...(firstName ? [action("plr_borrower_profile", "Full profile for top borrower", { borrowerName: firstName })] : []),
+            ...(firstName ? [action("plr_borrower_loans", "Loan history for top borrower", { borrowerNames: firstName })] : []),
+            ...(firstName ? [action("plr_borrower_contacts", "Contact info for top borrower", { borrowerNames: firstName })] : []),
+        ];
+        return structuredResult(lines.join("\n"), { items: slimItems, total, page: args.page }, actions);
+    });
+}
+//# sourceMappingURL=borrowerRankings.js.map

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

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

package/dist/tools/plr/borrowerSearch.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 registerBorrowerSearchTool(server: McpServer, plr: PlrClient): void;