@sfranalytics/mcp 0.6.0

package/dist/tools/sfr/buyerGrowth.js

@@ -0,0 +1,68 @@
+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";
+import { slugifyBuyerName } from "../slugHelper.js";
+const Input = z.object({
+    name: z.string().describe("Buyer/investor name or slug ('INVITATION HOMES' or 'invitation-homes')"),
+});
+export function registerBuyerGrowthTool(server, sfr) {
+    registerToolSafe(server, "sfr_buyer_growth", {
+        title: "Investor portfolio growth over time (SFR)",
+        description: "Track an investor's acquisition activity over time. Shows annual acquisition counts " +
+            "and cumulative portfolio size. " +
+            "Only works for major institutional investors — use sfr_top_buyers to discover names. " +
+            "Use after sfr_buyer_profile to understand HOW an investor is growing.",
+        inputSchema: Input,
+    }, async (args) => {
+        try {
+            const slug = slugifyBuyerName(args.name);
+            const data = await sfr.getBuyerGrowth(slug);
+            const items = data?.data ?? data?.growth ?? (Array.isArray(data) ? data : []);
+            const lines = [
+                `## Portfolio Growth — ${args.name}`,
+                `**Data Points:** ${items.length}`,
+                "",
+            ];
+            if (items.length > 0) {
+                // API returns {year, propertiesCount} (cumulative portfolio size by year)
+                // Compute YoY net acquisitions for additional insight
+                const rows = items.slice(0, 36).map((g, i) => {
+                    const count = g.propertiesCount ?? g.acquisitions ?? g.count;
+                    const prev = i > 0 ? (items[i - 1].propertiesCount ?? items[i - 1].count) : null;
+                    const net = (count != null && prev != null) ? count - prev : null;
+                    return [
+                        g.year ?? g.period ?? g.date ?? g.month ?? "—",
+                        count ?? "—",
+                        net != null ? `+${net.toLocaleString()}` : "—",
+                    ];
+                });
+                lines.push(markdownTable(["Year", "Properties", "Net Added"], rows));
+            }
+            else {
+                lines.push("```json");
+                lines.push(truncatedJson(data, 4000));
+                lines.push("```");
+            }
+            const actions = [
+                action("sfr_buyer_profile", "Full investor profile & strategy", { name: args.name }),
+                action("plr_borrower_search", "Check private lending activity", { search: args.name }),
+            ];
+            return structuredResult(lines.join("\n"), { growth: items }, actions);
+        }
+        catch (err) {
+            if (err instanceof ApiError && err.status === 404) {
+                const slug = slugifyBuyerName(args.name);
+                return structuredResult(`## Portfolio Growth — ${args.name}\n\n` +
+                    `_No profile found (slug: "${slug}"). Only major institutional investors have profiles. ` +
+                    `Use sfr_top_buyers to discover names with profiles. For local/individual investor growth trends, use plr_borrower_rankings instead._`, { name: args.name, slug, error: "not_found" }, [
+                    action("sfr_top_buyers", "Find buyers with profiles", {}),
+                    action("plr_borrower_rankings", "Growth trends for local investors", {}),
+                ]);
+            }
+            throw err;
+        }
+    });
+}
+//# sourceMappingURL=buyerGrowth.js.map

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

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

package/dist/tools/sfr/buyerProfile.d.ts

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

package/dist/tools/sfr/buyerProfile.js

