@flexprice/mcp-server 2.0.10 → 2.0.12

package/manifest.json

@@ -48,7 +48,7 @@
       "sensitive": true
     }
   },
-  "version": "2.0.10",
+  "version": "2.0.12",
   "tools": [
     {
       "name": "update-customer",

package/package.json

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

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.0.10",
-  genVersion: "2.866.2",
+  sdkVersion: "2.0.12",
+  genVersion: "2.869.23",
   userAgent:
-    "speakeasy-sdk/mcp-typescript 2.0.10 2.866.2 1.0 @flexprice/mcp-server",
+    "speakeasy-sdk/mcp-typescript 2.0.12 2.869.23 1.0 @flexprice/mcp-server",
 } as const;

package/src/lib/encodings.ts

@@ -474,6 +474,23 @@ export const encodeSpaceDelimitedQuery = queryEncoder(encodeSpaceDelimited);
 export const encodePipeDelimitedQuery = queryEncoder(encodePipeDelimited);
 export const encodeDeepObjectQuery = queryEncoder(encodeDeepObject);
 
+function isBlobLike(val: unknown): val is Blob {
+  if (val instanceof Blob) {
+    return true;
+  }
+
+  if (typeof val !== "object" || val == null || !(Symbol.toStringTag in val)) {
+    return false;
+  }
+
+  const tag = val[Symbol.toStringTag];
+  if (tag !== "Blob" && tag !== "File") {
+    return false;
+  }
+
+  return "stream" in val && typeof val.stream === "function";
+}
+
 export function appendForm(
   fd: FormData,
   key: string,
@@ -482,10 +499,12 @@ export function appendForm(
 ): void {
   if (value == null) {
     return;
-  } else if (value instanceof Blob && fileName) {
-    fd.append(key, value, fileName);
-  } else if (value instanceof Blob) {
-    fd.append(key, value);
+  } else if (isBlobLike(value)) {
+    if (fileName) {
+      fd.append(key, value as Blob, fileName);
+    } else {
+      fd.append(key, value as Blob);
+    }
   } else if (Array.isArray(value)) {
     value.forEach((v) => {
       appendForm(fd, key, v);

package/src/mcp-server/cli/serve/command.ts

@@ -44,6 +44,13 @@ export const serveCommand = buildCommand({
         values: ["dynamic"],
         optional: true,
       },
+      "tool-annotations": {
+        kind: "parsed",
+        brief:
+          "Filter tools by annotations (comma-separated: readOnly, destructive, idempotent, openWorld). Listed = required true, unlisted = required false.",
+        optional: true,
+        parse: (value) => value.split(",").map(s => s.trim()),
+      },
       scope: {
         kind: "enum",
         brief: "Mount tools/resources that match given scope (repeatable flag)",

package/src/mcp-server/cli/serve/impl.ts

@@ -12,6 +12,7 @@ import {
 } from "../../console-logger.js";
 import { MCPServerFlags } from "../../flags.js";
 import { createMCPServer } from "../../server.js";
+import { buildAnnotationFilter } from "../../tools.js";
 import { buildSDK } from "../../tools.js";
 
 import { landingPageExpress } from "../../../landing-page.js";
@@ -65,6 +66,7 @@ async function startStreamableHTTP(cliFlags: ServeCommandFlags) {
       logger,
       allowedTools: cliFlags.tool,
       dynamic: cliFlags.mode === "dynamic",
+      annotationFilter: buildAnnotationFilter(cliFlags["tool-annotations"]),
       scopes: cliFlags.scope,
       serverURL: cliFlags["server-url"],
       getSDK: () =>

package/src/mcp-server/cli/start/command.ts

@@ -44,6 +44,13 @@ export const startCommand = buildCommand({
         values: ["dynamic"],
         optional: true,
       },
+      "tool-annotations": {
+        kind: "parsed",
+        brief:
+          "Filter tools by annotations (comma-separated: readOnly, destructive, idempotent, openWorld). Listed = required true, unlisted = required false.",
+        optional: true,
+        parse: (value) => value.split(",").map(s => s.trim()),
+      },
       scope: {
         kind: "enum",
         brief: "Mount tools/resources that match given scope (repeatable flag)",

package/src/mcp-server/cli/start/impl.ts

@@ -12,6 +12,7 @@ import {
 } from "../../console-logger.js";
 import { MCPServerFlags } from "../../flags.js";
 import { createMCPServer } from "../../server.js";
+import { buildAnnotationFilter } from "../../tools.js";
 
 import { landingPageExpress } from "../../../landing-page.js";
 
@@ -52,6 +53,7 @@ async function startStdio(flags: StartCommandFlags) {
     logger,
     allowedTools: flags.tool,
     dynamic: flags.mode === "dynamic",
+    annotationFilter: buildAnnotationFilter(flags["tool-annotations"]),
     scopes: flags.scope,
     security: { ApiKeyAuth: flags["api-key-auth"] ?? "" },
     serverURL: flags["server-url"],
@@ -103,6 +105,7 @@ async function startSSE(cliFlags: StartCommandFlags) {
       logger,
       allowedTools: flags.tool,
       dynamic: flags.mode === "dynamic",
+      annotationFilter: buildAnnotationFilter(flags["tool-annotations"]),
       scopes: flags.scope,
       security: { ApiKeyAuth: flags["api-key-auth"] ?? "" },
       serverURL: flags["server-url"],

package/src/mcp-server/flags.ts

@@ -12,6 +12,7 @@ import { MCPScope } from "./scopes.js";
 export interface MCPServerFlags {
   readonly tool?: string[];
   readonly mode?: "dynamic" | undefined;
+  readonly "tool-annotations"?: string[] | undefined;
   readonly scope?: MCPScope[];
   readonly "api-key-auth"?: string | undefined;
   readonly "server-url"?: string | undefined;

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

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

package/src/mcp-server/server.ts

@@ -12,7 +12,11 @@ import {
   createRegisterResourceTemplate,
 } from "./resources.js";
 import { MCPScope } from "./scopes.js";
-import { createRegisterTool, registerDynamicTools } from "./tools.js";
+import {
+  createRegisterTool,
+  MCPToolAnnotationFilter,
+  registerDynamicTools,
+} from "./tools.js";
 import { tool$customersCreateCustomer } from "./tools/customersCreateCustomer.js";
 import { tool$customersDeleteCustomer } from "./tools/customersDeleteCustomer.js";
 import { tool$customersGetCustomer } from "./tools/customersGetCustomer.js";
@@ -89,6 +93,7 @@ export function createMCPServer(deps: {
   allowedTools?: string[] | undefined;
   dynamic?: boolean | undefined;
   scopes?: MCPScope[] | undefined;
+  annotationFilter?: MCPToolAnnotationFilter | undefined;
   getSDK?: () => FlexpriceCore;
   serverURL?: string | undefined;
   security?: SDKOptions["security"] | undefined;
@@ -96,7 +101,7 @@ export function createMCPServer(deps: {
 }) {
   const server = new McpServer({
     name: "Flexprice",
-    version: "2.0.10",
+    version: "2.0.12",
   });
 
   const getClient = deps.getSDK || (() =>
@@ -123,6 +128,7 @@ export function createMCPServer(deps: {
     scopes,
     allowedTools,
     deps.dynamic,
+    deps.annotationFilter,
   );
   const resource = createRegisterResource(
     deps.logger,

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

@@ -7,7 +7,7 @@ import { DtoCreateCustomerRequest$zodSchema } from "../../models/dtocreatecustom
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  request: DtoCreateCustomerRequest$zodSchema,
+  request: DtoCreateCustomerRequest$zodSchema.describe(`Customer`),
 };
 
 export const tool$customersCreateCustomer: ToolDefinition<typeof args> = {

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

@@ -7,7 +7,7 @@ import { CustomerFilter$zodSchema } from "../../models/customerfilter.js";
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  request: CustomerFilter$zodSchema,
+  request: CustomerFilter$zodSchema.describe(`Filter`),
 };
 
 export const tool$customersQueryCustomer: ToolDefinition<typeof args> = {

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

@@ -7,7 +7,7 @@ import { DtoGetUsageAnalyticsRequest$zodSchema } from "../../models/dtogetusagea
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  request: DtoGetUsageAnalyticsRequest$zodSchema,
+  request: DtoGetUsageAnalyticsRequest$zodSchema.describe(`Request body`),
 };
 
 export const tool$eventsGetUsageAnalytics: ToolDefinition<typeof args> = {

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

@@ -7,7 +7,7 @@ import { DtoGetUsageByMeterRequest$zodSchema } from "../../models/dtogetusagebym
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  request: DtoGetUsageByMeterRequest$zodSchema,
+  request: DtoGetUsageByMeterRequest$zodSchema.describe(`Request body`),
 };
 
 export const tool$eventsGetUsageByMeter: ToolDefinition<typeof args> = {

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

@@ -7,7 +7,7 @@ import { DtoGetUsageRequest$zodSchema } from "../../models/dtogetusagerequest.js
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  request: DtoGetUsageRequest$zodSchema,
+  request: DtoGetUsageRequest$zodSchema.describe(`Request body`),
 };
 
 export const tool$eventsGetUsageStatistics: ToolDefinition<typeof args> = {

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

@@ -7,7 +7,7 @@ import { DtoIngestEventRequest$zodSchema } from "../../models/dtoingesteventrequ
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  request: DtoIngestEventRequest$zodSchema,
+  request: DtoIngestEventRequest$zodSchema.describe(`Event data`),
 };
 
 export const tool$eventsIngestEvent: ToolDefinition<typeof args> = {

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

@@ -7,7 +7,7 @@ import { DtoBulkIngestEventRequest$zodSchema } from "../../models/dtobulkingeste
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  request: DtoBulkIngestEventRequest$zodSchema,
+  request: DtoBulkIngestEventRequest$zodSchema.describe(`Event data`),
 };
 
 export const tool$eventsIngestEventsBulk: ToolDefinition<typeof args> = {

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

@@ -7,7 +7,7 @@ import { DtoGetEventsRequest$zodSchema } from "../../models/dtogeteventsrequest.
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  request: DtoGetEventsRequest$zodSchema,
+  request: DtoGetEventsRequest$zodSchema.describe(`Request body`),
 };
 
 export const tool$eventsListRawEvents: ToolDefinition<typeof args> = {

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

@@ -7,7 +7,7 @@ import { DtoCreateInvoiceRequest$zodSchema } from "../../models/dtocreateinvoice
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  request: DtoCreateInvoiceRequest$zodSchema,
+  request: DtoCreateInvoiceRequest$zodSchema.describe(`Invoice details`),
 };
 
 export const tool$invoicesCreateInvoice: ToolDefinition<typeof args> = {

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

@@ -7,7 +7,9 @@ import { DtoGetPreviewInvoiceRequest$zodSchema } from "../../models/dtogetprevie
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  request: DtoGetPreviewInvoiceRequest$zodSchema,
+  request: DtoGetPreviewInvoiceRequest$zodSchema.describe(
+    `Preview Invoice Request`,
+  ),
 };
 
 export const tool$invoicesGetInvoicePreview: ToolDefinition<typeof args> = {

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

@@ -7,7 +7,7 @@ import { InvoiceFilter$zodSchema } from "../../models/invoicefilter.js";
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  request: InvoiceFilter$zodSchema,
+  request: InvoiceFilter$zodSchema.describe(`Filter`),
 };
 
 export const tool$invoicesQueryInvoice: ToolDefinition<typeof args> = {

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

@@ -7,7 +7,7 @@ import { DtoCreatePlanRequest$zodSchema } from "../../models/dtocreateplanreques
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  request: DtoCreatePlanRequest$zodSchema,
+  request: DtoCreatePlanRequest$zodSchema.describe(`Plan configuration`),
 };
 
 export const tool$plansCreatePlan: ToolDefinition<typeof args> = {

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

@@ -7,7 +7,7 @@ import { PlanFilter$zodSchema } from "../../models/planfilter.js";
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  request: PlanFilter$zodSchema,
+  request: PlanFilter$zodSchema.describe(`Filter`),
 };
 
 export const tool$plansQueryPlan: ToolDefinition<typeof args> = {

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

@@ -7,7 +7,7 @@ import { DtoCreatePriceRequest$zodSchema } from "../../models/dtocreatepricerequ
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  request: DtoCreatePriceRequest$zodSchema,
+  request: DtoCreatePriceRequest$zodSchema.describe(`Price configuration`),
 };
 
 export const tool$pricesCreatePrice: ToolDefinition<typeof args> = {

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

@@ -7,7 +7,9 @@ import { DtoCreateBulkPriceRequest$zodSchema } from "../../models/dtocreatebulkp
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  request: DtoCreateBulkPriceRequest$zodSchema,
+  request: DtoCreateBulkPriceRequest$zodSchema.describe(
+    `Bulk price configuration`,
+  ),
 };
 
 export const tool$pricesCreatePricesBulk: ToolDefinition<typeof args> = {

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

@@ -7,7 +7,7 @@ import { PriceFilter$zodSchema } from "../../models/pricefilter.js";
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  request: PriceFilter$zodSchema,
+  request: PriceFilter$zodSchema.describe(`Filter`),
 };
 
 export const tool$pricesQueryPrice: ToolDefinition<typeof args> = {

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

@@ -7,7 +7,7 @@ import { DtoAddAddonRequest$zodSchema } from "../../models/dtoaddaddonrequest.js
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  request: DtoAddAddonRequest$zodSchema,
+  request: DtoAddAddonRequest$zodSchema.describe(`Add Addon Request`),
 };
 
 export const tool$subscriptionsAddSubscriptionAddon: ToolDefinition<

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

@@ -7,7 +7,9 @@ import { DtoCreateSubscriptionRequest$zodSchema } from "../../models/dtocreatesu
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  request: DtoCreateSubscriptionRequest$zodSchema,
+  request: DtoCreateSubscriptionRequest$zodSchema.describe(
+    `Subscription Request`,
+  ),
 };
 
 export const tool$subscriptionsCreateSubscription: ToolDefinition<typeof args> =

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

@@ -7,7 +7,7 @@ import { DtoGetUsageBySubscriptionRequest$zodSchema } from "../../models/dtogetu
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  request: DtoGetUsageBySubscriptionRequest$zodSchema,
+  request: DtoGetUsageBySubscriptionRequest$zodSchema.describe(`Usage request`),
 };
 
 export const tool$subscriptionsGetSubscriptionUsage: ToolDefinition<

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

@@ -7,7 +7,7 @@ import { SubscriptionFilter$zodSchema } from "../../models/subscriptionfilter.js
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  request: SubscriptionFilter$zodSchema,
+  request: SubscriptionFilter$zodSchema.describe(`Filter`),
 };
 
 export const tool$subscriptionsQuerySubscription: ToolDefinition<typeof args> =

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

@@ -7,7 +7,7 @@ import { DtoRemoveAddonRequest$zodSchema } from "../../models/dtoremoveaddonrequ
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  request: DtoRemoveAddonRequest$zodSchema,
+  request: DtoRemoveAddonRequest$zodSchema.describe(`Remove Addon Request`),
 };
 
 export const tool$subscriptionsRemoveSubscriptionAddon: ToolDefinition<

package/src/mcp-server/tools.ts

@@ -20,6 +20,50 @@ import { MCPServerFlags } from "./flags.js";
 import { MCPScope, mcpScopes } from "./scopes.js";
 import { valueToBase64 } from "./shared.js";
 
+export type MCPToolAnnotationFilter = {
+  readOnlyHint?: boolean;
+  destructiveHint?: boolean;
+  idempotentHint?: boolean;
+  openWorldHint?: boolean;
+};
+
+const VALID_ANNOTATIONS = [
+  "readOnly",
+  "destructive",
+  "idempotent",
+  "openWorld",
+] as const;
+type AnnotationName = typeof VALID_ANNOTATIONS[number];
+
+const annotationToKey: Record<AnnotationName, keyof MCPToolAnnotationFilter> = {
+  readOnly: "readOnlyHint",
+  destructive: "destructiveHint",
+  idempotent: "idempotentHint",
+  openWorld: "openWorldHint",
+};
+
+export function buildAnnotationFilter(
+  annotations: string[] | undefined,
+): MCPToolAnnotationFilter {
+  const filter: MCPToolAnnotationFilter = {};
+  if (!annotations || annotations.length === 0) {
+    return filter;
+  }
+  for (const a of annotations) {
+    if (!VALID_ANNOTATIONS.includes(a as AnnotationName)) {
+      throw new Error(
+        `Invalid annotation filter: "${a}". Valid values are: ${
+          VALID_ANNOTATIONS.join(", ")
+        }`,
+      );
+    }
+  }
+  for (const name of VALID_ANNOTATIONS) {
+    filter[annotationToKey[name]] = annotations.includes(name);
+  }
+  return filter;
+}
+
 export type ToolDefinition<
   Args extends undefined | ZodRawShapeCompat = undefined,
 > = Args extends ZodRawShapeCompat ? {
@@ -90,6 +134,7 @@ export function createRegisterTool(
   allowedScopes: Set<MCPScope>,
   allowedTools?: Set<string>,
   dynamic?: boolean,
+  annotationFilter?: MCPToolAnnotationFilter,
 ): [
   <A extends ZodRawShapeCompat | undefined>(tool: ToolDefinition<A>) => void,
   Array<{ name: string; description: string }>,
@@ -119,6 +164,34 @@ export function createRegisterTool(
       return;
     }
 
+    if (annotationFilter) {
+      const a = tool.annotations;
+      if (
+        annotationFilter.readOnlyHint !== undefined
+        && a.readOnlyHint !== annotationFilter.readOnlyHint
+      ) {
+        return;
+      }
+      if (
+        annotationFilter.destructiveHint !== undefined
+        && a.destructiveHint !== annotationFilter.destructiveHint
+      ) {
+        return;
+      }
+      if (
+        annotationFilter.idempotentHint !== undefined
+        && a.idempotentHint !== annotationFilter.idempotentHint
+      ) {
+        return;
+      }
+      if (
+        annotationFilter.openWorldHint !== undefined
+        && a.openWorldHint !== annotationFilter.openWorldHint
+      ) {
+        return;
+      }
+    }
+
     toolMap.set(
       tool.name,
       tool as ToolDefinition<ZodRawShapeCompat | undefined>,

package/src/models/activatesubscriptionop.ts

@@ -24,7 +24,9 @@ export type ActivateSubscriptionRequest = {
 export const ActivateSubscriptionRequest$zodSchema: z.ZodType<
   ActivateSubscriptionRequest
 > = z.object({
-  body: DtoActivateDraftSubscriptionRequest$zodSchema,
+  body: DtoActivateDraftSubscriptionRequest$zodSchema.describe(
+    "Activate Draft Subscription Request",
+  ),
   id: z.string().describe("Subscription ID"),
 });
 

package/src/models/cancellationtype.ts

@@ -8,10 +8,12 @@ import { ClosedEnum } from "../types/enums.js";
 export const CancellationType = {
   Immediate: "immediate",
   EndOfPeriod: "end_of_period",
+  ScheduledDate: "scheduled_date",
 } as const;
 export type CancellationType = ClosedEnum<typeof CancellationType>;
 
 export const CancellationType$zodSchema = z.enum([
   "immediate",
   "end_of_period",
+  "scheduled_date",
 ]);

package/src/models/cancelsubscriptionop.ts

@@ -24,7 +24,9 @@ export type CancelSubscriptionRequest = {
 export const CancelSubscriptionRequest$zodSchema: z.ZodType<
   CancelSubscriptionRequest
 > = z.object({
-  body: DtoCancelSubscriptionRequest$zodSchema,
+  body: DtoCancelSubscriptionRequest$zodSchema.describe(
+    "Cancel Subscription Request",
+  ),
   id: z.string().describe("Subscription ID"),
 });
 

package/src/models/cancelsubscriptionscheduleop.ts

@@ -16,7 +16,9 @@ export type CancelSubscriptionScheduleRequest = {
 export const CancelSubscriptionScheduleRequest$zodSchema: z.ZodType<
   CancelSubscriptionScheduleRequest
 > = z.object({
-  body: DtoCancelScheduleRequest$zodSchema.optional(),
+  body: DtoCancelScheduleRequest$zodSchema.optional().describe(
+    "Cancel request (optional if using path parameter)",
+  ),
   schedule_id: z.string().describe(
     "Schedule ID (optional if using request body)",
   ),

package/src/models/commitmentinfo.ts

@@ -23,11 +23,15 @@ export const CommitmentInfo$zodSchema: z.ZodType<CommitmentInfo> = z.object({
   amount: z.string().optional(),
   computed_commitment_utilized_amount: z.string().optional(),
   computed_overage_amount: z.string().optional(),
-  computed_true_up_amount: z.string().optional(),
+  computed_true_up_amount: z.string().optional().describe(
+    "total_cost = computed_commitment_utilized_amount + computed_overage_amount + computed_true_up_amount",
+  ),
   duration: BillingPeriod$zodSchema.optional(),
   is_windowed: z.boolean().optional(),
   overage_factor: z.string().optional(),
-  quantity: z.string().optional(),
+  quantity: z.string().optional().describe(
+    "Only used for quantity-based commitments",
+  ),
   true_up_enabled: z.boolean().optional(),
   type: CommitmentType$zodSchema.optional(),
 });

package/src/models/createsubscriptionlineitemop.ts

@@ -24,7 +24,9 @@ export type CreateSubscriptionLineItemRequest = {
 export const CreateSubscriptionLineItemRequest$zodSchema: z.ZodType<
   CreateSubscriptionLineItemRequest
 > = z.object({
-  body: DtoCreateSubscriptionLineItemRequest$zodSchema,
+  body: DtoCreateSubscriptionLineItemRequest$zodSchema.describe(
+    "Create Line Item Request",
+  ),
   id: z.string().describe("Subscription ID"),
 });
 

package/src/models/deletepriceop.ts

@@ -20,7 +20,7 @@ export type DeletePriceRequest = { id: string; body: DtoDeletePriceRequest };
 
 export const DeletePriceRequest$zodSchema: z.ZodType<DeletePriceRequest> = z
   .object({
-    body: DtoDeletePriceRequest$zodSchema,
+    body: DtoDeletePriceRequest$zodSchema.describe("Delete Price Request"),
     id: z.string().describe("Price ID"),
   });
 

package/src/models/deletesubscriptionlineitemop.ts

@@ -24,7 +24,9 @@ export type DeleteSubscriptionLineItemRequest = {
 export const DeleteSubscriptionLineItemRequest$zodSchema: z.ZodType<
   DeleteSubscriptionLineItemRequest
 > = z.object({
-  body: DtoDeleteSubscriptionLineItemRequest$zodSchema,
+  body: DtoDeleteSubscriptionLineItemRequest$zodSchema.describe(
+    "Delete Line Item Request",
+  ),
   id: z.string().describe("Line Item ID"),
 });
 

package/src/models/dtoactivatedraftsubscriptionrequest.ts

@@ -9,5 +9,7 @@ export type DtoActivateDraftSubscriptionRequest = { start_date: string };
 export const DtoActivateDraftSubscriptionRequest$zodSchema: z.ZodType<
   DtoActivateDraftSubscriptionRequest
 > = z.object({
-  start_date: z.string(),
+  start_date: z.string().describe(
+    "start_date is the new start date for the subscription when activating",
+  ),
 });

package/src/models/dtoaddaddonrequest.ts

@@ -24,7 +24,9 @@ export const DtoAddAddonRequest$zodSchema: z.ZodType<DtoAddAddonRequest> = z
     line_item_commitments: z.record(
       z.string(),
       DtoLineItemCommitmentConfig$zodSchema,
-    ).optional(),
+    ).optional().describe(
+      "LineItemCommitments allows setting commitment configuration per addon line item (keyed by price_id)",
+    ),
     metadata: z.record(z.string(), z.any()).optional(),
     start_date: z.string().optional(),
     subscription_id: z.string(),