@carrierllc/mcp 0.1.0 → 0.2.1

package/dist/credits.js

@@ -0,0 +1,483 @@
+/**
+ * Carrier MCP — Credits System v2.0 (Pricing Evolution)
+ *
+ * Implements credit-based billing inspired by Stripe's Pricing Model Evolution Guide:
+ *   - Monthly credit allotments per tier (Lovable pattern)
+ *   - Auto-billed overages when base credits exhausted (Warp pattern)
+ *   - Credit rollovers for irregular usage (Lovable pattern)
+ *   - Daily free credits for acquisition (Browserbase/Lovable pattern)
+ *   - Billing thresholds to prevent bill shock (Hex pattern)
+ *   - Volume discounts for high-usage customers
+ *
+ * Storage layout (CARRIER_USERS KV):
+ *   key: credits:<sub>:<yyyymm>     value: CreditLedger
+ *   key: credits:daily:<sub>:<yyyymmdd>  value: DailyFreeCredits
+ *   key: credits:config:<sub>       value: CreditConfig (overrides, thresholds)
+ *   key: credits:rollover:<sub>     value: RolloverBalance
+ *
+ * Credit economy:
+ *   1 tool call = 1 credit (read scope)
+ *   1 tool call = 2 credits (write scope)
+ *   1 tool call = 5 credits (admin scope)
+ *   Intelligence composites = 3 credits each
+ *
+ * Stripe integration:
+ *   - Overages reported via Stripe Metered Billing (usage_records API)
+ *   - Billing thresholds trigger Stripe invoice finalization
+ *   - Credit grants created via Stripe Customer Balance Transactions
+ */
+// ---------------------------------------------------------------------------
+// Credit Constants
+// ---------------------------------------------------------------------------
+/** Monthly credit allotments per tier */
+export const TIER_CREDIT_ALLOTMENTS = {
+    free: 5_000,
+    pro: 100_000,
+    enterprise: Infinity,
+};
+/** Daily free credits for all users (acquisition driver) */
+export const DAILY_FREE_CREDITS = 50;
+/** Maximum rollover credits (cap at 2x monthly allotment) */
+export const ROLLOVER_CAP_MULTIPLIER = 2;
+/** Credit cost per scope */
+export const SCOPE_CREDIT_COSTS = {
+    read: 1,
+    write: 2,
+    admin: 5,
+    intelligence: 3,
+};
+/** Volume discount tiers (cumulative monthly usage) */
+export const VOLUME_DISCOUNTS = [
+    { threshold: 50_000, discountPct: 0 },
+    { threshold: 100_000, discountPct: 10 },
+    { threshold: 250_000, discountPct: 15 },
+    { threshold: 500_000, discountPct: 20 },
+    { threshold: 1_000_000, discountPct: 25 },
+];
+/** Default billing threshold (in cents) — triggers invoice at this spend level */
+export const DEFAULT_BILLING_THRESHOLD_CENTS = 10_000; // $100
+/** Overage price per credit (in cents) — Pro tier */
+export const OVERAGE_PRICE_PER_CREDIT_CENTS = 0.1; // $0.001 per credit
+// ---------------------------------------------------------------------------
+// Credit Check
+// ---------------------------------------------------------------------------
+/**
+ * Check if a user has sufficient credits for a tool call.
+ * Order of credit consumption:
+ *   1. Daily free credits (if available)
+ *   2. Monthly allotment (base + rollover)
+ *   3. Overage (if enabled for tier)
+ */
+export async function checkCredits(env, sub, tier, scope) {
+    const cost = SCOPE_CREDIT_COSTS[scope];
+    const month = currentMonth();
+    const today = currentDay();
+    const resetAt = firstDayNextMonth();
+    // Enterprise always allowed
+    if (tier === "enterprise") {
+        return {
+            allowed: true,
+            credits_remaining: Infinity,
+            daily_free_remaining: Infinity,
+            overage_active: false,
+            overage_amount_cents: 0,
+            threshold_pct: 0,
+            tier,
+            volume_discount_pct: 0,
+            reset_at: resetAt,
+        };
+    }
+    // Load ledger
+    const ledger = await getLedger(env, sub, month, tier);
+    const dailyFree = await getDailyFreeCredits(env, sub, today);
+    const config = await getCreditConfig(env, sub, tier);
+    // Calculate remaining
+    const monthlyRemaining = Math.max(0, ledger.allotment - ledger.consumed);
+    const dailyFreeRemaining = Math.max(0, dailyFree.granted - dailyFree.consumed);
+    const totalRemaining = dailyFreeRemaining + monthlyRemaining;
+    // Check if allowed
+    const overageEnabled = config.overages_enabled && tier !== "free";
+    const allowed = totalRemaining >= cost || overageEnabled;
+    // Volume discount
+    const volumeDiscount = resolveVolumeDiscount(ledger.consumed);
+    // Threshold percentage
+    const thresholdPct = config.billing_threshold_cents > 0
+        ? Math.round((ledger.overage_billed_cents / config.billing_threshold_cents) * 100)
+        : 0;
+    return {
+        allowed,
+        credits_remaining: monthlyRemaining,
+        daily_free_remaining: dailyFreeRemaining,
+        overage_active: monthlyRemaining < cost && dailyFreeRemaining < cost && overageEnabled,
+        overage_amount_cents: ledger.overage_billed_cents,
+        threshold_pct: thresholdPct,
+        tier,
+        volume_discount_pct: volumeDiscount,
+        reset_at: resetAt,
+    };
+}
+// ---------------------------------------------------------------------------
+// Credit Deduction
+// ---------------------------------------------------------------------------
+/**
+ * Deduct credits for a tool call. Fire-and-forget in the hot path.
+ *
+ * Consumption order:
+ *   1. Daily free credits first (lowest cost to user)
+ *   2. Monthly allotment
+ *   3. Overage (auto-billed, Pro+ only)
+ */
+export function deductCredits(env, sub, tier, scope) {
+    void (async () => {
+        const cost = SCOPE_CREDIT_COSTS[scope];
+        const month = currentMonth();
+        const today = currentDay();
+        // Enterprise — no deduction needed
+        if (tier === "enterprise")
+            return;
+        // Try daily free credits first
+        const dailyFree = await getDailyFreeCredits(env, sub, today);
+        const dailyRemaining = dailyFree.granted - dailyFree.consumed;
+        if (dailyRemaining >= cost) {
+            // Deduct from daily free pool
+            await putDailyFreeCredits(env, sub, today, {
+                ...dailyFree,
+                consumed: dailyFree.consumed + cost,
+            });
+            return;
+        }
+        // Deduct from monthly allotment
+        const ledger = await getLedger(env, sub, month, tier);
+        const monthlyRemaining = ledger.allotment - ledger.consumed;
+        if (monthlyRemaining >= cost) {
+            await putLedger(env, sub, month, {
+                ...ledger,
+                consumed: ledger.consumed + cost,
+                updated_at: new Date().toISOString(),
+            });
+            return;
+        }
+        // Overage path (Pro+ only)
+        const config = await getCreditConfig(env, sub, tier);
+        if (!config.overages_enabled || tier === "free")
+            return;
+        const volumeDiscount = resolveVolumeDiscount(ledger.consumed);
+        const effectiveRate = OVERAGE_PRICE_PER_CREDIT_CENTS * (1 - volumeDiscount / 100);
+        const overageCostCents = Math.round(cost * effectiveRate * 100) / 100;
+        const updatedLedger = {
+            ...ledger,
+            consumed: ledger.consumed + cost,
+            overage: ledger.overage + cost,
+            overage_billed_cents: ledger.overage_billed_cents + overageCostCents,
+            updated_at: new Date().toISOString(),
+        };
+        // Check billing threshold
+        if (!ledger.threshold_triggered &&
+            updatedLedger.overage_billed_cents >= config.billing_threshold_cents) {
+            updatedLedger.threshold_triggered = true;
+            // Trigger Stripe invoice finalization (async, non-blocking)
+            void triggerBillingThreshold(env, sub, updatedLedger.overage_billed_cents);
+        }
+        await putLedger(env, sub, month, updatedLedger);
+        // Push overage to Stripe at every 100-credit boundary
+        if (updatedLedger.overage % 100 === 0) {
+            void pushOverageToStripe(env, sub, 100, effectiveRate).catch(() => { });
+        }
+    })();
+}
+// ---------------------------------------------------------------------------
+// Credit Grant (Rollover)
+// ---------------------------------------------------------------------------
+/**
+ * Calculate and apply rollover credits from previous month.
+ * Called by the monthly cron job (scheduled handler).
+ *
+ * Rules:
+ *   - Only Pro+ tiers get rollovers
+ *   - Rollover = min(unused credits, allotment * ROLLOVER_CAP_MULTIPLIER)
+ *   - Rollovers expire after 1 month (use-it-or-lose-it next cycle)
+ */
+export async function applyMonthlyRollover(env, sub, tier) {
+    if (tier === "free")
+        return null;
+    const prevMonth = previousMonth();
+    const prevLedger = await getLedger(env, sub, prevMonth, tier);
+    const unused = Math.max(0, prevLedger.allotment - prevLedger.consumed);
+    if (unused === 0)
+        return null;
+    const maxRollover = TIER_CREDIT_ALLOTMENTS[tier] * ROLLOVER_CAP_MULTIPLIER;
+    const rolloverAmount = Math.min(unused, maxRollover);
+    const rollover = {
+        credits: rolloverAmount,
+        source_month: prevMonth,
+        expires_at: firstDayMonthAfterNext(),
+    };
+    await env.CARRIER_USERS.put(`credits:rollover:${sub}`, JSON.stringify(rollover), { expirationTtl: 62 * 24 * 60 * 60 });
+    // Apply to current month's ledger
+    const currentMo = currentMonth();
+    const currentLedger = await getLedger(env, sub, currentMo, tier);
+    await putLedger(env, sub, currentMo, {
+        ...currentLedger,
+        allotment: currentLedger.allotment + rolloverAmount,
+        rollover_applied: rolloverAmount,
+        updated_at: new Date().toISOString(),
+    });
+    return rollover;
+}
+// ---------------------------------------------------------------------------
+// Volume Discounts
+// ---------------------------------------------------------------------------
+/**
+ * Resolve the applicable volume discount percentage based on cumulative usage.
+ */
+export function resolveVolumeDiscount(consumed) {
+    let discount = 0;
+    for (const tier of VOLUME_DISCOUNTS) {
+        if (consumed >= tier.threshold) {
+            discount = tier.discountPct;
+        }
+        else {
+            break;
+        }
+    }
+    return discount;
+}
+// ---------------------------------------------------------------------------
+// Billing Threshold
+// ---------------------------------------------------------------------------
+/**
+ * Trigger billing threshold — creates a Stripe invoice for accumulated overages.
+ * Prevents bill shock by invoicing incrementally (Hex pattern).
+ */
+async function triggerBillingThreshold(env, sub, amountCents) {
+    const stripeKey = env.STRIPE_SECRET_KEY;
+    if (!stripeKey)
+        return;
+    const customerId = await env.CARRIER_USERS.get(`stripe_customer_id:${sub}`);
+    if (!customerId)
+        return;
+    // Create an invoice item for the threshold amount
+    const body = new URLSearchParams({
+        customer: customerId,
+        amount: String(Math.round(amountCents)),
+        currency: "usd",
+        description: `Carrier MCP overage credits (threshold reached)`,
+    });
+    const resp = await fetch("https://api.stripe.com/v1/invoiceitems", {
+        method: "POST",
+        headers: {
+            Authorization: `Bearer ${stripeKey}`,
+            "Content-Type": "application/x-www-form-urlencoded",
+        },
+        body: body.toString(),
+    });
+    if (!resp.ok)
+        return;
+    // Create and finalize the invoice
+    const invoiceBody = new URLSearchParams({
+        customer: customerId,
+        auto_advance: "true", // Auto-finalize and attempt payment
+        "collection_method": "charge_automatically",
+        description: "Carrier MCP — Overage billing threshold invoice",
+    });
+    await fetch("https://api.stripe.com/v1/invoices", {
+        method: "POST",
+        headers: {
+            Authorization: `Bearer ${stripeKey}`,
+            "Content-Type": "application/x-www-form-urlencoded",
+        },
+        body: invoiceBody.toString(),
+    });
+}
+/**
+ * Push overage usage records to Stripe Metered Billing.
+ */
+async function pushOverageToStripe(env, sub, quantity, ratePerCredit) {
+    const stripeKey = env.STRIPE_SECRET_KEY;
+    if (!stripeKey)
+        return;
+    const subItemId = await env.CARRIER_USERS.get(`stripe_sub_item_id:${sub}`);
+    if (!subItemId)
+        return;
+    const body = new URLSearchParams({
+        quantity: String(quantity),
+        timestamp: String(Math.floor(Date.now() / 1000)),
+        action: "increment",
+    });
+    await fetch(`https://api.stripe.com/v1/subscription_items/${subItemId}/usage_records`, {
+        method: "POST",
+        headers: {
+            Authorization: `Bearer ${stripeKey}`,
+            "Content-Type": "application/x-www-form-urlencoded",
+        },
+        body: body.toString(),
+    });
+    // Store rate for reconciliation
+    await env.CARRIER_USERS.put(`overage_rate:${sub}`, JSON.stringify({ rate_cents: ratePerCredit, updated_at: new Date().toISOString() }), { expirationTtl: 35 * 24 * 60 * 60 });
+}
+// ---------------------------------------------------------------------------
+// KV Helpers
+// ---------------------------------------------------------------------------
+async function getLedger(env, sub, month, tier) {
+    const key = `credits:${sub}:${month}`;
+    const raw = await env.CARRIER_USERS.get(key, "json").catch(() => null);
+    if (raw && typeof raw === "object" && "allotment" in raw) {
+        return raw;
+    }
+    // Initialize new ledger for the month
+    const allotment = TIER_CREDIT_ALLOTMENTS[tier];
+    return {
+        allotment,
+        consumed: 0,
+        rollover_applied: 0,
+        overage: 0,
+        overage_billed_cents: 0,
+        threshold_triggered: false,
+        updated_at: new Date().toISOString(),
+    };
+}
+async function putLedger(env, sub, month, ledger) {
+    const key = `credits:${sub}:${month}`;
+    await env.CARRIER_USERS.put(key, JSON.stringify(ledger), {
+        expirationTtl: 65 * 24 * 60 * 60, // ~2 months
+    });
+}
+async function getDailyFreeCredits(env, sub, day) {
+    const key = `credits:daily:${sub}:${day}`;
+    const raw = await env.CARRIER_USERS.get(key, "json").catch(() => null);
+    if (raw && typeof raw === "object" && "granted" in raw) {
+        return raw;
+    }
+    // Initialize daily free credits
+    return {
+        granted: DAILY_FREE_CREDITS,
+        consumed: 0,
+        date: day,
+    };
+}
+async function putDailyFreeCredits(env, sub, day, credits) {
+    const key = `credits:daily:${sub}:${day}`;
+    await env.CARRIER_USERS.put(key, JSON.stringify(credits), {
+        expirationTtl: 2 * 24 * 60 * 60, // 2 days
+    });
+}
+async function getCreditConfig(env, sub, tier) {
+    const key = `credits:config:${sub}`;
+    const raw = await env.CARRIER_USERS.get(key, "json").catch(() => null);
+    if (raw && typeof raw === "object" && "billing_threshold_cents" in raw) {
+        return raw;
+    }
+    // Default config
+    return {
+        billing_threshold_cents: DEFAULT_BILLING_THRESHOLD_CENTS,
+        overages_enabled: tier !== "free",
+        rollovers_enabled: tier !== "free",
+        overage_rate_cents: OVERAGE_PRICE_PER_CREDIT_CENTS,
+        volume_discount_pct: 0,
+        notify_at_pct: [50, 80, 95, 100],
+        updated_at: new Date().toISOString(),
+    };
+}
+// ---------------------------------------------------------------------------
+// Admin: Update Credit Config
+// ---------------------------------------------------------------------------
+/**
+ * Update a user's credit configuration (admin or self-service).
+ */
+export async function updateCreditConfig(env, sub, updates) {
+    const tier = await resolveUserTier(env, sub);
+    const current = await getCreditConfig(env, sub, tier);
+    const updated = {
+        ...current,
+        ...updates,
+        updated_at: new Date().toISOString(),
+    };
+    const key = `credits:config:${sub}`;
+    await env.CARRIER_USERS.put(key, JSON.stringify(updated));
+    return updated;
+}
+/**
+ * Get credit usage summary for a user (used by billing UI).
+ */
+export async function getCreditSummary(env, sub, tier) {
+    const month = currentMonth();
+    const today = currentDay();
+    const ledger = await getLedger(env, sub, month, tier);
+    const dailyFree = await getDailyFreeCredits(env, sub, today);
+    const config = await getCreditConfig(env, sub, tier);
+    const rolloverRaw = await env.CARRIER_USERS.get(`credits:rollover:${sub}`, "json").catch(() => null);
+    const rollover = rolloverRaw;
+    const volumeDiscount = resolveVolumeDiscount(ledger.consumed);
+    return { ledger, daily_free: dailyFree, config, rollover, volume_discount_pct: volumeDiscount };
+}
+// ---------------------------------------------------------------------------
+// Stripe Credit Grants
+// ---------------------------------------------------------------------------
+/**
+ * Issue a credit grant to a customer via Stripe Customer Balance Transactions.
+ * Used for promotional credits, referral bonuses, and compensation.
+ */
+export async function issueStripeCredits(env, sub, amountCents, description) {
+    const stripeKey = env.STRIPE_SECRET_KEY;
+    if (!stripeKey)
+        return false;
+    const customerId = await env.CARRIER_USERS.get(`stripe_customer_id:${sub}`);
+    if (!customerId)
+        return false;
+    const body = new URLSearchParams({
+        amount: String(-Math.abs(amountCents)), // Negative = credit to customer
+        currency: "usd",
+        description,
+    });
+    const resp = await fetch(`https://api.stripe.com/v1/customers/${customerId}/balance_transactions`, {
+        method: "POST",
+        headers: {
+            Authorization: `Bearer ${stripeKey}`,
+            "Content-Type": "application/x-www-form-urlencoded",
+        },
+        body: body.toString(),
+    });
+    return resp.ok;
+}
+// ---------------------------------------------------------------------------
+// Internal Helpers
+// ---------------------------------------------------------------------------
+async function resolveUserTier(env, sub) {
+    const raw = await env.CARRIER_USERS.get(`user:${sub}`, "json").catch(() => null);
+    if (raw && typeof raw === "object" && "tier" in raw) {
+        const t = raw.tier;
+        if (t === "pro" || t === "enterprise")
+            return t;
+    }
+    return "free";
+}
+function currentMonth() {
+    const now = new Date();
+    return `${now.getUTCFullYear()}${String(now.getUTCMonth() + 1).padStart(2, "0")}`;
+}
+function currentDay() {
+    const now = new Date();
+    return `${now.getUTCFullYear()}${String(now.getUTCMonth() + 1).padStart(2, "0")}${String(now.getUTCDate()).padStart(2, "0")}`;
+}
+function previousMonth() {
+    const now = new Date();
+    const d = new Date(Date.UTC(now.getUTCFullYear(), now.getUTCMonth() - 1, 1));
+    return `${d.getUTCFullYear()}${String(d.getUTCMonth() + 1).padStart(2, "0")}`;
+}
+function firstDayNextMonth() {
+    const now = new Date();
+    const y = now.getUTCFullYear();
+    const m = now.getUTCMonth() + 1;
+    if (m === 12)
+        return new Date(Date.UTC(y + 1, 0, 1)).toISOString();
+    return new Date(Date.UTC(y, m, 1)).toISOString();
+}
+function firstDayMonthAfterNext() {
+    const now = new Date();
+    const y = now.getUTCFullYear();
+    const m = now.getUTCMonth() + 2;
+    if (m >= 12)
+        return new Date(Date.UTC(y + 1, m - 12, 1)).toISOString();
+    return new Date(Date.UTC(y, m, 1)).toISOString();
+}
+//# sourceMappingURL=credits.js.map

