listingbureau-mcp 0.1.0

package/dist/tools/wallet.tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet.tools.d.ts","sourceRoot":"","sources":["../../src/tools/wallet.tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAQvD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,QA+EtE"}

package/dist/tools/wallet.tools.js

@@ -0,0 +1,55 @@
+import { z } from "zod";
+import { formatResult, formatPaginatedResult, formatErrorResult, } from "../utils/response.js";
+export function registerWalletTools(server, client) {
+    server.tool("lb_wallet_get_balance", "Get Listing Bureau wallet balance (credits and USD). May include a warning if data is temporarily unavailable.", {}, { readOnlyHint: true }, async () => {
+        try {
+            const res = await client.request("GET", "/api/v1/wallet");
+            return formatResult(res.data);
+        }
+        catch (e) {
+            return formatErrorResult(e);
+        }
+    });
+    server.tool("lb_wallet_get_transactions", "Get Listing Bureau wallet transaction history (paginated). Last page may include legacy entries beyond per_page count.", {
+        page: z.number().int().min(1).optional().describe("Page number (default 1)"),
+        per_page: z
+            .number()
+            .int()
+            .min(1)
+            .max(100)
+            .optional()
+            .describe("Results per page (default 50, max 100)"),
+    }, { readOnlyHint: true }, async (params) => {
+        try {
+            const query = {};
+            if (params.page !== undefined)
+                query.page = String(params.page);
+            if (params.per_page !== undefined)
+                query.per_page = String(params.per_page);
+            const res = await client.request("GET", "/api/v1/wallet/transactions", undefined, query);
+            if (res.meta) {
+                return formatPaginatedResult(res.data, res.meta);
+            }
+            return formatResult(res.data);
+        }
+        catch (e) {
+            return formatErrorResult(e);
+        }
+    });
+    server.tool("lb_wallet_topup", "Generate a Stripe checkout URL to top up wallet balance. Returns a URL to complete payment.", {
+        amount: z
+            .number()
+            .min(5)
+            .max(5000)
+            .describe("Top-up amount in USD (minimum $5, maximum $5,000)"),
+    }, {}, async (params) => {
+        try {
+            const res = await client.request("POST", "/api/v1/wallet/topup", { amount: params.amount });
+            return formatResult(res.data);
+        }
+        catch (e) {
+            return formatErrorResult(e);
+        }
+    });
+}
+//# sourceMappingURL=wallet.tools.js.map

package/dist/tools/wallet.tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet.tools.js","sourceRoot":"","sources":["../../src/tools/wallet.tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,UAAU,mBAAmB,CAAC,MAAiB,EAAE,MAAgB;IACrE,MAAM,CAAC,IAAI,CACT,uBAAuB,EACvB,gHAAgH,EAChH,EAAE,EACF,EAAE,YAAY,EAAE,IAAI,EAAG,EACvB,KAAK,IAAI,EAAE;QACT,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,OAAO,CAC9B,KAAK,EACL,gBAAgB,CACjB,CAAC;YACF,OAAO,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAChC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,iBAAiB,CAAC,CAAC,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,4BAA4B,EAC5B,wHAAwH,EACxH;QACE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;QAC5E,QAAQ,EAAE,CAAC;aACR,MAAM,EAAE;aACR,GAAG,EAAE;aACL,GAAG,CAAC,CAAC,CAAC;aACN,GAAG,CAAC,GAAG,CAAC;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,wCAAwC,CAAC;KACtD,EACD,EAAE,YAAY,EAAE,IAAI,EAAG,EACvB,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,IAAI,CAAC;YACH,MAAM,KAAK,GAA2B,EAAE,CAAC;YACzC,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS;gBAAE,KAAK,CAAC,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAChE,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS;gBAC/B,KAAK,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC3C,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,OAAO,CAC9B,KAAK,EACL,6BAA6B,EAC7B,SAAS,EACT,KAAK,CACN,CAAC;YACF,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;gBACb,OAAO,qBAAqB,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;YACnD,CAAC;YACD,OAAO,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAChC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,iBAAiB,CAAC,CAAC,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,iBAAiB,EACjB,6FAA6F,EAC7F;QACE,MAAM,EAAE,CAAC;aACN,MAAM,EAAE;aACR,GAAG,CAAC,CAAC,CAAC;aACN,GAAG,CAAC,IAAI,CAAC;aACT,QAAQ,CAAC,mDAAmD,CAAC;KACjE,EACD,EAAE,EACF,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,OAAO,CAC9B,MAAM,EACN,sBAAsB,EACtB,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAC1B,CAAC;YACF,OAAO,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAChC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,iBAAiB,CAAC,CAAC,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/utils/cost.d.ts

