listingbureau-mcp 0.1.5 → 0.1.6

package/dist/client/lb-client.d.ts

@@ -30,6 +30,6 @@ export declare class LBClient {
      * Make an authenticated API request.
      * Retries once on 401 (token expired mid-request).
      */
-    request<T>(method: string, path: string, body?: Record<string, unknown>, query?: Record<string, string>): Promise<ApiSuccessResponse<T>>;
+    request<T>(method: string, path: string, body?: Record<string, unknown>, query?: Record<string, string>, toolName?: string): Promise<ApiSuccessResponse<T>>;
     private doRequest;
 }

package/dist/client/lb-client.js

@@ -153,14 +153,14 @@ export class LBClient {
      * Make an authenticated API request.
      * Retries once on 401 (token expired mid-request).
      */
-    async request(method, path, body, query) {
+    async request(method, path, body, query, toolName) {
         await this.ensureAuth();
-        const response = await this.doRequest(method, path, body, query);
+        const response = await this.doRequest(method, path, body, query, toolName);
         // Single retry on 401
         if (response.status === "error" && response._statusCode === 401) {
             this.jwt = null;
             await this.ensureAuth();
-            const retry = await this.doRequest(method, path, body, query);
+            const retry = await this.doRequest(method, path, body, query, toolName);
             if (retry.status === "error") {
                 throw new LBApiError(retry._statusCode ?? 500, retry.error.code, retry.error.message);
             }
@@ -171,7 +171,7 @@ export class LBClient {
         }
         return response;
     }
-    async doRequest(method, path, body, query) {
+    async doRequest(method, path, body, query, toolName) {
         let url = `${this.baseUrl}${path}`;
         if (query) {
             const params = new URLSearchParams(Object.entries(query).filter(([, v]) => v !== undefined && v !== ""));
@@ -181,6 +181,8 @@ export class LBClient {
         }
         const headers = {
             Authorization: `Bearer ${this.jwt.access_token}`,
+            "X-LB-Source": "mcp",
+            ...(toolName && { "X-LB-Tool": toolName }),
         };
         const options = { method, headers };
         if (body && method !== "GET") {

package/dist/index.js

@@ -10,6 +10,7 @@ import { registerOrdersTools } from "./tools/orders.tools.js";
 import { registerFeedbackTools } from "./tools/feedback.tools.js";
 import { registerCostTools } from "./tools/cost.tools.js";
 import { validateBaseUrl } from "./utils/validate-url.js";
+import { checkForUpdate } from "./utils/update-check.js";
 import { createRequire } from "node:module";
 const require = createRequire(import.meta.url);
 const pkg = require("../package.json");
@@ -42,3 +43,4 @@ registerFeedbackTools(server, client);
 registerCostTools(server, client);
 const transport = new StdioServerTransport();
 await server.connect(transport);
+checkForUpdate(pkg.version).catch(() => { });

package/dist/tools/account.tools.js

@@ -4,8 +4,8 @@ export function registerAccountTools(server, client) {
     server.tool("lb_account_get", "Get Listing Bureau account info (email, name, account status, wallet balance)", {}, { readOnlyHint: true }, async () => {
         try {
             const [accountRes, walletRes] = await Promise.all([
-                client.request("GET", "/api/v1/account"),
-                client.request("GET", "/api/v1/wallet"),
+                client.request("GET", "/api/v1/account", undefined, undefined, "lb_account_get"),
+                client.request("GET", "/api/v1/wallet", undefined, undefined, "lb_account_get"),
             ]);
             const account = accountRes.data;
             const wallet = walletRes.data;
@@ -55,7 +55,7 @@ export function registerAccountTools(server, client) {
             if (Object.keys(body).length === 0) {
                 return formatErrorResult(new Error("At least one field (first_name, last_name, company) must be provided"));
             }
-            const res = await client.request("PATCH", "/api/v1/account/profile", body);
+            const res = await client.request("PATCH", "/api/v1/account/profile", body, undefined, "lb_account_update_profile");
             return formatResult(res.data);
         }
         catch (e) {
@@ -64,7 +64,7 @@ export function registerAccountTools(server, client) {
     });
     server.tool("lb_account_get_service_rates", "Get current Listing Bureau service pricing rates. Returns empty object if no plan is active.", {}, { readOnlyHint: true }, async () => {
         try {
-            const res = await client.request("GET", "/api/v1/account/service-rates");
+            const res = await client.request("GET", "/api/v1/account/service-rates", undefined, undefined, "lb_account_get_service_rates");
             return formatResult(res.data);
         }
         catch (e) {
@@ -73,7 +73,7 @@ export function registerAccountTools(server, client) {
     });
     server.tool("lb_account_get_subscription", "Get Listing Bureau subscription info (plan label, fee, discount, wallet usage)", {}, { readOnlyHint: true }, async () => {
         try {
-            const res = await client.request("GET", "/api/v1/account/subscription");
+            const res = await client.request("GET", "/api/v1/account/subscription", undefined, undefined, "lb_account_get_subscription");
             return formatResult(res.data);
         }
         catch (e) {

package/dist/tools/cost.tools.js

@@ -34,8 +34,8 @@ export function registerCostTools(server, client) {
                 return formatErrorResult(new Error("Provide either a 'schedule' array, OR at least one volume (atc/sfb/pgv > 0) with 'num_days'"));
             }
             const [ratesRes, walletRes] = await Promise.all([
-                client.request("GET", "/api/v1/account/service-rates"),
-                client.request("GET", "/api/v1/wallet"),
+                client.request("GET", "/api/v1/account/service-rates", undefined, undefined, "lb_estimate_cost"),
+                client.request("GET", "/api/v1/wallet", undefined, undefined, "lb_estimate_cost"),
             ]);
             const rates = ratesRes.data;
             const wallet = walletRes.data;

package/dist/tools/feedback.tools.js

@@ -9,7 +9,7 @@ export function registerFeedbackTools(server, client) {
             .describe("Feedback text (10-5000 characters)"),
     }, { idempotentHint: false }, async (params) => {
         try {
-            const res = await client.request("POST", "/api/v1/feedback", { feedback: params.feedback });
+            const res = await client.request("POST", "/api/v1/feedback", { feedback: params.feedback }, undefined, "lb_feedback_submit");
             return formatResult(res.data);
         }
         catch (e) {

package/dist/tools/orders.tools.js

@@ -17,7 +17,7 @@ export function registerOrdersTools(server, client) {
                 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/orders", undefined, query);
+            const res = await client.request("GET", "/api/v1/orders", undefined, query, "lb_orders_list");
             if (res.meta) {
                 return formatPaginatedResult(res.data, res.meta);
             }
@@ -31,7 +31,7 @@ export function registerOrdersTools(server, client) {
         order_id: z.string().describe("Order identifier"),
     }, { readOnlyHint: true }, async (params) => {
         try {
-            const res = await client.request("GET", `/api/v1/orders/${encodeURIComponent(params.order_id)}`);
+            const res = await client.request("GET", `/api/v1/orders/${encodeURIComponent(params.order_id)}`, undefined, undefined, "lb_orders_get");
             return formatResult(res.data);
         }
         catch (e) {
@@ -47,7 +47,7 @@ export function registerOrdersTools(server, client) {
             .describe("Issue description (1-1000 characters)"),
     }, { idempotentHint: false }, async (params) => {
         try {
-            const res = await client.request("POST", `/api/v1/orders/${encodeURIComponent(params.order_id)}/report-issue`, { description: params.description });
+            const res = await client.request("POST", `/api/v1/orders/${encodeURIComponent(params.order_id)}/report-issue`, { description: params.description }, undefined, "lb_orders_report_issue");
             return formatResult(res.data);
         }
         catch (e) {

package/dist/tools/projects.tools.js

@@ -22,7 +22,7 @@ export function registerProjectsTools(server, client) {
                 query.region = params.region;
             if (params.active !== undefined)
                 query.active = String(params.active);
-            const res = await client.request("GET", "/api/v1/projects", undefined, query);
+            const res = await client.request("GET", "/api/v1/projects", undefined, query, "lb_projects_list");
             return formatResult(res.data);
         }
         catch (e) {
@@ -57,7 +57,7 @@ export function registerProjectsTools(server, client) {
             if (params.expected_retail_price !== undefined) {
                 body.expected_retail_price = params.expected_retail_price;
             }
-            const res = await client.request("POST", "/api/v1/projects", body);
+            const res = await client.request("POST", "/api/v1/projects", body, undefined, "lb_projects_create");
             return formatResult(res.data);
         }
         catch (e) {
@@ -68,7 +68,7 @@ export function registerProjectsTools(server, client) {
         ui_id: z.string().describe("Project unique identifier"),
     }, { readOnlyHint: true }, async (params) => {
         try {
-            const res = await client.request("GET", `/api/v1/projects/${encodeURIComponent(params.ui_id)}`);
+            const res = await client.request("GET", `/api/v1/projects/${encodeURIComponent(params.ui_id)}`, undefined, undefined, "lb_projects_get");
             return formatResult(res.data);
         }
         catch (e) {
@@ -86,7 +86,7 @@ export function registerProjectsTools(server, client) {
             if (Object.keys(body).length === 0) {
                 return formatErrorResult(new Error("At least one field (active) must be provided"));
             }
-            const res = await client.request("PATCH", `/api/v1/projects/${encodeURIComponent(params.ui_id)}`, body);
+            const res = await client.request("PATCH", `/api/v1/projects/${encodeURIComponent(params.ui_id)}`, body, undefined, "lb_projects_update");
             return formatResult(res.data);
         }
         catch (e) {
@@ -97,7 +97,7 @@ export function registerProjectsTools(server, client) {
         ui_id: z.string().describe("Project unique identifier"),
     }, { destructiveHint: true }, async (params) => {
         try {
-            const res = await client.request("DELETE", `/api/v1/projects/${encodeURIComponent(params.ui_id)}`);
+            const res = await client.request("DELETE", `/api/v1/projects/${encodeURIComponent(params.ui_id)}`, undefined, undefined, "lb_projects_archive");
             return formatResult(res.data);
         }
         catch (e) {
@@ -118,7 +118,7 @@ export function registerProjectsTools(server, client) {
             const query = {};
             if (params.days !== undefined)
                 query.days = String(params.days);
-            const res = await client.request("GET", `/api/v1/projects/${encodeURIComponent(params.ui_id)}/stats`, undefined, query);
+            const res = await client.request("GET", `/api/v1/projects/${encodeURIComponent(params.ui_id)}/stats`, undefined, query, "lb_projects_get_stats");
             return formatResult(res.data);
         }
         catch (e) {

package/dist/tools/schedule.tools.js

@@ -18,6 +18,7 @@ const scheduleEntrySchema = z.object({
 async function appendCostSummary(data, client) {
     const result = { ...data };
     try {
+        // Internal enrichment fetch — no tool attribution in audit log
         const ratesRes = await client.request("GET", "/api/v1/account/service-rates");
         const rates = ratesRes.data;
         const { dated, ongoing } = mapScheduleEntries(data.scheduling);
@@ -102,7 +103,7 @@ export function registerScheduleTools(server, client) {
         ui_id: z.string().describe("Project unique identifier"),
     }, { readOnlyHint: true }, async (params) => {
         try {
-            const res = await client.request("GET", `/api/v1/projects/${encodeURIComponent(params.ui_id)}/schedule`);
+            const res = await client.request("GET", `/api/v1/projects/${encodeURIComponent(params.ui_id)}/schedule`, undefined, undefined, "lb_schedule_get");
             const augmented = await appendCostSummary(res.data, client);
             return formatResult(augmented);
         }
@@ -119,7 +120,7 @@ export function registerScheduleTools(server, client) {
             .describe("Array of daily schedule entries"),
     }, { destructiveHint: true, idempotentHint: true }, async (params) => {
         try {
-            const res = await client.request("PUT", `/api/v1/projects/${encodeURIComponent(params.ui_id)}/schedule`, { schedule: params.schedule });
+            const res = await client.request("PUT", `/api/v1/projects/${encodeURIComponent(params.ui_id)}/schedule`, { schedule: params.schedule }, undefined, "lb_schedule_set");
             const augmented = await appendCostSummary(res.data, client);
             return formatResult(augmented);
         }
@@ -139,7 +140,7 @@ export function registerScheduleTools(server, client) {
                 sfb: params.sfb ?? 0,
                 pgv: params.pgv ?? 0,
             };
-            const res = await client.request("POST", `/api/v1/projects/${encodeURIComponent(params.ui_id)}/schedule/quick`, body);
+            const res = await client.request("POST", `/api/v1/projects/${encodeURIComponent(params.ui_id)}/schedule/quick`, body, undefined, "lb_schedule_quick_set");
             const augmented = await appendCostSummary(res.data, client);
             return formatResult(augmented);
         }

package/dist/tools/wallet.tools.js

@@ -3,7 +3,7 @@ import { formatResult, formatPaginatedResult, formatErrorResult, } from "../util
 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");
+            const res = await client.request("GET", "/api/v1/wallet", undefined, undefined, "lb_wallet_get_balance");
             return formatResult(res.data);
         }
         catch (e) {
@@ -26,7 +26,7 @@ export function registerWalletTools(server, client) {
                 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);
+            const res = await client.request("GET", "/api/v1/wallet/transactions", undefined, query, "lb_wallet_get_transactions");
             if (res.meta) {
                 return formatPaginatedResult(res.data, res.meta);
             }
@@ -44,7 +44,7 @@ export function registerWalletTools(server, client) {
             .describe("Top-up amount in USD (minimum $5, maximum $5,000)"),
     }, { destructiveHint: true }, async (params) => {
         try {
-            const res = await client.request("POST", "/api/v1/wallet/topup", { amount: params.amount });
+            const res = await client.request("POST", "/api/v1/wallet/topup", { amount: params.amount }, undefined, "lb_wallet_topup");
             return formatResult(res.data);
         }
         catch (e) {

package/dist/utils/response.js

@@ -1,4 +1,5 @@
 import { formatError } from "./errors.js";
+import { getUpdateNotice } from "./update-check.js";
 /**
  * Format a successful API response as an MCP tool result.
  * Handles both entity responses and message-only responses.
@@ -36,6 +37,10 @@ export function formatResult(data) {
     for (const w of warnings) {
         text += `\n\n⚠️ Warning: ${w}`;
     }
+    const notice = getUpdateNotice();
+    if (notice) {
+        text += `\n\n${notice}`;
+    }
     return {
         content: [{ type: "text", text }],
     };
@@ -49,8 +54,13 @@ export function formatPaginatedResult(data, meta) {
         data,
         pagination: meta,
     };
+    let text = JSON.stringify(result, null, 2);
+    const notice = getUpdateNotice();
+    if (notice) {
+        text += `\n\n${notice}`;
+    }
     return {
-        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        content: [{ type: "text", text }],
     };
 }
 /** Format an error as an MCP tool error result. */

package/dist/utils/update-check.d.ts

@@ -0,0 +1,8 @@
+/** Compare semver strings. Returns true only if latest > current. */
+export declare function isNewerVersion(latest: string, current: string): boolean;
+/** Fire-and-forget npm registry check. Stores notice for later retrieval. */
+export declare function checkForUpdate(currentVersion: string): Promise<void>;
+/** Returns the update notice once, then null for all subsequent calls. */
+export declare function getUpdateNotice(): string | null;
+/** Reset state for testing. */
+export declare function resetForTesting(): void;

package/dist/utils/update-check.js

@@ -0,0 +1,61 @@
+// Module-level state — reset via resetForTesting() in test files.
+// Once noticeConsumed is true, subsequent checkForUpdate calls still overwrite
+// updateNotice but getUpdateNotice will return null. This is intentional:
+// the notice is designed to fire once per process lifetime.
+let updateNotice = null;
+let noticeConsumed = false;
+/** Compare semver strings. Returns true only if latest > current. */
+export function isNewerVersion(latest, current) {
+    const latestParts = latest.split(".").map(Number);
+    const currentParts = current.split(".").map(Number);
+    if (latestParts.length !== 3 || currentParts.length !== 3)
+        return false;
+    if (latestParts.some((n) => !Number.isFinite(n)) || currentParts.some((n) => !Number.isFinite(n)))
+        return false;
+    for (let i = 0; i < 3; i++) {
+        if (latestParts[i] > currentParts[i])
+            return true;
+        if (latestParts[i] < currentParts[i])
+            return false;
+    }
+    return false;
+}
+/** Fire-and-forget npm registry check. Stores notice for later retrieval. */
+export async function checkForUpdate(currentVersion) {
+    try {
+        const res = await fetch("https://registry.npmjs.org/listingbureau-mcp/latest", {
+            signal: AbortSignal.timeout(5000),
+        });
+        if (!res.ok)
+            return;
+        const json = (await res.json());
+        const latest = json.version;
+        if (typeof latest !== "string" || !/^\d+\.\d+\.\d+$/.test(latest))
+            return;
+        if (isNewerVersion(latest, currentVersion)) {
+            updateNotice =
+                `📦 Update available: v${currentVersion} → v${latest}\n` +
+                    `To update:\n` +
+                    `  npm: npx listingbureau-mcp@latest (or npm update -g listingbureau-mcp)\n` +
+                    `  Desktop: Download from https://github.com/listingbureau/listingbureau-mcp/releases/latest`;
+        }
+    }
+    catch {
+        // Silent failure — network errors, TimeoutError, AbortError, bad JSON all swallowed
+    }
+}
+/** Returns the update notice once, then null for all subsequent calls. */
+export function getUpdateNotice() {
+    if (noticeConsumed)
+        return null;
+    if (updateNotice) {
+        noticeConsumed = true;
+        return updateNotice;
+    }
+    return null;
+}
+/** Reset state for testing. */
+export function resetForTesting() {
+    updateNotice = null;
+    noticeConsumed = false;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "listingbureau-mcp",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "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",