package/dist/credits.js.map

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

package/dist/index.d.ts

@@ -1,19 +1,14 @@
 #!/usr/bin/env node
 /**
- * @carrierllc/mcp — stdio entry point.
+ * Carrier MCP — single-user stdio entry point (MCPB / DXT bundle target).
  *
- * Single-user stdio MCP server. Reads ESIMVAULT_API_TOKEN (or CARRIER_OCS_API_TOKEN)
- * and CARRIER_OCS_BASE_URL from env. No OAuth — direct OCS access.
+ * Reads CARRIER_OCS_API_TOKEN from env; calls OCS directly with that token.
+ * No OAuth, no Workers — for local Claude Desktop installs via the .mcpb bundle.
  *
- * Usage:
- *   ESIMVAULT_API_TOKEN=<token> npx -y @carrierllc/mcp
+ * For multi-user deployments, use the remote OAuth endpoint at mcp.carrier.llc/mcp.
  *
- * MCP config (Claude Desktop / Cursor / Windsurf):
- *   {
- *     "command": "npx",
- *     "args": ["-y", "@carrierllc/mcp"],
- *     "env": { "ESIMVAULT_API_TOKEN": "YOUR_KEY" }
- *   }
+ * Tool registry MUST mirror agent.ts exactly so that generate-docs / verify-fidelity
+ * produce the same tool list as the deployed Worker.
  */
 export {};
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -1,43 +1,94 @@
 #!/usr/bin/env node
 /**
- * @carrierllc/mcp — stdio entry point.
+ * Carrier MCP — single-user stdio entry point (MCPB / DXT bundle target).
  *
- * Single-user stdio MCP server. Reads ESIMVAULT_API_TOKEN (or CARRIER_OCS_API_TOKEN)
- * and CARRIER_OCS_BASE_URL from env. No OAuth — direct OCS access.
+ * Reads CARRIER_OCS_API_TOKEN from env; calls OCS directly with that token.
+ * No OAuth, no Workers — for local Claude Desktop installs via the .mcpb bundle.
  *
- * Usage:
- *   ESIMVAULT_API_TOKEN=<token> npx -y @carrierllc/mcp
+ * For multi-user deployments, use the remote OAuth endpoint at mcp.carrier.llc/mcp.
  *
- * MCP config (Claude Desktop / Cursor / Windsurf):
- *   {
- *     "command": "npx",
- *     "args": ["-y", "@carrierllc/mcp"],
- *     "env": { "ESIMVAULT_API_TOKEN": "YOUR_KEY" }
- *   }
+ * Tool registry MUST mirror agent.ts exactly so that generate-docs / verify-fidelity
+ * produce the same tool list as the deployed Worker.
  */
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { OcsClient } from "./client.js";
 import { registerAllTools } from "./tools.js";
