@sfranalytics/mcp 0.6.3 → 0.6.5

package/dist/tools/plr/loansNearby.js

@@ -3,10 +3,13 @@ import { structuredResult, markdownTable } from "../formatters.js";
 import { registerToolSafe } from "../registerToolSafe.js";
 import { autoFillPlrDates } from "../dateHelper.js";
 import { action } from "../nextActions.js";
+import { ApiError } from "../../services/httpClient.js";
 const Input = z.object({
     propertyAddress: z
         .string()
-        .describe("Full property address, e.g. '123 Main St, Phoenix, AZ 85004'"),
+        .describe("Full property address (e.g. '123 Main St, Phoenix, AZ 85004'). " +
+        "Used for geocoding — must be close enough to resolve. " +
+        "If geocoding fails, try a nearby address or use plr_borrower_search with geographic filters."),
     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'"),
@@ -22,92 +25,105 @@ export function registerLoansNearbyTool(server, plr) {
             "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(" | "));
+        try {
+            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);
         }
-        else {
-            lines.push("_No loans found within radius._");
+        catch (err) {
+            if (err instanceof ApiError && err.status === 404) {
+                const zipMatch = args.propertyAddress.match(/\b(\d{5})\b/);
+                const zip = zipMatch?.[1];
+                return structuredResult(`## Loans Nearby — ${args.propertyAddress}\n\n` +
+                    `_Address not found or could not be geocoded. Verify the exact address format. ` +
+                    `Use sfr_search_properties with the zip code to find the canonical address, ` +
+                    `or use plr_borrower_search with geographic filters instead._`, { address: args.propertyAddress, error: "not_found" }, [action("sfr_search_properties", "Search by zip to find correct address", zip ? { search_type: "zip", zips: zip } : undefined)]);
+            }
+            throw err;
         }
-        // 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

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

package/dist/tools/plr/transactionHistory.js

@@ -2,8 +2,12 @@ import { z } from "zod";
 import { structuredResult, markdownTable, truncatedJson } from "../formatters.js";
 import { registerToolSafe } from "../registerToolSafe.js";
 import { action } from "../nextActions.js";
+import { ApiError } from "../../services/httpClient.js";
 const Input = z.object({
-    propertyAddress: z.string().describe("Full property address, e.g. '123 Main St, Phoenix, AZ 85004'"),
+    propertyAddress: z.string().describe("Full property address exactly as recorded (e.g. '123 Main St, Phoenix, AZ 85004'). " +
+        "Must match dataset precisely — abbreviations (St/Ave/Blvd), directional prefixes (N/S/E/W), " +
+        "and unit numbers matter. If unsure, use sfr_search_properties with the zip code first to find " +
+        "the canonical address."),
     page: z.coerce.number().default(1).describe("Page number (default 1)"),
     pageSize: z.coerce.number().default(10).describe("Results per page (default 10, max 25)"),
 });
@@ -16,59 +20,72 @@ export function registerTransactionHistoryTool(server, plr) {
             "Complements sfr_property_transactions which shows deeds/sales.",
         inputSchema: Input,
     }, async (args) => {
-        const body = {
-            property_address: args.propertyAddress,
-            page: args.page,
-            page_size: Math.min(args.pageSize, 25),
-        };
-        const data = await plr.transactionHistory(body);
-        const items = data?.results ?? data?.data ?? (Array.isArray(data) ? data : []);
-        const total = data?.count ?? items.length;
-        const lines = [
-            `## Private Lending History — ${args.propertyAddress}`,
-            `**Total:** ${total} transactions`,
-            "",
-        ];
-        if (items.length > 0) {
-            const fmt$ = (v) => v != null && Number(v) > 0 ? `$${Number(v).toLocaleString()}` : "—";
-            const rows = items.slice(0, 20).map((t) => [
-                t.recording_date ?? "—",
-                t.tx_type ?? t.transaction_type_clean ?? "—",
-                fmt$(t.sale_amt),
-                t.buyer_borrower1_name ?? "—",
-                t.seller1_name ?? "—",
-                t.lender_clean ?? t.first_mtg_lender_name ?? "—",
-                fmt$(t.first_mtg_amt),
-            ]);
-            lines.push(markdownTable(["Date", "Type", "Sale Price", "Buyer", "Seller", "Lender", "Mortgage"], rows));
-            if (data.property_details) {
-                const pd = data.property_details;
-                lines.push("", "### 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.property_type ? `**Type:** ${pd.property_type}` : null,
-                    pd.beds ? `**Beds:** ${pd.beds}` : null,
-                    pd.total_sqft ? `**Sqft:** ${pd.total_sqft}` : null,
-                ].filter(Boolean);
-                lines.push(detailLines.join(" | "));
+        try {
+            const body = {
+                property_address: args.propertyAddress,
+                page: args.page,
+                page_size: Math.min(args.pageSize, 25),
+            };
+            const data = await plr.transactionHistory(body);
+            const items = data?.results ?? data?.data ?? (Array.isArray(data) ? data : []);
+            const total = data?.count ?? items.length;
+            const lines = [
+                `## Private Lending History — ${args.propertyAddress}`,
+                `**Total:** ${total} transactions`,
+                "",
+            ];
+            if (items.length > 0) {
+                const fmt$ = (v) => v != null && Number(v) > 0 ? `$${Number(v).toLocaleString()}` : "—";
+                const rows = items.slice(0, 20).map((t) => [
+                    t.recording_date ?? "—",
+                    t.tx_type ?? t.transaction_type_clean ?? "—",
+                    fmt$(t.sale_amt),
+                    t.buyer_borrower1_name ?? "—",
+                    t.seller1_name ?? "—",
+                    t.lender_clean ?? t.first_mtg_lender_name ?? "—",
+                    fmt$(t.first_mtg_amt),
+                ]);
+                lines.push(markdownTable(["Date", "Type", "Sale Price", "Buyer", "Seller", "Lender", "Mortgage"], rows));
+                if (data.property_details) {
+                    const pd = data.property_details;
+                    lines.push("", "### 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.property_type ? `**Type:** ${pd.property_type}` : null,
+                        pd.beds ? `**Beds:** ${pd.beds}` : null,
+                        pd.total_sqft ? `**Sqft:** ${pd.total_sqft}` : null,
+                    ].filter(Boolean);
+                    lines.push(detailLines.join(" | "));
+                }
             }
+            else {
+                lines.push("_No private lending transactions found for this property._");
+                if (data && typeof data === "object") {
+                    lines.push("```json");
+                    lines.push(truncatedJson(data, 2000));
+                    lines.push("```");
+                }
+            }
+            const actions = [
+                action("sfr_get_property", "Full property details & valuation", { address: args.propertyAddress }),
+                action("plr_loans_nearby", "Other loans in the area", { propertyAddress: args.propertyAddress }),
+                action("sfr_property_transactions", "Deed & sale history", { address: args.propertyAddress }),
+            ];
+            return structuredResult(lines.join("\n"), { items, total, page: args.page }, actions);
         }
-        else {
-            lines.push("_No private lending transactions found for this property._");
-            if (data && typeof data === "object") {
-                lines.push("```json");
-                lines.push(truncatedJson(data, 2000));
-                lines.push("```");
+        catch (err) {
+            if (err instanceof ApiError && err.status === 404) {
+                const zipMatch = args.propertyAddress.match(/\b(\d{5})\b/);
+                const zip = zipMatch?.[1];
+                return structuredResult(`## Private Lending History — ${args.propertyAddress}\n\n` +
+                    `_Property not found at this address. The address must exactly match the dataset ` +
+                    `(including directional prefixes like 'E'/'W', abbreviations like 'St'/'Ave', and unit numbers). ` +
+                    `Use sfr_search_properties with the zip code to find the canonical address._`, { address: args.propertyAddress, error: "not_found" }, [action("sfr_search_properties", "Search by zip to find correct address", zip ? { search_type: "zip", zips: zip } : undefined)]);
             }
+            throw err;
         }
-        const actions = [
-            action("sfr_get_property", "Full property details & valuation", { address: args.propertyAddress }),
-            action("plr_loans_nearby", "Other loans in the area", { propertyAddress: args.propertyAddress }),
-            action("sfr_property_transactions", "Deed & sale history", { address: args.propertyAddress }),
-        ];
-        return structuredResult(lines.join("\n"), { items, total, page: args.page }, actions);
     });
 }
 //# sourceMappingURL=transactionHistory.js.map

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

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

package/dist/tools/sfr/bestBuyers.js

@@ -2,8 +2,12 @@ import { z } from "zod";
 import { structuredResult, markdownTable, truncatedJson } from "../formatters.js";
 import { action } from "../nextActions.js";
 import { registerToolSafe } from "../registerToolSafe.js";
+import { ApiError } from "../../services/httpClient.js";
 const Input = z.object({
-    address: z.string().describe("Full property address, e.g. '123 Main St, Phoenix, AZ 85004'"),
+    address: z.string().describe("Full property address exactly as recorded (e.g. '123 Main St, Phoenix, AZ 85004'). " +
+        "Must match dataset precisely — abbreviations (St/Ave/Blvd), directional prefixes (N/S/E/W), " +
+        "and unit numbers matter. If unsure, use sfr_search_properties with the zip code first to find " +
+        "the canonical address."),
 });
 export function registerBestBuyersTool(server, sfr) {
     registerToolSafe(server, "sfr_best_buyers", {
@@ -13,48 +17,61 @@ export function registerBestBuyersTool(server, sfr) {
             "Ideal for sellers, wholesalers, or agents matching properties to active buyers.",
         inputSchema: Input,
     }, async (args) => {
-        const data = await sfr.getBestBuyers(args.address);
-        const buyers = data?.data ?? data?.buyers ?? (Array.isArray(data) ? data : []);
-        const lines = [
-            `## Best Buyers — ${args.address}`,
-            `**Matches:** ${buyers.length} investors`,
-            "",
-        ];
-        if (buyers.length > 0) {
-            // API returns {name, matchScore, totalAcquisitions, recentPurchasesCount, matchReasons}
-            const rows = buyers.slice(0, 25).map((b, i) => [
-                i + 1,
-                b.name ?? b.buyer_name ?? "—",
-                b.totalAcquisitions ?? b.acquisitions ?? "—",
-                b.recentPurchasesCount ?? "—",
-                b.matchScore != null ? `${b.matchScore}%` : "—",
-                Array.isArray(b.matchReasons) ? b.matchReasons[0] ?? "—" : "—",
-            ]);
-            lines.push(markdownTable(["#", "Buyer", "Total Acq.", "Recent", "Match", "Reason"], rows));
+        try {
+            const data = await sfr.getBestBuyers(args.address);
+            const buyers = data?.data ?? data?.buyers ?? (Array.isArray(data) ? data : []);
+            const lines = [
+                `## Best Buyers — ${args.address}`,
+                `**Matches:** ${buyers.length} investors`,
+                "",
+            ];
+            if (buyers.length > 0) {
+                // API returns {name, matchScore, totalAcquisitions, recentPurchasesCount, matchReasons}
+                const rows = buyers.slice(0, 25).map((b, i) => [
+                    i + 1,
+                    b.name ?? b.buyer_name ?? "—",
+                    b.totalAcquisitions ?? b.acquisitions ?? "—",
+                    b.recentPurchasesCount ?? "—",
+                    b.matchScore != null ? `${b.matchScore}%` : "—",
+                    Array.isArray(b.matchReasons) ? b.matchReasons[0] ?? "—" : "—",
+                ]);
+                lines.push(markdownTable(["#", "Buyer", "Total Acq.", "Recent", "Match", "Reason"], rows));
+            }
+            else {
+                lines.push("```json");
+                lines.push(truncatedJson(data, 3000));
+                lines.push("```");
+            }
+            // Slim buyers — keep match-specific fields, strip URL slugs
+            const slimBuyers = buyers.slice(0, 25).map((b) => ({
+                name: b.name ?? b.buyer_name,
+                totalAcquisitions: b.totalAcquisitions ?? b.acquisitions,
+                recentPurchasesCount: b.recentPurchasesCount,
+                purchasesWithinQuarterMile: b.purchasesWithinQuarterMile || undefined,
+                matchScore: b.matchScore,
+                matchReasons: b.matchReasons,
+                hasProfile: b.hasProfilePage || undefined,
+                hasContact: b.hasContactInfo || undefined,
+            }));
+            const firstName = buyers[0]?.name ?? buyers[0]?.buyer_name;
+            const actions = [
+                ...(firstName ? [action("sfr_buyer_profile", "Profile top match", { name: firstName })] : []),
+                ...(firstName ? [action("sfr_buyer_growth", "Growth trend for top match", { name: firstName })] : []),
+                action("sfr_get_property", "Full property details", { address: args.address }),
+            ];
+            return structuredResult(lines.join("\n"), { items: slimBuyers, total: buyers.length, page: 1 }, actions);
         }
-        else {
-            lines.push("```json");
-            lines.push(truncatedJson(data, 3000));
-            lines.push("```");
+        catch (err) {
+            if (err instanceof ApiError && err.status === 404) {
+                const zipMatch = args.address.match(/\b(\d{5})\b/);
+                const zip = zipMatch?.[1];
+                return structuredResult(`## Best Buyers — ${args.address}\n\n` +
+                    `_Property not found at this address. The address must exactly match the dataset ` +
+                    `(including directional prefixes like 'E'/'W', abbreviations like 'St'/'Ave', and unit numbers). ` +
+                    `Use sfr_search_properties with the zip code to find the canonical address._`, { address: args.address, error: "not_found" }, [action("sfr_search_properties", "Search by zip to find correct address", zip ? { search_type: "zip", zips: zip } : undefined)]);
+            }
+            throw err;
         }
-        // Slim buyers — keep match-specific fields, strip URL slugs
-        const slimBuyers = buyers.slice(0, 25).map((b) => ({
-            name: b.name ?? b.buyer_name,
-            totalAcquisitions: b.totalAcquisitions ?? b.acquisitions,
-            recentPurchasesCount: b.recentPurchasesCount,
-            purchasesWithinQuarterMile: b.purchasesWithinQuarterMile || undefined,
-            matchScore: b.matchScore,
-            matchReasons: b.matchReasons,
-            hasProfile: b.hasProfilePage || undefined,
-            hasContact: b.hasContactInfo || undefined,
-        }));
-        const firstName = buyers[0]?.name ?? buyers[0]?.buyer_name;
-        const actions = [
-            ...(firstName ? [action("sfr_buyer_profile", "Profile top match", { name: firstName })] : []),
-            ...(firstName ? [action("sfr_buyer_growth", "Growth trend for top match", { name: firstName })] : []),
-            action("sfr_get_property", "Full property details", { address: args.address }),
-        ];
-        return structuredResult(lines.join("\n"), { items: slimBuyers, total: buyers.length, page: 1 }, actions);
     });
 }
 //# sourceMappingURL=bestBuyers.js.map

package/dist/tools/sfr/bestBuyers.js.map

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

package/dist/tools/sfr/buyerProfile.js

@@ -16,10 +16,12 @@ export function registerBuyerProfileTool(server, sfr) {
             "target property type, price range), geographic focus, related LLCs, and contact info. " +
             "Includes flip vs hold percentages and target margin ranges. " +
             "Returns relatedLLCs — use these names with sfr_flip_activity(buyer_name=) to find flip transactions across all entities. " +
+            "Note: relatedLLCs may return simplified/slug names rather than exact deed-recorded entity names for some investors. " +
             "For iBuyer/flipper margin analysis, chain: buyer_profile → get relatedLLCs → sfr_flip_activity per LLC. " +
-            "Only major institutional investors have profiles — use sfr_top_buyers to discover names. " +
+            "Profiles exist for investors with significant recorded transaction volume (typically 50+ acquisitions). " +
+            "Smaller investors won't have profiles — use sfr_top_buyers to discover names. " +
             "For acquisition trends over time, use sfr_buyer_growth. " +
-            "CHAIN: Use plr_borrower_search with the investor name to check if they borrow from private lenders.",
+            "CHAIN: Use plr_borrower_profile with the investor name to check private lending activity and get contact info (requires PLR API key).",
         inputSchema: Input,
     }, async (args) => {
         try {
@@ -108,7 +110,7 @@ export function registerBuyerProfileTool(server, sfr) {
                 const topZip = Array.isArray(data.portfolio?.topZipCodes) ? data.portfolio.topZipCodes[0] : undefined;
                 const actions = [
                     action("sfr_buyer_growth", "Acquisition trend over time", { name: args.name }),
-                    action("plr_borrower_search", "Check if investor borrows privately", { search: args.name }),
+                    action("plr_borrower_profile", "Lending activity + contacts (PLR key required)", { borrowerName: args.name }),
                     ...(topZip ? [action("sfr_zip_detail", "Deep-dive top zip", { zipCode: topZip })] : []),
                     ...(topZip ? [action("sfr_search_properties", "Recent purchases in top zip", { search_type: "zip", zips: topZip })] : []),
                 ];
@@ -152,8 +154,13 @@ export function registerBuyerProfileTool(server, sfr) {
             if (err instanceof ApiError && err.status === 404) {
                 const slug = slugifyBuyerName(args.name);
                 return structuredResult(`## Investor Profile — ${args.name}\n\n` +
-                    `_No profile found (slug: "${slug}"). Only major institutional investors have profiles. ` +
-                    `Use sfr_top_buyers to discover names with profiles._`, { name: args.name, slug, error: "not_found" }, [action("sfr_top_buyers", "Find buyers with profiles", {})]);
+                    `_No SFR profile found (slug: "${slug}"). SFR profiles exist only for large institutional investors ` +
+                    `(typically 50+ acquisitions)._ ` +
+                    `For smaller investors, plr_borrower_profile provides lending activity and contact info (phone, email, principals). ` +
+                    `Requires a PLR API key — reach out at support@sfranalytics.com or chat at https://mcp.sfranalytics.com to get access.`, { name: args.name, slug, error: "not_found" }, [
+                    action("plr_borrower_profile", "Check PLR for lending activity + contacts", { borrowerName: args.name }),
+                    action("sfr_top_buyers", "Find institutional buyers with profiles"),
+                ]);
             }
             throw err;
         }