@@ -0,0 +1,162 @@
+import { z } from "zod";
+import { structuredResult, kvSummary, markdownTable, fmtDollars } from "../formatters.js";
+import { action } from "../nextActions.js";
+import { registerToolSafe } from "../registerToolSafe.js";
+import { ApiError } from "../../services/httpClient.js";
+import { slugifyBuyerName } from "../slugHelper.js";
+const Input = z.object({
+    name: z.string().describe("Buyer/investor name or slug. Accepts display name ('INVITATION HOMES') " +
+        "or slug ('invitation-homes'). Use sfr_top_buyers to discover names."),
+});
+export function registerBuyerProfileTool(server, sfr) {
+    registerToolSafe(server, "sfr_buyer_profile", {
+        title: "Investor profile & strategy (SFR)",
+        description: "Get a comprehensive profile of a property investor/buyer by name. " +
+            "Returns portfolio stats (count, value, avg price), investment strategy (flip vs hold, " +
+            "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. " +
+            "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. " +
+            "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.",
+        inputSchema: Input,
+    }, async (args) => {
+        try {
+            const slug = slugifyBuyerName(args.name);
+            const data = await sfr.getBuyerProfile(slug);
+            const lines = [`## Investor Profile — ${data?.name ?? args.name}`, ""];
+            if (data && typeof data === "object" && !data.statusCode) {
+                const p = data.portfolio;
+                lines.push(kvSummary([
+                    ["Name", data.name],
+                    ["Most Active MSA", data.mostActiveMsa],
+                    ["Properties", p?.propertiesCount],
+                    ["Portfolio Value", p?.portfolioValue ? fmtDollars(p.portfolioValue) : undefined],
+                    ["Avg Purchase Price", p?.averagePurchasePrice ? fmtDollars(p.averagePurchasePrice) : undefined],
+                    ["Avg Property Value", p?.averagePropertyValue ? fmtDollars(p.averagePropertyValue) : undefined],
+                    ["Avg Purchase Year", p?.averagePurchaseYear != null ? Math.round(p.averagePurchaseYear) : undefined],
+                    ["Avg Year Built", p?.averageYearBuilt != null ? Math.round(p.averageYearBuilt) : undefined],
+                    ["Top Zip Codes", Array.isArray(p?.topZipCodes) ? p.topZipCodes.join(", ") : undefined],
+                    ["Has Contact Info", data.hasContactInfo ? "Yes" : "No"],
+                ]));
+                // Related LLCs
+                if (Array.isArray(data.relatedLLCs) && data.relatedLLCs.length > 0) {
+                    lines.push("", "### Related LLCs");
+                    const rows = data.relatedLLCs.map((llc) => [
+                        llc.formattedName ?? llc.name ?? "—",
+                        llc.address ?? "—",
+                    ]);
+                    lines.push(markdownTable(["Name", "Address"], rows));
+                }
+                // Investor profile (AI-generated strategy analysis)
+                const ip = data.investorProfile;
+                if (ip) {
+                    lines.push("", "### Investment Strategy");
+                    if (ip.summary)
+                        lines.push(ip.summary, "");
+                    const bms = ip.businessModelStrategy;
+                    if (bms) {
+                        lines.push(kvSummary([
+                            ["Primary Strategy", bms.primaryStrategy],
+                            ["Flip %", bms.flipPercentage],
+                            ["Hold %", bms.holdPercentage],
+                            ["Positioning", bms.competitivePositioning],
+                            ["Target Margin", bms.targetReturns?.marginRange],
+                            ["Median Margin", bms.targetReturns?.medianMargin],
+                        ]));
+                    }
+                    const dp = ip.dealParameters;
+                    if (dp) {
+                        lines.push("", "### Deal Parameters");
+                        lines.push(kvSummary([
+                            ["Price Range", dp.priceRange?.sweetSpot ? `${dp.priceRange.sweetSpot} (avg ${dp.priceRange.average})` : undefined],
+                            ["Max Price", dp.priceRange?.maximum],
+                            ["Target Size", dp.targetProperties?.size],
+                            ["Target Config", dp.targetProperties?.configuration],
+                            ["Condition", dp.targetProperties?.condition],
+                            ["$/Sqft", dp.targetProperties?.pricePerSqft],
+                            ["Cash %", dp.acquisitionMethod?.cash],
+                            ["Private Lending %", dp.acquisitionMethod?.privateLending],
+                            ["Conventional %", dp.acquisitionMethod?.conventional],
+                        ]));
+                    }
+                    const geo = ip.geographicFocus;
+                    if (geo) {
+                        lines.push("", "### Geographic Focus");
+                        lines.push(kvSummary([
+                            ["Primary Market", geo.primaryMarket],
+                            ["Target Zips", Array.isArray(geo.targetZipCodes) ? geo.targetZipCodes.join(", ") : undefined],
+                            ["Concentration", geo.marketCharacteristics?.concentration],
+                            ["Market Dynamics", geo.marketCharacteristics?.marketDynamics],
+                            ["Median Income", geo.marketCharacteristics?.medianIncome],
+                            ["Property Age", geo.marketCharacteristics?.propertyAge],
+                        ]));
+                    }
+                }
+                // Contacts
+                const c = data.contacts;
+                if (c) {
+                    lines.push("", "### Contacts");
+                    lines.push(kvSummary([
+                        ["Person", c.pname ?? c.fname],
+                        ["Phones", Array.isArray(c.phones) && c.phones.length > 0 ? c.phones.join(", ") : undefined],
+                        ["Emails", Array.isArray(c.emails) && c.emails.length > 0 ? c.emails.join(", ") : undefined],
+                        ["Address", c.address],
+                    ]));
+                }
+                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 }),
+                    ...(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 })] : []),
+                ];
+                const structured = {
+                    name: data.name,
+                    mostActiveMsa: data.mostActiveMsa,
+                    hasContactInfo: data.hasContactInfo,
+                    portfolio: p ? {
+                        propertiesCount: p.propertiesCount,
+                        portfolioValue: p.portfolioValue,
+                        averagePurchasePrice: p.averagePurchasePrice,
+                        averagePropertyValue: p.averagePropertyValue,
+                        averagePurchaseYear: p.averagePurchaseYear,
+                        averageYearBuilt: p.averageYearBuilt,
+                        topZipCodes: p.topZipCodes,
+                    } : undefined,
+                    relatedLLCs: Array.isArray(data.relatedLLCs)
+                        ? data.relatedLLCs.map((llc) => ({ name: llc.formattedName ?? llc.name, address: llc.address }))
+                        : undefined,
+                    investorProfile: ip ? {
+                        summary: ip.summary,
+                        businessModelStrategy: ip.businessModelStrategy,
+                        dealParameters: ip.dealParameters,
+                        geographicFocus: ip.geographicFocus,
+                    } : undefined,
+                    contacts: c ? {
+                        name: c.pname ?? c.fname,
+                        phones: c.phones,
+                        emails: c.emails,
+                        address: c.address,
+                    } : undefined,
+                };
+                return structuredResult(lines.join("\n"), structured, actions);
+            }
+            else {
+                lines.push("_No profile data available._");
+            }
+            return structuredResult(lines.join("\n"), {});
+        }
+        catch (err) {
+            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", {})]);
+            }
+            throw err;
+        }
+    });
+}
+//# sourceMappingURL=buyerProfile.js.map

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

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

