@sfranalytics/mcp 0.6.0

package/dist/server.js

@@ -0,0 +1,213 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { VERSION } from "./version.js";
+import { HttpClient } from "./services/httpClient.js";
+import { SfrClient } from "./services/sfr.js";
+import { PlrClient } from "./services/plr.js";
+// Tool registrations — Health
+import { registerHealthTool } from "./tools/health.js";
+// SFR Tools
+import { registerSearchPropertiesTool } from "./tools/sfr/searchProperties.js";
+import { registerGetPropertyTool } from "./tools/sfr/getProperty.js";
+import { registerPropertyTransactionsTool } from "./tools/sfr/propertyTransactions.js";
+import { registerMlsListingsTool } from "./tools/sfr/propertyBatch.js";
+import { registerPropertyCompsTool } from "./tools/sfr/propertyComps.js";
+import { registerRentalStatsTool } from "./tools/sfr/rentalStats.js";
+import { registerRentalComparablesTool } from "./tools/sfr/rentalComparables.js";
+import { registerZipFinderTool } from "./tools/sfr/zipFinder.js";
+import { registerZipDetailTool } from "./tools/sfr/zipDetail.js";
+import { registerTopBuyersTool } from "./tools/sfr/topBuyers.js";
+import { registerBuyerProfileTool } from "./tools/sfr/buyerProfile.js";
+import { registerBuyerGrowthTool } from "./tools/sfr/buyerGrowth.js";
+import { registerBestBuyersTool } from "./tools/sfr/bestBuyers.js";
+import { registerMarketHighlightsTool } from "./tools/sfr/marketHighlights.js";
+import { registerInvestorActivityTool } from "./tools/sfr/investorActivity.js";
+import { registerFlipStatsTool } from "./tools/sfr/flipStats.js";
+import { registerFlipActivityTool } from "./tools/sfr/flipActivity.js";
+import { registerInstitutionalOwnersTool } from "./tools/sfr/institutionalOwners.js";
+import { registerActivityHighlightsTool } from "./tools/sfr/activityHighlights.js";
+import { registerDistressSearchTool } from "./tools/sfr/distressSearch.js";
+import { registerRentalMarketAnalysisTool } from "./tools/sfr/rentalMarketAnalysis.js";
+// PLR Tools
+import { registerBorrowerSearchTool } from "./tools/plr/borrowerSearch.js";
+import { registerBorrowerProfileTool } from "./tools/plr/borrowerProfile.js";
+import { registerBorrowerRankingsTool } from "./tools/plr/borrowerRankings.js";
+import { registerTopBorrowersTool } from "./tools/plr/topBorrowers.js";
+import { registerBorrowerLoansTool } from "./tools/plr/borrowerLoans.js";
+import { registerBorrowerContactsTool } from "./tools/plr/borrowerContacts.js";
+import { registerLenderRankingsTool } from "./tools/plr/lenderRankings.js";
+import { registerTopLendersTool } from "./tools/plr/topLenders.js";
+import { registerLenderBorrowersTool } from "./tools/plr/lenderBorrowers.js";
+import { registerChurnedBorrowersTool } from "./tools/plr/churnedBorrowers.js";
+import { registerMarketTrendsTool } from "./tools/plr/marketTrends.js";
+import { registerMsaRankingsTool } from "./tools/plr/msaRankings.js";
+import { registerLoansNearbyTool } from "./tools/plr/loansNearby.js";
+import { registerTransactionHistoryTool } from "./tools/plr/transactionHistory.js";
+import { registerPortfolioSummaryTool } from "./tools/plr/portfolioSummary.js";
+import { registerNegativeRemarksTool } from "./tools/plr/negativeRemarks.js";
+import { registerOwnerSearchTool } from "./tools/plr/ownerSearch.js";
+import { registerPrompts } from "./tools/prompts.js";
+// Snowflake Tools
+import { registerMarketSnapshotTool } from "./tools/snowflake/marketSnapshot.js";
+import { registerMarketTrendsTool as registerSfMarketTrendsTool } from "./tools/snowflake/marketTrends.js";
+import { registerCompareMarketsTool } from "./tools/snowflake/compareMarkets.js";
+import { registerRankZipsTool } from "./tools/snowflake/rankZips.js";
+import { registerRentalMarketTool } from "./tools/snowflake/rentalMarket.js";
+import { registerRentalYieldTool } from "./tools/snowflake/rentalYield.js";
+import { registerRankRentalZipsTool } from "./tools/snowflake/rankRentalZips.js";
+import { registerZipInvestorActivityTool } from "./tools/snowflake/investorActivity.js";
+import { registerZipProfileTool } from "./tools/snowflake/zipProfile.js";
+import { registerHviTrendTool } from "./tools/snowflake/hviTrend.js";
+import { initSnowflake } from "./services/snowflake.js";
+function buildInstructions(hasSfr, hasPlr, hasSnowflake) {
+    const sections = [
+        "SFR Analytics MCP — real estate investment data for single-family rental (SFR) markets.",
+        "",
+    ];
+    sections.push("DATA SOURCES:");
+    if (hasSfr) {
+        sections.push("  SFR API (sfr_*) — Property transactions, buyer profiles, rental data, zip analytics, market activity");
+    }
+    if (hasPlr) {
+        sections.push("  Private Lender Radar (plr_*) — Private/hard-money lending: borrowers, lenders, loan trends");
+    }
+    if (hasSnowflake) {
+        sections.push("  Snowflake (sfr_market_*, sfr_rental_*, sfr_zip_*, sfr_hvi_*) — Redfin market data, census demographics, rental yield, investor activity");
+    }
+    sections.push("", "TOOL GROUPS & WHEN TO USE EACH:", "");
+    if (hasSfr) {
+        sections.push("Property Research: sfr_search_properties (find transactions), sfr_get_property (single property),", "  sfr_property_transactions (history), sfr_property_batch (MLS listings), sfr_property_comps (comparables),", "  sfr_distress_search (pre-foreclosure, vacant, zombie foreclosure properties)", "", "Rental Analysis: sfr_rental_stats (market-level stats by location), sfr_rental_comparables (comps near address),", "  sfr_rental_market_analysis (YoY rent growth, monthly trends — find where rents are rising/falling)", "", "Zip/Market Screening: sfr_zip_finder (rank zips by yield/rent/value), sfr_zip_detail (deep-dive one zip),", "  sfr_institutional_owners (REITs/funds in area)", "", "Buyer Intelligence: sfr_top_buyers (any geography), sfr_market_highlights (MSA-only with filters),", "  sfr_buyer_profile (investor portfolio & strategy), sfr_buyer_growth (trends over time),", "  sfr_best_buyers (hot deals), sfr_activity_highlights (quick market snapshot)", "", "Market Activity: sfr_investor_activity (MSA transactions with portfolio size),", "  sfr_flip_stats (flip market summary), sfr_flip_activity (individual flips)", "");
+    }
+    if (hasPlr) {
+        sections.push("Lending Intelligence: plr_borrower_search (filter by loans/type/state/contacts),", "  plr_borrower_rankings (growth metrics), plr_top_borrowers (nationwide leaderboard),", "  plr_borrower_profile (full profile), plr_borrower_loans (loan history), plr_borrower_contacts (contact info)", "", "Lender Intelligence: plr_lender_rankings (by loan count, nationwide), plr_top_lenders (by volume, with geo),", "  plr_lender_borrowers (lender's clients), plr_churned_borrowers (lender's lost clients)", "", "Market Trends: plr_market_trends (nationwide time series), plr_msa_rankings (geographic rankings),", "  plr_portfolio_summary (nationwide totals), plr_loans_nearby (loans near address),", "  plr_transaction_history (nationwide transaction feed)", "", "Negative Remarks: plr_negative_remarks (foreclosures, defaults, adverse events by borrower/lender)", "", "Principal Search: plr_owner_search (search by person name, not LLC)", "");
+    }
+    if (hasSnowflake) {
+        sections.push("Snowflake Market Data: sfr_market_snapshot (ZIP/city Redfin snapshot with buyer leverage),", "  sfr_market_trends (price/DOM/inventory time series), sfr_compare_markets (side-by-side 2-4 locations),", "  sfr_rank_zips (rank ZIPs by price/DOM/growth/inventory in a metro)", "", "Snowflake Rental & Yield: sfr_rental_market_sf (rent stats with percentiles from 5.9M listings),", "  sfr_rental_yield (market yield vs acquisition yield, cap rates, 1% rule),", "  sfr_rank_rental_zips (rank ZIPs by rent/yield/listings)", "", "Snowflake Census & Investor: sfr_zip_profile (demographics, housing stock, SFH detail),", "  sfr_hvi_trend (home value + rental value index over time),", "  sfr_zip_investor_activity (cash/corp/flip transactions, current corporate ownership)", "");
+    }
+    sections.push("COMMON WORKFLOWS:");
+    if (hasSfr) {
+        sections.push("1. Market screening: sfr_zip_finder -> sfr_zip_detail -> sfr_rental_stats -> sfr_top_buyers", "2. Buyer research: sfr_top_buyers -> sfr_buyer_profile -> sfr_buyer_growth");
+    }
+    if (hasPlr) {
+        sections.push(`${hasSfr ? "3" : "1"}. Lending market: plr_portfolio_summary -> plr_market_trends -> plr_msa_rankings`, `${hasSfr ? "4" : "2"}. Borrower outreach: plr_borrower_search -> plr_borrower_loans -> plr_borrower_contacts`);
+    }
+    if (hasSfr) {
+        sections.push(`${hasPlr ? "5" : "3"}. Property analysis: sfr_search_properties -> sfr_get_property -> sfr_rental_comparables`);
+    }
+    if (hasSfr && hasPlr) {
+        sections.push("6. Lender market share: plr_top_lenders (filter by state/MSA/loanType for competitive analysis)", "7. Borrower distress: plr_churned_borrowers -> plr_negative_remarks (check for defaults) -> plr_borrower_loans (get state) -> sfr_distress_search (owner_name + state)", "8. Investor deep-dive: sfr_top_buyers -> sfr_buyer_profile -> plr_borrower_search (check if buyer borrows privately)", "9. Maturing loans prospecting: plr_borrower_search (nextDueStart/nextDueEnd for maturity window) -> plr_borrower_loans (outstandingOnly=true) -> plr_borrower_contacts", "10. Competitive intelligence: plr_top_lenders (market share) -> plr_lender_borrowers (lender's clients) -> plr_churned_borrowers (lost clients) -> plr_borrower_contacts (outreach)", "11. Market sizing: plr_borrower_search (count borrowers by MSA, minBridgeLoans for tier proxy) -> plr_msa_rankings (YoY growth) -> plr_portfolio_summary (national context)", "12. Borrower deep-dive: plr_borrower_search -> plr_borrower_profile (lender relationships) -> plr_borrower_loans (LTC calculation, deal sizes) -> plr_borrower_contacts (phone/email)");
+    }
+    sections.push("", "IMPORTANT NOTES:");
+    if (hasPlr) {
+        sections.push("  plr_market_trends and plr_portfolio_summary are NATIONWIDE only — no geographic filters", "  plr_top_borrowers has NO MSA/city filter — use plr_borrower_search for metro-level queries", "  plr_owner_search requires state filter for best results — person names are matched within states");
+    }
+    if (hasSfr) {
+        sections.push("  sfr_buyer_profile only works for major institutional investors — use sfr_top_buyers to find names", "  Buyer endpoints with search_type param require matching location param (e.g., search_type='state' needs state=)", "  sfr_top_buyers search_type='city' requires both city= and state= params", "  sfr_rental_market_analysis works best at city level — MSA/state often returns zeros", "  sfr_investor_activity is the best tool for cash buyer identification (isCashBuyer field) — sfr_search_properties purchase_type is NOT a cash filter", "  sfr_flip_activity supports buyer_name filter (partial match, case-insensitive) — use for iBuyer margin analysis (e.g. buyer_name='OPENDOOR')", "  sfr_search_properties with seller_name is the best tool for 'where is [institution] selling?' — broader date range than sfr_investor_activity");
+    }
+    if (hasSfr && hasPlr) {
+        sections.push("  sfr_distress_search requires a location filter — when using owner_name from PLR, include state from plr_borrower_loans", "  PLR lender tools: use short 'lender' field names for plr_lender_borrowers/plr_churned_borrowers, not display 'clean_name'", "  PLR and SFR APIs use DIFFERENT MSA names for the same metro (e.g. PLR: 'Austin-Round Rock-San Marcos, TX' vs SFR: 'Austin-Round Rock-Georgetown, TX'). Use plr_msa_rankings to discover correct PLR MSA names. SFR tools auto-resolve MSA names for sfr_investor_activity, sfr_market_highlights, sfr_top_buyers, sfr_flip_stats, sfr_flip_activity, and sfr_institutional_owners.");
+    }
+    sections.push("  Use sfra_health to verify API connectivity");
+    return sections.join("\n");
+}
+export function createServer(config) {
+    const hasSfr = config.sfr !== null;
+    const hasPlr = config.plr !== null;
+    const hasSnowflake = config.snowflake !== null;
+    let sfrClient = null;
+    let plrClient = null;
+    if (config.sfr) {
+        const sfrHttp = new HttpClient({
+            baseUrl: config.sfr.baseUrl,
+            defaultHeaders: { [config.sfr.apiTokenHeader]: config.sfr.apiToken },
+            timeoutMs: config.http.timeoutMs,
+        });
+        sfrClient = new SfrClient(sfrHttp);
+    }
+    if (config.plr) {
+        const plrHttp = new HttpClient({
+            baseUrl: config.plr.baseUrl,
+            defaultHeaders: { [config.plr.apiTokenHeader]: config.plr.apiToken },
+            timeoutMs: config.http.timeoutMs,
+        });
+        plrClient = new PlrClient(plrHttp);
+    }
+    if (config.snowflake) {
+        initSnowflake(config.snowflake);
+    }
+    const server = new McpServer({ name: "@sfranalytics/mcp", version: VERSION }, {
+        capabilities: { logging: {} },
+        instructions: buildInstructions(hasSfr, hasPlr, hasSnowflake),
+    });
+    // Health — always registered, checks only configured APIs
+    registerHealthTool(server, sfrClient, plrClient, config);
+    // SFR Tools
+    if (sfrClient) {
+        // Properties (6)
+        registerSearchPropertiesTool(server, sfrClient);
+        registerGetPropertyTool(server, sfrClient);
+        registerPropertyTransactionsTool(server, sfrClient);
+        registerMlsListingsTool(server, sfrClient);
+        registerPropertyCompsTool(server, sfrClient);
+        registerDistressSearchTool(server, sfrClient);
+        // Rentals (3)
+        registerRentalStatsTool(server, sfrClient);
+        registerRentalComparablesTool(server, sfrClient);
+        registerRentalMarketAnalysisTool(server, sfrClient);
+        // Zip/Geo Analytics (3)
+        registerZipFinderTool(server, sfrClient);
+        registerZipDetailTool(server, sfrClient);
+        registerInstitutionalOwnersTool(server, sfrClient);
+        // Buyers & Investors (5)
+        registerTopBuyersTool(server, sfrClient);
+        registerBuyerProfileTool(server, sfrClient);
+        registerBuyerGrowthTool(server, sfrClient);
+        registerBestBuyersTool(server, sfrClient);
+        registerMarketHighlightsTool(server, sfrClient);
+        // Market Activity (4)
+        registerInvestorActivityTool(server, sfrClient);
+        registerFlipStatsTool(server, sfrClient);
+        registerFlipActivityTool(server, sfrClient);
+        registerActivityHighlightsTool(server, sfrClient);
+    }
+    // PLR Tools
+    if (plrClient) {
+        // Borrowers (6)
+        registerBorrowerSearchTool(server, plrClient);
+        registerBorrowerProfileTool(server, plrClient);
+        registerBorrowerRankingsTool(server, plrClient);
+        registerTopBorrowersTool(server, plrClient);
+        registerBorrowerLoansTool(server, plrClient);
+        registerBorrowerContactsTool(server, plrClient);
+        // Lenders (4)
+        registerLenderRankingsTool(server, plrClient);
+        registerTopLendersTool(server, plrClient);
+        registerLenderBorrowersTool(server, plrClient);
+        registerChurnedBorrowersTool(server, plrClient);
+        // Market & Portfolio (5)
+        registerMarketTrendsTool(server, plrClient);
+        registerMsaRankingsTool(server, plrClient);
+        registerLoansNearbyTool(server, plrClient);
+        registerTransactionHistoryTool(server, plrClient);
+        registerPortfolioSummaryTool(server, plrClient);
+        // Negative Remarks & Owner Search (2)
+        registerNegativeRemarksTool(server, plrClient);
+        registerOwnerSearchTool(server, plrClient);
+    }
+    // Snowflake Tools (10)
+    if (hasSnowflake) {
+        registerMarketSnapshotTool(server);
+        registerSfMarketTrendsTool(server);
+        registerCompareMarketsTool(server);
+        registerRankZipsTool(server);
+        registerRentalMarketTool(server);
+        registerRentalYieldTool(server);
+        registerRankRentalZipsTool(server);
+        registerZipInvestorActivityTool(server);
+        registerZipProfileTool(server);
+        registerHviTrendTool(server);
+    }
+    // Example prompts — scoped to available APIs
+    registerPrompts(server, hasSfr, hasPlr);
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/services/httpClient.d.ts

@@ -0,0 +1,19 @@
+export declare class ApiError extends Error {
+    readonly status: number;
+    readonly url: string;
+    readonly details?: unknown | undefined;
+    constructor(message: string, status: number, url: string, details?: unknown | undefined);
+}
+export type HttpClientOptions = {
+    baseUrl: string;
+    defaultHeaders: Record<string, string>;
+    timeoutMs: number;
+};
+export declare class HttpClient {
+    private readonly opts;
+    constructor(opts: HttpClientOptions);
+    request<T>(method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE", path: string, init?: {
+        query?: Record<string, string | number | boolean | undefined | unknown>;
+        body?: unknown;
+    }): Promise<T>;
+}

