@carrierllc/mcp 0.0.1 → 0.2.0

package/dist/pricing-tools.js

@@ -0,0 +1,428 @@
+/**
+ * Carrier MCP — Pricing & Credits MCP Tools
+ *
+ * Exposes credit management, billing configuration, and usage analytics
+ * as MCP tools. These tools allow AI agents and users to:
+ *   - Check credit balance and usage
+ *   - Configure billing thresholds
+ *   - View volume discount status
+ *   - Manage overage settings
+ *   - View billing history and projections
+ *
+ * Inspired by Stripe Projects CLI patterns:
+ *   - `stripe projects billing show` → credit_balance
+ *   - `stripe projects upgrade` → upgrade_plan
+ *   - `stripe projects billing add` → configure_billing
+ */
+import { checkCredits, getCreditSummary, updateCreditConfig, TIER_CREDIT_ALLOTMENTS, SCOPE_CREDIT_COSTS, VOLUME_DISCOUNTS, DAILY_FREE_CREDITS, } from "./credits.js";
+import { getThresholdConfig, updateThresholdConfig, } from "./billing-thresholds.js";
+export const PRICING_TOOLS = [
+    // -------------------------------------------------------------------------
+    // credit_balance — View current credit balance and usage
+    // -------------------------------------------------------------------------
+    {
+        name: "credit_balance",
+        description: "View your current credit balance, daily free credits, overage status, " +
+            "volume discount tier, and billing threshold status. Use this to understand " +
+            "your current usage and remaining capacity before making API calls.",
+        scope: "read",
+        inputSchema: {
+            type: "object",
+            properties: {},
+            required: [],
+        },
+        handler: async (env, props) => {
+            const tier = props.tier;
+            const summary = await getCreditSummary(env, props.sub, tier);
+            const creditCheck = await checkCredits(env, props.sub, tier, "read");
+            return {
+                tier,
+                credits: {
+                    monthly_allotment: summary.ledger.allotment,
+                    consumed: summary.ledger.consumed,
+                    remaining: Math.max(0, summary.ledger.allotment - summary.ledger.consumed),
+                    rollover_applied: summary.ledger.rollover_applied,
+                    overage_consumed: summary.ledger.overage,
+                    overage_billed_cents: summary.ledger.overage_billed_cents,
+                },
+                daily_free: {
+                    granted: summary.daily_free.granted,
+                    consumed: summary.daily_free.consumed,
+                    remaining: Math.max(0, summary.daily_free.granted - summary.daily_free.consumed),
+                },
+                volume_discount: {
+                    current_pct: summary.volume_discount_pct,
+                    next_tier: getNextVolumeDiscountTier(summary.ledger.consumed),
+                },
+                billing: {
+                    overages_enabled: summary.config.overages_enabled,
+                    threshold_triggered: summary.ledger.threshold_triggered,
+                    billing_threshold_cents: summary.config.billing_threshold_cents,
+                    overage_rate_cents: summary.config.overage_rate_cents,
+                },
+                rollover: summary.rollover
+                    ? {
+                        credits: summary.rollover.credits,
+                        source_month: summary.rollover.source_month,
+                        expires_at: summary.rollover.expires_at,
+                    }
+                    : null,
+                reset_at: creditCheck.reset_at,
+                credit_costs: SCOPE_CREDIT_COSTS,
+            };
+        },
+    },
+    // -------------------------------------------------------------------------
+    // configure_billing — Update billing preferences
+    // -------------------------------------------------------------------------
+    {
+        name: "configure_billing",
+        description: "Configure your billing preferences: enable/disable overages, set billing " +
+            "thresholds (bill shock prevention), configure notification percentages, " +
+            "and set hard spending caps. Pro and Enterprise tiers only.",
+        scope: "write",
+        inputSchema: {
+            type: "object",
+            properties: {
+                overages_enabled: {
+                    type: "boolean",
+                    description: "Enable or disable auto-billed overages when monthly credits are exhausted",
+                },
+                billing_threshold_cents: {
+                    type: "number",
+                    description: "Amount in cents at which an invoice is automatically generated (e.g., 10000 = $100)",
+                },
+                hard_cap_cents: {
+                    type: "number",
+                    description: "Maximum overage spend in cents before overages are paused (0 = no cap)",
+                },
+                auto_pause_on_cap: {
+                    type: "boolean",
+                    description: "Whether to automatically pause overages when hard cap is reached",
+                },
+                notify_at_pct: {
+                    type: "array",
+                    items: { type: "number" },
+                    description: "Percentage thresholds at which to send notifications (e.g., [50, 80, 95, 100])",
+                },
+                notification_email: {
+                    type: "string",
+                    description: "Email address for billing threshold notifications",
+                },
+                webhook_url: {
+                    type: "string",
+                    description: "Webhook URL for billing threshold events",
+                },
+            },
+            required: [],
+        },
+        handler: async (env, props, args) => {
+            const tier = props.tier;
+            if (tier === "free") {
+                return {
+                    error: "Billing configuration requires Pro or Enterprise tier",
+                    upgrade_url: "https://mcp.carrier.llc/upgrade",
+                };
+            }
+            // Update credit config
+            const creditUpdates = {};
+            if (typeof args.overages_enabled === "boolean") {
+                creditUpdates.overages_enabled = args.overages_enabled;
+            }
+            if (typeof args.billing_threshold_cents === "number") {
+                creditUpdates.billing_threshold_cents = args.billing_threshold_cents;
+            }
+            if (Array.isArray(args.notify_at_pct)) {
+                creditUpdates.notify_at_pct = args.notify_at_pct;
+            }
+            const updatedCreditConfig = Object.keys(creditUpdates).length > 0
+                ? await updateCreditConfig(env, props.sub, creditUpdates)
+                : await getCreditConfigForSub(env, props.sub, tier);
+            // Update threshold config
+            const thresholdUpdates = {};
+            if (typeof args.hard_cap_cents === "number") {
+                thresholdUpdates.hard_cap_cents = args.hard_cap_cents;
+            }
+            if (typeof args.auto_pause_on_cap === "boolean") {
+                thresholdUpdates.auto_pause_on_cap = args.auto_pause_on_cap;
+            }
+            if (typeof args.notification_email === "string") {
+                thresholdUpdates.notification_email = args.notification_email;
+            }
+            if (typeof args.webhook_url === "string") {
+                thresholdUpdates.webhook_url = args.webhook_url;
+            }
+            const updatedThresholdConfig = Object.keys(thresholdUpdates).length > 0
+                ? await updateThresholdConfig(env, props.sub, thresholdUpdates)
+                : await getThresholdConfig(env, props.sub, tier);
+            return {
+                status: "updated",
+                credit_config: {
+                    overages_enabled: updatedCreditConfig.overages_enabled,
+                    billing_threshold_cents: updatedCreditConfig.billing_threshold_cents,
+                    overage_rate_cents: updatedCreditConfig.overage_rate_cents,
+                    notify_at_pct: updatedCreditConfig.notify_at_pct,
+                },
+                threshold_config: {
+                    hard_cap_cents: updatedThresholdConfig.hard_cap_cents,
+                    auto_pause_on_cap: updatedThresholdConfig.auto_pause_on_cap,
+                    invoice_threshold_cents: updatedThresholdConfig.invoice_threshold_cents,
+                    notification_email: updatedThresholdConfig.notification_email,
+                    webhook_url: updatedThresholdConfig.webhook_url,
+                },
+            };
+        },
+    },
+    // -------------------------------------------------------------------------
+    // usage_projection — Project future usage and costs
+    // -------------------------------------------------------------------------
+    {
+        name: "usage_projection",
+        description: "Project your credit usage and costs for the remainder of the billing period " +
+            "based on current consumption rate. Includes overage cost estimates and " +
+            "recommendations for plan changes.",
+        scope: "read",
+        inputSchema: {
+            type: "object",
+            properties: {
+                days_to_project: {
+                    type: "number",
+                    description: "Number of days to project forward (default: remaining days in month)",
+                },
+            },
+            required: [],
+        },
+        handler: async (env, props, args) => {
+            const tier = props.tier;
+            const summary = await getCreditSummary(env, props.sub, tier);
+            const now = new Date();
+            const dayOfMonth = now.getUTCDate();
+            const daysInMonth = new Date(now.getUTCFullYear(), now.getUTCMonth() + 1, 0).getUTCDate();
+            const daysRemaining = typeof args.days_to_project === "number"
+                ? args.days_to_project
+                : daysInMonth - dayOfMonth;
+            // Calculate daily burn rate
+            const dailyBurnRate = dayOfMonth > 0 ? summary.ledger.consumed / dayOfMonth : 0;
+            const projectedTotal = Math.round(summary.ledger.consumed + dailyBurnRate * daysRemaining);
+            const projectedOverage = Math.max(0, projectedTotal - summary.ledger.allotment);
+            // Calculate projected overage cost
+            const volumeDiscount = getVolumeDiscountForUsage(projectedTotal);
+            const effectiveRate = summary.config.overage_rate_cents * (1 - volumeDiscount / 100);
+            const projectedOverageCents = Math.round(projectedOverage * effectiveRate);
+            // Recommendation
+            const recommendation = generateRecommendation(tier, projectedTotal, summary.ledger.allotment, projectedOverageCents);
+            return {
+                current_period: {
+                    day_of_month: dayOfMonth,
+                    days_in_month: daysInMonth,
+                    days_remaining: daysRemaining,
+                },
+                usage: {
+                    consumed_to_date: summary.ledger.consumed,
+                    daily_burn_rate: Math.round(dailyBurnRate),
+                    projected_total: projectedTotal,
+                    allotment: summary.ledger.allotment,
+                },
+                overage_projection: {
+                    projected_overage_credits: projectedOverage,
+                    projected_overage_cents: projectedOverageCents,
+                    volume_discount_pct: volumeDiscount,
+                    effective_rate_cents: effectiveRate,
+                },
+                recommendation,
+            };
+        },
+    },
+    // -------------------------------------------------------------------------
+    // pricing_plans — View available plans and pricing
+    // -------------------------------------------------------------------------
+    {
+        name: "pricing_plans",
+        description: "View all available Carrier MCP pricing plans with credit allotments, " +
+            "features, overage rates, and volume discount tiers. Use this to compare " +
+            "plans and understand upgrade benefits.",
+        scope: "read",
+        inputSchema: {
+            type: "object",
+            properties: {},
+            required: [],
+        },
+        handler: async (_env, props) => {
+            const currentTier = props.tier;
+            return {
+                current_plan: currentTier,
+                plans: [
+                    {
+                        id: "free",
+                        name: "Free",
+                        price_monthly_cents: 0,
+                        credits_monthly: TIER_CREDIT_ALLOTMENTS.free,
+                        daily_free_credits: DAILY_FREE_CREDITS,
+                        scopes: ["read"],
+                        features: [
+                            "5,000 monthly credits",
+                            "50 daily free credits",
+                            "Read-only OCS access",
+                            "Basic fleet monitoring",
+                        ],
+                        overages: false,
+                        rollovers: false,
+                        volume_discounts: false,
+                    },
+                    {
+                        id: "pro",
+                        name: "Pro",
+                        price_monthly_cents: 4_900,
+                        credits_monthly: TIER_CREDIT_ALLOTMENTS.pro,
+                        daily_free_credits: DAILY_FREE_CREDITS,
+                        scopes: ["read", "write"],
+                        features: [
+                            "100,000 monthly credits",
+                            "50 daily free credits",
+                            "Read + Write OCS access",
+                            "Intelligence composites",
+                            "Auto-billed overages at $0.001/credit",
+                            "Credit rollovers (unused → next month)",
+                            "Volume discounts (up to 25% off overages)",
+                            "Billing thresholds (bill shock prevention)",
+                            "Configurable hard spending caps",
+                            "Priority support",
+                        ],
+                        overages: true,
+                        rollovers: true,
+                        volume_discounts: true,
+                        overage_rate_cents: 0.1,
+                    },
+                    {
+                        id: "enterprise",
+                        name: "Enterprise",
+                        price_monthly_cents: 49_900,
+                        credits_monthly: "unlimited",
+                        daily_free_credits: DAILY_FREE_CREDITS,
+                        scopes: ["read", "write", "admin"],
+                        features: [
+                            "Unlimited credits",
+                            "All OCS scopes (incl. admin)",
+                            "Intelligence composites",
+                            "Custom rate limits",
+                            "SSO / SAML",
+                            "Dedicated support",
+                            "SLA guarantee",
+                            "Custom billing terms",
+                        ],
+                        overages: false,
+                        rollovers: false,
+                        volume_discounts: false,
+                    },
+                ],
+                volume_discount_tiers: VOLUME_DISCOUNTS,
+                credit_costs: SCOPE_CREDIT_COSTS,
+                upgrade_url: "https://mcp.carrier.llc/upgrade",
+            };
+        },
+    },
+    // -------------------------------------------------------------------------
+    // billing_events — View recent billing threshold events
+    // -------------------------------------------------------------------------
+    {
+        name: "billing_events",
+        description: "View recent billing threshold events: notifications, invoice triggers, " +
+            "hard cap alerts, and overage pauses. Useful for monitoring spend and " +
+            "understanding billing activity.",
+        scope: "read",
+        inputSchema: {
+            type: "object",
+            properties: {
+                limit: {
+                    type: "number",
+                    description: "Maximum number of events to return (default: 20, max: 50)",
+                },
+            },
+            required: [],
+        },
+        handler: async (env, props, args) => {
+            const limit = Math.min(typeof args.limit === "number" ? args.limit : 20, 50);
+            const eventsKey = `threshold:events:${props.sub}`;
+            const raw = await env.CARRIER_USERS.get(eventsKey, "json").catch(() => null);
+            const events = Array.isArray(raw) ? raw.slice(-limit) : [];
+            return {
+                events,
+                total: events.length,
+                threshold_config: await getThresholdConfig(env, props.sub, props.tier),
+            };
+        },
+    },
+];
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function getNextVolumeDiscountTier(consumed) {
+    for (const tier of VOLUME_DISCOUNTS) {
+        if (consumed < tier.threshold) {
+            return {
+                threshold: tier.threshold,
+                discount_pct: tier.discountPct,
+                credits_until: tier.threshold - consumed,
+            };
+        }
+    }
+    return null; // Already at max discount
+}
+function getVolumeDiscountForUsage(usage) {
+    let discount = 0;
+    for (const tier of VOLUME_DISCOUNTS) {
+        if (usage >= tier.threshold) {
+            discount = tier.discountPct;
+        }
+        else {
+            break;
+        }
+    }
+    return discount;
+}
+function generateRecommendation(tier, projectedTotal, allotment, projectedOverageCents) {
+    if (tier === "free" && projectedTotal > allotment * 0.8) {
+        return {
+            action: "upgrade_to_pro",
+            reason: "You're projected to exceed 80% of your free tier credits. " +
+                "Pro gives you 100,000 credits/month with overages, rollovers, and volume discounts.",
+        };
+    }
+    if (tier === "pro" && projectedOverageCents > 4_900) {
+        // Overages exceed the cost of Enterprise
+        return {
+            action: "upgrade_to_enterprise",
+            reason: "Your projected overage costs exceed the Enterprise plan price. " +
+                "Enterprise gives unlimited credits at $499/month.",
+            savings_cents: projectedOverageCents - 4_900 + 4_900, // overage + pro fee vs enterprise
+        };
+    }
+    if (tier === "pro" && projectedTotal < allotment * 0.3) {
+        return {
+            action: "no_change",
+            reason: "You're using less than 30% of your Pro allotment. " +
+                "Unused credits will roll over to next month (up to 2x your allotment).",
+        };
+    }
+    return {
+        action: "no_change",
+        reason: "Your current plan is well-suited to your usage pattern.",
+    };
+}
+async function getCreditConfigForSub(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;
+    }
+    return {
+        billing_threshold_cents: 10_000,
+        overages_enabled: tier !== "free",
+        rollovers_enabled: tier !== "free",
+        overage_rate_cents: 0.1,
+        volume_discount_pct: 0,
+        notify_at_pct: [50, 80, 95, 100],
+        updated_at: new Date().toISOString(),
+    };
+}
+//# sourceMappingURL=pricing-tools.js.map