@@ -0,0 +1,50 @@
+import type { ServiceRates, ScheduleEntry } from "../client/types.js";
+export interface DailyCost {
+    date: string;
+    atc: number;
+    sfb: number;
+    pgv: number;
+    total: number;
+}
+export interface CostEstimate {
+    num_days: number;
+    totals: {
+        atc: number;
+        pgv: number;
+        sfb: number;
+        grand_total: number;
+    };
+    avg_daily_cost: number;
+    daily_breakdown?: DailyCost[];
+}
+/** Full SFB per-unit cost including product price, tax, and passthrough. */
+export declare function sfbUnitCost(rates: ServiceRates, retailPrice?: number): number;
+/**
+ * Compute cost estimate from a normalized schedule (array of daily volumes).
+ * Each entry uses { date, atc, sfb, pgv } with MCP-facing field names.
+ */
+export declare function estimateCost(schedule: {
+    date: string;
+    atc: number;
+    sfb: number;
+    pgv: number;
+}[], rates: ServiceRates, retailPrice?: number): CostEstimate;
+/**
+ * Map backend ScheduleEntry (purchase/pageview) to cost-friendly shape (sfb/pgv).
+ * Separates dated entries from the ongoing entry for independent cost calculation.
+ */
+export declare function mapScheduleEntries(entries: ScheduleEntry[]): {
+    dated: {
+        date: string;
+        atc: number;
+        sfb: number;
+        pgv: number;
+    }[];
+    ongoing: {
+        atc: number;
+        sfb: number;
+        pgv: number;
+    } | null;
+};
+export declare function round2(n: number): number;
+//# sourceMappingURL=cost.d.ts.map

package/dist/utils/cost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost.d.ts","sourceRoot":"","sources":["../../src/utils/cost.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEtE,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IACvE,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,SAAS,EAAE,CAAC;CAC/B;AAED,4EAA4E;AAC5E,wBAAgB,WAAW,CAAC,KAAK,EAAE,YAAY,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAO7E;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,EAAE,EACnE,KAAK,EAAE,YAAY,EACnB,WAAW,CAAC,EAAE,MAAM,GACnB,YAAY,CAkDd;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,aAAa,EAAE,GACvB;IACD,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACjE,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAC3D,CAyBA;AAWD,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAExC"}

package/dist/utils/cost.js