package/dist/services/httpClient.js

@@ -0,0 +1,73 @@
+import { VERSION } from "../version.js";
+export class ApiError extends Error {
+    status;
+    url;
+    details;
+    constructor(message, status, url, details) {
+        super(message);
+        this.status = status;
+        this.url = url;
+        this.details = details;
+        this.name = "ApiError";
+    }
+}
+export class HttpClient {
+    opts;
+    constructor(opts) {
+        this.opts = opts;
+    }
+    async request(method, path, init) {
+        const url = new URL(this.opts.baseUrl + path);
+        if (init?.query) {
+            for (const [k, v] of Object.entries(init.query)) {
+                if (v === undefined)
+                    continue;
+                if (Array.isArray(v)) {
+                    for (const item of v)
+                        url.searchParams.append(k, String(item));
+                }
+                else if (typeof v === "object" && v !== null) {
+                    url.searchParams.set(k, JSON.stringify(v));
+                }
+                else {
+                    url.searchParams.set(k, String(v));
+                }
+            }
+        }
+        const controller = new AbortController();
+        const t = setTimeout(() => controller.abort(), this.opts.timeoutMs);
+        try {
+            const res = await fetch(url, {
+                method,
+                headers: {
+                    "User-Agent": `@sfranalytics/mcp/${VERSION}`,
+                    ...this.opts.defaultHeaders,
+                    ...(init?.body ? { "Content-Type": "application/json" } : {}),
+                },
+                body: init?.body ? JSON.stringify(init.body) : undefined,
+                signal: controller.signal,
+            });
+            const contentType = res.headers.get("content-type") ?? "";
+            const isJson = contentType.includes("application/json");
+            const payload = isJson
+                ? await res.json().catch(() => undefined)
+                : await res.text().catch(() => "");
+            if (!res.ok) {
+                throw new ApiError(`HTTP ${res.status} ${method} ${path}`, res.status, url.toString(), payload);
+            }
+            return payload;
+        }
+        catch (err) {
+            if (err instanceof ApiError)
+                throw err;
+            if (err instanceof Error && err.name === "AbortError") {
+                throw new ApiError(`Timeout after ${this.opts.timeoutMs}ms`, 408, url.toString());
+            }
+            throw err;
+        }
+        finally {
+            clearTimeout(t);
+        }
+    }
+}
+//# sourceMappingURL=httpClient.js.map