package/dist/tools/sfr/distressSearch.d.ts

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

package/dist/tools/sfr/distressSearch.js

@@ -0,0 +1,173 @@
+import { z } from "zod";
+import { structuredResult, markdownTable, fmtDollars } from "../formatters.js";
+import { action } from "../nextActions.js";
+import { registerToolSafe } from "../registerToolSafe.js";
+const Input = z.object({
+    search_type: z
+        .enum(["state", "city", "zip", "county", "msa"])
+        .optional()
+        .describe("Location search type — auto-inferred from provided location params when omitted"),
+    state: z.string().optional().describe("State abbreviation, e.g. 'FL'"),
+    city: z.string().optional().describe("City name, e.g. 'Miami'"),
+    zips: z.string().optional().describe("Comma-separated zip codes, e.g. '33101,33102'"),
+    county: z.string().optional().describe("County name"),
+    msa: z.string().optional().describe("MSA name, e.g. 'Miami-Fort Lauderdale-Pompano Beach, FL'"),
+    owner_name: z.string().optional().describe("Owner/entity name (partial match). Use with borrower names from PLR tools, e.g. 'EMERSON POINT LLC'"),
+    pre_foreclosure: z.boolean().optional().describe("Filter for pre-foreclosure properties"),
+    pre_foreclosure_date_min: z.string().optional().describe("Earliest pre-foreclosure date (YYYYMMDD)"),
+    pre_foreclosure_date_max: z.string().optional().describe("Latest pre-foreclosure date (YYYYMMDD)"),
+    vacant: z.boolean().optional().describe("Filter for vacant properties"),
+    zombie_foreclosure: z.boolean().optional().describe("Filter for zombie foreclosure properties"),
+    beds_min: z.coerce.number().optional().describe("Minimum bedrooms"),
+    beds_max: z.coerce.number().optional().describe("Maximum bedrooms"),
+    baths_min: z.coerce.number().optional().describe("Minimum bathrooms"),
+    baths_max: z.coerce.number().optional().describe("Maximum bathrooms"),
+    property_type: z.string().optional().describe("Property type: 'SFR', 'Condo', 'Multi-Family'"),
+    page: z.coerce.number().default(1).describe("Page number (default 1)"),
+    page_size: z.coerce.number().default(20).describe("Results per page (default 20, max 100)"),
+});
+export function registerDistressSearchTool(server, sfr) {
+    registerToolSafe(server, "sfr_distress_search", {
+        title: "Search distressed / pre-foreclosure properties (SFR)",
+        description: "Search for distressed properties: pre-foreclosure, vacant, and zombie foreclosure. " +
+            "Returns property details with distress indicators (owner name, foreclosure dates, vacancy). " +
+            "Requires at least one location filter (state, city, zip, county, or msa) — search_type is auto-inferred when omitted. " +
+            "Use owner_name to cross-reference PLR borrower names (from plr_lender_borrowers or plr_churned_borrowers) " +
+            "with distressed property owners — include a state filter from plr_borrower_loans. " +
+            "For individual property details use sfr_get_property." +
+            " Data coverage varies by market — some metros return zero distressed properties even when they exist. If no results, try narrowing to specific zip codes or use plr_negative_remarks for borrower-level distress signals instead.",
+        inputSchema: Input,
+    }, async (args) => {
+        // Pre-flight: API requires at least one location filter
+        const hasGeography = args.state || args.city || args.zips || args.county || args.msa;
+        if (!hasGeography) {
+            return structuredResult(`## Distress Search — Missing Geography\n\n` +
+                `_The distress API requires at least one location filter (state, city, zip, county, or msa)._ ` +
+                (args.owner_name
+                    ? `To search for **${args.owner_name}**, first look up their loan states via plr_borrower_loans, then retry with a state filter.`
+                    : `Please provide a location parameter (e.g. state='FL').`), { owner_name: args.owner_name ?? null, error: "missing_geography" }, args.owner_name
+                ? [action("plr_borrower_loans", "Look up borrower geography", { borrowerNames: args.owner_name })]
+                : []);
+        }
+        // Infer search_type from provided geography when omitted
+        const searchType = args.search_type
+            ?? (args.msa ? "msa" : undefined)
+            ?? (args.city ? "city" : undefined)
+            ?? (args.zips ? "zip" : undefined)
+            ?? (args.county ? "county" : undefined)
+            ?? (args.state ? "state" : undefined);
+        const query = {
+            search_type: searchType,
+            page: args.page,
+            page_size: Math.min(args.page_size, 100),
+            sort: "recording_date",
+        };
+        // Location
+        if (args.state)
+            query.state = args.state;
+        if (args.city)
+            query.city = args.city;
+        if (args.zips)
+            query.zip_codes = args.zips;
+        if (args.county)
+            query.county = args.county;
+        if (args.msa)
+            query.msa = args.msa;
+        if (args.owner_name)
+            query.owner_name = args.owner_name;
+        // Distress filters
+        if (args.pre_foreclosure !== undefined)
+            query.pre_foreclosure = args.pre_foreclosure;
+        if (args.pre_foreclosure_date_min)
+            query.pre_foreclosure_date_min = args.pre_foreclosure_date_min;
+        if (args.pre_foreclosure_date_max)
+            query.pre_foreclosure_date_max = args.pre_foreclosure_date_max;
+        if (args.vacant !== undefined)
+            query.vacant = args.vacant;
+        if (args.zombie_foreclosure !== undefined)
+            query.zombie_foreclosure = args.zombie_foreclosure;
+        // Property filters (use !== undefined to allow 0)
+        if (args.beds_min !== undefined)
+            query.beds_min = args.beds_min;
+        if (args.beds_max !== undefined)
+            query.beds_max = args.beds_max;
+        if (args.baths_min !== undefined)
+            query.baths_min = args.baths_min;
+        if (args.baths_max !== undefined)
+            query.baths_max = args.baths_max;
+        if (args.property_type)
+            query.property_type = args.property_type;
+        const data = await sfr.getPropertySearch(query);
+        const items = Array.isArray(data?.data) ? data.data : [];
+        const total = data?.total ?? items.length;
+        const loc = args.city ?? args.zips ?? args.county ?? args.state ?? args.msa ?? "All";
+        const lines = [
+            `## Distressed Properties — ${loc}`,
+            `**Total:** ${typeof total === "number" ? total.toLocaleString() : total} | **Page:** ${args.page} | **Showing:** ${items.length}`,
+            "",
+        ];
+        if (items.length > 0) {
+            const rows = items.slice(0, 25).map((p) => [
+                p.address?.formatted_street_address ?? "—",
+                p.address?.city ?? "—",
+                p.address?.zip_code ?? "—",
+                p.structure?.beds_count ?? "—",
+                p.pre_foreclosure?.flag ? "Yes" : "No",
+                p.pre_foreclosure?.recording_date ?? "—",
+                p.vacant ? "Yes" : "No",
+                fmtDollars(p.valuation?.value ?? p.assessments?.assessed_value),
+            ]);
+            lines.push(markdownTable(["Address", "City", "ZIP", "Beds", "Pre-Forecl.", "Fcl. Date", "Vacant", "Value"], rows));
+        }
+        else {
+            lines.push("_No distressed properties found matching criteria._ " +
+                "Data coverage varies by market. Try narrowing to specific zip codes, or " +
+                "use plr_negative_remarks for borrower-level distress signals (foreclosures, defaults).");
+        }
+        // Slim structured items
+        const slimItems = items.slice(0, 25).map((p) => ({
+            address: p.address?.formatted_street_address,
+            city: p.address?.city,
+            state: p.address?.state,
+            zip: p.address?.zip_code,
+            beds: p.structure?.beds_count || undefined,
+            baths: p.structure?.baths || undefined,
+            yearBuilt: p.structure?.year_built || undefined,
+            propertyType: p.property_class_description || undefined,
+            preForeclosure: p.pre_foreclosure?.flag ?? false,
+            preForeclosureDate: p.pre_foreclosure?.recording_date || undefined,
+            preForeclosureReason: p.pre_foreclosure?.reason || undefined,
+            vacant: p.vacant ?? false,
+            estimatedValue: p.valuation?.value || undefined,
+            assessedValue: p.assessments?.assessed_value || undefined,
+            ownerName: p.owner?.name || undefined,
+            lastSaleDate: p.last_sale?.date || undefined,
+            lastSalePrice: p.last_sale?.price || undefined,
+        }));
+        const firstAddr = items[0]
+            ? `${items[0].address?.formatted_street_address}, ${items[0].address?.city}, ${items[0].address?.state} ${items[0].address?.zip_code}`
+            : undefined;
+        // sfr_top_buyers supports state/city/zip/msa but NOT county
+        const topBuyersSupported = searchType !== "county";
+        const topBuyersArgs = { search_type: searchType };
+        if (args.state)
+            topBuyersArgs.state = args.state;
+        if (args.city)
+            topBuyersArgs.city = args.city;
+        if (args.zips)
+            topBuyersArgs.zips = args.zips;
+        if (args.msa)
+            topBuyersArgs.msa = args.msa;
+        const actions = [
+            ...(firstAddr ? [action("sfr_get_property", "Full details on first result", { address: firstAddr })] : []),
+            action("plr_borrower_search", "Find private borrowers in this area", {
+                ...(args.state ? { state: args.state } : {}),
+            }),
+            ...(topBuyersSupported
+                ? [action("sfr_top_buyers", "Who's buying distressed properties here", topBuyersArgs)]
+                : []),
+        ];
+        return structuredResult(lines.join("\n"), { items: slimItems, total, page: args.page }, actions);
+    });
+}
+//# sourceMappingURL=distressSearch.js.map

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

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