@@ -0,0 +1,98 @@
+/** Full SFB per-unit cost including product price, tax, and passthrough. */
+export function sfbUnitCost(rates, retailPrice) {
+    if (retailPrice == null) {
+        return rates.sfb_service_fee;
+    }
+    const tax = retailPrice * rates.sfb_tax_rate;
+    const passthrough = (retailPrice + tax) * rates.sfb_passthrough_rate;
+    return rates.sfb_service_fee + retailPrice + tax + passthrough;
+}
+/**
+ * Compute cost estimate from a normalized schedule (array of daily volumes).
+ * Each entry uses { date, atc, sfb, pgv } with MCP-facing field names.
+ */
+export function estimateCost(schedule, rates, retailPrice) {
+    if (schedule.length === 0) {
+        return {
+            num_days: 0,
+            totals: { atc: 0, pgv: 0, sfb: 0, grand_total: 0 },
+            avg_daily_cost: 0,
+        };
+    }
+    const sfbUnit = sfbUnitCost(rates, retailPrice);
+    const includeDailyBreakdown = schedule.length <= 14;
+    let totalAtc = 0;
+    let totalSfb = 0;
+    let totalPgv = 0;
+    const dailyBreakdown = [];
+    for (const day of schedule) {
+        const dayAtc = day.atc * rates.atc;
+        const daySfb = day.sfb * sfbUnit;
+        const dayPgv = day.pgv * rates.pgv;
+        totalAtc += dayAtc;
+        totalSfb += daySfb;
+        totalPgv += dayPgv;
+        if (includeDailyBreakdown) {
+            dailyBreakdown.push({
+                date: day.date,
+                atc: round2(dayAtc),
+                sfb: round2(daySfb),
+                pgv: round2(dayPgv),
+                total: round2(dayAtc + daySfb + dayPgv),
+            });
+        }
+    }
+    const grandTotal = totalAtc + totalSfb + totalPgv;
+    const numDays = schedule.length;
+    return {
+        num_days: numDays,
+        totals: {
+            atc: round2(totalAtc),
+            pgv: round2(totalPgv),
+            sfb: round2(totalSfb),
+            grand_total: round2(grandTotal),
+        },
+        avg_daily_cost: round2(numDays > 0 ? grandTotal / numDays : 0),
+        ...(includeDailyBreakdown ? { daily_breakdown: dailyBreakdown } : {}),
+    };
+}
+/**
+ * Map backend ScheduleEntry (purchase/pageview) to cost-friendly shape (sfb/pgv).
+ * Separates dated entries from the ongoing entry for independent cost calculation.
+ */
+export function mapScheduleEntries(entries) {
+    const dated = [];
+    let ongoing = null;
+    for (const e of entries) {
+        // Backend sets both id and date to "ongoing" for the perpetual entry — check both defensively
+        if (e.id === "ongoing" || e.date === "ongoing") {
+            ongoing = { atc: e.atc, sfb: e.purchase, pgv: e.pageview };
+            continue;
+        }
+        // Only include entries with a recognizable date format (MM/DD/YYYY or YYYY-MM-DD)
+        const normalized = normalizeDateToIso(e.date);
+        if (!/^\d{4}-\d{2}-\d{2}$/.test(normalized)) {
+            console.warn(`[cost] Skipping schedule entry with unrecognized date format: "${e.date}"`);
+            continue;
+        }
+        dated.push({
+            date: normalized,
+            atc: e.atc,
+            sfb: e.purchase,
+            pgv: e.pageview,
+        });
+    }
+    return { dated, ongoing };
+}
+/** Normalize backend date format (MM/DD/YYYY) to ISO (YYYY-MM-DD). Passes through other formats. */
+function normalizeDateToIso(date) {
+    // Groups: [1]=MM, [2]=DD, [3]=YYYY → reorder to YYYY-MM-DD
+    const match = date.match(/^(\d{2})\/(\d{2})\/(\d{4})$/);
+    if (match)
+        return `${match[3]}-${match[1]}-${match[2]}`;
+    return date;
+}
+export function round2(n) {
+    return Math.round(n * 100) / 100;
+}
+//# sourceMappingURL=cost.js.map

package/dist/utils/cost.js.map

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

package/dist/utils/errors.d.ts

@@ -0,0 +1,9 @@
+/** Custom error class for Listing Bureau API errors. */
+export declare class LBApiError extends Error {
+    readonly statusCode: number;
+    readonly code: string;
+    constructor(statusCode: number, code: string, message: string);
+}
+/** Format an LBApiError (or unknown error) into a human-readable string. */
+export declare function formatError(error: unknown): string;
+//# sourceMappingURL=errors.d.ts.map

package/dist/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,qBAAa,UAAW,SAAQ,KAAK;aAEjB,UAAU,EAAE,MAAM;aAClB,IAAI,EAAE,MAAM;gBADZ,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EAC5B,OAAO,EAAE,MAAM;CAKlB;AAED,4EAA4E;AAC5E,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAQlD"}

package/dist/utils/errors.js

