@sfranalytics/mcp 0.6.0

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

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

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

@@ -0,0 +1,15 @@
+import type { SfrClient } from "../../services/sfr.js";
+type MsaResolution = {
+    resolvedMsa?: string;
+    method: "exact" | "fallback" | "none";
+};
+/**
+ * Resolve canonical MSA naming by probing city/state activity and reading the returned `msa` field.
+ * This handles alias mismatches like "Birmingham-Hoover, AL" vs canonical "Birmingham, AL".
+ */
+export declare function resolveCanonicalMsa(sfr: SfrClient, args: {
+    requestedMsa: string;
+    salesDateMin?: string;
+    salesDateMax?: string;
+}): Promise<MsaResolution>;
+export {};

package/dist/tools/sfr/msaResolver.js

@@ -0,0 +1,109 @@
+const STATE_NAME_TO_ABBR = {
+    alabama: "AL",
+    alaska: "AK",
+    arizona: "AZ",
+    arkansas: "AR",
+    california: "CA",
+    colorado: "CO",
+    connecticut: "CT",
+    delaware: "DE",
+    florida: "FL",
+    georgia: "GA",
+    hawaii: "HI",
+    idaho: "ID",
+    illinois: "IL",
+    indiana: "IN",
+    iowa: "IA",
+    kansas: "KS",
+    kentucky: "KY",
+    louisiana: "LA",
+    maine: "ME",
+    maryland: "MD",
+    massachusetts: "MA",
+    michigan: "MI",
+    minnesota: "MN",
+    mississippi: "MS",
+    missouri: "MO",
+    montana: "MT",
+    nebraska: "NE",
+    nevada: "NV",
+    "new hampshire": "NH",
+    "new jersey": "NJ",
+    "new mexico": "NM",
+    "new york": "NY",
+    "north carolina": "NC",
+    "north dakota": "ND",
+    ohio: "OH",
+    oklahoma: "OK",
+    oregon: "OR",
+    pennsylvania: "PA",
+    "rhode island": "RI",
+    "south carolina": "SC",
+    "south dakota": "SD",
+    tennessee: "TN",
+    texas: "TX",
+    utah: "UT",
+    vermont: "VT",
+    virginia: "VA",
+    washington: "WA",
+    "west virginia": "WV",
+    wisconsin: "WI",
+    wyoming: "WY",
+    "district of columbia": "DC",
+};
+function toStateAbbr(raw) {
+    const trimmed = raw.trim();
+    if (!trimmed)
+        return undefined;
+    if (/^[A-Za-z]{2}$/.test(trimmed))
+        return trimmed.toUpperCase();
+    return STATE_NAME_TO_ABBR[trimmed.toLowerCase()];
+}
+function parseMsaToCityState(msa) {
+    const cleaned = msa.trim();
+    if (!cleaned)
+        return {};
+    const [leftRaw, rightRaw] = cleaned.split(",", 2);
+    const left = (leftRaw ?? cleaned).replace(/\s+metropolitan area$/i, "").trim();
+    const city = left.split(/-{1,2}/)[0]?.trim();
+    const state = rightRaw ? toStateAbbr(rightRaw) : undefined;
+    return { city: city || undefined, state };
+}
+/**
+ * Resolve canonical MSA naming by probing city/state activity and reading the returned `msa` field.
+ * This handles alias mismatches like "Birmingham-Hoover, AL" vs canonical "Birmingham, AL".
+ */
+export async function resolveCanonicalMsa(sfr, args) {
+    const requested = args.requestedMsa.trim();
+    if (!requested)
+        return { method: "none" };
+    const { city, state } = parseMsaToCityState(requested);
+    if (!city || !state)
+        return { method: "none" };
+    const probeQuery = {
+        search_type: "city",
+        city,
+        state,
+        page: 1,
+        page_size: 1,
+    };
+    if (args.salesDateMin)
+        probeQuery.sales_date_min = args.salesDateMin;
+    if (args.salesDateMax)
+        probeQuery.sales_date_max = args.salesDateMax;
+    try {
+        const probeData = await sfr.getBuyerActivity(probeQuery);
+        const probeItems = Array.isArray(probeData) ? probeData : probeData?.data ?? [];
+        const canonical = typeof probeItems[0]?.msa === "string" ? probeItems[0].msa.trim() : undefined;
+        if (!canonical)
+            return { method: "none" };
+        if (canonical.toLowerCase() === requested.toLowerCase()) {
+            return { resolvedMsa: canonical, method: "exact" };
+        }
+        return { resolvedMsa: canonical, method: "fallback" };
+    }
+    catch {
+        return { method: "none" };
+    }
+}
+//# sourceMappingURL=msaResolver.js.map

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

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

