@sfranalytics/mcp 0.6.0

package/dist/tools/plr/marketTrends.js

@@ -0,0 +1,95 @@
+import { z } from "zod";
+import { structuredResult, markdownTable, truncatedJson, fmtDollars, fmtPercent, fmtPeriod } from "../formatters.js";
+import { registerToolSafe } from "../registerToolSafe.js";
+import { autoFillPlrDates } from "../dateHelper.js";
+import { action } from "../nextActions.js";
+const Input = z.object({
+    granularity: z
+        .enum(["monthly", "quarterly", "yearly", "loan_type", "seasonal", "rolling"])
+        .default("monthly")
+        .describe("Time series granularity"),
+    startDate: z.string().optional().describe("Start date, e.g. '2023-01-01'"),
+    endDate: z.string().optional().describe("End date"),
+    loanTypes: z.string().optional().describe("Comma-separated loan types: DSCR, Bridge, Unknown"),
+});
+const granularityToEndpoint = {
+    monthly: "monthly_market_trends",
+    quarterly: "quarterly_trends",
+    yearly: "year_over_year_comparison",
+    loan_type: "loan_type_trends",
+    seasonal: "seasonal_analysis",
+    rolling: "rolling_averages",
+};
+export function registerMarketTrendsTool(server, plr) {
+    registerToolSafe(server, "plr_market_trends", {
+        title: "Private lending market trends — NATIONWIDE only (PLR)",
+        description: "Get NATIONWIDE private lending time series data with 6 granularity options: " +
+            "monthly, quarterly, yearly, loan_type breakdowns, seasonal analysis, and rolling averages. " +
+            "Returns loan counts, volumes, unique lender/borrower counts, and growth metrics. " +
+            "NOTE: This is nationwide data only — geographic filters (state/MSA) are NOT supported. " +
+            "For geographic rankings, use plr_msa_rankings. " +
+            "For a point-in-time market overview, use plr_portfolio_summary.",
+        inputSchema: Input,
+    }, async (args) => {
+        const endpoint = granularityToEndpoint[args.granularity];
+        const query = {};
+        if (args.startDate)
+            query.start_date = args.startDate;
+        if (args.endDate)
+            query.end_date = args.endDate;
+        if (args.loanTypes)
+            query.loan_types = args.loanTypes;
+        autoFillPlrDates(query);
+        const data = await plr.marketTrends(endpoint, query);
+        const items = data?.results ?? data?.data ?? (Array.isArray(data) ? data : []);
+        const lines = [
+            `## Private Lending Market Trends (${args.granularity})`,
+            "",
+        ];
+        if (items.length > 0) {
+            // Try to build a table from the first item's keys
+            const sampleKeys = Object.keys(items[0]).slice(0, 8);
+            const dollarKeys = new Set(sampleKeys.filter((k) => /amount|volume/i.test(k)));
+            const pctKeys = new Set(sampleKeys.filter((k) => /growth|percent|change/i.test(k)));
+            const dateKeys = new Set(sampleKeys.filter((k) => /^(month|quarter|period|year)$/i.test(k)));
+            // Detect if last row's period is incomplete (contains current month)
+            const now = new Date();
+            const isPartialPeriod = (v) => {
+                const d = new Date(v);
+                if (isNaN(d.getTime()))
+                    return false;
+                return d.getFullYear() === now.getFullYear() && d.getMonth() === now.getMonth();
+            };
+            const sliced = items.slice(0, 36);
+            const rows = sliced.map((row, idx) => sampleKeys.map((k) => {
+                const v = row[k];
+                if (v == null)
+                    return "—";
+                if (typeof v === "number" && dollarKeys.has(k) && v > 10000)
+                    return fmtDollars(v);
+                if (typeof v === "number" && pctKeys.has(k))
+                    return fmtPercent(v);
+                if (typeof v === "string" && dateKeys.has(k)) {
+                    const label = fmtPeriod(k, v);
+                    if (idx === sliced.length - 1 && isPartialPeriod(v))
+                        return `${label} (partial)`;
+                    return label;
+                }
+                return String(v);
+            }));
+            lines.push(markdownTable(sampleKeys, rows));
+        }
+        else {
+            lines.push("```json");
+            lines.push(truncatedJson(data, 4000));
+            lines.push("```");
+        }
+        const actions = [
+            action("plr_msa_rankings", "Geographic breakdown by MSA", {}),
+            action("plr_portfolio_summary", "Point-in-time market overview", {}),
+            action("plr_top_lenders", "Top lenders by volume", {}),
+        ];
+        return structuredResult(lines.join("\n"), { items, total: items.length, page: 1 }, actions);
+    });
+}
+//# sourceMappingURL=marketTrends.js.map

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

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

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