package/dist/services/httpClient.js.map

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

package/dist/services/plr.d.ts

@@ -0,0 +1,26 @@
+import { HttpClient } from "./httpClient.js";
+export declare class PlrClient {
+    private readonly http;
+    constructor(http: HttpClient);
+    borrowerListBuilder(filters: Record<string, unknown>): Promise<unknown>;
+    borrowerProfile(params: Record<string, unknown>): Promise<unknown>;
+    borrowerRankings(filters: Record<string, unknown>): Promise<unknown>;
+    nationwideLargestBorrowers(filters: Record<string, unknown>): Promise<unknown>;
+    borrowerLoans(filters: Record<string, unknown>): Promise<unknown>;
+    borrowerContacts(params: Record<string, unknown>): Promise<unknown>;
+    lenderRankings(filters: Record<string, unknown>): Promise<unknown>;
+    churnedBorrowers(params: Record<string, unknown>): Promise<unknown>;
+    topLendersByVolume(filters: Record<string, unknown>): Promise<unknown>;
+    lenderBorrowers(filters: Record<string, unknown>): Promise<unknown>;
+    marketTrends(endpoint: string, params: Record<string, unknown>): Promise<unknown>;
+    loansNearby(params: Record<string, unknown>): Promise<unknown>;
+    msaRankings(filters: Record<string, unknown>): Promise<unknown>;
+    transactionHistory(filters: Record<string, unknown>): Promise<unknown>;
+    portfolioSummary(params: Record<string, unknown>): Promise<unknown>;
+    negativeRemarks(filters: Record<string, unknown>): Promise<unknown>;
+    ownersList(params: Record<string, unknown>): Promise<unknown>;
+    healthCheck(): Promise<{
+        ok: boolean;
+        latencyMs: number;
+    }>;
+}