@@ -0,0 +1,22 @@
+/** Custom error class for Listing Bureau API errors. */
+export class LBApiError extends Error {
+    statusCode;
+    code;
+    constructor(statusCode, code, message) {
+        super(message);
+        this.statusCode = statusCode;
+        this.code = code;
+        this.name = "LBApiError";
+    }
+}
+/** Format an LBApiError (or unknown error) into a human-readable string. */
+export function formatError(error) {
+    if (error instanceof LBApiError) {
+        return `API Error [${error.code}] (${error.statusCode}): ${error.message}`;
+    }
+    if (error instanceof Error) {
+        return `Error: ${error.message}`;
+    }
+    return `Unknown error: ${String(error)}`;
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,MAAM,OAAO,UAAW,SAAQ,KAAK;IAEjB;IACA;IAFlB,YACkB,UAAkB,EAClB,IAAY,EAC5B,OAAe;QAEf,KAAK,CAAC,OAAO,CAAC,CAAC;QAJC,eAAU,GAAV,UAAU,CAAQ;QAClB,SAAI,GAAJ,IAAI,CAAQ;QAI5B,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF;AAED,4EAA4E;AAC5E,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,IAAI,KAAK,YAAY,UAAU,EAAE,CAAC;QAChC,OAAO,cAAc,KAAK,CAAC,IAAI,MAAM,KAAK,CAAC,UAAU,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC;IAC7E,CAAC;IACD,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,UAAU,KAAK,CAAC,OAAO,EAAE,CAAC;IACnC,CAAC;IACD,OAAO,kBAAkB,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;AAC3C,CAAC"}

package/dist/utils/response.d.ts

@@ -0,0 +1,20 @@
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+/**
+ * Format a successful API response as an MCP tool result.
+ * Handles both entity responses and message-only responses.
+ * Surfaces `warning` and `balance_warning` fields independently.
+ */
+export declare function formatResult(data: unknown): CallToolResult;
+/**
+ * Format a paginated API response as an MCP tool result.
+ * Includes pagination metadata.
+ */
+export declare function formatPaginatedResult(data: unknown, meta: {
+    page: number;
+    per_page: number;
+    total: number;
+    total_pages: number;
+}): CallToolResult;
+/** Format an error as an MCP tool error result. */
+export declare function formatErrorResult(error: unknown): CallToolResult;
+//# sourceMappingURL=response.d.ts.map

package/dist/utils/response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.d.ts","sourceRoot":"","sources":["../../src/utils/response.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAGzE;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,cAAc,CAuC1D;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,OAAO,EACb,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAC3E,cAAc,CAQhB;AAED,mDAAmD;AACnD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,CAKhE"}

package/dist/utils/response.js

@@ -0,0 +1,63 @@
+import { formatError } from "./errors.js";
+/**
+ * Format a successful API response as an MCP tool result.
+ * Handles both entity responses and message-only responses.
+ * Surfaces `warning` and `balance_warning` fields independently.
+ */
+export function formatResult(data) {
+    const warnings = [];
+    let cleaned = data;
+    if (data && typeof data === "object") {
+        const obj = { ...data };
+        // Top-level warning string
+        if ("warning" in obj && typeof obj.warning === "string") {
+            warnings.push(obj.warning);
+            delete obj.warning;
+        }
+        // balance_warning object (independent of warning)
+        if ("balance_warning" in obj && obj.balance_warning && typeof obj.balance_warning === "object") {
+            const bw = obj.balance_warning;
+            const parts = [];
+            if (typeof bw.warning === "string" && bw.warning.trim())
+                parts.push(bw.warning);
+            if (typeof bw.daily_cost_estimate === "number")
+                parts.push(`Daily cost estimate: $${bw.daily_cost_estimate.toFixed(2)}`);
+            if (typeof bw.balance === "number")
+                parts.push(`Balance: $${bw.balance.toFixed(2)}`);
+            if (typeof bw.days_remaining === "number")
+                parts.push(`Days remaining: ${bw.days_remaining.toFixed(1)}`);
+            if (parts.length > 0)
+                warnings.push(parts.join(" | "));
+            delete obj.balance_warning;
+        }
+        cleaned = obj;
+    }
+    let text = JSON.stringify(cleaned, null, 2);
+    for (const w of warnings) {
+        text += `\n\n⚠️ Warning: ${w}`;
+    }
+    return {
+        content: [{ type: "text", text }],
+    };
+}
+/**
+ * Format a paginated API response as an MCP tool result.
+ * Includes pagination metadata.
+ */
+export function formatPaginatedResult(data, meta) {
+    const result = {
+        data,
+        pagination: meta,
+    };
+    return {
+        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+    };
+}
+/** Format an error as an MCP tool error result. */
+export function formatErrorResult(error) {
+    return {
+        content: [{ type: "text", text: formatError(error) }],
+        isError: true,
+    };
+}
+//# sourceMappingURL=response.js.map

package/dist/utils/response.js.map

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

package/dist/utils/validate-url.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Validate and normalize a base URL for API requests.
+ * - Rejects invalid URLs and non-http(s) protocols
+ * - Non-localhost URLs must use https://
+ * - Returns URL.origin (never includes trailing slash per WHATWG spec)
+ */
+export declare function validateBaseUrl(raw: string): string;
+//# sourceMappingURL=validate-url.d.ts.map

package/dist/utils/validate-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-url.d.ts","sourceRoot":"","sources":["../../src/utils/validate-url.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CA8BnD"}

package/dist/utils/validate-url.js

@@ -0,0 +1,28 @@
+/**
+ * Validate and normalize a base URL for API requests.
+ * - Rejects invalid URLs and non-http(s) protocols
+ * - Non-localhost URLs must use https://
+ * - Returns URL.origin (never includes trailing slash per WHATWG spec)
+ */
+export function validateBaseUrl(raw) {
+    let parsed;
+    try {
+        parsed = new URL(raw);
+    }
+    catch {
+        throw new Error(`Invalid LB_BASE_URL: "${raw}" is not a valid URL`);
+    }
+    if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
+        throw new Error(`Invalid LB_BASE_URL: protocol "${parsed.protocol}" is not allowed (must be http: or https:)`);
+    }
+    const isLocalhost = parsed.hostname === "localhost" ||
+        parsed.hostname.startsWith("127.") ||
+        parsed.hostname === "[::1]" ||
+        // IPv4-mapped IPv6 loopback — Node normalizes 127.x.y.z to [::ffff:7fXX:XXXX]
+        (parsed.hostname.startsWith("[::ffff:7f") && parsed.hostname.endsWith("]"));
+    if (parsed.protocol === "http:" && !isLocalhost) {
+        throw new Error(`Invalid LB_BASE_URL: http:// is only allowed for localhost — use https:// for "${parsed.hostname}"`);
+    }
+    return parsed.origin;
+}
+//# sourceMappingURL=validate-url.js.map