package/dist/tools/sfr/propertyBatch.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 registerMlsListingsTool(server: McpServer, sfr: SfrClient): void;

package/dist/tools/sfr/propertyBatch.js

@@ -0,0 +1,73 @@
+import { z } from "zod";
+import { structuredResult, kvSummary, truncatedJson } from "../formatters.js";
+import { action } from "../nextActions.js";
+import { registerToolSafe } from "../registerToolSafe.js";
+const Input = z.object({
+    addresses: z
+        .array(z.string())
+        .min(1)
+        .max(100)
+        .describe("Array of full addresses, e.g. ['123 Main St, Phoenix, AZ 85004', '456 Oak Ave, Tempe, AZ 85281']"),
+});
+export function registerMlsListingsTool(server, sfr) {
+    registerToolSafe(server, "sfr_property_batch", {
+        title: "Batch property lookup by addresses (SFR)",
+        description: "Look up multiple properties at once by address (up to 100). " +
+            "Returns full property details (valuation, structure, owner, last sale) for each. " +
+            "Much more efficient than calling sfr_get_property repeatedly. " +
+            "Pass addresses as an array of strings.",
+        inputSchema: Input,
+    }, async (args) => {
+        const data = await sfr.getPropertyBatch(args.addresses);
+        const items = Array.isArray(data) ? data : data?.data ?? data?.properties ?? [];
+        const lines = [
+            `## Batch Property Lookup`,
+            `**Requested:** ${args.addresses.length} | **Found:** ${items.length}`,
+            "",
+        ];
+        for (const item of items.slice(0, 20)) {
+            // API returns {address: string, property: {...}, error: string|null}
+            const prop = item?.property ?? item;
+            const queryAddr = item?.address;
+            const addr = prop?.address;
+            const fullAddr = addr
+                ? `${addr.formatted_street_address}, ${addr.city}, ${addr.state} ${addr.zip_code}`
+                : queryAddr ?? "Unknown";
+            if (item?.error) {
+                lines.push(`### ${queryAddr ?? "Unknown"}`);
+                const errMsg = typeof item.error === "string" ? item.error : JSON.stringify(item.error);
+                lines.push(`_Error: ${errMsg}_`);
+                lines.push("");
+                continue;
+            }
+            lines.push(`### ${fullAddr}`);
+            lines.push(kvSummary([
+                ["Property Type", prop?.property_type],
+                ["Beds/Baths", `${prop?.structure?.beds_count ?? "?"} / ${prop?.structure?.baths ?? "?"}`],
+                ["Sqft", prop?.structure?.total_area_sq_ft],
+                ["Year Built", prop?.structure?.year_built],
+                ["Last Sale", prop?.last_sale?.price ? `$${Number(prop.last_sale.price).toLocaleString()} (${prop.last_sale.date})` : undefined],
+                ["Assessed Value", prop?.assessments?.assessed_value ? `$${Number(prop.assessments.assessed_value).toLocaleString()}` : undefined],
+                ["Owner", prop?.owner?.name],
+                ["Owner Occupied", prop?.owner?.owner_occupied],
+            ]));
+            lines.push("");
+        }
+        if (items.length === 0) {
+            lines.push("```json");
+            lines.push(truncatedJson(data, 3000));
+            lines.push("```");
+        }
+        const firstItem = items.find((i) => !i?.error);
+        const firstProp = firstItem?.property ?? firstItem;
+        const firstPropAddr = firstProp?.address
+            ? `${firstProp.address.formatted_street_address}, ${firstProp.address.city}, ${firstProp.address.state} ${firstProp.address.zip_code}`
+            : args.addresses[0];
+        const actions = [
+            action("sfr_rental_comparables", "Rental comps for first property", { address: firstPropAddr }),
+            action("sfr_property_comps", "Sales comps for first property", { address: firstPropAddr }),
+        ];
+        return structuredResult(lines.join("\n"), { items, total: items.length, page: 1 }, actions);
+    });
+}
+//# sourceMappingURL=propertyBatch.js.map

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

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