package/dist/services/plr.js

@@ -0,0 +1,75 @@
+export class PlrClient {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    // --- Borrower Analytics ---
+    async borrowerListBuilder(filters) {
+        return this.http.request("POST", "/api/v1/analytics/borrower/borrower_list_builder/", { body: filters });
+    }
+    async borrowerProfile(params) {
+        return this.http.request("GET", "/api/v1/analytics/borrower/borrower_profile/", { query: params });
+    }
+    async borrowerRankings(filters) {
+        return this.http.request("POST", "/api/v1/analytics/borrower/borrower_rankings/", { body: filters });
+    }
+    async nationwideLargestBorrowers(filters) {
+        return this.http.request("POST", "/api/v1/analytics/borrower/nationwide_largest_borrowers/", { body: filters });
+    }
+    async borrowerLoans(filters) {
+        return this.http.request("POST", "/api/v1/analytics/borrower/borrower_loans/", { body: filters });
+    }
+    async borrowerContacts(params) {
+        return this.http.request("GET", "/api/v1/analytics/borrower/borrower_contact_table/", { query: params });
+    }
+    // --- Lender Analytics ---
+    async lenderRankings(filters) {
+        return this.http.request("POST", "/api/v1/analytics/lender/lender_rankings/", { body: filters });
+    }
+    async churnedBorrowers(params) {
+        return this.http.request("POST", "/api/v1/analytics/lender/churned_borrowers/", { body: params });
+    }
+    async topLendersByVolume(filters) {
+        return this.http.request("POST", "/api/v1/analytics/lender/top_lenders_by_volume/", { body: filters });
+    }
+    async lenderBorrowers(filters) {
+        return this.http.request("POST", "/api/v1/analytics/lender/lender_borrowers/", { body: filters });
+    }
+    // --- Time Series ---
+    async marketTrends(endpoint, params) {
+        return this.http.request("GET", `/api/v1/analytics/time-series/${endpoint}/`, { query: params });
+    }
+    // --- Property Analytics ---
+    async loansNearby(params) {
+        return this.http.request("GET", "/api/v1/analytics/property/loans_nearby/", { query: params });
+    }
+    async msaRankings(filters) {
+        return this.http.request("POST", "/api/v1/analytics/metro/msa_rankings/", { body: filters });
+    }
+    async transactionHistory(filters) {
+        return this.http.request("POST", "/api/v1/analytics/property/transaction_history/", { body: filters });
+    }
+    async portfolioSummary(params) {
+        return this.http.request("GET", "/api/v1/analytics/portfolio/portfolio_summary/", { query: params });
+    }
+    // --- Negative Remarks ---
+    async negativeRemarks(filters) {
+        return this.http.request("POST", "/api/v1/analytics/borrower/negative_remarks/", { body: filters });
+    }
+    // --- Owner Search ---
+    async ownersList(params) {
+        return this.http.request("GET", "/api/v1/analytics/borrower/owners_list/", { query: params });
+    }
+    // --- Health ---
+    async healthCheck() {
+        const start = Date.now();
+        try {
+            await this.http.request("GET", "/health-check/");
+            return { ok: true, latencyMs: Date.now() - start };
+        }
+        catch {
+            return { ok: false, latencyMs: Date.now() - start };
+        }
+    }
+}
+//# sourceMappingURL=plr.js.map