-import { registerAllIntelligenceTools } from "./intelligence.js";
+import { registerIntelligenceTools } from "./intelligence.js";
+import { registerAllBacklogTools } from "./tools-backlog.js";
+import { registerAllCarrierAskTools } from "./tools-carrier-ask.js";
+import { registerListRecentOcsEventsTool } from "./list-recent-ocs-events.js";
+import { registerAllApps } from "./apps/index.js";
 import { registerAllPrompts } from "./prompts.js";
+import { registerAllPricingTools } from "./tools-pricing.js";
+import { registerScheduleAndUsageTools } from "./tools-ui-agent-schedule.js";
+import { registerAllUiAgentTools } from "./tools-ui-agent.js";
+import { registerUiAgentAskTools } from "./tools-ui-agent-ask.js";
+import { registerStripeConnectTools } from "./stripe-connect-tools.js";
 const baseUrl = process.env.CARRIER_OCS_BASE_URL ??
     process.env.ESIMVAULT_BASE_URL ??
     "https://ocs.esimvault.cloud";
-const token = process.env.ESIMVAULT_API_TOKEN ??
-    process.env.CARRIER_OCS_API_TOKEN;
+const token = process.env.CARRIER_OCS_API_TOKEN ?? process.env.ESIMVAULT_API_TOKEN;
 if (!token) {
-    process.stderr.write("ERROR: ESIMVAULT_API_TOKEN (or CARRIER_OCS_API_TOKEN) must be set.\n" +
-        "Get a key at https://mcp.carrier.llc\n");
+    console.error("ERROR: CARRIER_OCS_API_TOKEN (or legacy ESIMVAULT_API_TOKEN) must be set.");
     process.exit(1);
 }