package/dist/tools/sfr/propertyComps.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 registerPropertyCompsTool(server: McpServer, sfr: SfrClient): void;

package/dist/tools/sfr/propertyComps.js

@@ -0,0 +1,56 @@
+import { z } from "zod";
+import { structuredResult, markdownTable, truncatedJson } from "../formatters.js";
+import { action } from "../nextActions.js";
+import { registerToolSafe } from "../registerToolSafe.js";
+const Input = z.object({
+    address: z.string().describe("Full property address, e.g. '123 Main St, Phoenix, AZ 85004'"),
+    page: z.coerce.number().default(1).describe("Page number"),
+    page_size: z.coerce.number().min(20).default(25).describe("Results per page (min 20)"),
+});
+export function registerPropertyCompsTool(server, sfr) {
+    registerToolSafe(server, "sfr_property_comps", {
+        title: "Get nearby sales comparables (SFR)",
+        description: "Get recent nearby SALES comparables for a property by address. " +
+            "Returns similar properties with sale prices, dates, beds, sqft, and distance. " +
+            "Use this for property valuation based on recent sales. " +
+            "For RENTAL comparables, use sfr_rental_comparables instead.",
+        inputSchema: Input,
+    }, async (args) => {
+        const data = await sfr.getNearbySales({
+            address: args.address,
+            page: args.page,
+            page_size: args.page_size,
+        });
+        const items = data?.data ?? (Array.isArray(data) ? data : []);
+        const total = data?.total ?? items.length;
+        const lines = [
+            `## Nearby Sales — ${args.address}`,
+            `**Total:** ${total} comparables`,
+            "",
+        ];
+        if (items.length > 0) {
+            const fmt$ = (v) => v != null ? `$${Number(v).toLocaleString()}` : "—";
+            const rows = items.slice(0, 25).map((c) => [
+                c.FULL_STREET_ADDRESS ?? c.address ?? "—",
+                c.CITY ?? c.city ?? "—",
+                fmt$(c.SALE_AMT ?? c.sales_price),
+                c.RECORDING_DATE ?? c.recording_date ?? c.SALE_DATE ?? "—",
+                c.SUM_BUILDING_SQFT ?? c.building_sqft ?? "—",
+                c.YEAR_BUILT ?? c.year_built ?? "—",
+            ]);
+            lines.push(markdownTable(["Address", "City", "Price", "Date", "Sqft", "Year Built"], rows));
+        }
+        else {
+            lines.push("```json");
+            lines.push(truncatedJson(data, 3000));
+            lines.push("```");
+        }
+        const actions = [
+            action("sfr_get_property", "Full property details", { address: args.address }),
+            action("sfr_rental_comparables", "Rental comps to estimate income", { address: args.address }),
+            action("plr_loans_nearby", "Private lending activity nearby", { propertyAddress: args.address }),
+        ];
+        return structuredResult(lines.join("\n"), { items, total, page: args.page }, actions);
+    });
+}
+//# sourceMappingURL=propertyComps.js.map

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

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

package/dist/tools/sfr/propertyTransactions.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 registerPropertyTransactionsTool(server: McpServer, sfr: SfrClient): void;

package/dist/tools/sfr/propertyTransactions.js