package/dist/services/plr.js.map

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

package/dist/services/sfr.d.ts

@@ -0,0 +1,33 @@
+import { HttpClient } from "./httpClient.js";
+type QueryParams = Record<string, unknown>;
+export declare class SfrClient {
+    private readonly http;
+    constructor(http: HttpClient);
+    getPropertyByAddress(address: string): Promise<unknown>;
+    getPropertyBatch(addresses: string[]): Promise<unknown>;
+    getNearbySales(params: QueryParams): Promise<unknown>;
+    getPropertyTransactions(address: string): Promise<unknown>;
+    getBuyerActivity(params: QueryParams): Promise<unknown>;
+    getTopBuyers(params: QueryParams): Promise<unknown>;
+    getMarketTopBuyers(params: QueryParams): Promise<unknown>;
+    getBuyerProfile(name: string): Promise<unknown>;
+    getBuyerGrowth(name: string): Promise<unknown>;
+    getBestBuyers(address: string): Promise<unknown>;
+    getMarketActivity(params: QueryParams): Promise<unknown>;
+    getFlips(params: QueryParams): Promise<unknown>;
+    getActivityCount(params: QueryParams): Promise<unknown>;
+    getZipFinder(params: QueryParams): Promise<unknown>;
+    getZipDetail(zipCode: string): Promise<unknown>;
+    getInstitutionalLargestOwners(params: QueryParams): Promise<unknown>;
+    getFlipHoldTime(params: QueryParams): Promise<unknown>;
+    getFlipGrossMargin(params: QueryParams): Promise<unknown>;
+    getPropertySearch(params: QueryParams): Promise<unknown>;
+    getRentalStats(params: QueryParams): Promise<unknown>;
+    getRentalComparables(params: QueryParams): Promise<unknown>;
+    getRentalMarketAnalysis(params: QueryParams): Promise<unknown>;
+    healthCheck(): Promise<{
+        ok: boolean;
+        latencyMs: number;
+    }>;
+}
+export {};

