@solvapay/server 1.0.0-preview.20 → 1.0.0-preview.21

package/dist/index.d.ts

@@ -1,212 +1,353 @@
 interface components {
     schemas: {
-        UpdateProviderDto: Record<string, never>;
+        UpdateProviderDto: {
+            /** @description Legal entity information */
+            legalEntity?: Record<string, never>;
+            /**
+             * Provider description
+             * @example My business
+             */
+            description?: string;
+            /**
+             * Business website URL
+             * @example https://example.com
+             */
+            website?: string;
+            /**
+             * Business type
+             * @example individual
+             * @enum {string}
+             */
+            businessType?: "individual" | "company";
+            /**
+             * Business email address
+             * @example business@example.com
+             */
+            businessEmail?: string;
+            /**
+             * Support email address
+             * @example support@example.com
+             */
+            supportEmail?: string;
+            /**
+             * Business telephone number
+             * @example +1234567890
+             */
+            telephone?: string;
+            /**
+             * Support telephone number
+             * @example +1234567890
+             */
+            supportTelephone?: string;
+            /**
+             * Default currency code
+             * @example usd
+             */
+            defaultCurrency?: string;
+            /** @description Arbitrary metadata */
+            metadata?: Record<string, never>;
+            /** @description Terms of Service acceptance */
+            tosAcceptance?: Record<string, never>;
+        };
         CreateSecretKey: Record<string, never>;
-        CheckName: Record<string, never>;
-        CreateAdminAgent: Record<string, never>;
-        UpdateAdminAgent: Record<string, never>;
-        Agent: Record<string, never>;
-        CreateAgentRequest: Record<string, never>;
-        UpdateAgentRequest: Record<string, never>;
-        Signup: Record<string, never>;
+        Signup: {
+            name: string;
+            email: string;
+            /** @enum {string} */
+            type?: "provider" | "admin" | "super_admin";
+        };
         AuthResponse: Record<string, never>;
-        Login: Record<string, never>;
-        ForgotPassword: Record<string, never>;
-        ResetPassword: Record<string, never>;
-        VerifyEmail: Record<string, never>;
+        Login: {
+            /** @description Email to send a 6-digit login code to */
+            email: string;
+        };
+        VerifyLoginCode: {
+            email: string;
+            /** @description 6-digit login code sent to email */
+            code: string;
+        };
+        VerifyEmail: {
+            emailVerificationCode: string;
+        };
         CreateUser: Record<string, never>;
         UpdateUser: Record<string, never>;
         UpdateProfile: Record<string, never>;
         UpdatePreferences: Record<string, never>;
-        ChangePassword: Record<string, never>;
-        RequestEmailChange: Record<string, never>;
-        CreateProductRequest: {
-            /**
-             * Product name
-             * @example AI Writing Assistant
-             */
-            name: string;
+        RequestEmailChange: {
+            newEmail: string;
+        };
+        VerifyEmailChange: {
+            code: string;
+        };
+        CreateCheckoutSessionRequest: {
             /**
-             * Product description
-             * @example AI-powered writing tool
+             * Customer reference
+             * @example cus_3c4d5e6f7g8h
              */
-            description?: string;
-            /** URL to the product image */
-            imageUrl?: string;
+            customerReference: string;
             /**
-             * Free-form product type defined by the provider
-             * @example Coding Assistant
+             * Plan reference (optional)
+             * @example pln_2b3c4d5e6f7g
              */
-            productType?: string;
+            planRef?: string;
             /**
-             * Whether this product uses MCP Pay proxy
-             * @default false
+             * Product reference (required)
+             * @example prd_1a2b3c4d5e6f
              */
-            isMcpPay: boolean;
-            /** Product-specific configuration */
-            config?: Record<string, never>;
-            /** Arbitrary key-value metadata */
-            metadata?: Record<string, never>;
+            productRef: string;
         };
-        SdkProductResponse: {
+        CheckoutSessionResponse: {
             /**
-             * Product ID
+             * Checkout session ID
              * @example 507f1f77bcf86cd799439011
              */
             id: string;
             /**
-             * Product reference
-             * @example prd_1A2B3C4D
+             * Public session ID used in checkout URL
+             * @example a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6
              */
-            reference: string;
+            sessionId: string;
             /**
-             * Product name
-             * @example AI Writing Assistant
+             * Amount in cents
+             * @example 2999
              */
-            name: string;
-            /** Product description */
-            description?: string;
-            /** URL to the product image */
-            imageUrl?: string;
-            /** Free-form product type */
-            productType?: string;
+            amount: number;
             /**
-             * Product status
+             * Currency code
+             * @example USD
+             */
+            currency: string;
+            /**
+             * Session status
              * @example active
              */
             status: string;
             /**
-             * Product balance in cents
-             * @example 0
+             * Checkout URL to open the checkout page
+             * @example https://solvapay.com/customer/checkout?id=a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6
              */
-            balance: number;
+            checkoutUrl: string;
+        };
+        SelectCustomerSessionProductRequest: {
             /**
-             * Total number of transactions
-             * @example 0
+             * Product reference or ID to scope the customer manage session
+             * @example prd_1a2b3c4d5e6f
              */
-            totalTransactions: number;
+            productRef: string;
+        };
+        CancelRenewalRequest: {
+            /** @description Reason for cancelling renewal */
+            reason?: string;
+        };
+        ExternalAccount: {
             /**
-             * Whether this product uses MCP Pay proxy
-             * @example false
+             * Country code
+             * @example US
              */
-            isMcpPay: boolean;
-            /** Product-specific configuration */
-            config?: Record<string, never>;
-            /** Arbitrary key-value metadata */
-            metadata?: Record<string, never>;
-            /** Creation timestamp */
-            createdAt: string;
-            /** Last update timestamp */
-            updatedAt: string;
-            /** Plans associated with this product */
-            plans?: string[];
-        };
-        UpdateProductRequest: {
-            /** Product name */
-            name?: string;
-            /** Product description */
-            description?: string;
-            /** URL to the product image */
-            imageUrl?: string;
-            /** Free-form product type defined by the provider */
-            productType?: string;
+            country: string;
             /**
-             * Product status
+             * Currency code
+             * @example usd
+             */
+            currency: string;
+            /**
+             * Account holder name
+             * @example John Doe
+             */
+            accountHolderName: string;
+            /**
+             * Account holder type
+             * @example individual
              * @enum {string}
              */
-            status?: "active" | "inactive" | "suspended";
-            /** Product-specific configuration */
-            config?: Record<string, never>;
-            /** Arbitrary key-value metadata */
-            metadata?: Record<string, never>;
+            accountHolderType: "individual" | "company";
+            /**
+             * Routing number
+             * @example 110000000
+             */
+            routingNumber: string;
+            /**
+             * Account number
+             * @example 000123456789
+             */
+            accountNumber: string;
         };
-        CreatePlanRequest: {
+        TosAcceptance: {
             /**
-             * Plan name
-             * @example Basic Plan
+             * IP address of user accepting ToS
+             * @example 192.168.1.1
              */
-            name: string;
+            ip: string;
+        };
+        UpdateConnectedAccount: {
             /**
-             * Plan description
-             * @example Basic recurring plan with monthly billing
+             * Business website URL
+             * @example https://example.com
              */
-            description?: string;
+            website?: string;
+            /** @description External bank account */
+            externalAccount?: components["schemas"]["ExternalAccount"];
+            /** @description Terms of Service acceptance */
+            tosAcceptance?: components["schemas"]["TosAcceptance"];
+        };
+        Plan: {
             /**
-             * Plan type
+             * Plan type exposed in SDK
              * @example recurring
              * @enum {string}
              */
-            type?: "recurring" | "usage-based" | "hybrid" | "one-time";
+            type: "recurring" | "one-time";
             /**
-             * Billing cycle (required for recurring/hybrid, optional for post-paid usage-based)
-             * @example monthly
-             * @enum {string}
+             * Plan ID
+             * @example 507f1f77bcf86cd799439011
              */
-            billingCycle?: "weekly" | "monthly" | "quarterly" | "yearly" | "custom";
+            id: string;
             /**
-             * Plan price
-             * @example 29.99
+             * Plan reference
+             * @example pln_1A2B3C4D
              */
-            price?: number;
+            reference: string;
+            /**
+             * Plan price in cents
+             * @example 2999
+             */
+            price: number;
             /**
              * Currency code (ISO 4217)
              * @example USD
-             * @enum {string}
              */
-            currency?: "USD" | "EUR" | "GBP" | "SEK" | "NOK" | "DKK" | "CAD" | "AUD" | "JPY" | "CHF" | "PLN" | "CZK" | "HUF" | "RON" | "BGN" | "HRK" | "RSD" | "MKD" | "BAM" | "ALL" | "ISK" | "TRY" | "RUB" | "UAH" | "BYN" | "MDL" | "GEL" | "AMD" | "AZN" | "KZT" | "KGS" | "TJS" | "TMT" | "UZS" | "MNT" | "CNY" | "KRW" | "THB" | "VND" | "IDR" | "MYR" | "SGD" | "PHP" | "INR" | "PKR" | "BDT" | "LKR" | "NPR" | "AFN" | "IRR" | "IQD" | "JOD" | "KWD" | "LBP" | "OMR" | "QAR" | "SAR" | "SYP" | "AED" | "YER" | "ILS" | "EGP" | "MAD" | "TND" | "DZD" | "LYD" | "SDG" | "ETB" | "KES" | "TZS" | "UGX" | "RWF" | "BIF" | "DJF" | "SOS" | "ERN" | "SLL" | "GMD" | "GNF" | "CVE" | "STN" | "AOA" | "ZAR" | "BWP" | "SZL" | "LSL" | "NAD" | "ZMW" | "ZWL" | "MZN" | "MWK" | "MGA" | "MUR" | "SCR" | "KMF" | "MVR";
+            currency: string;
             /**
-             * Setup fee
-             * @example 0
+             * Currency symbol (derived from currency)
+             * @example $
+             */
+            currencySymbol?: string;
+            /**
+             * Number of free units included
+             * @example 100
+             */
+            freeUnits?: number;
+            /**
+             * One-time setup fee
+             * @example 500
              */
             setupFee?: number;
             /**
-             * Trial days
-             * @example 7
+             * Free trial period in days
+             * @example 14
              */
             trialDays?: number;
             /**
-             * Number of free units included
-             * @example 100
+             * Billing cycle
+             * @example monthly
              */
-            freeUnits?: number;
+            billingCycle?: string;
             /**
-             * Billing model for usage-based plans
+             * Billing model
              * @example pre-paid
              * @enum {string}
              */
             billingModel?: "pre-paid" | "post-paid";
             /**
-             * Price per unit for usage-based plans
+             * Price per usage unit
              * @example 0.01
              */
             pricePerUnit?: number;
             /**
-             * Unit name for usage-based plans
-             * @example request
+             * What the plan measures for usage tracking
+             * @example requests
              */
-            unit?: string;
+            measures?: string;
             /**
-             * Usage quota for usage-based plans
+             * Usage limit for the meter
              * @example 10000
              */
-            quota?: number;
+            limit?: number;
             /**
-             * Whether to rollover unused units
+             * Whether unused units roll over to next period
              * @example false
              */
             rolloverUnusedUnits?: boolean;
+            /** @description Usage limits */
+            limits?: {
+                [key: string]: unknown;
+            };
+            /** @description Plan features */
+            features?: {
+                [key: string]: unknown;
+            };
+            /**
+             * Whether this is a free tier plan
+             * @example false
+             */
+            isFreeTier: boolean;
+            /**
+             * Whether payment is required
+             * @example true
+             */
+            requiresPayment: boolean;
+            /**
+             * Whether the plan is active (derived from status)
+             * @example true
+             */
+            isActive: boolean;
+            /** @description Maximum number of active users */
+            maxActiveUsers?: number;
+            /** @description Access expiry in days */
+            accessExpiryDays?: number;
+            /**
+             * Plan status
+             * @example active
+             */
+            status: string;
+            /** @description Creation timestamp */
+            createdAt: string;
+            /** @description Last update timestamp */
+            updatedAt: string;
+        };
+        CreatePlanRequest: {
+            /**
+             * Plan type exposed in SDK
+             * @example recurring
+             * @enum {string}
+             */
+            type?: "recurring" | "one-time";
+            /**
+             * Billing cycle (required for recurring/hybrid, optional for post-paid usage-based)
+             * @example monthly
+             * @enum {string}
+             */
+            billingCycle?: "weekly" | "monthly" | "quarterly" | "yearly" | "custom";
             /**
-             * Base price for hybrid plans
-             * @example 29.99
+             * Plan price in cents
+             * @example 2999
+             */
+            price?: number;
+            /**
+             * Currency code (ISO 4217)
+             * @example USD
+             * @enum {string}
+             */
+            currency?: "USD" | "EUR" | "GBP" | "SEK" | "NOK" | "DKK" | "CAD" | "AUD" | "JPY" | "CHF" | "PLN" | "CZK" | "HUF" | "RON" | "BGN" | "HRK" | "RSD" | "MKD" | "BAM" | "ALL" | "ISK" | "TRY" | "RUB" | "UAH" | "BYN" | "MDL" | "GEL" | "AMD" | "AZN" | "KZT" | "KGS" | "TJS" | "TMT" | "UZS" | "MNT" | "CNY" | "KRW" | "THB" | "VND" | "IDR" | "MYR" | "SGD" | "PHP" | "INR" | "PKR" | "BDT" | "LKR" | "NPR" | "AFN" | "IRR" | "IQD" | "JOD" | "KWD" | "LBP" | "OMR" | "QAR" | "SAR" | "SYP" | "AED" | "YER" | "ILS" | "EGP" | "MAD" | "TND" | "DZD" | "LYD" | "SDG" | "ETB" | "KES" | "TZS" | "UGX" | "RWF" | "BIF" | "DJF" | "SOS" | "ERN" | "SLL" | "GMD" | "GNF" | "CVE" | "STN" | "AOA" | "ZAR" | "BWP" | "SZL" | "LSL" | "NAD" | "ZMW" | "ZWL" | "MZN" | "MWK" | "MGA" | "MUR" | "SCR" | "KMF" | "MVR";
+            /**
+             * Number of free units included
+             * @example 100
+             */
+            freeUnits?: number;
+            /**
+             * Usage limit for the meter
+             * @example 10000
              */
-            basePrice?: number;
+            limit?: number;
             /**
              * Usage limits (shape varies by plan type)
              * @example {
              *       "maxTransactions": 1000
              *     }
              */
-            limits?: Record<string, never>;
+            limits?: {
+                [key: string]: unknown;
+            };
             /**
              * Plan features (generic key/value, shape is provider-defined)
              * @example {
@@ -214,7 +355,9 @@ interface components {
              *       "prioritySupport": false
              *     }
              */
-            features?: Record<string, never>;
+            features?: {
+                [key: string]: unknown;
+            };
             /**
              * Whether this is a free tier plan
              * @example false
@@ -241,178 +384,1103 @@ interface components {
              * @example 30
              */
             accessExpiryDays?: number;
-            /** Additional metadata */
-            metadata?: Record<string, never>;
+            /** @description Additional metadata */
+            metadata?: {
+                [key: string]: unknown;
+            };
             /**
              * Whether this is the default plan
              * @example false
              */
             default?: boolean;
         };
-        UpdatePlanRequest: Record<string, never>;
-        CreateCheckoutSessionRequest: {
+        UpdatePlanRequest: {
             /**
-             * Customer reference
-             * @example cus_3c4d5e6f7g8h
+             * Billing cycle
+             * @example monthly
+             * @enum {string}
              */
-            customerReference: string;
+            billingCycle?: "weekly" | "monthly" | "quarterly" | "yearly" | "custom";
             /**
-             * Plan reference (optional)
-             * @example pln_2b3c4d5e6f7g
+             * Plan price in cents
+             * @example 2999
              */
-            planRef?: string;
+            price?: number;
             /**
-             * Product reference (required)
-             * @example prd_1a2b3c4d5e6f
+             * Currency code (ISO 4217)
+             * @example USD
              */
-            productRef: string;
-        };
-        CheckoutSessionResponse: {
+            currency?: string;
             /**
-             * Checkout session ID
-             * @example 507f1f77bcf86cd799439011
+             * Number of free units included
+             * @example 100
              */
-            id: string;
+            freeUnits?: number;
             /**
-             * Public session ID used in checkout URL
-             * @example a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6
+             * Usage limit for the meter
+             * @example 10000
              */
-            sessionId: string;
+            limit?: number;
             /**
-             * Amount in cents
-             * @example 2999
+             * Usage limits (shape varies by plan type)
+             * @example {
+             *       "maxTransactions": 1000
+             *     }
              */
-            amount: number;
+            limits?: {
+                [key: string]: unknown;
+            };
             /**
-             * Currency code
-             * @example USD
+             * Plan features (generic key/value, shape is provider-defined)
+             * @example {
+             *       "apiAccess": true,
+             *       "prioritySupport": false
+             *     }
+             */
+            features?: {
+                [key: string]: unknown;
+            };
+            /**
+             * Whether this is a free tier plan
+             * @example false
+             */
+            isFreeTier?: boolean;
+            /**
+             * Whether payment is required
+             * @example true
+             */
+            requiresPayment?: boolean;
+            /**
+             * Plan status
+             * @example active
+             * @enum {string}
+             */
+            status?: "active" | "inactive" | "archived";
+            /**
+             * Maximum number of active users
+             * @example 10
+             */
+            maxActiveUsers?: number;
+            /**
+             * Access expiry in days
+             * @example 30
+             */
+            accessExpiryDays?: number;
+            /** @description Additional metadata */
+            metadata?: {
+                [key: string]: unknown;
+            };
+            /**
+             * Whether this is the default plan
+             * @example false
+             */
+            default?: boolean;
+        };
+        ProductConfigDto: {
+            /**
+             * Fulfillment type
+             * @example digital
+             */
+            fulfillmentType?: string;
+            /**
+             * Validity period in days
+             * @example 30
+             */
+            validityPeriod?: number;
+            /**
+             * Delivery method
+             * @example api
+             */
+            deliveryMethod?: string;
+        };
+        CreateProductRequest: {
+            /**
+             * Product name
+             * @example AI Writing Assistant
+             */
+            name: string;
+            /**
+             * Product description
+             * @example AI-powered writing tool
+             */
+            description?: string;
+            /** @description URL to the product image */
+            imageUrl?: string;
+            /**
+             * Free-form product type defined by the provider
+             * @example Coding Assistant
+             */
+            productType?: string;
+            /**
+             * Whether this product uses MCP Pay proxy
+             * @default false
+             */
+            isMcpPay: boolean;
+            /** @description Product-specific configuration */
+            config?: components["schemas"]["ProductConfigDto"];
+            /** @description Arbitrary key-value metadata */
+            metadata?: {
+                [key: string]: unknown;
+            };
+        };
+        SdkPlanResponse: {
+            /**
+             * Plan ID
+             * @example 507f1f77bcf86cd799439011
+             */
+            id: string;
+            /**
+             * Plan reference
+             * @example pln_1A2B3C4D
+             */
+            reference: string;
+            /**
+             * Plan price in cents
+             * @example 2999
+             */
+            price: number;
+            /**
+             * Currency code (ISO 4217)
+             * @example USD
              */
             currency: string;
+            /**
+             * Currency symbol
+             * @example $
+             */
+            currencySymbol?: string;
+            /**
+             * One-time setup fee
+             * @example 500
+             */
+            setupFee?: number;
+            /**
+             * Free trial period in days
+             * @example 14
+             */
+            trialDays?: number;
+            /**
+             * Billing cycle
+             * @example monthly
+             */
+            billingCycle?: string;
+            /**
+             * Billing model
+             * @example pre-paid
+             */
+            billingModel?: string;
+            /**
+             * Price per unit in cents
+             * @example 10
+             */
+            pricePerUnit?: number;
+            /**
+             * What the plan measures for usage tracking
+             * @example requests
+             */
+            measures?: string;
+            /**
+             * Usage limit for the meter
+             * @example 10000
+             */
+            limit?: number;
+            /**
+             * Whether unused units roll over to next period
+             * @example false
+             */
+            rolloverUnusedUnits?: boolean;
+            /**
+             * Included free units
+             * @example 1000
+             */
+            freeUnits?: number;
+            /** @description Usage limits */
+            limits?: {
+                [key: string]: unknown;
+            };
+            /** @description Plan features */
+            features?: {
+                [key: string]: unknown;
+            };
+            /**
+             * Whether this is a free tier plan
+             * @example false
+             */
+            isFreeTier: boolean;
+            /**
+             * Whether payment is required
+             * @example true
+             */
+            requiresPayment: boolean;
+            /**
+             * Whether the plan is active
+             * @example true
+             */
+            isActive: boolean;
+            /**
+             * Plan status
+             * @example active
+             */
+            status: string;
+            /** @description Creation timestamp */
+            createdAt: string;
+            /** @description Last update timestamp */
+            updatedAt: string;
+        };
+        SdkProductResponse: {
+            /**
+             * Product ID
+             * @example 507f1f77bcf86cd799439011
+             */
+            id: string;
+            /**
+             * Product reference
+             * @example prd_1A2B3C4D
+             */
+            reference: string;
+            /**
+             * Product name
+             * @example AI Writing Assistant
+             */
+            name: string;
+            /** @description Product description */
+            description?: string;
+            /** @description URL to the product image */
+            imageUrl?: string;
+            /** @description Free-form product type */
+            productType?: string;
+            /**
+             * Product status
+             * @example active
+             */
+            status: string;
+            /**
+             * Product balance in cents
+             * @example 0
+             */
+            balance: number;
+            /**
+             * Total number of transactions
+             * @example 0
+             */
+            totalTransactions: number;
+            /**
+             * Whether this product uses MCP Pay proxy
+             * @example false
+             */
+            isMcpPay: boolean;
+            /** @description Product-specific configuration */
+            config?: components["schemas"]["ProductConfigDto"];
+            /** @description Arbitrary key-value metadata */
+            metadata?: {
+                [key: string]: unknown;
+            };
+            /** @description Creation timestamp */
+            createdAt: string;
+            /** @description Last update timestamp */
+            updatedAt: string;
+            /** @description Plans associated with this product */
+            plans?: components["schemas"]["SdkPlanResponse"][];
+            /**
+             * MCP linkage details for MCP-enabled products
+             * @example {
+             *       "mcpServerId": "67f90f1f1b1c9c0b8df0f111",
+             *       "mcpServerReference": "mcp_ABC123",
+             *       "mcpSubdomain": "acme-docs",
+             *       "mcpProxyUrl": "https://acme-docs.mcp.solvapay.com/mcp",
+             *       "originUrl": "https://origin.example.com/mcp",
+             *       "defaultPlanId": "67f90f1f1b1c9c0b8df0f001"
+             *     }
+             */
+            mcp?: {
+                [key: string]: unknown;
+            };
+        };
+        UpdateProductRequest: {
+            /** @description Product name */
+            name?: string;
+            /** @description Product description */
+            description?: string;
+            /** @description URL to the product image */
+            imageUrl?: string;
+            /** @description Free-form product type defined by the provider */
+            productType?: string;
+            /**
+             * Product status
+             * @enum {string}
+             */
+            status?: "active" | "inactive" | "suspended";
+            /** @description Product-specific configuration */
+            config?: components["schemas"]["ProductConfigDto"];
+            /** @description Arbitrary key-value metadata */
+            metadata?: {
+                [key: string]: unknown;
+            };
+        };
+        McpBootstrapFreePlanConfig: {
+            /**
+             * Free plan display name override
+             * @example Starter
+             */
+            name?: string;
+            /**
+             * Included free units (default 1000)
+             * @example 500
+             */
+            freeUnits?: number;
+        };
+        McpBootstrapPaidPlanInput: {
+            /**
+             * Logical plan key (must not be "free")
+             * @example pro
+             */
+            key: string;
+            /**
+             * Plan display name
+             * @example Pro
+             */
+            name: string;
+            /**
+             * Plan price in cents (must be > 0)
+             * @example 2000
+             */
+            price: number;
+            /**
+             * Currency code (ISO 4217)
+             * @example USD
+             */
+            currency: string;
+            /**
+             * Billing cycle for recurring plans
+             * @example monthly
+             * @enum {string}
+             */
+            billingCycle?: "weekly" | "monthly" | "quarterly" | "yearly" | "custom";
+            /**
+             * Plan type
+             * @example recurring
+             * @enum {string}
+             */
+            type?: "recurring" | "one-time";
+            /**
+             * Included free units
+             * @example 1000
+             */
+            freeUnits?: number;
+            /**
+             * Meter id for usage tracking
+             * @example 67f90f1f1b1c9c0b8df0f001
+             */
+            meterId?: string;
+            /**
+             * Plan usage limit
+             * @example 10000
+             */
+            limit?: number;
+            /** @description Plan features */
+            features?: {
+                [key: string]: unknown;
+            };
+        };
+        McpBootstrapToolInput: {
+            /**
+             * Tool name
+             * @example search_docs
+             */
+            name: string;
+            /**
+             * Tool description
+             * @example Search indexed documents
+             */
+            description?: string;
+            /**
+             * If true, tool is publicly available without a plan
+             * @example false
+             */
+            noPlan?: boolean;
+            /**
+             * Direct plan IDs allowed for this tool
+             * @example [
+             *       "67f90f1f1b1c9c0b8df0f001"
+             *     ]
+             */
+            planIds?: string[];
+            /**
+             * Plan references allowed for this tool
+             * @example [
+             *       "pln_ABC123"
+             *     ]
+             */
+            planRefs?: string[];
+            /**
+             * Bootstrap plan keys allowed for this tool (for example free or starter_paid)
+             * @example [
+             *       "free"
+             *     ]
+             */
+            planKeys?: string[];
+        };
+        McpBootstrapRequest: {
+            /**
+             * Product name (optional when derivable from origin MCP metadata)
+             * @example Acme MCP Toolkit
+             */
+            name?: string;
+            /**
+             * Product description
+             * @example MCP toolkit with tiered access
+             */
+            description?: string;
+            /** @description Product image URL */
+            imageUrl?: string;
+            /**
+             * Free-form product type
+             * @example MCP Server
+             */
+            productType?: string;
+            /**
+             * Origin MCP server URL (must be https)
+             * @example https://origin.example.com/mcp
+             */
+            originUrl: string;
+            /**
+             * Domain slug input for MCP server name/subdomain normalization
+             * @example acme-docs
+             */
+            mcpDomain?: string;
+            /**
+             * Optional auth header name forwarded to origin server
+             * @example X-API-Key
+             */
+            authHeaderName?: string;
+            /**
+             * Optional auth API key forwarded to origin server
+             * @example sk-origin-123
+             */
+            authApiKey?: string;
+            /** @description Free plan config overrides. A free plan is always created; this just customizes name/freeUnits. */
+            freePlan?: components["schemas"]["McpBootstrapFreePlanConfig"];
+            /** @description Paid plan definitions requiring price + currency */
+            paidPlans?: components["schemas"]["McpBootstrapPaidPlanInput"][];
+            /** @description Tool to plan mapping configuration */
+            tools?: components["schemas"]["McpBootstrapToolInput"][];
+            /** @description Arbitrary product metadata */
+            metadata?: {
+                [key: string]: unknown;
+            };
+        };
+        McpBootstrapResult: {
+            /** @description Created product */
+            product: components["schemas"]["SdkProductResponse"];
+            /**
+             * Created or updated MCP server identity
+             * @example {
+             *       "id": "67f90f1f1b1c9c0b8df0f111",
+             *       "reference": "mcp_ABC123",
+             *       "subdomain": "acme-docs",
+             *       "mcpProxyUrl": "https://acme-docs.mcp.solvapay.com/mcp",
+             *       "url": "https://origin.example.com/mcp",
+             *       "defaultPlanId": "67f90f1f1b1c9c0b8df0f001"
+             *     }
+             */
+            mcpServer: {
+                [key: string]: unknown;
+            };
+            /**
+             * Resolved plan mapping by bootstrap key
+             * @example {
+             *       "free": {
+             *         "id": "67f90f1f1b1c9c0b8df0f001",
+             *         "reference": "pln_FREE123",
+             *         "name": "Free"
+             *       }
+             *     }
+             */
+            planMap: {
+                [key: string]: unknown;
+            };
+            /**
+             * True when tools were auto-discovered from origin because the request omitted tools
+             * @example true
+             */
+            toolsAutoMapped?: boolean;
+            /** @description Auto-discovered tools used during bootstrap */
+            autoMappedTools?: {
+                name?: string;
+                description?: string;
+            }[];
+        };
+        McpBootstrapPreviewResult: {
+            /** @description Discovered tools from the origin MCP server */
+            discoveredTools: {
+                name?: string;
+                description?: string;
+            }[];
+            /** @description Validation status for the provided bootstrap payload */
+            validation: {
+                valid?: boolean;
+                errors?: components["schemas"]["McpBootstrapPreviewValidationError"][];
+            };
+            /**
+             * Product name derived from origin MCP metadata or hostname fallback
+             * @example acme-origin-mcp
+             */
+            derivedName?: string;
+            /**
+             * Product description derived from origin server instructions
+             * @example MCP toolkit for document retrieval and summarization.
+             */
+            derivedDescription?: string;
+            /** @description Source of derived metadata */
+            metadataSource: {
+                /** @enum {string} */
+                name?: "request" | "origin" | "hostname";
+                /** @enum {string} */
+                description?: "request" | "instructions" | "none";
+            };
+            /** @description Suggested default tool-to-plan mapping for UI review */
+            suggestedMapping: {
+                name?: string;
+                description?: string;
+                planKey?: string;
+            }[];
+        };
+        RecordMeterEventDto: {
+            /**
+             * Meter name to record against
+             * @example requests
+             */
+            meterName: string;
+            /**
+             * Customer reference
+             * @example cus_ABC123
+             */
+            customerId: string;
+            /**
+             * Numeric value (default 1)
+             * @default 1
+             * @example 1
+             */
+            value: number;
+            /**
+             * Arbitrary key-value tags
+             * @example {
+             *       "endpoint": "/api/v1/search",
+             *       "region": "us-east-1"
+             *     }
+             */
+            properties?: {
+                [key: string]: unknown;
+            };
+            /** @description Product ID to scope the usage event to */
+            productId?: string;
+            /** @description Product reference to scope the usage event to */
+            productReference?: string;
+            /** @description ISO 8601 timestamp (defaults to now) */
+            timestamp?: string;
+        };
+        RecordBulkMeterEventsDto: {
+            /** @description Array of events to record */
+            events: components["schemas"]["RecordMeterEventDto"][];
+        };
+        CreateCustomerSessionRequest: {
+            /**
+             * Customer reference identifier
+             * @example cus_3c4d5e6f7g8h
+             */
+            customerRef: string;
+            /**
+             * Optional product reference or ID to scope the customer manage page to a single product.
+             * @example prd_1a2b3c4d5e6f
+             */
+            productRef?: string;
+        };
+        CustomerSessionResponse: {
+            /**
+             * Customer session ID
+             * @example 507f1f77bcf86cd799439011
+             */
+            id: string;
+            /**
+             * Public session ID used in customer URL
+             * @example e3f1c2d4b6a89f001122334455667788
+             */
+            sessionId: string;
             /**
              * Session status
              * @example active
              */
             status: string;
             /**
-             * Checkout URL to open the checkout page
-             * @example https://solvapay.com/customer/checkout?id=a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6
+             * Customer URL to open the customer page
+             * @example https://solvapay.com/customer/manage?id=e3f1c2d4b6a89f001122334455667788
              */
-            checkoutUrl: string;
+            customerUrl: string;
         };
-        CancelRenewalRequest: Record<string, never>;
-        UpdateConnectedAccount: Record<string, never>;
-        CancelPurchaseRequest: {
-            /** Reason for cancellation */
-            reason?: string;
+        CreateCustomerRequest: {
+            /**
+             * Customer email address (required)
+             * @example customer@example.com
+             */
+            email: string;
+            /**
+             * Customer full name (optional)
+             * @example John Doe
+             */
+            name?: string;
+            /**
+             * External reference ID from your auth system to map this customer to an auth user (optional)
+             * @example auth_user_12345
+             */
+            externalRef?: string;
         };
-        CheckLimitRequest: {
+        PurchaseInfo: {
+            /**
+             * Purchase reference
+             * @example pur_1A2B3C4D
+             */
+            reference: string;
+            /**
+             * Product name
+             * @example API Gateway Manager
+             */
+            productName: string;
+            /**
+             * Product reference
+             * @example prd_abc123
+             */
+            productReference?: string;
+            /**
+             * Purchase status
+             * @example active
+             */
+            status: string;
+            /**
+             * Start date
+             * @example 2025-10-27T10:00:00Z
+             */
+            startDate: string;
+            /**
+             * Amount paid in original currency (in cents)
+             * @example 9900
+             */
+            amount: number;
+            /**
+             * Currency code
+             * @example USD
+             */
+            currency: string;
+            /**
+             * End date of purchase
+             * @example 2025-11-27T10:00:00Z
+             */
+            endDate?: string;
+            /**
+             * When purchase was cancelled
+             * @example 2025-10-28T10:00:00Z
+             */
+            cancelledAt?: string;
+            /**
+             * Reason for cancellation
+             * @example Customer request
+             */
+            cancellationReason?: string;
+            /** @description Snapshot of the plan at time of purchase */
+            planSnapshot?: Record<string, never>;
+        };
+        CustomerResponse: {
             /**
              * Customer reference identifier
+             * @example cus_3c4d5e6f7g8h
+             */
+            reference: string;
+            /**
+             * Customer full name
+             * @example John Doe
+             */
+            name: string;
+            /**
+             * Customer email address
+             * @example customer@example.com
+             */
+            email: string;
+            /**
+             * External reference ID from your auth system (if set during creation or update)
+             * @example auth_user_12345
+             */
+            externalRef?: string;
+            /** @description Active purchases */
+            purchases?: components["schemas"]["PurchaseInfo"][];
+        };
+        CreateCustomerSessionResponse: {
+            /**
+             * Customer session ID/token
+             * @example e3f1c2d4b6a89f001122334455667788
+             */
+            sessionId: string;
+            /**
+             * Full customer URL based on backend configuration (ready to redirect customer)
+             * @example https://solvapay.com/customer/manage?id=e3f1c2d4b6a89f001122334455667788
+             */
+            customerUrl: string;
+        };
+        GetCustomerSessionResponse: {
+            /**
+             * Customer session ID/token
+             * @example e3f1c2d4b6a89f001122334455667788
+             */
+            sessionId: string;
+            /**
+             * Session status
+             * @example active
+             * @enum {string}
+             */
+            status: "active" | "expired" | "used";
+            /**
+             * Full customer URL based on backend configuration (ready to redirect customer)
+             * @example https://solvapay.com/customer/manage?id=e3f1c2d4b6a89f001122334455667788
+             */
+            customerUrl: string;
+            /**
+             * Session expiration date
+             * @example 2025-01-01T12:00:00.000Z
+             */
+            expiresAt: string;
+            /** @description Customer object from session data */
+            customer: components["schemas"]["CustomerResponse"];
+            /**
+             * Session creation date
+             * @example 2025-01-01T11:45:00.000Z
+             */
+            createdAt: string;
+            /**
+             * Session last update date
+             * @example 2025-01-01T11:45:00.000Z
+             */
+            updatedAt: string;
+        };
+        UserInfoRequest: {
+            /**
+             * Customer reference
              * @example cus_3C4D5E6F
              */
             customerRef: string;
             /**
-             * Product reference identifier
+             * Product reference
              * @example prd_1A2B3C4D
              */
             productRef: string;
         };
-        LimitResponse: {
+        UserInfoUserDto: {
+            /** @example cus_3C4D5E6F */
+            reference: string;
+            /** @example John Doe */
+            name?: string | null;
+            /** @example john@example.com */
+            email: string;
+            /** @example auth_user_12345 */
+            externalRef?: string | null;
+        };
+        UserInfoUsageDto: {
+            /** @example 1000 */
+            total: number;
+            /** @example 250 */
+            used: number;
+            /** @example 750 */
+            remaining: number;
             /**
-             * Whether the customer is within their usage limits
+             * Meter ObjectId reference
+             * @example 507f1f77bcf86cd799439011
+             */
+            meterId?: string;
+            /** @example 25 */
+            percentUsed?: number | null;
+        };
+        UserInfoPlanDto: {
+            /** @example pln_2B3C4D5E */
+            reference: string;
+            /**
+             * Price in minor currency units (e.g. cents)
+             * @example 2999
+             */
+            price: number;
+            /** @example USD */
+            currency: string;
+            /** @example recurring */
+            type: string;
+            /** @example monthly */
+            billingCycle?: string | null;
+            features?: string[] | null;
+            limits?: {
+                [key: string]: unknown;
+            } | null;
+        };
+        UserInfoPurchaseDto: {
+            /** @example pur_1A2B3C4D */
+            reference: string;
+            /** @example active */
+            status: string;
+            /** @example My API Product */
+            productName: string;
+            /** @example recurring */
+            planType: string;
+            /** @example 2025-10-27T10:00:00Z */
+            startDate?: string | null;
+            /** @example 2025-11-27T10:00:00Z */
+            endDate?: string | null;
+            usage?: components["schemas"]["UserInfoUsageDto"];
+            plan?: components["schemas"]["UserInfoPlanDto"];
+        };
+        UserInfoResponse: {
+            /**
+             * Human-readable status summary
+             * @example Active subscription: My API Product (25% usage consumed)
+             */
+            status: string;
+            /**
+             * Customer portal session URL
+             * @example https://solvapay.com/customer/manage?id=abc123
+             */
+            verifyUrl?: string | null;
+            user?: components["schemas"]["UserInfoUserDto"];
+            purchase?: components["schemas"]["UserInfoPurchaseDto"];
+        };
+        McpToolDto: {
+            /**
+             * Tool name
+             * @example search_documents
+             */
+            name: string;
+            /**
+             * Plan IDs that grant access to this tool
+             * @example [
+             *       "pln_abc123"
+             *     ]
+             */
+            planIds?: string[];
+            /**
+             * If true, the tool is unprotected (no purchase check or usage tracking)
+             * @example false
+             */
+            noPlan?: boolean;
+            /**
+             * Human-readable tool description
+             * @example Search indexed documents
+             */
+            description?: string;
+            /**
+             * Whether this is a virtual platform tool handled by SolvaPay
+             * @example false
+             */
+            isVirtual?: boolean;
+        };
+        McpServerDto: {
+            /**
+             * Server ID
+             * @example 507f1f77bcf86cd799439011
+             */
+            id?: string;
+            /**
+             * Unique server reference
+             * @example mcp_abc123
+             */
+            reference?: string;
+            /**
+             * Domain slug used to derive the MCP endpoint subdomain
+             * @example my-mcp-server
+             */
+            name: string;
+            /**
+             * URL-safe subdomain derived from name
+             * @example my-mcp-server
+             */
+            subdomain: string;
+            /**
+             * SolvaPay proxy URL that MCP clients connect to
+             * @example https://mytelescope.mcp.solvapay.com/mcp
+             */
+            mcpProxyUrl?: string;
+            /**
+             * Origin URL of the actual MCP server
+             * @example https://origin.example.com/mcp
+             */
+            url: string;
+            /**
+             * Avatar image URL
+             * @example https://example.com/avatar.png
+             */
+            avatarUrl?: string;
+            /** @description Registered tools for this server */
+            tools?: components["schemas"]["McpToolDto"][];
+            /**
+             * Default plan ID for tool access gating. Must belong to the linked product and be a free-tier plan (isFreeTier=true or price=0).
+             * @example pln_default
+             */
+            defaultPlanId?: string;
+            /**
+             * Associated product ID
+             * @example 507f1f77bcf86cd799439011
+             */
+            productId?: string;
+            /**
+             * Server status
+             * @example active
+             * @enum {string}
+             */
+            status?: "active" | "inactive" | "suspended";
+            /**
+             * Provider ID that owns this server
+             * @example 507f1f77bcf86cd799439011
+             */
+            providerId: string;
+            /**
+             * Custom auth header name for origin requests
+             * @example X-API-Key
+             */
+            authHeaderName?: string;
+            /**
+             * Whether an auth API key is configured
              * @example true
              */
-            withinLimits: boolean;
+            hasAuthApiKey?: boolean;
+            /**
+             * Total number of tool-call transactions
+             * @example 42
+             */
+            totalTransactions?: number;
+            /**
+             * Current balance in cents
+             * @example 1500
+             */
+            balance?: number;
+        };
+        PlanSnapshotDto: {
+            /**
+             * Plan reference
+             * @example pln_1A2B3C4D
+             */
+            reference?: string;
+            /**
+             * Plan price in cents
+             * @example 2999
+             */
+            price: number;
+            /**
+             * Currency code
+             * @example USD
+             */
+            currency: string;
+            /**
+             * Plan type
+             * @example recurring
+             */
+            planType: string;
+            /**
+             * Billing cycle
+             * @example monthly
+             */
+            billingCycle?: string | null;
+            /** @description Plan features */
+            features?: {
+                [key: string]: unknown;
+            } | null;
+            /** @description Usage limits */
+            limits?: {
+                [key: string]: unknown;
+            } | null;
+            /**
+             * Meter ObjectId reference
+             * @example 507f1f77bcf86cd799439011
+             */
+            meterId?: string;
             /**
-             * Remaining usage units before hitting the limit
-             * @example 997
+             * Usage limit for the meter
+             * @example 5000
              */
-            remaining: number;
+            limit?: number;
             /**
-             * Checkout session ID if payment is required
-             * @example e3f1c2d4b6a89f001122334455667788
+             * Number of free units included
+             * @example 100
              */
-            checkoutSessionId?: string;
+            freeUnits?: number;
             /**
-             * Checkout URL if payment is required
-             * @example https://solvapay.com/customer/checkout?id=e3f1c2d4b6a89f001122334455667788
+             * Price per usage unit in cents
+             * @example 10
              */
-            checkoutUrl?: string;
+            pricePerUnit?: number;
         };
-        CreateCustomerSessionRequest: {
+        UsageBillingDto: {
             /**
-             * Customer reference identifier
-             * @example cus_3c4d5e6f7g8h
+             * Units consumed in current period
+             * @example 150
              */
-            customerRef: string;
-        };
-        CustomerSessionResponse: {
+            used: number;
             /**
-             * Customer session ID
-             * @example 507f1f77bcf86cd799439011
+             * Units exceeding the plan limit
+             * @example 0
              */
-            id: string;
+            overageUnits: number;
             /**
-             * Public session ID used in customer URL
-             * @example e3f1c2d4b6a89f001122334455667788
+             * Overage cost in cents
+             * @example 0
              */
-            sessionId: string;
+            overageCost: number;
             /**
-             * Session status
-             * @example active
+             * Period start date
+             * @example 2025-10-01T00:00:00Z
              */
-            status: string;
+            periodStart?: string;
             /**
-             * Customer URL to open the customer page
-             * @example https://solvapay.com/customer/manage?id=e3f1c2d4b6a89f001122334455667788
+             * Period end date
+             * @example 2025-11-01T00:00:00Z
              */
-            customerUrl: string;
+            periodEnd?: string;
         };
-        CreateCustomerRequest: {
+        PurchaseResponse: {
             /**
-             * Customer email address (required)
-             * @example customer@example.com
+             * Purchase ID
+             * @example 507f1f77bcf86cd799439011
              */
-            email: string;
+            id: string;
             /**
-             * Customer full name (optional)
-             * @example John Doe
+             * Purchase reference
+             * @example pur_1A2B3C4D
              */
-            name?: string;
+            reference: string;
             /**
-             * External reference ID from your auth system to map this customer to an auth user (optional)
-             * @example auth_user_12345
+             * Customer reference
+             * @example cus_3C4D5E6F
              */
-            externalRef?: string;
-        };
-        PurchaseInfo: {
+            customerRef: string;
             /**
-             * Purchase reference
-             * @example sub_abc123
+             * Customer email
+             * @example customer@example.com
              */
-            reference: string;
+            customerEmail: string;
             /**
-             * Plan name
-             * @example Pro Plan
+             * Product reference
+             * @example prd_1A2B3C4D
              */
-            planName: string;
+            productRef: string;
             /**
-             * Product reference
-             * @example prd_abc123
+             * Product ID
+             * @example 507f1f77bcf86cd799439012
              */
-            productReference?: string;
+            productId?: string;
+            /**
+             * Product name
+             * @example API Gateway Manager
+             */
+            productName?: string;
+            /** @description Plan snapshot at time of purchase */
+            planSnapshot: components["schemas"]["PlanSnapshotDto"];
             /**
              * Purchase status
              * @example active
              */
             status: string;
             /**
-             * Start date
-             * @example 2025-10-27T10:00:00Z
-             */
-            startDate: string;
-            /**
-             * Amount paid in original currency (in cents)
+             * Amount in cents
              * @example 9900
              */
             amount: number;
@@ -421,92 +1489,94 @@ interface components {
              * @example USD
              */
             currency: string;
-            /**
-             * End date of purchase
-             * @example 2025-11-27T10:00:00Z
-             */
+            /** @description Start date */
+            startDate: string;
+            /** @description End date */
             endDate?: string;
+            /** @description Paid at timestamp */
+            paidAt?: string;
+            /** @description Usage billing state for usage-based plans */
+            usage?: components["schemas"]["UsageBillingDto"];
             /**
-             * When purchase was cancelled
-             * @example 2025-10-28T10:00:00Z
+             * Is recurring
+             * @example true
              */
-            cancelledAt?: string;
+            isRecurring: boolean;
             /**
-             * Reason for cancellation
-             * @example Customer request
+             * Billing cycle
+             * @enum {string}
              */
+            billingCycle?: "weekly" | "monthly" | "quarterly" | "yearly";
+            /** @description Next billing date */
+            nextBillingDate?: string;
+            /** @description Auto-renew enabled */
+            autoRenew?: boolean;
+            /** @description Whether this is a free tier purchase */
+            isFreeTier?: boolean;
+            /** @description Cancelled at */
+            cancelledAt?: string;
+            /** @description Cancellation reason */
             cancellationReason?: string;
+            /** @description Created at */
+            createdAt: string;
         };
-        CustomerResponse: {
+        CancelPurchaseRequest: {
+            /** @description Reason for cancellation */
+            reason?: string;
+        };
+        CheckLimitRequest: {
             /**
              * Customer reference identifier
-             * @example cus_3c4d5e6f7g8h
-             */
-            reference: string;
-            /**
-             * Customer full name
-             * @example John Doe
+             * @example cus_3C4D5E6F
              */
-            name: string;
+            customerRef: string;
             /**
-             * Customer email address
-             * @example customer@example.com
+             * Product reference identifier
+             * @example prd_1A2B3C4D
              */
-            email: string;
+            productRef: string;
             /**
-             * External reference ID from your auth system (if set during creation or update)
-             * @example auth_user_12345
+             * Plan reference to pre-select when creating a checkout session. If provided and the customer needs to purchase, the checkout page skips plan selection and shows the payment form directly.
+             * @example pln_2B3C4D5E
              */
-            externalRef?: string;
-            /** Active purchases */
-            purchases?: components["schemas"]["PurchaseInfo"][];
-        };
-        CreateCustomerSessionResponse: {
+            planRef?: string;
             /**
-             * Customer session ID/token
-             * @example e3f1c2d4b6a89f001122334455667788
+             * Canonical usage meter name used for limit checks (for example: requests, tokens).
+             * @example requests
              */
-            sessionId: string;
+            meterName?: string;
             /**
-             * Full customer URL based on backend configuration (ready to redirect customer)
-             * @example https://solvapay.com/customer/manage?id=e3f1c2d4b6a89f001122334455667788
+             * Usage type alias for meterName. If both are provided, meterName takes precedence.
+             * @example requests
              */
-            customerUrl: string;
+            usageType?: string;
         };
-        GetCustomerSessionResponse: {
-            /**
-             * Customer session ID/token
-             * @example e3f1c2d4b6a89f001122334455667788
-             */
-            sessionId: string;
+        LimitResponse: {
             /**
-             * Session status
-             * @example active
-             * @enum {string}
+             * Whether the customer is within their usage limits
+             * @example true
              */
-            status: "active" | "expired" | "used";
+            withinLimits: boolean;
             /**
-             * Full customer URL based on backend configuration (ready to redirect customer)
-             * @example https://solvapay.com/customer/manage?id=e3f1c2d4b6a89f001122334455667788
+             * Remaining usage units before hitting the limit
+             * @example 997
              */
-            customerUrl: string;
+            remaining: number;
             /**
-             * Session expiration date
-             * @example 2025-01-01T12:00:00.000Z
+             * Checkout session ID if payment is required
+             * @example e3f1c2d4b6a89f001122334455667788
              */
-            expiresAt: string;
-            /** Customer object from session data */
-            customer: components["schemas"]["CustomerResponse"];
+            checkoutSessionId?: string;
             /**
-             * Session creation date
-             * @example 2025-01-01T11:45:00.000Z
+             * Checkout URL if payment is required
+             * @example https://solvapay.com/customer/checkout?id=e3f1c2d4b6a89f001122334455667788
              */
-            createdAt: string;
+            checkoutUrl?: string;
             /**
-             * Session last update date
-             * @example 2025-01-01T11:45:00.000Z
+             * The meter name to use when tracking usage events
+             * @example requests
              */
-            updatedAt: string;
+            meterName?: string;
         };
         DynamicClientRegistrationDto: {
             /** @example My AI Agent */
@@ -579,19 +1649,19 @@ interface components {
             token_endpoint_auth_method: string;
         };
         GoogleLoginDto: {
-            /** The authorization code returned by Google */
+            /** @description The authorization code returned by Google */
             code: string;
-            /** The redirect URI used in the initial authorization request */
+            /** @description The redirect URI used in the initial authorization request */
             redirect_uri: string;
-            /** The state parameter returned by Google (contains client_id) */
+            /** @description The state parameter returned by Google (contains client_id) */
             state: string;
         };
         GithubLoginDto: {
-            /** The authorization code returned by GitHub */
+            /** @description The authorization code returned by GitHub */
             code: string;
-            /** The redirect URI used in the initial authorization request */
+            /** @description The redirect URI used in the initial authorization request */
             redirect_uri: string;
-            /** The state parameter returned by GitHub (contains client_id) */
+            /** @description The state parameter returned by GitHub (contains client_id) */
             state: string;
         };
         ExecuteAnalyticsQuery: Record<string, never>;
@@ -627,12 +1697,17 @@ interface components {
             secondary?: string;
         };
         ThemeOverridesDto: {
-            /** Light mode color overrides */
+            /** @description Light mode color overrides */
             light?: components["schemas"]["ThemeModeColorsDto"];
-            /** Dark mode color overrides */
+            /** @description Dark mode color overrides */
             dark?: components["schemas"]["ThemeModeColorsDto"];
         };
         UpdateBrandThemeDto: {
+            /**
+             * Logo image URL displayed in hosted page headers
+             * @example /ui/files/download/provider-assets/provider-123/logos/logo.png
+             */
+            logo?: string;
             /**
              * Provider's brand name displayed on hosted pages
              * @example Acme Corp
@@ -655,11 +1730,33 @@ interface components {
              * @example 16px
              */
             fontSize: string;
-            /** Per-mode color overrides for light and dark themes */
+            /** @description Per-mode color overrides for light and dark themes */
             themes?: components["schemas"]["ThemeOverridesDto"];
         };
-        CreateWebhookEndpointDto: Record<string, never>;
-        UpdateWebhookEndpointDto: Record<string, never>;
+        CreateWebhookEndpointDto: {
+            /**
+             * Webhook endpoint URL
+             * @example https://example.com/webhook
+             */
+            url: string;
+            /**
+             * Webhook endpoint description
+             * @example Production webhook
+             */
+            description?: string;
+        };
+        UpdateWebhookEndpointDto: {
+            /**
+             * Webhook endpoint URL
+             * @example https://example.com/webhook
+             */
+            url?: string;
+            /**
+             * Webhook endpoint description
+             * @example Updated webhook
+             */
+            description?: string;
+        };
         CreatePreregistrationDto: {
             /** @example jane@company.com */
             email: string;
@@ -675,6 +1772,10 @@ interface components {
                 [key: string]: string;
             };
         };
+        /** @description Auto-generated fallback schema for unresolved reference: McpBootstrapPreviewValidationError */
+        McpBootstrapPreviewValidationError: {
+            [key: string]: unknown;
+        };
     };
     responses: never;
     parameters: never;
@@ -689,11 +1790,17 @@ interface components {
  * Types related to the SolvaPay API client and backend communication.
  */
 
+type UsageMeterType = 'requests' | 'tokens';
+type CheckLimitsRequest = components['schemas']['CheckLimitRequest'] & {
+    meterName?: string;
+    usageType?: UsageMeterType;
+};
 /**
  * Extended LimitResponse with plan field
  */
 type LimitResponseWithPlan = components['schemas']['LimitResponse'] & {
     plan: string;
+    meterName?: string;
 };
 /**
  * Extended CustomerResponse with proper field mapping
@@ -732,6 +1839,67 @@ interface ProcessPaymentResult {
     oneTimePurchase?: OneTimePurchaseInfo;
     status: 'completed';
 }
+interface McpBootstrapFreePlanConfig {
+    name?: string;
+    freeUnits?: number;
+}
+interface McpBootstrapPaidPlanInput {
+    key: string;
+    name: string;
+    /** Price in cents (e.g. 2000 = $20.00) */
+    price: number;
+    currency: string;
+    billingCycle?: 'weekly' | 'monthly' | 'quarterly' | 'yearly' | 'custom';
+    type?: 'recurring' | 'one-time';
+    freeUnits?: number;
+    meterId?: string;
+    limit?: number;
+    features?: Record<string, unknown>;
+}
+interface ToolPlanMappingInput {
+    name: string;
+    description?: string;
+    noPlan?: boolean;
+    planIds?: string[];
+    planRefs?: string[];
+    planKeys?: string[];
+}
+interface McpBootstrapRequest {
+    name?: string;
+    description?: string;
+    imageUrl?: string;
+    productType?: string;
+    originUrl: string;
+    /** Optional token combined with provider name to derive the final MCP subdomain. */
+    mcpDomain?: string;
+    authHeaderName?: string;
+    authApiKey?: string;
+    freePlan?: McpBootstrapFreePlanConfig;
+    paidPlans?: McpBootstrapPaidPlanInput[];
+    tools?: ToolPlanMappingInput[];
+    metadata?: Record<string, unknown>;
+}
+interface McpBootstrapResponse {
+    product: components['schemas']['SdkProductResponse'];
+    mcpServer: {
+        id?: string;
+        reference?: string;
+        subdomain?: string;
+        mcpProxyUrl?: string;
+        url: string;
+        defaultPlanId?: string;
+    };
+    planMap: Record<string, {
+        id: string;
+        reference: string;
+        name?: string;
+    }>;
+    toolsAutoMapped?: boolean;
+    autoMappedTools?: Array<{
+        name: string;
+        description?: string;
+    }>;
+}
 /**
  * SolvaPay API Client Interface
  *
@@ -740,16 +1908,19 @@ interface ProcessPaymentResult {
  * You can provide your own implementation or use the default createSolvaPayClient().
  */
 interface SolvaPayClient {
-    checkLimits(params: components['schemas']['CheckLimitRequest']): Promise<LimitResponseWithPlan>;
+    checkLimits(params: CheckLimitsRequest): Promise<LimitResponseWithPlan>;
     trackUsage(params: {
         customerRef: string;
-        productRef: string;
-        planRef: string;
-        outcome: string;
-        action?: string;
-        requestId?: string;
-        actionDuration?: number;
+        actionType?: 'transaction' | 'api_call' | 'hour' | 'email' | 'storage' | 'custom';
+        units?: number;
+        outcome?: 'success' | 'paywall' | 'fail';
+        productReference?: string;
+        purchaseReference?: string;
+        description?: string;
+        metadata?: Record<string, unknown>;
+        duration?: number;
         timestamp?: string;
+        idempotencyKey?: string;
     }): Promise<void>;
     createCustomer?(params: components['schemas']['CreateCustomerRequest']): Promise<{
         customerRef: string;
@@ -769,17 +1940,26 @@ interface SolvaPayClient {
         reference: string;
         name: string;
     }>;
+    bootstrapMcpProduct?(params: McpBootstrapRequest): Promise<McpBootstrapResponse>;
     updateProduct?(productRef: string, params: components['schemas']['UpdateProductRequest']): Promise<components['schemas']['SdkProductResponse']>;
     deleteProduct?(productRef: string): Promise<void>;
-    listPlans?(productRef: string): Promise<Array<{
+    cloneProduct?(productRef: string, overrides?: {
+        name?: string;
+    }): Promise<{
         reference: string;
         name: string;
-        description?: string;
+    }>;
+    listPlans?(productRef: string): Promise<Array<{
+        reference: string;
         price?: number;
         currency?: string;
         interval?: string;
         isFreeTier?: boolean;
         freeUnits?: number;
+        measures?: string;
+        limit?: number;
+        pricePerUnit?: number;
+        billingModel?: string;
         metadata?: Record<string, unknown>;
         [key: string]: unknown;
     }>>;
@@ -787,7 +1967,10 @@ interface SolvaPayClient {
         productRef: string;
     }): Promise<{
         reference: string;
-        name: string;
+    }>;
+    updatePlan?(productRef: string, planRef: string, params: Partial<components['schemas']['CreatePlanRequest']>): Promise<{
+        reference: string;
+        [key: string]: unknown;
     }>;
     deletePlan?(productRef: string, planRef: string): Promise<void>;
     createPaymentIntent?(params: {
@@ -811,6 +1994,10 @@ interface SolvaPayClient {
         customerRef: string;
         planRef?: string;
     }): Promise<ProcessPaymentResult>;
+    getUserInfo?(params: {
+        customerRef: string;
+        productRef: string;
+    }): Promise<components['schemas']['UserInfoResponse']>;
     createCheckoutSession(params: components['schemas']['CreateCheckoutSessionRequest']): Promise<components['schemas']['CheckoutSessionResponse']>;
     createCustomerSession(params: components['schemas']['CreateCustomerSessionRequest']): Promise<components['schemas']['CreateCustomerSessionResponse']>;
 }
@@ -835,6 +2022,7 @@ interface PaywallArgs {
 interface PaywallMetadata {
     product?: string;
     plan?: string;
+    usageType?: 'requests' | 'tokens';
 }
 /**
  * Structured content for paywall errors
@@ -918,6 +2106,10 @@ interface PayableOptions {
      * Plan reference (alias for plan, preferred for consistency with backend API)
      */
     planRef?: string;
+    /**
+     * Usage meter type to charge against (defaults to 'requests')
+     */
+    usageType?: 'requests' | 'tokens';
     /**
      * Optional function to extract customer reference from context
      */
@@ -971,6 +2163,49 @@ interface McpAdapterOptions {
     transformResponse?: (result: any) => any;
 }
 
+/**
+ * Virtual Tools for MCP Server Monetization
+ *
+ * Provides the same self-service tools (get_user_info, upgrade, manage_account)
+ * that hosted MCP Pay servers get automatically, but for SDK-integrated servers.
+ * These tools are NOT usage-tracked and bypass the paywall.
+ */
+
+interface VirtualToolsOptions {
+    /** Product reference (required) */
+    product: string;
+    /** Extract customer reference from MCP tool args */
+    getCustomerRef: (args: Record<string, unknown>) => string;
+    /** Tool names to exclude from registration (optional) */
+    exclude?: string[];
+}
+interface VirtualToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: 'object';
+        properties: Record<string, object>;
+        required: string[];
+    };
+    handler: (args: Record<string, unknown>) => Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        isError?: boolean;
+    }>;
+}
+declare const VIRTUAL_TOOL_DEFINITIONS: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: Record<string, object>;
+        required: string[];
+    };
+}[];
+declare function createVirtualTools(apiClient: SolvaPayClient, options: VirtualToolsOptions): VirtualToolDefinition[];
+
 /**
  * Configuration for creating a SolvaPay instance.
  *
@@ -1007,6 +2242,12 @@ interface CreateSolvaPayConfig {
      * Defaults to production API URL if not provided.
      */
     apiBaseUrl?: string;
+    /**
+     * TTL in ms for the checkLimits cache (default 10 000).
+     * Positive results are cached and optimistically decremented to avoid
+     * redundant API calls during tool-call bursts.
+     */
+    limitsCacheTTL?: number;
 }
 /**
  * Payable function that provides explicit adapters for different frameworks.
@@ -1269,7 +2510,8 @@ interface SolvaPay {
      * ```typescript
      * const limits = await solvaPay.checkLimits({
      *   customerRef: 'user_123',
-     *   productRef: 'prd_myapi'
+     *   productRef: 'prd_myapi',
+     *   planRef: 'pln_premium'
      * });
      *
      * if (!limits.withinLimits) {
@@ -1281,11 +2523,15 @@ interface SolvaPay {
     checkLimits(params: {
         customerRef: string;
         productRef: string;
+        planRef?: string;
+        meterName?: 'requests' | 'tokens';
+        usageType?: 'requests' | 'tokens';
     }): Promise<{
         withinLimits: boolean;
         remaining: number;
         plan: string;
         checkoutUrl?: string;
+        meterName?: string;
     }>;
     /**
      * Track usage for a customer action.
@@ -1306,26 +2552,26 @@ interface SolvaPay {
      * @example
      * ```typescript
      * await solvaPay.trackUsage({
-     *   customerRef: 'user_123',
-     *   productRef: 'prd_myapi',
-     *   planRef: 'pln_premium',
+     *   customerRef: 'cus_3C4D5E6F',
+     *   actionType: 'api_call',
+     *   units: 1,
      *   outcome: 'success',
-     *   action: 'api_call',
-     *   requestId: 'req_123',
-     *   actionDuration: 150,
-     *   timestamp: new Date().toISOString()
+     *   metadata: { toolName: 'search', endpoint: '/search' },
      * });
      * ```
      */
     trackUsage(params: {
         customerRef: string;
-        productRef: string;
-        planRef: string;
-        outcome: 'success' | 'paywall' | 'fail';
-        action?: string;
-        requestId: string;
-        actionDuration: number;
-        timestamp: string;
+        actionType?: 'transaction' | 'api_call' | 'hour' | 'email' | 'storage' | 'custom';
+        units?: number;
+        outcome?: 'success' | 'paywall' | 'fail';
+        productReference?: string;
+        purchaseReference?: string;
+        description?: string;
+        metadata?: Record<string, unknown>;
+        duration?: number;
+        timestamp?: string;
+        idempotencyKey?: string;
     }): Promise<void>;
     /**
      * Create a new customer in SolvaPay backend.
@@ -1423,6 +2669,7 @@ interface SolvaPay {
      *
      * @param params - Customer session parameters
      * @param params.customerRef - Customer reference
+     * @param params.productRef - Optional product reference for scoping portal view
      * @returns Customer portal session with redirect URL
      *
      * @example
@@ -1437,10 +2684,47 @@ interface SolvaPay {
      */
     createCustomerSession(params: {
         customerRef: string;
+        productRef?: string;
     }): Promise<{
         sessionId: string;
         customerUrl: string;
     }>;
+    /**
+     * Bootstrap an MCP-enabled product with plans and tool mappings.
+     *
+     * This helper wraps the backend orchestration endpoint and is intended for
+     * fast setup flows where you want one call for product + plans + MCP config.
+     */
+    bootstrapMcpProduct(params: McpBootstrapRequest): Promise<McpBootstrapResponse>;
+    /**
+     * Get virtual tool definitions with bound handlers for MCP server integration.
+     *
+     * Returns an array of tool objects (name, description, inputSchema, handler)
+     * that provide self-service capabilities: user info, upgrade, and account management.
+     * These tools bypass the paywall and are not usage-tracked.
+     *
+     * Register the returned tools on your MCP server alongside your own tools.
+     *
+     * @param options - Virtual tools configuration
+     * @param options.product - Product reference (required)
+     * @param options.getCustomerRef - Function to extract customer ref from tool args
+     * @param options.exclude - Optional list of tool names to exclude
+     * @returns Array of virtual tool definitions with handlers
+     *
+     * @example
+     * ```typescript
+     * const virtualTools = solvaPay.getVirtualTools({
+     *   product: 'prd_myapi',
+     *   getCustomerRef: args => args._auth?.customer_ref || 'anonymous',
+     * });
+     *
+     * // Register on your MCP server
+     * for (const tool of virtualTools) {
+     *   // Add to tools/list and tools/call handlers
+     * }
+     * ```
+     */
+    getVirtualTools(options: VirtualToolsOptions): VirtualToolDefinition[];
     /**
      * Direct access to the API client for advanced operations.
      *
@@ -1656,6 +2940,23 @@ declare class PaywallError extends Error {
  */
 declare function withRetry<T>(fn: () => Promise<T>, options?: RetryOptions): Promise<T>;
 
+/**
+ * MCP OAuth helper utilities.
+ *
+ * These helpers are intentionally lightweight and do not verify JWT signatures.
+ * Use them after token validation (for example via /v1/oauth/userinfo).
+ */
+declare class McpBearerAuthError extends Error {
+    constructor(message: string);
+}
+type McpBearerCustomerRefOptions = {
+    claimPriority?: string[];
+};
+declare function extractBearerToken(authorization?: string | null): string | null;
+declare function decodeJwtPayload(token: string): Record<string, unknown>;
+declare function getCustomerRefFromJwtPayload(payload: Record<string, unknown>, options?: McpBearerCustomerRefOptions): string;
+declare function getCustomerRefFromBearerAuthHeader(authorization?: string | null, options?: McpBearerCustomerRefOptions): string;
+
 /**
  * Helper Types
  *
@@ -2027,4 +3328,4 @@ declare function verifyWebhook({ body, signature, secret, }: {
     secret: string;
 }): any;
 
-export { type AuthenticatedUser, type CreateSolvaPayConfig, type CustomerResponseMapped, type ErrorResult, type HttpAdapterOptions, type McpAdapterOptions, type NextAdapterOptions, type OneTimePurchaseInfo, type PayableFunction, type PayableOptions, type PaywallArgs, PaywallError, type PaywallMetadata, type PaywallStructuredContent, type PaywallToolResult, type ProcessPaymentResult, type RetryOptions, type ServerClientOptions, type SolvaPay, type SolvaPayClient, cancelPurchaseCore, createCheckoutSessionCore, createCustomerSessionCore, createPaymentIntentCore, createSolvaPay, createSolvaPayClient, getAuthenticatedUserCore, handleRouteError, isErrorResult, listPlansCore, processPaymentIntentCore, syncCustomerCore, verifyWebhook, withRetry };
+export { type AuthenticatedUser, type CreateSolvaPayConfig, type CustomerResponseMapped, type ErrorResult, type HttpAdapterOptions, type McpAdapterOptions, McpBearerAuthError, type McpBootstrapFreePlanConfig, type McpBootstrapPaidPlanInput, type McpBootstrapRequest, type McpBootstrapResponse, type NextAdapterOptions, type OneTimePurchaseInfo, type PayableFunction, type PayableOptions, type PaywallArgs, PaywallError, type PaywallMetadata, type PaywallStructuredContent, type PaywallToolResult, type ProcessPaymentResult, type RetryOptions, type ServerClientOptions, type SolvaPay, type SolvaPayClient, type ToolPlanMappingInput, VIRTUAL_TOOL_DEFINITIONS, type VirtualToolDefinition, type VirtualToolsOptions, cancelPurchaseCore, createCheckoutSessionCore, createCustomerSessionCore, createPaymentIntentCore, createSolvaPay, createSolvaPayClient, createVirtualTools, decodeJwtPayload, extractBearerToken, getAuthenticatedUserCore, getCustomerRefFromBearerAuthHeader, getCustomerRefFromJwtPayload, handleRouteError, isErrorResult, listPlansCore, processPaymentIntentCore, syncCustomerCore, verifyWebhook, withRetry };