package/dist/tools/plr/msaRankings.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 MSA by name, e.g. 'Phoenix'"),
+    states: z.string().optional().describe("Comma-separated state abbreviations"),
+    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 registerMsaRankingsTool(server, plr) {
+    registerToolSafe(server, "plr_msa_rankings", {
+        title: "Rank MSAs by lending activity (PLR)",
+        description: "Rank metropolitan statistical areas (MSAs) by private lending volume. " +
+            "Shows which metros have the most bridge/DSCR lending activity, loan counts, " +
+            "and period-over-period changes. Great for identifying hot markets. " +
+            "Defaults to last 1 year if no dates provided. " +
+            "Requires MSAs with 100+ loans in both the current and previous period.",
+        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.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.msaRankings(body);
+        const items = data?.results ?? data?.data ?? (Array.isArray(data) ? data : []);
+        const total = data?.count ?? items.length;
+        const lines = [
+            `## MSA Rankings by Lending Activity`,
+            `**Total:** ${total} | **Page:** ${args.page}`,
+            "",
+        ];
+        if (items.length > 0) {
+            const fmtPct = (v) => v != null ? `${(Number(v) * 100).toFixed(1)}%` : "—";
+            const rows = items.slice(0, 25).map((m, i) => [
+                i + 1 + (args.page - 1) * args.pageSize,
+                m.msa ?? "—",
+                m.recent_loan_count ?? "—",
+                fmtDollars(m.recent_total_amount),
+                fmtPct(m.loan_count_percent_change),
+                fmtPct(m.total_amount_percent_change),
+            ]);
+            lines.push(markdownTable(["#", "MSA", "Loans", "Volume", "Loan %Chg", "Vol %Chg"], rows));
+        }
+        else {
+            lines.push("```json");
+            lines.push(truncatedJson(data, 3000));
+            lines.push("```");
+        }
+        const firstMsa = items[0]?.msa;
+        const actions = [
+            ...(firstMsa ? [action("plr_top_lenders", "Top lenders in leading MSA", { msas: firstMsa })] : []),
+            ...(firstMsa ? [action("plr_borrower_rankings", "Top borrowers in leading MSA", { msas: firstMsa })] : []),
+            ...(firstMsa ? [action("sfr_top_buyers", "SFR buyers in leading MSA", { search_type: "msa", msa: firstMsa })] : []),
+        ];
+        return structuredResult(lines.join("\n"), { items, total, page: args.page }, actions);
+    });
+}
+//# sourceMappingURL=msaRankings.js.map

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

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

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

package/dist/tools/plr/negativeRemarks.js