@@ -0,0 +1,50 @@
+import { z } from "zod";
+import { structuredResult, markdownTable, truncatedJson } from "../formatters.js";
+import { action } from "../nextActions.js";
+import { registerToolSafe } from "../registerToolSafe.js";
+const Input = z.object({
+    address: z.string().describe("Full property address, e.g. '123 Main St, Phoenix, AZ 85004'"),
+});
+export function registerPropertyTransactionsTool(server, sfr) {
+    registerToolSafe(server, "sfr_property_transactions", {
+        title: "Property transaction history (SFR)",
+        description: "Get the full transaction history (deeds, sales, mortgages) for a specific property address. " +
+            "Shows every recorded ownership change and financing event. " +
+            "Use this to understand a property's chain of title, price appreciation, and financing patterns.",
+        inputSchema: Input,
+    }, async (args) => {
+        const data = await sfr.getPropertyTransactions(args.address);
+        // API returns {property_id, address, transactions: [...]}
+        const items = data?.transactions ?? data?.data ?? (Array.isArray(data) ? data : []);
+        const lines = [
+            `## Transaction History — ${args.address}`,
+            `**Transactions:** ${items.length}`,
+            "",
+        ];
+        if (items.length > 0) {
+            const fmt$ = (v) => v != null && Number(v) > 0 ? `$${Number(v).toLocaleString()}` : "—";
+            const rows = items.slice(0, 30).map((t) => [
+                t.RECORDING_DATE ?? t.recording_date ?? "—",
+                t.TRANSACTION_TYPE ?? t.transaction_type ?? "—",
+                fmt$(t.SALE_AMT ?? t.sale_amt),
+                t.BUYER_BORROWER1_NAME ?? t.buyer_name ?? "—",
+                t.SELLER1_NAME ?? t.seller_name ?? "—",
+                fmt$(t.FIRST_MTG_AMT ?? t.mortgage_amount),
+                t.FIRST_MTG_LENDER_NAME ?? "—",
+            ]);
+            lines.push(markdownTable(["Date", "Type", "Sale Price", "Buyer", "Seller", "Mortgage", "Lender"], rows));
+        }
+        else {
+            lines.push("```json");
+            lines.push(truncatedJson(data, 3000));
+            lines.push("```");
+        }
+        const actions = [
+            action("sfr_get_property", "Current property details & valuation", { address: args.address }),
+            action("sfr_rental_comparables", "Estimate rental income", { address: args.address }),
+            action("plr_transaction_history", "Private lending history", { propertyAddress: args.address }),
+        ];
+        return structuredResult(lines.join("\n"), { items, total: items.length, page: 1 }, actions);
+    });
+}
+//# sourceMappingURL=propertyTransactions.js.map

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

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

package/dist/tools/sfr/rentalComparables.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 registerRentalComparablesTool(server: McpServer, sfr: SfrClient): void;

package/dist/tools/sfr/rentalComparables.js

@@ -0,0 +1,91 @@
+import { z } from "zod";
+import { structuredResult, markdownTable, truncatedJson } from "../formatters.js";
+import { action } from "../nextActions.js";
+import { registerToolSafe } from "../registerToolSafe.js";
+const Input = z.object({
+    address: z.string().describe("Full property address, e.g. '123 Main St, Phoenix, AZ 85004'"),
+    radius: z.coerce.number().optional().describe("Search radius in miles (default varies by API)"),
+    page: z.coerce.number().default(1).describe("Page number (default 1)"),
+    page_size: z.coerce.number().default(25).describe("Results per page (default 25, max 100)"),
+});
+export function registerRentalComparablesTool(server, sfr) {
+    registerToolSafe(server, "sfr_rental_comparables", {
+        title: "Rental comparables by address (SFR)",
+        description: "Find nearby rental comparables for a property. Returns similar properties that have rented " +
+            "recently with their rent amounts, bed/bath, and distance. " +
+            "Use this to estimate fair market rent for an investment property.",
+        inputSchema: Input,
+    }, async (args) => {
+        // API requires separate street/city/state/zip_code fields
+        const parts = args.address.split(",").map((s) => s.trim());
+        const query = {
+            page: args.page,
+            page_size: args.page_size,
+        };
+        if (parts.length >= 3) {
+            // "123 Main St, City, ST 85004" or "123 Main St, City, ST, 85004"
+            query.street = parts[0];
+            query.city = parts[1];
+            const stateZip = parts.length >= 4
+                ? { state: parts[2], zip_code: parts[3] }
+                : (() => {
+                    const m = parts[2].match(/^([A-Z]{2})\s+(\d{5})/);
+                    return m ? { state: m[1], zip_code: m[2] } : { state: parts[2] };
+                })();
+            Object.assign(query, stateZip);
+        }
+        else {
+            // Fallback: pass as-is and let the API handle it
+            query.street = args.address;
+        }
+        if (args.radius !== undefined)
+            query.radius = args.radius;
+        const data = await sfr.getRentalComparables(query);
+        // API returns {subject, comparables: [...], analysis}
+        const items = data?.comparables ?? data?.data ?? (Array.isArray(data) ? data : []);
+        const total = items.length;
+        const lines = [
+            `## Rental Comparables — ${args.address}`,
+            `**Total:** ${total} comps`,
+            "",
+        ];
+        if (data?.subject) {
+            const subj = data.subject;
+            lines.push(`**Subject:** ${subj.address}`);
+            if (subj.attributes) {
+                const a = subj.attributes;
+                lines.push(`**Attributes:** ${a.bedrooms ?? "?"} bed / ${a.bathrooms ?? "?"} bath / ${a.sqft ?? "?"} sqft / ${a.propertyType ?? "?"}`);
+            }
+            lines.push("");
+        }
+        if (items.length > 0) {
+            const rows = items.slice(0, 25).map((c) => [
+                c.address ?? "—",
+                c.rent != null ? `$${Math.round(Number(c.rent)).toLocaleString()}/mo` : "—",
+                c.rentPerSqft != null ? `$${Number(c.rentPerSqft).toFixed(2)}` : "—",
+                c.attributes?.bedrooms ?? "—",
+                c.attributes?.bathrooms ?? "—",
+                c.attributes?.sqft ?? "—",
+                c.similarity != null ? `${(Number(c.similarity) * 100).toFixed(0)}%` : "—",
+            ]);
+            lines.push(markdownTable(["Address", "Rent", "$/Sqft", "Beds", "Baths", "Sqft", "Similarity"], rows));
+            if (data?.analysis) {
+                lines.push("", "### Analysis", "```json");
+                lines.push(truncatedJson(data.analysis, 2000));
+                lines.push("```");
+            }
+        }
+        else {
+            lines.push("```json");
+            lines.push(truncatedJson(data, 3000));
+            lines.push("```");
+        }
+        const actions = [
+            action("sfr_get_property", "Full property details", { address: args.address }),
+            action("sfr_property_comps", "Sales comps for valuation", { address: args.address }),
+            action("plr_loans_nearby", "Private lending activity nearby", { propertyAddress: args.address }),
+        ];
+        return structuredResult(lines.join("\n"), { subject: data?.subject, analysis: data?.analysis, items, total, page: args.page }, actions);
+    });
+}
+//# sourceMappingURL=rentalComparables.js.map

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

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

