@flexprice/mcp-server 2.1.30 → 2.1.31

package/manifest.json

@@ -48,7 +48,7 @@
       "sensitive": true
     }
   },
-  "version": "2.1.30",
+  "version": "2.1.31",
   "tools": [
     {
       "name": "update-customer",
@@ -100,7 +100,7 @@
     },
     {
       "name": "create-invoice",
-      "description": "Create one-off invoice\n\nUse when creating a manual or one-off invoice (e.g. custom charge or non-recurring billing). Invoice is created in draft; finalize when ready."
+      "description": "Create one-off invoice\n\nUse when creating a manual or one-off invoice (e.g. custom charge or non-recurring billing). Invoice is created in draft; finalize when ready.\nPass a `checkout` object to gate the invoice behind a hosted payment session: the invoice stays DRAFT with no invoice number, and the response carries `checkout_session.payment_action.url` for the customer to pay. It finalizes only when the payment webhook lands; if the session expires the invoice is voided and archived. Poll `GET /checkout/sessions/{id}` until `terminal` is true. One-off invoices only."
     },
     {
       "name": "get-invoice-preview",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flexprice/mcp-server",
-  "version": "2.1.30",
+  "version": "2.1.31",
   "author": "flexprice",
   "type": "module",
   "sideEffects": false,

package/src/funcs/invoicesCreateInvoice.ts

@@ -30,6 +30,7 @@ import { Result } from "../types/fp.js";
  *
  * @remarks
  * Use when creating a manual or one-off invoice (e.g. custom charge or non-recurring billing). Invoice is created in draft; finalize when ready.
+ * Pass a `checkout` object to gate the invoice behind a hosted payment session: the invoice stays DRAFT with no invoice number, and the response carries `checkout_session.payment_action.url` for the customer to pay. It finalizes only when the payment webhook lands; if the session expires the invoice is voided and archived. Poll `GET /checkout/sessions/{id}` until `terminal` is true. One-off invoices only.
  */
 export function invoicesCreateInvoice(
   client$: FlexpriceCore,

package/src/lib/config.ts

@@ -69,8 +69,8 @@ export function serverURLFromOptions(options: SDKOptions): URL | null {
 export const SDK_METADATA = {
   language: "typescript",
   openapiDocVersion: "1.0",
-  sdkVersion: "2.1.30",
-  genVersion: "2.935.1",
+  sdkVersion: "2.1.31",
+  genVersion: "2.938.0",
   userAgent:
-    "speakeasy-sdk/mcp-typescript 2.1.30 2.935.1 1.0 @flexprice/mcp-server",
+    "speakeasy-sdk/mcp-typescript 2.1.31 2.938.0 1.0 @flexprice/mcp-server",
 } as const;

package/src/mcp-server/mcp-server.ts

@@ -21,7 +21,7 @@ const routes = buildRouteMap({
 export const app = buildApplication(routes, {
   name: "mcp",
   versionInfo: {
-    currentVersion: "2.1.30",
+    currentVersion: "2.1.31",
   },
 });
 

package/src/mcp-server/server.ts

@@ -106,7 +106,7 @@ export function createMCPServer(deps: {
 }) {
   const server = new McpServer({
     name: "Flexprice",
-    version: "2.1.30",
+    version: "2.1.31",
   });
 
   const getClient = deps.getSDK || (() =>

package/src/mcp-server/tools/invoicesCreateInvoice.ts

@@ -14,7 +14,8 @@ export const tool$invoicesCreateInvoice: ToolDefinition<typeof args> = {
   name: "create-invoice",
   description: `Create one-off invoice
 
-Use when creating a manual or one-off invoice (e.g. custom charge or non-recurring billing). Invoice is created in draft; finalize when ready.`,
+Use when creating a manual or one-off invoice (e.g. custom charge or non-recurring billing). Invoice is created in draft; finalize when ready.
+Pass a \`checkout\` object to gate the invoice behind a hosted payment session: the invoice stays DRAFT with no invoice number, and the response carries \`checkout_session.payment_action.url\` for the customer to pay. It finalizes only when the payment webhook lands; if the session expires the invoice is voided and archived. Poll \`GET /checkout/sessions/{id}\` until \`terminal\` is true. One-off invoices only.`,
   scopes: ["write"],
   annotations: {
     "title": "",

package/src/models/checkoutaction.ts

@@ -10,6 +10,7 @@ export const CheckoutAction = {
   ModifySubscription: "modify_subscription",
   WalletTopup: "wallet_topup",
   AddAddon: "add_addon",
+  PayInvoice: "pay_invoice",
 } as const;
 export type CheckoutAction = ClosedEnum<typeof CheckoutAction>;
 
@@ -18,4 +19,5 @@ export const CheckoutAction$zodSchema = z.enum([
   "modify_subscription",
   "wallet_topup",
   "add_addon",
+  "pay_invoice",
 ]);

package/src/models/createinvoicerequest.ts

@@ -3,6 +3,7 @@
  */
 
 import * as z from "zod";
+import { CheckoutParams, CheckoutParams$zodSchema } from "./checkoutparams.js";
 import {
   CreateInvoiceLineItemRequest,
   CreateInvoiceLineItemRequest$zodSchema,
@@ -29,6 +30,7 @@ export type CreateInvoiceRequest = {
   amount_paid?: string | undefined;
   billing_period?: string | undefined;
   billing_reason?: InvoiceBillingReason | undefined;
+  checkout?: CheckoutParams | undefined;
   coupons?: Array<string> | undefined;
   currency: string;
   customer_id: string;
@@ -68,6 +70,7 @@ export const CreateInvoiceRequest$zodSchema: z.ZodType<CreateInvoiceRequest> = z
       "billing_period is the period this invoice covers (e.g., \"monthly\", \"yearly\")",
     ),
     billing_reason: InvoiceBillingReason$zodSchema.optional(),
+    checkout: CheckoutParams$zodSchema.optional(),
     coupons: z.array(z.string()).optional().describe("coupons"),
     currency: z.string().describe(
       "currency is the three-letter ISO currency code (e.g., USD, EUR) for the invoice",

package/src/models/createsubscriptionrequest.ts

@@ -26,6 +26,10 @@ import {
   LineItemCommitmentConfig,
   LineItemCommitmentConfig$zodSchema,
 } from "./lineitemcommitmentconfig.js";
+import {
+  LineItemGrouping,
+  LineItemGrouping$zodSchema,
+} from "./lineitemgrouping.js";
 import {
   OverrideEntitlementRequest,
   OverrideEntitlementRequest$zodSchema,
@@ -87,6 +91,7 @@ export type CreateSubscriptionRequest = {
   inheritance?: SubscriptionInheritanceConfig | undefined;
   line_item_commitments?: { [k: string]: LineItemCommitmentConfig } | undefined;
   line_item_coupons?: { [k: string]: Array<string> } | undefined;
+  line_item_grouping?: LineItemGrouping | undefined;
   line_items?: Array<CreateSubscriptionLineItemRequest> | undefined;
   lookup_key?: string | undefined;
   metadata?: { [k: string]: string } | undefined;
@@ -147,6 +152,7 @@ export const CreateSubscriptionRequest$zodSchema: z.ZodType<
   ),
   line_item_coupons: z.record(z.string(), z.array(z.string())).optional()
     .describe("Deprecated: use SubscriptionCoupons instead."),
+  line_item_grouping: LineItemGrouping$zodSchema.optional(),
   line_items: z.array(CreateSubscriptionLineItemRequest$zodSchema).optional()
     .describe("LineItems are extra (non-plan) line items added at creation."),
   lookup_key: z.string().optional(),

package/src/models/event.ts

@@ -10,6 +10,7 @@ export type Event = {
   event_name?: string | undefined;
   external_customer_id?: string | undefined;
   id?: string | undefined;
+  ingested_at?: string | undefined;
   properties?: { [k: string]: any } | undefined;
   source?: string | undefined;
   timestamp?: string | undefined;
@@ -21,6 +22,7 @@ export const Event$zodSchema: z.ZodType<Event> = z.object({
   event_name: z.string().optional(),
   external_customer_id: z.string().optional(),
   id: z.string().optional(),
+  ingested_at: z.iso.datetime({ offset: true }).optional(),
   properties: z.record(z.string(), z.any()).optional(),
   source: z.string().optional(),
   timestamp: z.string().optional(),

package/src/models/geteventbyidresponse.ts

@@ -17,6 +17,7 @@ import {
 export type GetEventByIDResponse = {
   debug_tracker?: DebugTracker | undefined;
   event?: Event | undefined;
+  events?: Array<Event> | undefined;
   processed_events?: Array<FeatureUsageInfo> | undefined;
   status?: EventProcessingStatusType | undefined;
 };
@@ -25,6 +26,7 @@ export const GetEventByIDResponse$zodSchema: z.ZodType<GetEventByIDResponse> = z
   .object({
     debug_tracker: DebugTracker$zodSchema.optional(),
     event: Event$zodSchema.optional(),
+    events: z.array(Event$zodSchema).optional(),
     processed_events: z.array(FeatureUsageInfo$zodSchema).optional(),
     status: EventProcessingStatusType$zodSchema.optional(),
   });

package/src/models/invoiceresponse.ts

@@ -3,6 +3,10 @@
  */
 
 import * as z from "zod";
+import {
+  CheckoutSessionResponse,
+  CheckoutSessionResponse$zodSchema,
+} from "./checkoutsessionresponse.js";
 import {
   CouponApplicationResponse,
   CouponApplicationResponse$zodSchema,
@@ -16,6 +20,10 @@ import {
   InvoiceLineItemResponse,
   InvoiceLineItemResponse$zodSchema,
 } from "./invoicelineitemresponse.js";
+import {
+  InvoiceSourceType,
+  InvoiceSourceType$zodSchema,
+} from "./invoicesourcetype.js";
 import { InvoiceStatus, InvoiceStatus$zodSchema } from "./invoicestatus.js";
 import { InvoiceType, InvoiceType$zodSchema } from "./invoicetype.js";
 import { PaymentStatus, PaymentStatus$zodSchema } from "./paymentstatus.js";
@@ -42,6 +50,7 @@ export type InvoiceResponse = {
   billing_period?: string | undefined;
   billing_reason?: string | undefined;
   billing_sequence?: number | undefined;
+  checkout_session?: CheckoutSessionResponse | undefined;
   coupon_applications?: Array<CouponApplicationResponse> | undefined;
   created_at?: string | undefined;
   created_by?: string | undefined;
@@ -71,6 +80,7 @@ export type InvoiceResponse = {
   period_start?: string | undefined;
   recalculated_invoice_id?: string | undefined;
   refunded_amount?: string | undefined;
+  source_type?: InvoiceSourceType | undefined;
   status?: Status | undefined;
   subscription?: SubscriptionResponse | undefined;
   subscription_customer_id?: string | undefined;
@@ -112,6 +122,7 @@ export const InvoiceResponse$zodSchema: z.ZodType<InvoiceResponse> = z.object({
   billing_sequence: z.int().optional().describe(
     "billing_sequence is the sequential number indicating the billing cycle for subscription invoices",
   ),
+  checkout_session: CheckoutSessionResponse$zodSchema.optional(),
   coupon_applications: z.array(CouponApplicationResponse$zodSchema).optional()
     .describe(
       "coupon_applications contains the coupon applications associated with this invoice (overrides embedded field)",
@@ -186,6 +197,7 @@ export const InvoiceResponse$zodSchema: z.ZodType<InvoiceResponse> = z.object({
   refunded_amount: z.string().optional().describe(
     "refunded_amount is the total sum of credit notes of type \"refund\".\nThese are actual refunds issued to the customer.",
   ),
+  source_type: InvoiceSourceType$zodSchema.optional(),
   status: Status$zodSchema.optional(),
   subscription: z.lazy(() => SubscriptionResponse$zodSchema).optional(),
   subscription_customer_id: z.string().optional().describe(

package/src/models/invoicesourcetype.ts

@@ -0,0 +1,15 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { ClosedEnum } from "../types/enums.js";
+
+export const InvoiceSourceType = {
+  Checkout: "checkout",
+} as const;
+export type InvoiceSourceType = ClosedEnum<typeof InvoiceSourceType>;
+
+export const InvoiceSourceType$zodSchema = z.enum([
+  "checkout",
+]);

package/src/models/lineitemgrouping.ts

@@ -0,0 +1,17 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { ClosedEnum } from "../types/enums.js";
+
+export const LineItemGrouping = {
+  PerChargePeriod: "per_charge_period",
+  PerBillingPeriod: "per_billing_period",
+} as const;
+export type LineItemGrouping = ClosedEnum<typeof LineItemGrouping>;
+
+export const LineItemGrouping$zodSchema = z.enum([
+  "per_charge_period",
+  "per_billing_period",
+]);

package/src/models/subscriptionresponse.ts

@@ -30,6 +30,10 @@ import {
   InvoiceResponse,
   InvoiceResponse$zodSchema,
 } from "./invoiceresponse.js";
+import {
+  LineItemGrouping,
+  LineItemGrouping$zodSchema,
+} from "./lineitemgrouping.js";
 import { PauseStatus, PauseStatus$zodSchema } from "./pausestatus.js";
 import { PaymentTerms, PaymentTerms$zodSchema } from "./paymentterms.js";
 import { PlanResponse, PlanResponse$zodSchema } from "./planresponse.js";
@@ -91,6 +95,7 @@ export type SubscriptionResponse = {
   id?: string | undefined;
   invoicing_customer_id?: string | undefined;
   latest_invoice?: InvoiceResponse | undefined;
+  line_item_grouping?: LineItemGrouping | undefined;
   line_items?: Array<SubscriptionSubscriptionLineItem> | undefined;
   lookup_key?: string | undefined;
   metadata?: { [k: string]: string } | undefined;
@@ -196,6 +201,7 @@ export const SubscriptionResponse$zodSchema: z.ZodType<SubscriptionResponse> = z
       "InvoicingCustomerID is the customer ID to use for invoicing\nThis can differ from the subscription customer (e.g., parent company invoicing for child company)",
     ),
     latest_invoice: z.lazy(() => InvoiceResponse$zodSchema).optional(),
+    line_item_grouping: LineItemGrouping$zodSchema.optional(),
     line_items: z.array(SubscriptionSubscriptionLineItem$zodSchema).optional(),
     lookup_key: z.string().optional().describe(
       "LookupKey is the key used to lookup the subscription in our system",

package/src/models/subscriptionresponsev2.ts

@@ -18,6 +18,10 @@ import {
   CustomerResponse,
   CustomerResponse$zodSchema,
 } from "./customerresponse.js";
+import {
+  LineItemGrouping,
+  LineItemGrouping$zodSchema,
+} from "./lineitemgrouping.js";
 import { PauseStatus, PauseStatus$zodSchema } from "./pausestatus.js";
 import { PaymentTerms, PaymentTerms$zodSchema } from "./paymentterms.js";
 import { PlanResponse, PlanResponse$zodSchema } from "./planresponse.js";
@@ -76,6 +80,7 @@ export type SubscriptionResponseV2 = {
   gateway_payment_method_id?: string | undefined;
   id?: string | undefined;
   invoicing_customer_id?: string | undefined;
+  line_item_grouping?: LineItemGrouping | undefined;
   line_items?: Array<SubscriptionLineItemResponse> | undefined;
   lookup_key?: string | undefined;
   metadata?: { [k: string]: string } | undefined;
@@ -178,6 +183,7 @@ export const SubscriptionResponseV2$zodSchema: z.ZodType<
   invoicing_customer_id: z.string().optional().describe(
     "InvoicingCustomerID is the customer ID to use for invoicing\nThis can differ from the subscription customer (e.g., parent company invoicing for child company)",
   ),
+  line_item_grouping: LineItemGrouping$zodSchema.optional(),
   line_items: z.array(SubscriptionLineItemResponse$zodSchema).optional()
     .describe(
       "LineItems is expanded only if \"subscription_line_items\" is in expand parameter\nEach line item can optionally include expanded price data",

package/src/models/subscriptionscheduleresponse.ts

@@ -9,37 +9,18 @@ import {
   SubscriptionScheduleChangeType$zodSchema,
 } from "./subscriptionschedulechangetype.js";
 
-/**
- * configuration contains type-specific configuration (e.g., target_plan_id for plan changes)
- */
-export type Configuration = {};
-
-export const Configuration$zodSchema: z.ZodType<Configuration> = z.object({})
-  .describe(
-    "configuration contains type-specific configuration (e.g., target_plan_id for plan changes)",
-  );
-
-/**
- * execution_result contains type-specific execution result
- */
-export type ExecutionResult = {};
-
-export const ExecutionResult$zodSchema: z.ZodType<ExecutionResult> = z.object(
-  {},
-).describe("execution_result contains type-specific execution result");
-
 /**
  * Full details of a subscription schedule
  */
 export type SubscriptionScheduleResponse = {
   can_be_cancelled?: boolean | undefined;
   cancelled_at?: string | undefined;
-  configuration?: Configuration | undefined;
+  configuration?: { [k: string]: any } | undefined;
   created_at?: string | undefined;
   days_until_execution?: number | undefined;
   error_message?: string | undefined;
   executed_at?: string | undefined;
-  execution_result?: ExecutionResult | undefined;
+  execution_result?: { [k: string]: any } | undefined;
   id?: string | undefined;
   metadata?: { [k: string]: string } | undefined;
   schedule_type?: SubscriptionScheduleChangeType | undefined;
@@ -58,7 +39,7 @@ export const SubscriptionScheduleResponse$zodSchema: z.ZodType<
   cancelled_at: z.iso.datetime({ offset: true }).optional().describe(
     "cancelled_at is when the schedule was cancelled",
   ),
-  configuration: z.lazy(() => Configuration$zodSchema).optional().describe(
+  configuration: z.record(z.string(), z.any()).optional().describe(
     "configuration contains type-specific configuration (e.g., target_plan_id for plan changes)",
   ),
   created_at: z.iso.datetime({ offset: true }).optional().describe(
@@ -73,7 +54,7 @@ export const SubscriptionScheduleResponse$zodSchema: z.ZodType<
   executed_at: z.iso.datetime({ offset: true }).optional().describe(
     "executed_at is when the schedule was executed",
   ),
-  execution_result: z.lazy(() => ExecutionResult$zodSchema).optional().describe(
+  execution_result: z.record(z.string(), z.any()).optional().describe(
     "execution_result contains type-specific execution result",
   ),
   id: z.string().optional().describe("id of the schedule"),

package/src/tool-names.ts

@@ -50,7 +50,7 @@ export const toolNames: Array<{ name: string; description: string }>= [
   },
   {
     "name": "create-invoice",
-    "description": "Create one-off invoice\n\nUse when creating a manual or one-off invoice (e.g. custom charge or non-recurring billing). Invoice is created in draft; finalize when ready."
+    "description": "Create one-off invoice\n\nUse when creating a manual or one-off invoice (e.g. custom charge or non-recurring billing). Invoice is created in draft; finalize when ready.\nPass a `checkout` object to gate the invoice behind a hosted payment session: the invoice stays DRAFT with no invoice number, and the response carries `checkout_session.payment_action.url` for the customer to pay. It finalizes only when the payment webhook lands; if the session expires the invoice is voided and archived. Poll `GET /checkout/sessions/{id}` until `terminal` is true. One-off invoices only."
   },
   {
     "name": "get-invoice-preview",