package/dist/utils/validate-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-url.js","sourceRoot":"","sources":["../../src/utils/validate-url.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,IAAI,MAAW,CAAC;IAChB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CACb,yBAAyB,GAAG,sBAAsB,CACnD,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,KAAK,OAAO,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAChE,MAAM,IAAI,KAAK,CACb,kCAAkC,MAAM,CAAC,QAAQ,4CAA4C,CAC9F,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,GACf,MAAM,CAAC,QAAQ,KAAK,WAAW;QAC/B,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC;QAClC,MAAM,CAAC,QAAQ,KAAK,OAAO;QAC3B,8EAA8E;QAC9E,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,YAAY,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;IAE9E,IAAI,MAAM,CAAC,QAAQ,KAAK,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CACb,kFAAkF,MAAM,CAAC,QAAQ,GAAG,CACrG,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC;AACvB,CAAC"}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "listingbureau-mcp",
+  "version": "0.1.0",
+  "description": "Amazon organic ranking MCP server. Run ranking campaigns, track keyword positions, and monitor rank movement from any AI assistant.",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "listingbureau-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "mcp-server",
+    "model-context-protocol",
+    "amazon",
+    "amazon-ranking",
+    "amazon-seller",
+    "amazon-fba",
+    "amazon-seo",
+    "organic-ranking",
+    "rank-tracker",
+    "ecommerce",
+    "listing-optimization",
+    "claude",
+    "cursor",
+    "ai-tools",
+    "seller-tools"
+  ],
+  "author": "Listing Bureau",
+  "license": "MIT",
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ]
+}