package/dist/tools/sfr/rentalMarketAnalysis.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 registerRentalMarketAnalysisTool(server: McpServer, sfr: SfrClient): void;

package/dist/tools/sfr/rentalMarketAnalysis.js

@@ -0,0 +1,134 @@
+import { z } from "zod";
+import { structuredResult, kvSummary, markdownTable, fmtPercent } from "../formatters.js";
+import { action } from "../nextActions.js";
+import { registerToolSafe } from "../registerToolSafe.js";
+const Input = z.object({
+    geography_type: z
+        .enum(["city", "county", "msa", "state", "zipCode"])
+        .describe("Type of geography to analyze"),
+    geography_values: z
+        .string()
+        .describe("Comma-separated geography values (e.g. 'Jacksonville,Tampa' for cities, 'FL' for state)"),
+    time_range_start: z.string().optional().describe("Start date (YYYY-MM-DD)"),
+    time_range_end: z.string().optional().describe("End date (YYYY-MM-DD)"),
+    property_types: z.string().optional().describe("Comma-separated property types"),
+    bedrooms: z.string().optional().describe("Comma-separated bedroom counts (e.g. '2,3,4')"),
+});
+export function registerRentalMarketAnalysisTool(server, sfr) {
+    registerToolSafe(server, "sfr_rental_market_analysis", {
+        title: "Rental market analysis with trends (SFR)",
+        description: "Analyze rental market trends: YoY rent growth, monthly rent trends, and market metrics. " +
+            "Use this to find where rents are increasing or decreasing. " +
+            "Compare multiple geographies by passing comma-separated values. " +
+            "IMPORTANT: Use geography_type='city' for best results. MSA and state queries frequently return all zeros. If you need MSA-level rental data, use sfr_rental_stats instead. " +
+            "For point-in-time rental stats (median, percentiles), use sfr_rental_stats instead.",
+        inputSchema: Input,
+    }, async (args) => {
+        const query = {
+            geography_type: args.geography_type,
+            geography_values: args.geography_values,
+        };
+        if (args.time_range_start)
+            query.time_range_start = args.time_range_start;
+        if (args.time_range_end)
+            query.time_range_end = args.time_range_end;
+        if (args.property_types)
+            query.property_types = args.property_types;
+        if (args.bedrooms)
+            query.bedrooms = args.bedrooms;
+        const data = await sfr.getRentalMarketAnalysis(query);
+        const markets = Array.isArray(data?.markets) ? data.markets : [];
+        const lines = [
+            `## Rental Market Analysis`,
+            `_Geography: ${args.geography_type} — ${args.geography_values}_`,
+            "",
+        ];
+        if (markets.length === 0) {
+            lines.push("_No market data returned. Check geography values are valid._");
+            return structuredResult(lines.join("\n"), { markets: [], error: "no_data" });
+        }
+        // Summary for each market
+        for (const market of markets) {
+            const geo = market.geography ?? "Unknown";
+            const m = market.metrics ?? {};
+            const yoy = m.rentGrowthYoY;
+            lines.push(`### ${geo}`);
+            lines.push("");
+            lines.push(kvSummary([
+                ["Average Rent", m.averageRent ? `$${Math.round(m.averageRent).toLocaleString()}/mo` : undefined],
+                ["Median Rent", m.medianRent ? `$${Math.round(m.medianRent).toLocaleString()}/mo` : undefined],
+                ["YoY Growth", yoy != null ? fmtPercent(yoy * 100) : "N/A"],
+                ["Total Listings", m.totalListings?.toLocaleString()],
+                ["Avg Rent/sqft", m.averageRentPerSqft ? `$${m.averageRentPerSqft.toFixed(2)}/sqft` : undefined],
+            ]));
+            lines.push("");
+            // Monthly trends table (last 12 months if available)
+            const trends = market.trends?.monthly ?? [];
+            if (trends.length > 0) {
+                const recentTrends = trends.slice(-12);
+                lines.push("#### Monthly Trends (last 12 months)");
+                const rows = recentTrends.map((t) => [
+                    t.month,
+                    t.avgRent ? `$${t.avgRent.toLocaleString()}` : "—",
+                    t.volume?.toLocaleString() ?? "—",
+                ]);
+                lines.push(markdownTable(["Month", "Avg Rent", "Volume"], rows));
+                lines.push("");
+            }
+        }
+        // Structured output
+        const structured = {
+            markets: markets.map((m) => ({
+                geography: m.geography,
+                metrics: {
+                    averageRent: m.metrics?.averageRent,
+                    medianRent: m.metrics?.medianRent,
+                    rentGrowthYoY: m.metrics?.rentGrowthYoY,
+                    totalListings: m.metrics?.totalListings,
+                    averageRentPerSqft: m.metrics?.averageRentPerSqft,
+                    priceDistribution: m.metrics?.priceDistribution,
+                },
+                trendsSummary: {
+                    monthCount: (m.trends?.monthly ?? []).length,
+                    latestMonth: (m.trends?.monthly ?? []).at(-1)?.month,
+                    latestAvgRent: (m.trends?.monthly ?? []).at(-1)?.avgRent,
+                },
+                trends: (m.trends?.monthly ?? []).slice(-12),
+            })),
+        };
+        // Determine search_type + location for nextActions
+        const geoTypeToSearch = {
+            city: "city",
+            county: "county",
+            msa: "msa",
+            state: "state",
+            zipCode: "zip",
+        };
+        const searchType = geoTypeToSearch[args.geography_type] ?? "city";
+        const firstGeo = args.geography_values.split(",")[0]?.trim();
+        const locArgs = { search_type: searchType };
+        if (searchType === "city")
+            locArgs.city = firstGeo;
+        else if (searchType === "state")
+            locArgs.state = firstGeo;
+        else if (searchType === "zip")
+            locArgs.zips = firstGeo;
+        else if (searchType === "msa")
+            locArgs.msa = firstGeo;
+        else if (searchType === "county")
+            locArgs.county = firstGeo;
+        // sfr_top_buyers supports state/city/zip/msa but NOT county
+        const topBuyersSupported = searchType !== "county";
+        const actions = [
+            action("sfr_rental_stats", "Point-in-time rental stats", locArgs),
+            ...(topBuyersSupported
+                ? [action("sfr_top_buyers", "Active buyers in this area", locArgs)]
+                : []),
+            action("sfr_zip_finder", "Rank zips by yield", {
+                sort: "-gross_yield",
+            }),
+        ];
+        return structuredResult(lines.join("\n"), structured, actions);
+    });
+}
+//# sourceMappingURL=rentalMarketAnalysis.js.map

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

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

package/dist/tools/sfr/rentalStats.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 registerRentalStatsTool(server: McpServer, sfr: SfrClient): void;