-const client = new OcsClient(baseUrl, token);
-const server = new McpServer({ name: "carrier-mcp", version: "0.1.0" }, {
-    instructions: "Carrier MCP — direct eSIMVault OCS access via stdio. 51 tools for MVNO/eSIM fleet management. " +
-        "43 OCS tools (read/write/admin) + 8 intelligence composites + 5 prompts.",
+// Minimal env shim — stdio mode never touches KV/R2/AE/secrets at runtime.
+// CF-only bindings (OAUTH_KV, OCS_EVENT_ROUTING, ASSETS, CARRIER_USERS, DOWNLOADS)
+// are stubbed so that tool *registration* succeeds; their handlers would error if
+// actually invoked in stdio mode (acceptable — these tools require the Workers runtime).
+const stdioEnv = {
+    CARRIER_OCS_BASE_URL: baseUrl,
+    CARRIER_TOKEN_ENCRYPTION_KEY: "",
+    SENTRY_DSN: "",
+    CLERK_PUBLISHABLE_KEY: "",
+    CLERK_SECRET_KEY: "",
+    CLERK_WEBHOOK_SECRET: "",
+    AUDIT_LOG: { writeDataPoint: (_) => undefined },
+    OAUTH_KV: null,
+    OCS_EVENT_ROUTING: null,
+    ASSETS: null,
+    CARRIER_USERS: null,
+    DOWNLOADS: null,
+    MANUS_API_KEY: "",
+    STRIPE_SECRET_KEY: "",
+};
+const props = {
+    sub: "stdio@local",
+    reseller_id: 0,
+    reseller_name: "stdio",
+    tier: "enterprise",
+    scope: ["read", "write", "admin"],
+};
+const audit = (_row) => {
+    // no-op in stdio mode
+};
+const getUserToken = async (_sub) => token;
+const toolCtx = { env: stdioEnv, props, audit, getUserToken };
+const server = new McpServer({ name: "carrier-mcp", version: "0.2.0" }, {
+    instructions: "Carrier MCP — single-user stdio mode. Full tool registry (mirrors the deployed Worker).",
 });
-registerAllTools(server, client);
-registerAllIntelligenceTools(server, client);
+// v1: 43 OCS API wrappers
+registerAllTools(server, toolCtx);
+// v1 intelligence: 8 AI composite tools
+registerIntelligenceTools(server, toolCtx);
+// v1.1 backlog: 8 confirmed-live OCS methods
+registerAllBacklogTools(server, toolCtx);
+// NL router: carrier_ask + carrier_ask_describe
+registerAllCarrierAskTools(server, toolCtx);
+// OCS event ring-buffer tool
+registerListRecentOcsEventsTool(server, stdioEnv);
+// v1.2 MCP Apps (fleet-health, provisioning-wizard, balance-topup)
+registerAllApps(server, toolCtx);
+// Pricing + projects tools
+registerAllPricingTools(server, toolCtx);
+// UI agent schedule + usage tools
+registerScheduleAndUsageTools(server, toolCtx);
+// UI agent write tools
+registerAllUiAgentTools(server, toolCtx);
+// UI agent ask/reply tools
+registerUiAgentAskTools(server, toolCtx);
+// Stripe Connect + Radar tools
+registerStripeConnectTools(server, { env: stdioEnv, props });
 registerAllPrompts(server);
 const transport = new StdioServerTransport();
 await server.connect(transport);