package/dist/pricing-tools.js.map

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

package/dist/projects-tools.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Carrier MCP — Projects Tools (Stripe Projects CLI Pattern)
+ *
+ * Implements the Stripe Projects CLI paradigm for Carrier:
+ *   - Service catalog browsing (carrier ecosystem services)
+ *   - Credential vault management (API token rotation, env sync)
+ *   - Billing management via natural language (upgrade/downgrade)
+ *   - LLM context generation for AI agent workflows
+ *   - Multi-environment management (dev/staging/prod)
+ *
+ * These tools enable AI agents to:
+ *   1. Discover and provision Carrier services
+ *   2. Manage credentials securely
+ *   3. Handle billing operations programmatically
+ *   4. Generate context for downstream AI workflows
+ *
+ * Inspired by: `stripe projects init`, `stripe projects add`, `stripe projects catalog`
+ */
+import type { Env, CarrierProps, ToolScope } from "./types.js";
+import type { Tier } from "./billing.js";
+export interface CarrierService {
+    id: string;
+    name: string;
+    category: string;
+    description: string;
+    tier_required: Tier;
+    scopes_required: string[];
+    endpoints: string[];
+    docs_url: string;
+}
+export interface ProjectsToolDef {
+    name: string;
+    description: string;
+    scope: ToolScope;
+    inputSchema: Record<string, unknown>;
+    handler: (env: Env, props: CarrierProps, args: Record<string, unknown>) => Promise<unknown>;
+}
+export declare const PROJECTS_TOOLS: ProjectsToolDef[];
+//# sourceMappingURL=projects-tools.d.ts.map

package/dist/projects-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects-tools.d.ts","sourceRoot":"","sources":["../src/projects-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAOzC,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,IAAI,CAAC;IACpB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAyFD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,SAAS,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,OAAO,EAAE,CACP,GAAG,EAAE,GAAG,EACR,KAAK,EAAE,YAAY,EACnB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC1B,OAAO,CAAC,OAAO,CAAC,CAAC;CACvB;AAED,eAAO,MAAM,cAAc,EAAE,eAAe,EA+X3C,CAAC"}