package/dist/tools/sfr/flipActivity.d.ts

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

package/dist/tools/sfr/flipActivity.js

@@ -0,0 +1,110 @@
+import { z } from "zod";
+import { structuredResult, markdownTable, argsToQuery } from "../formatters.js";
+import { action, locationArgs } from "../nextActions.js";
+import { registerToolSafe } from "../registerToolSafe.js";
+import { resolveCanonicalMsa } from "./msaResolver.js";
+const Input = z.object({
+    search_type: z.enum(["state", "city", "zip", "msa"]).default("msa")
+        .describe("Location search type (default: msa)"),
+    msa: z.string().optional().describe("MSA name, e.g. 'Phoenix-Mesa-Chandler, AZ'"),
+    state: z.string().optional().describe("State abbreviation, e.g. 'AZ'"),
+    city: z.string().optional().describe("City name (requires state param when search_type='city')"),
+    zips: z.string().optional().describe("Comma-separated zip codes"),
+    buyer_name: z.string().optional().describe("Filter by buyer/flipper name"),
+    is_foreclosure: z.boolean().optional().describe("Filter for foreclosure sales only"),
+    is_reo_sale: z.boolean().optional().describe("Filter for REO (bank-owned) sales only"),
+    page: z.coerce.number().default(1).describe("Page number (default 1)"),
+    page_size: z.coerce.number().default(20).describe("Results per page (default 20, max 100)"),
+});
+export function registerFlipActivityTool(server, sfr) {
+    registerToolSafe(server, "sfr_flip_activity", {
+        title: "Recent flip transactions (SFR)",
+        description: "Browse individual flip transactions (buy-and-resell) in a market. " +
+            "Returns original buyer, flipper, purchase/sale prices, hold time, and profit. " +
+            "Supports buyer_name filtering (partial match, case-insensitive) for a specific buyer/flipper strategy. " +
+            "For iBuyer margin analysis (e.g. 'how are Opendoor margins trending'), use buyer_name='OPENDOOR' — partial match finds all Opendoor entities. " +
+            "Chain with sfr_buyer_profile to get relatedLLCs and search flips across all related entities. " +
+            "Can filter for foreclosure sales (is_foreclosure) or REO/bank-owned sales (is_reo_sale). " +
+            "For aggregate flip distributions (hold time buckets, margin ranges), use sfr_flip_stats.",
+        inputSchema: Input,
+    }, async (args) => {
+        const query = argsToQuery(args);
+        let effectiveMsa = args.msa;
+        let resolutionMethod = "exact";
+        const data = await sfr.getFlips(query);
+        let items = Array.isArray(data) ? data : data?.data ?? [];
+        if (items.length === 0 && args.search_type === "msa" && args.msa) {
+            resolutionMethod = "none";
+            const resolved = await resolveCanonicalMsa(sfr, { requestedMsa: args.msa });
+            if (resolved.resolvedMsa
+                && resolved.resolvedMsa.toLowerCase() !== args.msa.trim().toLowerCase()) {
+                effectiveMsa = resolved.resolvedMsa;
+                const retryData = await sfr.getFlips({ ...query, msa: effectiveMsa });
+                items = Array.isArray(retryData) ? retryData : retryData?.data ?? [];
+                if (items.length > 0)
+                    resolutionMethod = "fallback";
+            }
+        }
+        const loc = (effectiveMsa ?? args.msa) ?? args.city ?? args.zips ?? args.state ?? "All";
+        const lines = [
+            `## Flip Transactions — ${loc}`,
+            `**Showing:** ${items.length} flips`,
+            "",
+        ];
+        if (resolutionMethod === "fallback") {
+            lines.push(`_MSA normalized: '${args.msa}' -> '${effectiveMsa}'_`, "");
+        }
+        if (items.length > 0) {
+            const fmt$ = (v) => v != null ? `$${Number(v).toLocaleString()}` : "—";
+            const rows = items.slice(0, 25).map((f) => [
+                f.address ? `${f.address}, ${f.city ?? ""}` : "—",
+                f.prevBuyer ?? "—",
+                fmt$(f.prevSaleValue),
+                fmt$(f.saleValue),
+                f.daysDiff != null ? `${f.daysDiff}d` : "—",
+                fmt$(f.saleAmountDiff),
+            ]);
+            lines.push(markdownTable(["Address", "Flipper", "Buy Price", "Sell Price", "Hold", "Profit"], rows));
+        }
+        else {
+            lines.push("_No flip transactions found._ " +
+                (args.buyer_name ? `Buyer name '${args.buyer_name}' may not match — try a shorter/partial name. ` : "") +
+                "Try widening the date range or checking the MSA/city name.");
+        }
+        // Slim items — raw API has 40+ fields with boolean flags, URL slugs, lat/lng
+        const slimItems = items.slice(0, 25).map((f) => ({
+            address: f.address,
+            city: f.city,
+            zip: f.zipCode,
+            state: f.state,
+            propertyType: f.landUseCode,
+            sqft: f.buildingArea || undefined,
+            yearBuilt: f.yearBuilt || undefined,
+            prevBuyer: f.prevBuyer,
+            prevSaleValue: f.prevSaleValue,
+            prevSaleDate: f.prevSaleDate,
+            buyerName: f.buyerName,
+            saleValue: f.saleValue,
+            saleDate: f.saleDate,
+            daysDiff: f.daysDiff,
+            grossMargin: f.grossMargin ?? f.saleAmountDiff,
+            transactionType: f.transactionType,
+            isCashPurchase: f.isCashPurchase || undefined,
+            isCorporatePurchase: f.isCorporatePurchase || undefined,
+            isNewConstruction: f.isNewConstruction || undefined,
+            isForeclosure: f.isForeclosure || undefined,
+            flipMortgage: f.flipMortgage || undefined,
+            msa: f.msa,
+        }));
+        const firstAddr = items[0] ? `${items[0].address}, ${items[0].city}, ${items[0].state} ${items[0].zipCode}` : undefined;
+        const firstFlipper = items[0]?.prevBuyer;
+        const locArgs = locationArgs(args);
+        const actions = [
+            ...(firstAddr ? [action("sfr_get_property", "Details on first flip", { address: firstAddr })] : []),
+            ...(firstFlipper ? [action("sfr_buyer_profile", "Profile of flipper", { name: firstFlipper })] : []),
+            action("sfr_flip_stats", "Flip profitability trends", locArgs),
+        ];
+        return structuredResult(lines.join("\n"), { items: slimItems, total: items.length, page: args.page }, actions);
+    });
+}
+//# sourceMappingURL=flipActivity.js.map

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

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

package/dist/tools/sfr/flipStats.d.ts

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