@@ -0,0 +1,94 @@
+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({
+    borrower_name: z.string().optional().describe("Borrower/entity name (partial match, ILIKE)"),
+    lender_name: z.string().optional().describe("Lender name (partial match on standardized name)"),
+    states: z.string().optional().describe("Comma-separated state codes (e.g. 'FL,TX')"),
+    event_types: z.string().optional().describe("Comma-separated event types (e.g. 'FORECLOSURE')"),
+    negative_event_date_start: z.string().optional().describe("Start date for events (YYYY-MM-DD)"),
+    negative_event_date_end: z.string().optional().describe("End date for events (YYYY-MM-DD)"),
+    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 registerNegativeRemarksTool(server, plr) {
+    registerToolSafe(server, "plr_negative_remarks", {
+        title: "Negative remarks / adverse events (PLR)",
+        description: "Search adverse loan events — foreclosures, defaults, and negative remarks from private lender originations. " +
+            "Filter by borrower name, lender, state, event type, and date range. " +
+            "Use to identify borrower credit risk and distress patterns. " +
+            "CHAIN: combine with plr_churned_borrowers to find churned borrowers with negative events, " +
+            "or with sfr_distress_search for property-level distress.",
+        inputSchema: Input,
+    }, async (args) => {
+        const body = {
+            page: args.page,
+            page_size: Math.min(args.pageSize, 25),
+        };
+        if (args.borrower_name)
+            body.borrower_name = args.borrower_name;
+        if (args.lender_name)
+            body.lender_name = args.lender_name;
+        if (args.states)
+            body.states = args.states.split(",").map((s) => s.trim());
+        if (args.event_types)
+            body.event_types = args.event_types.split(",").map((s) => s.trim());
+        if (args.negative_event_date_start)
+            body.negative_event_date_start = args.negative_event_date_start;
+        if (args.negative_event_date_end)
+            body.negative_event_date_end = args.negative_event_date_end;
+        const data = await plr.negativeRemarks(body);
+        const items = data?.results ?? data?.data ?? (Array.isArray(data) ? data : []);
+        const total = data?.count ?? items.length;
+        const filterDesc = [
+            args.borrower_name && `borrower="${args.borrower_name}"`,
+            args.lender_name && `lender="${args.lender_name}"`,
+            args.states && `states=${args.states}`,
+            args.event_types && `events=${args.event_types}`,
+        ].filter(Boolean).join(", ") || "all";
+        const lines = [
+            `## Negative Remarks — ${filterDesc}`,
+            `**Total:** ${total} | **Page:** ${args.page} | **Showing:** ${items.length}`,
+            "",
+        ];
+        if (items.length > 0) {
+            const rows = items.slice(0, 25).map((r) => [
+                r.borrower_name ?? "—",
+                r.lender_name ?? r.lender ?? "—",
+                fmtDollars(r.loan_amount),
+                r.negative_event_date ?? "—",
+                r.event_type ?? "—",
+                r.address ?? "—",
+                r.city ?? "—",
+                r.state ?? "—",
+            ]);
+            lines.push(markdownTable(["Borrower", "Lender", "Loan Amt", "Event Date", "Event Type", "Address", "City", "State"], rows));
+        }
+        else {
+            lines.push("_No negative remarks found._");
+        }
+        const slimItems = items.slice(0, 25).map((r) => ({
+            property_id: r.property_id,
+            borrower_name: r.borrower_name,
+            lender_name: r.lender_name ?? r.lender,
+            loan_date: r.loan_date,
+            loan_amount: r.loan_amount,
+            negative_event_date: r.negative_event_date,
+            event_type: r.event_type,
+            address: r.address,
+            city: r.city,
+            state: r.state,
+            zip_code: r.zip_code,
+        }));
+        const firstName = items[0]?.borrower_name;
+        const firstState = items[0]?.state;
+        const actions = [
+            ...(firstName ? [action("plr_borrower_loans", "Borrower loan history", { borrowerNames: firstName })] : []),
+            ...(firstName ? [action("plr_borrower_contacts", "Contact info", { borrowerNames: firstName })] : []),
+            ...(firstName && firstState ? [action("sfr_distress_search", "Property distress status", { owner_name: firstName, state: firstState })] : []),
+        ];
+        return structuredResult(lines.join("\n"), { items: slimItems, total, page: args.page }, actions);
+    });
+}
+//# sourceMappingURL=negativeRemarks.js.map

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

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

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

package/dist/tools/plr/ownerSearch.js

@@ -0,0 +1,57 @@
+import { z } from "zod";
+import { structuredResult, markdownTable } from "../formatters.js";
+import { registerToolSafe } from "../registerToolSafe.js";
+import { action } from "../nextActions.js";
+const Input = z.object({
+    search: z.string().describe("Person/owner name to search (partial match, ILIKE)"),
+    states: z.string().optional().describe("Comma-separated state codes for filtering (e.g. 'CA,TX')"),
+    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 registerOwnerSearchTool(server, plr) {
+    registerToolSafe(server, "plr_owner_search", {
+        title: "Principal/owner name search (PLR)",
+        description: "Search for principal/owner names (people, not LLCs). Returns person names and their loan counts. " +
+            "Use when a user asks about a specific person rather than an entity/LLC. " +
+            "Requires a state filter for best results. " +
+            "CHAIN: owner names → plr_borrower_contacts (to get linked LLCs and contact info) → " +
+            "plr_borrower_loans (loan history under associated entities).",
+        inputSchema: Input,
+    }, async (args) => {
+        const query = {
+            search: args.search,
+            page: args.page,
+            page_size: Math.min(args.pageSize, 25),
+        };
+        if (args.states)
+            query.states = args.states;
+        const data = await plr.ownersList(query);
+        const items = data?.results ?? data?.data ?? (Array.isArray(data) ? data : []);
+        const total = data?.count ?? items.length;
+        const lines = [
+            `## Owner Search — "${args.search}"${args.states ? ` (${args.states})` : ""}`,
+            `**Total:** ${total} | **Page:** ${args.page} | **Showing:** ${items.length}`,
+            "",
+        ];
+        if (items.length > 0) {
+            const rows = items.slice(0, 25).map((r, i) => [
+                i + 1 + (args.page - 1) * args.pageSize,
+                r.owner_name ?? "—",
+                r.loans_count ?? "—",
+            ]);
+            lines.push(markdownTable(["#", "Owner Name", "Loans"], rows));
+        }
+        else {
+            lines.push("_No owners found._ " +
+                (!args.states ? "Try adding a states filter — person name search works best with a state (e.g. states='TX'). " : "") +
+                "Check spelling and try partial names (first + last only, no middle name).");
+        }
+        const firstName = items[0]?.owner_name;
+        const actions = [
+            ...(firstName ? [action("plr_borrower_contacts", "Contact info + linked LLCs", { borrowerNames: firstName })] : []),
+            ...(firstName ? [action("plr_negative_remarks", "Check for negative events", { borrower_name: firstName })] : []),
+        ];
+        return structuredResult(lines.join("\n"), { items, total, page: args.page }, actions);
+    });
+}
+//# sourceMappingURL=ownerSearch.js.map

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

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

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

package/dist/tools/plr/portfolioSummary.js

@@ -0,0 +1,99 @@
+import { z } from "zod";
+import { structuredResult, kvSummary, 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({
+    startDate: z.string().optional().describe("Start date, e.g. '2024-01-01'"),
+    endDate: z.string().optional().describe("End date"),
+});
+export function registerPortfolioSummaryTool(server, plr) {
+    registerToolSafe(server, "plr_portfolio_summary", {
+        title: "Nationwide private lending summary — totals & distributions (PLR)",
+        description: "Get a NATIONWIDE summary of the private lending market: total loans, total volume, " +
+            "unique lenders, unique borrowers, MSA count, state count, plus loan type and " +
+            "land use distributions. NOTE: This is nationwide only — no geographic filters. " +
+            "Use this to set context before deeper analysis. " +
+            "For geographic breakdowns, use plr_msa_rankings.",
+        inputSchema: Input,
+    }, async (args) => {
+        const query = {};
+        if (args.startDate)
+            query.start_date = args.startDate;
+        if (args.endDate)
+            query.end_date = args.endDate;
+        autoFillPlrDates(query);
+        const data = await plr.portfolioSummary(query);
+        const lines = [`## Private Lending Market Summary`, ""];
+        if (data && typeof data === "object") {
+            // API returns {date_range, overall_metrics: {...}, loan_type_distribution, land_use_distribution}
+            const metrics = data.overall_metrics ?? data;
+            const dateRange = data.date_range;
+            if (dateRange) {
+                lines.push(`**Period:** ${dateRange.start_date} to ${dateRange.end_date}`, "");
+            }
+            lines.push(kvSummary([
+                ["Total Loans", metrics.total_loans != null ? Number(metrics.total_loans).toLocaleString() : undefined],
+                ["Total Volume", metrics.total_amount ? fmtDollars(metrics.total_amount) : undefined],
+                ["Average Loan", metrics.avg_amount ? fmtDollars(metrics.avg_amount) : undefined],
+                ["Unique Lenders", metrics.unique_lenders != null ? Number(metrics.unique_lenders).toLocaleString() : undefined],
+                ["Unique Borrowers", metrics.unique_borrowers != null ? Number(metrics.unique_borrowers).toLocaleString() : undefined],
+                ["MSAs", metrics.unique_msas ?? metrics.msa_count],
+                ["States", metrics.unique_states ?? metrics.state_count],
+            ]));
+            const loanTypes = data.loan_type_distribution ?? data.loan_types;
+            if (Array.isArray(loanTypes) && loanTypes.length > 0) {
+                lines.push("", "### Loan Type Distribution");
+                const rows = loanTypes.map((lt) => [
+                    lt.loan_type ?? "—",
+                    lt.loan_count != null ? Number(lt.loan_count).toLocaleString() : "—",
+                    fmtDollars(lt.total_amount),
+                ]);
+                lines.push(markdownTable(["Type", "Loans", "Volume"], rows));
+            }
+            const landUse = data.land_use_distribution ?? data.land_use;
+            if (Array.isArray(landUse) && landUse.length > 0) {
+                lines.push("", "### Land Use Distribution");
+                const rows = landUse.map((lu) => [
+                    lu.land_use_category ?? "—",
+                    lu.loan_count != null ? Number(lu.loan_count).toLocaleString() : "—",
+                    fmtDollars(lu.total_amount),
+                ]);
+                lines.push(markdownTable(["Category", "Loans", "Volume"], rows));
+            }
+        }
+        else {
+            lines.push("```json");
+            lines.push(truncatedJson(data, 4000));
+            lines.push("```");
+        }
+        const actions = [
+            action("plr_market_trends", "Time series trends", { granularity: "monthly" }),
+            action("plr_msa_rankings", "Geographic breakdown by MSA", {}),
+            action("plr_top_lenders", "Top lenders by volume", {}),
+        ];
+        const metrics2 = data?.overall_metrics ?? data ?? {};
+        const loanTypes2 = data?.loan_type_distribution ?? data?.loan_types;
+        const landUse2 = data?.land_use_distribution ?? data?.land_use;
+        const structured = {
+            date_range: data?.date_range,
+            overall_metrics: {
+                total_loans: metrics2.total_loans,
+                total_amount: metrics2.total_amount,
+                avg_amount: metrics2.avg_amount,
+                unique_lenders: metrics2.unique_lenders,
+                unique_borrowers: metrics2.unique_borrowers,
+                unique_msas: metrics2.unique_msas ?? metrics2.msa_count,
+                unique_states: metrics2.unique_states ?? metrics2.state_count,
+            },
+            loan_type_distribution: Array.isArray(loanTypes2)
+                ? loanTypes2.map((lt) => ({ loan_type: lt.loan_type, loan_count: lt.loan_count, total_amount: lt.total_amount }))
+                : undefined,
+            land_use_distribution: Array.isArray(landUse2)
+                ? landUse2.map((lu) => ({ land_use_category: lu.land_use_category, loan_count: lu.loan_count, total_amount: lu.total_amount }))
+                : undefined,
+        };
+        return structuredResult(lines.join("\n"), structured, actions);
+    });
+}
+//# sourceMappingURL=portfolioSummary.js.map

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

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

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

package/dist/tools/plr/topBorrowers.js

@@ -0,0 +1,69 @@
+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({
+    state: z.string().optional().describe("Optional state filter, e.g. 'CA'"),
+    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 registerTopBorrowersTool(server, plr) {
+    registerToolSafe(server, "plr_top_borrowers", {
+        title: "Nationwide borrower leaderboard (PLR)",
+        description: "Simple nationwide leaderboard of the largest private lending borrowers by loan volume. " +
+            "State filter only — NO MSA/city filter. For borrowers in a specific metro/MSA, use plr_borrower_search. " +
+            "Returns borrower name, loan count, total volume, avg loan size, and number of lenders. " +
+            "Best for quick 'who are the biggest borrowers nationally?' or 'top borrowers in FL' questions. " +
+            "Use plr_borrower_profile for full details on any borrower. " +
+            "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.state)
+            body.state = args.state;
+        if (args.startDate)
+            body.start_date = args.startDate;
+        if (args.endDate)
+            body.end_date = args.endDate;
+        autoFillPlrDates(body);
+        const data = await plr.nationwideLargestBorrowers(body);
+        const items = data?.results ?? data?.data ?? (Array.isArray(data) ? data : []);
+        const total = data?.count ?? items.length;
+        const lines = [
+            `## Top Borrowers Nationwide${args.state ? ` (${args.state})` : ""}`,
+            `**Total:** ${total} | **Page:** ${args.page}`,
+            "",
+        ];
+        if (items.length > 0) {
+            // API returns {borrower, loan_count, total_amount, avg_loan_amount, lenders}
+            const rows = items.slice(0, 30).map((b, i) => [
+                i + 1 + (args.page - 1) * args.pageSize,
+                b.borrower ?? b.borrower_name ?? b.name ?? "—",
+                b.loan_count ?? b.total_loans ?? "—",
+                fmtDollars(b.total_amount),
+                b.avg_loan_amount ? fmtDollars(b.avg_loan_amount) : "—",
+                b.lenders ? String(b.lenders).split(";").length : "—",
+            ]);
+            lines.push(markdownTable(["#", "Borrower", "Loans", "Volume", "Avg Loan", "Lenders"], rows));
+        }
+        else {
+            lines.push("```json");
+            lines.push(truncatedJson(data, 3000));
+            lines.push("```");
+        }
+        const firstName = items[0]?.borrower ?? items[0]?.borrower_name ?? items[0]?.name;
+        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, total, page: args.page }, actions);
+    });
+}
+//# sourceMappingURL=topBorrowers.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"topBorrowers.js","sourceRoot":"","sources":["../../../src/tools/plr/topBorrowers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9F,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC;IACrB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;IACzE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;IAC1E,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC;IACnD,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,yBAAyB,CAAC;IACtE,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,uCAAuC,CAAC;CAC1F,CAAC,CAAC;AAEH,MAAM,UAAU,wBAAwB,CAAC,MAAiB,EAAE,GAAc;IACxE,gBAAgB,CAAC,MAAM,EACrB,mBAAmB,EACnB;QACE,KAAK,EAAE,uCAAuC;QAC9C,WAAW,EACT,yFAAyF;YACzF,0GAA0G;YAC1G,yFAAyF;YACzF,iGAAiG;YACjG,6DAA6D;YAC7D,mHAAmH;QACrH,WAAW,EAAE,KAAK;KACnB,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACX,MAAM,IAAI,GAA4B;YACpC,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC;SACvC,CAAC;QACF,IAAI,IAAI,CAAC,KAAK;YAAE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACxC,IAAI,IAAI,CAAC,SAAS;YAAE,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC;QACrD,IAAI,IAAI,CAAC,OAAO;YAAE,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC;QAC/C,gBAAgB,CAAC,IAAI,CAAC,CAAC;QAEvB,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,0BAA0B,CAAC,IAAI,CAAQ,CAAC;QAC/D,MAAM,KAAK,GAAG,IAAI,EAAE,OAAO,IAAI,IAAI,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC/E,MAAM,KAAK,GAAG,IAAI,EAAE,KAAK,IAAI,KAAK,CAAC,MAAM,CAAC;QAE1C,MAAM,KAAK,GAAG;YACZ,8BAA8B,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACpE,cAAc,KAAK,gBAAgB,IAAI,CAAC,IAAI,EAAE;YAC9C,EAAE;SACH,CAAC;QAEF,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,6EAA6E;YAC7E,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,CAAS,EAAE,EAAE,CAAC;gBACzD,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ;gBACvC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,aAAa,IAAI,CAAC,CAAC,IAAI,IAAI,GAAG;gBAC9C,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,WAAW,IAAI,GAAG;gBACpC,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC;gBAC1B,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,GAAG;gBACvD,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG;aACtD,CAAC,CAAC;YACH,KAAK,CAAC,IAAI,CAAC,aAAa,CACtB,CAAC,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,CAAC,EAC3D,IAAI,CACL,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACtB,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;YACtC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpB,CAAC;QAED,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,QAAQ,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,aAAa,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC;QAClF,MAAM,OAAO,GAAG;YACd,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,sBAAsB,EAAE,+BAA+B,EAAE,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACpH,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,oBAAoB,EAAE,+BAA+B,EAAE,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACnH,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,uBAAuB,EAAE,+BAA+B,EAAE,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;SACvH,CAAC;QAEF,OAAO,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;IAC1F,CAAC,CACF,CAAC;AACJ,CAAC"}

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