listingbureau-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Listing Bureau
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,152 @@
+# listingbureau-mcp
+
+Organic ranking campaigns for Amazon products, managed through your AI assistant.
+
+The only ranking-focused Amazon MCP server. Create ranking campaigns, set velocity schedules, track keyword positions, and monitor rank movement from Claude, Cursor, or any MCP-compatible client.
+
+Built on the same infrastructure that moved 1,700+ products to page one. Median time: 48 days.
+
+## What it does
+
+This MCP server connects your AI assistant to [Listing Bureau](https://listingbureau.com)'s Amazon ranking infrastructure. Three signal types drive organic rank improvement:
+
+- **Search-Find-Buy (SFB)** signals the A10 algorithm that real shoppers searched for a keyword, found the product, and purchased it
+- **Add-to-Cart (ATC)** builds conversion velocity and purchase intent signals
+- **Page Views (PGV)** generate session-level browsing behavior that supports organic discovery
+
+Your assistant handles the entire workflow: create a project for any ASIN and keyword, set a daily velocity schedule, estimate costs before committing, and pull position reports to track movement.
+
+## Quick start
+
+### Claude Desktop
+
+Add to `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "listingbureau": {
+      "command": "npx",
+      "args": ["listingbureau-mcp"],
+      "env": {
+        "LB_API_KEY": "your-api-key-here"
+      }
+    }
+  }
+}
+```
+
+### Claude Code
+
+```bash
+claude mcp add listingbureau -- npx listingbureau-mcp
+```
+
+Then set your API key in the MCP config.
+
+### Cursor
+
+Add to `.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "listingbureau": {
+      "command": "npx",
+      "args": ["listingbureau-mcp"],
+      "env": {
+        "LB_API_KEY": "your-api-key-here"
+      }
+    }
+  }
+}
+```
+
+### Get an API key
+
+Create an account at [listingbureau.com](https://listingbureau.com). Your API key is in the dashboard under Settings.
+
+## Environment variables
+
+| Variable | Required | Default | Description |
+|----------|----------|---------|-------------|
+| `LB_API_KEY` | Yes | - | Listing Bureau API key |
+| `LB_BASE_URL` | No | `https://listingbureau.com` | API base URL (override for staging/dev) |
+
+## Tools
+
+21 tools across 7 categories.
+
+### Projects (6 tools)
+
+| Tool | Description |
+|------|-------------|
+| `lb_projects_list` | List projects with optional region/active filters |
+| `lb_projects_create` | Create a new Amazon project (ASIN + keyword + region) |
+| `lb_projects_get` | Get project details (schedule, services, SERP data) |
+| `lb_projects_update` | Update project (pause/resume) |
+| `lb_projects_archive` | Archive (soft delete) a project |
+| `lb_projects_get_stats` | Get daily stats (SFB, ATC, PGV, SERP, ARA, BR, SQR) |
+
+### Schedule (3 tools)
+
+| Tool | Description |
+|------|-------------|
+| `lb_schedule_get` | Get current per-day schedule |
+| `lb_schedule_set` | Set full per-day schedule (replaces existing) |
+| `lb_schedule_quick_set` | Quick-set uniform daily volumes |
+
+### Cost Estimation (1 tool)
+
+| Tool | Description |
+|------|-------------|
+| `lb_estimate_cost` | Estimate campaign cost before committing. Computes total cost, daily averages, and wallet sustainability. |
+
+### Wallet (3 tools)
+
+| Tool | Description |
+|------|-------------|
+| `lb_wallet_get_balance` | Get wallet balance (credits and USD) |
+| `lb_wallet_get_transactions` | Get transaction history (paginated) |
+| `lb_wallet_topup` | Generate a Stripe checkout URL to top up wallet balance |
+
+### Orders (3 tools)
+
+| Tool | Description |
+|------|-------------|
+| `lb_orders_list` | List orders (paginated, newest first) |
+| `lb_orders_get` | Get order details |
+| `lb_orders_report_issue` | Report an issue with an order |
+
+### Account (4 tools)
+
+| Tool | Description |
+|------|-------------|
+| `lb_account_get` | Get account info (email, name, company, plan) |
+| `lb_account_update_profile` | Update profile fields (first_name, last_name, company) |
+| `lb_account_get_service_rates` | Get current service pricing rates |
+| `lb_account_get_subscription` | Get subscription info (plan, fee, discount) |
+
+### Feedback (1 tool)
+
+| Tool | Description |
+|------|-------------|
+| `lb_feedback_submit` | Submit feedback (10-5000 characters) |
+
+## Development
+
+```bash
+npm install
+npm run build
+npm run dev    # watch mode
+npm test
+```
+
+## Links
+
+- [Landing page](https://listingbureau.com/mcp)
+- [Create an account](https://listingbureau.com)
+
+## License
+
+MIT

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

@@ -0,0 +1,36 @@
+import type { ApiSuccessResponse } from "./types.js";
+export declare class LBClient {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private jwt;
+    private authInProgress;
+    private consecutiveAuthFailures;
+    private authBackoffDeadline;
+    constructor(apiKey: string, baseUrl: string);
+    /**
+     * Wait until the backoff window has elapsed (no-op if already past deadline).
+     * Must only be called while authInProgress is set (ensureAuth holds the mutex).
+     */
+    private waitForBackoff;
+    /**
+     * Ensure we have a valid access token.
+     * - No tokens -> authenticate with API key
+     * - Expiring in <30s -> proactively refresh
+     * - Refresh fails -> re-authenticate from scratch
+     */
+    private ensureAuth;
+    /** Exchange API key for JWT tokens. */
+    private authenticate;
+    /**
+     * Refresh the access token.
+     * On failure, throws so ensureAuth() stays the single re-auth entry point.
+     */
+    private refresh;
+    /**
+     * 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>>;
+    private doRequest;
+}
+//# sourceMappingURL=lb-client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lb-client.d.ts","sourceRoot":"","sources":["../../src/client/lb-client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,kBAAkB,EAInB,MAAM,YAAY,CAAC;AAepB,qBAAa,QAAQ;IAOjB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAP1B,OAAO,CAAC,GAAG,CAAyB;IACpC,OAAO,CAAC,cAAc,CAA8B;IACpD,OAAO,CAAC,uBAAuB,CAAK;IACpC,OAAO,CAAC,mBAAmB,CAAK;gBAGb,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM;IAGlC;;;OAGG;YACW,cAAc;IAQ5B;;;;;OAKG;YACW,UAAU;IAkCxB,uCAAuC;YACzB,YAAY;IAgD1B;;;OAGG;YACW,OAAO;IA6CrB;;;OAGG;IACG,OAAO,CAAC,CAAC,EACb,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC;YA8BnB,SAAS;CA4CxB"}

package/dist/client/lb-client.js

@@ -0,0 +1,205 @@
+import { LBApiError } from "../utils/errors.js";
+/** Decode a JWT payload without verifying signature (we only need `exp`). */
+function decodeJwtExp(token) {
+    const parts = token.split(".");
+    if (parts.length !== 3)
+        throw new Error("Invalid JWT format");
+    // Base64url -> Base64 -> Buffer -> JSON
+    const payload = Buffer.from(parts[1], "base64url").toString("utf-8");
+    const parsed = JSON.parse(payload);
+    if (typeof parsed.exp !== "number") {
+        throw new Error("JWT missing exp claim");
+    }
+    return parsed.exp; // Unix seconds
+}
+export class LBClient {
+    apiKey;
+    baseUrl;
+    jwt = null;
+    authInProgress = null;
+    consecutiveAuthFailures = 0;
+    authBackoffDeadline = 0;
+    constructor(apiKey, baseUrl) {
+        this.apiKey = apiKey;
+        this.baseUrl = baseUrl;
+    }
+    /**
+     * Wait until the backoff window has elapsed (no-op if already past deadline).
+     * Must only be called while authInProgress is set (ensureAuth holds the mutex).
+     */
+    async waitForBackoff() {
+        if (this.consecutiveAuthFailures === 0)
+            return;
+        const remaining = this.authBackoffDeadline - Date.now();
+        if (remaining > 0) {
+            await new Promise((resolve) => setTimeout(resolve, remaining));
+        }
+    }
+    /**
+     * Ensure we have a valid access token.
+     * - No tokens -> authenticate with API key
+     * - Expiring in <30s -> proactively refresh
+     * - Refresh fails -> re-authenticate from scratch
+     */
+    async ensureAuth() {
+        // Prevent concurrent auth calls
+        if (this.authInProgress) {
+            await this.authInProgress;
+            return;
+        }
+        const nowSec = Math.floor(Date.now() / 1000);
+        if (!this.jwt) {
+            this.authInProgress = this.authenticate();
+            try {
+                await this.authInProgress;
+            }
+            finally {
+                this.authInProgress = null;
+            }
+            return;
+        }
+        // Proactive refresh: 30 seconds before expiry
+        if (this.jwt.expires_at - nowSec < 30) {
+            // Both refresh and fallback re-auth run inside the same authInProgress mutex window
+            this.authInProgress = this.refresh().catch(() => {
+                // Refresh failed and cleared jwt -- re-authenticate from scratch
+                return this.authenticate();
+            });
+            try {
+                await this.authInProgress;
+            }
+            finally {
+                this.authInProgress = null;
+            }
+        }
+    }
+    /** Exchange API key for JWT tokens. */
+    async authenticate() {
+        await this.waitForBackoff();
+        try {
+            const res = await fetch(`${this.baseUrl}/api/v1/auth/token`, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({ api_key: this.apiKey }),
+            });
+            let json;
+            try {
+                json = (await res.json());
+            }
+            catch {
+                throw new LBApiError(res.status, "PARSE_ERROR", `Auth server returned non-JSON response (HTTP ${res.status})`);
+            }
+            if (json.status === "error") {
+                throw new LBApiError(res.status, json.error.code, json.error.message);
+            }
+            const { access_token, refresh_token } = json.data;
+            this.jwt = {
+                access_token,
+                refresh_token,
+                expires_at: decodeJwtExp(access_token),
+            };
+            this.consecutiveAuthFailures = 0;
+        }
+        catch (e) {
+            this.consecutiveAuthFailures++;
+            const base = Math.min(1000 * Math.pow(2, this.consecutiveAuthFailures - 1), 60_000);
+            const jitter = base * 0.25 * Math.random();
+            this.authBackoffDeadline = Date.now() + base + jitter;
+            throw e;
+        }
+    }
+    /**
+     * Refresh the access token.
+     * On failure, throws so ensureAuth() stays the single re-auth entry point.
+     */
+    async refresh() {
+        if (!this.jwt) {
+            throw new Error("Cannot refresh without existing tokens");
+        }
+        const refreshToken = this.jwt.refresh_token;
+        try {
+            const res = await fetch(`${this.baseUrl}/api/v1/auth/refresh`, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    Authorization: `Bearer ${refreshToken}`,
+                },
+            });
+            let json;
+            try {
+                json = (await res.json());
+            }
+            catch {
+                throw new LBApiError(res.status, "PARSE_ERROR", `Refresh server returned non-JSON response (HTTP ${res.status})`);
+            }
+            if (json.status === "error") {
+                // Refresh failed -- throw so catch block clears jwt and re-throws
+                throw new Error(`Refresh failed: ${json.error.message}`);
+            }
+            const { access_token } = json.data;
+            this.jwt = {
+                ...this.jwt,
+                access_token,
+                expires_at: decodeJwtExp(access_token),
+            };
+        }
+        catch (e) {
+            // Clear tokens so next ensureAuth() triggers full re-auth
+            this.jwt = null;
+            throw e;
+        }
+    }
+    /**
+     * Make an authenticated API request.
+     * Retries once on 401 (token expired mid-request).
+     */
+    async request(method, path, body, query) {
+        await this.ensureAuth();
+        const response = await this.doRequest(method, path, body, query);
+        // 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);
+            if (retry.status === "error") {
+                throw new LBApiError(retry._statusCode ?? 500, retry.error.code, retry.error.message);
+            }
+            return retry;
+        }
+        if (response.status === "error") {
+            throw new LBApiError(response._statusCode ?? 500, response.error.code, response.error.message);
+        }
+        return response;
+    }
+    async doRequest(method, path, body, query) {
+        let url = `${this.baseUrl}${path}`;
+        if (query) {
+            const params = new URLSearchParams(Object.entries(query).filter(([, v]) => v !== undefined && v !== ""));
+            const qs = params.toString();
+            if (qs)
+                url += `?${qs}`;
+        }
+        const headers = {
+            Authorization: `Bearer ${this.jwt.access_token}`,
+        };
+        const options = { method, headers };
+        if (body && method !== "GET") {
+            headers["Content-Type"] = "application/json";
+            options.body = JSON.stringify(body);
+        }
+        const res = await fetch(url, options);
+        // Note: non-JSON responses (e.g., gateway 502/401) throw here and bypass
+        // the 401-retry path in request(). This is acceptable -- gateway-level 401s
+        // are not recoverable via token refresh anyway.
+        let json;
+        try {
+            json = (await res.json());
+        }
+        catch {
+            throw new LBApiError(res.status, "PARSE_ERROR", `Server returned non-JSON response (HTTP ${res.status})`);
+        }
+        // Attach status code for retry logic
+        return { ...json, _statusCode: res.status };
+    }
+}
+//# sourceMappingURL=lb-client.js.map

package/dist/client/lb-client.js.map

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

package/dist/client/types.d.ts

@@ -0,0 +1,185 @@
+/** API response envelope for success responses. */
+export interface ApiSuccessResponse<T> {
+    status: "success";
+    data: T;
+    meta?: PaginationMeta;
+}
+/** API response envelope for error responses. */
+export interface ApiErrorResponse {
+    status: "error";
+    error: {
+        code: string;
+        message: string;
+    };
+}
+export type ApiResponse<T> = ApiSuccessResponse<T> | ApiErrorResponse;
+export interface PaginationMeta {
+    page: number;
+    per_page: number;
+    total: number;
+    total_pages: number;
+}
+/** POST /auth/token response -- includes both tokens + optional cid. */
+export interface TokenResponse {
+    access_token: string;
+    refresh_token: string;
+    cid?: string;
+}
+/** POST /auth/refresh response -- access_token only, NO refresh_token. */
+export interface RefreshResponse {
+    access_token: string;
+}
+/** Stored JWT state within LBClient. */
+export interface JwtState {
+    access_token: string;
+    refresh_token: string;
+    /** Unix seconds when the access token expires. */
+    expires_at: number;
+}
+export interface Account {
+    email: string;
+    first_name: string;
+    last_name: string;
+    account_type: string;
+    company?: string;
+}
+export interface Subscription {
+    account_type: string;
+    plan_label: string;
+    use_wallet: boolean;
+    subscription_fee: number;
+}
+export interface ServiceRates {
+    atc: number;
+    pgv: number;
+    sfb_service_fee: number;
+    sfb_tax_rate: number;
+    sfb_passthrough_rate: number;
+    sfb_formula: string;
+    [key: string]: unknown;
+}
+export interface BalanceWarning {
+    warning: string;
+    daily_cost_estimate: number;
+    balance?: number;
+    days_remaining?: number;
+}
+export interface CostSummary {
+    total_estimated_cost: number | null;
+    avg_daily_cost: number;
+    num_scheduled_days: number | null;
+    note: string;
+}
+export interface WalletBalance {
+    balance_usd: number;
+    held_usd: number;
+}
+export interface Transaction {
+    id: string;
+    amount: number;
+    balance_after: number;
+    type: string;
+    description: string;
+    reference_id: string;
+    created_at: string;
+}
+export interface TopupResponse {
+    checkout_url: string;
+}
+export interface Project {
+    ui_id: string;
+    cid: string;
+    marketplace: string;
+    region: string;
+    asin: string | null;
+    itemid: string | null;
+    keyword: string;
+    active: boolean;
+    archived: boolean;
+    dt_utc: string;
+    product_id: string;
+    services: {
+        atc: number;
+        sfb: number;
+        pgv: number;
+    };
+    scheduling: ScheduleEntry[];
+    data: {
+        serps: Record<string, unknown>;
+    };
+    unavailable: boolean;
+}
+export interface ProjectListItem {
+    ui_id: string;
+    marketplace: string;
+    region: string;
+    asin: string | null;
+    itemid: string | null;
+    keyword: string;
+    active: boolean;
+    archived: boolean;
+    product_id: string;
+    services: {
+        atc: number;
+        sfb: number;
+        pgv: number;
+    };
+}
+export interface ScheduleEntry {
+    id: string;
+    date: string;
+    atc: number;
+    purchase: number;
+    pageview: number;
+}
+export interface ScheduleResponse {
+    ui_id: string;
+    services: {
+        atc: number;
+        sfb: number;
+        pgv: number;
+    };
+    scheduling: ScheduleEntry[];
+    balance_warning?: BalanceWarning;
+}
+export interface ProjectStatsResponse {
+    days: number;
+    total: number;
+    stats: ProjectStatsDay[];
+}
+export interface ProjectStatsDay {
+    date: string;
+    dt: string | null;
+    services: {
+        sfb: ServiceDayStats;
+        atc: ServiceDayStats;
+        pgv: ServiceDayStats;
+    };
+    serp: Record<string, unknown> | null;
+    ara: Record<string, unknown> | null;
+    br: Record<string, unknown> | null;
+    sqr: Record<string, unknown> | null;
+    ranks: unknown[] | null;
+}
+export interface ServiceDayStats {
+    assignments: number | null;
+    executed: number;
+}
+export interface Order {
+    order_id: string;
+    cid: string;
+    status: string;
+    dt_utc: string;
+    items: unknown[];
+    campaign: string;
+    region: string;
+    asin: string | null;
+    keyword: string;
+    ui_id: string;
+    issue_reported: boolean;
+}
+export interface MessageResponse {
+    message: string;
+    [key: string]: unknown;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/client/types.d.ts.map

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

package/dist/client/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/client/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/client/types.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,42 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { LBClient } from "./client/lb-client.js";
+import { registerAccountTools } from "./tools/account.tools.js";
+import { registerWalletTools } from "./tools/wallet.tools.js";
+import { registerProjectsTools } from "./tools/projects.tools.js";
+import { registerScheduleTools } from "./tools/schedule.tools.js";
+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";
+const apiKey = process.env.LB_API_KEY;
+if (!apiKey) {
+    console.error("LB_API_KEY environment variable is required");
+    process.exit(1);
+}
+let baseUrl = "https://listingbureau.com";
+if (process.env.LB_BASE_URL) {
+    try {
+        baseUrl = validateBaseUrl(process.env.LB_BASE_URL);
+    }
+    catch (e) {
+        console.error(e.message);
+        process.exit(1);
+    }
+}
+const client = new LBClient(apiKey, baseUrl);
+const server = new McpServer({
+    name: "listingbureau",
+    version: "0.1.0",
+});
+registerAccountTools(server, client);
+registerWalletTools(server, client);
+registerProjectsTools(server, client);
+registerScheduleTools(server, client);
+registerOrdersTools(server, client);
+registerFeedbackTools(server, client);
+registerCostTools(server, client);
+const transport = new StdioServerTransport();
+await server.connect(transport);
+//# sourceMappingURL=index.js.map