package/dist/services/sfr.js

@@ -0,0 +1,124 @@
+export class SfrClient {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    // --- Properties ---
+    async getPropertyByAddress(address) {
+        return this.http.request("GET", "/properties/by-address", {
+            query: { address },
+        });
+    }
+    async getPropertyBatch(addresses) {
+        return this.http.request("GET", "/properties/batch", {
+            query: { addresses: addresses.join("|") },
+        });
+    }
+    async getNearbySales(params) {
+        return this.http.request("GET", "/properties/nearby-sales", {
+            query: params,
+        });
+    }
+    async getPropertyTransactions(address) {
+        return this.http.request("GET", "/properties/transactions", {
+            query: { address },
+        });
+    }
+    // --- Buyers ---
+    async getBuyerActivity(params) {
+        return this.http.request("GET", "/buyers/activity", {
+            query: params,
+        });
+    }
+    async getTopBuyers(params) {
+        return this.http.request("GET", "/buyers/activity/top-buyers", {
+            query: params,
+        });
+    }
+    async getMarketTopBuyers(params) {
+        return this.http.request("GET", "/buyers/market/top-buyers", {
+            query: params,
+        });
+    }
+    async getBuyerProfile(name) {
+        return this.http.request("GET", `/buyer-profiles/${encodeURIComponent(name)}`);
+    }
+    async getBuyerGrowth(name) {
+        return this.http.request("GET", `/buyer-profiles/${encodeURIComponent(name)}/growth`);
+    }
+    async getBestBuyers(address) {
+        return this.http.request("GET", "/buyers/best-buyers", {
+            query: { address },
+        });
+    }
+    async getMarketActivity(params) {
+        return this.http.request("GET", "/buyers/market", {
+            query: params,
+        });
+    }
+    async getFlips(params) {
+        return this.http.request("GET", "/geo-analytics/flips", {
+            query: params,
+        });
+    }
+    async getActivityCount(params) {
+        return this.http.request("GET", "/buyers/activity/count", {
+            query: params,
+        });
+    }
+    // --- Geo Analytics ---
+    async getZipFinder(params) {
+        return this.http.request("GET", "/geo-analytics/zip-finder", {
+            query: params,
+        });
+    }
+    async getZipDetail(zipCode) {
+        return this.http.request("GET", `/geo-analytics/zip-finder/zip/${encodeURIComponent(zipCode)}`);
+    }
+    async getInstitutionalLargestOwners(params) {
+        return this.http.request("GET", "/geo-analytics/institutional-ownership/largest-owners", { query: params });
+    }
+    async getFlipHoldTime(params) {
+        return this.http.request("GET", "/geo-analytics/flips/hold-time", {
+            query: params,
+        });
+    }
+    async getFlipGrossMargin(params) {
+        return this.http.request("GET", "/geo-analytics/flips/gross-margin", {
+            query: params,
+        });
+    }
+    async getPropertySearch(params) {
+        return this.http.request("GET", "/properties/search", {
+            query: params,
+        });
+    }
+    // --- Rental Analytics ---
+    async getRentalStats(params) {
+        return this.http.request("GET", "/rental-analytics/stats", {
+            query: params,
+        });
+    }
+    async getRentalComparables(params) {
+        return this.http.request("GET", "/rental-analytics/comparables", {
+            query: params,
+        });
+    }
+    async getRentalMarketAnalysis(params) {
+        return this.http.request("GET", "/rental-analytics/market-analysis", {
+            query: params,
+        });
+    }
+    // --- Health ---
+    async healthCheck() {
+        const start = Date.now();
+        try {
+            await this.http.request("GET", "/health-check");
+            return { ok: true, latencyMs: Date.now() - start };
+        }
+        catch {
+            return { ok: false, latencyMs: Date.now() - start };
+        }
+    }
+}
+//# sourceMappingURL=sfr.js.map

package/dist/services/sfr.js.map

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

package/dist/services/snowflake.d.ts

@@ -0,0 +1,12 @@
+export type SnowflakeConfig = {
+    account: string;
+    username: string;
+    password: string;
+    database: string;
+    schema: string;
+    warehouse: string;
+};
+export declare function initSnowflake(cfg: SnowflakeConfig): void;
+export declare function isSnowflakeConfigured(): boolean;
+export declare function sfQuery<T = Record<string, unknown>>(sql: string, binds?: (string | number)[]): Promise<T[]>;
+export declare function disconnectSnowflake(): Promise<void>;