@flexprice/mcp-server 2.1.20 → 2.1.25

package/manifest.json

@@ -48,7 +48,7 @@
       "sensitive": true
     }
   },
-  "version": "2.1.20",
+  "version": "2.1.25",
   "tools": [
     {
       "name": "update-customer",
@@ -62,6 +62,14 @@
       "name": "get-customer-by-external-id",
       "description": "Get customer by external ID\n\nUse when resolving a customer by your app's id (e.g. from your user table). Ideal for integrations that key by external id."
     },
+    {
+      "name": "get-customer-entitlements-by-external-i-d",
+      "description": "Get customer entitlements by external ID\n\nUse when checking entitlements by your app's customer id (e.g. feature gating at the edge). Supports optional filters (feature_ids, subscription_ids)."
+    },
+    {
+      "name": "get-subscriptions-for-customer",
+      "description": "Get subscriptions for customer by external ID\n\nReturns all subscriptions for a customer looked up by external_id, with line-item meters and entitlements attached (no pagination)."
+    },
     {
       "name": "query-customer",
       "description": "Query customers\n\nUse when listing or searching customers (e.g. admin CRM or reporting). Returns a paginated list; supports filtering and sorting."
@@ -108,7 +116,7 @@
     },
     {
       "name": "update-invoice",
-      "description": "Update invoice\n\nUse when updating invoice metadata or due date (e.g. PDF URL, net terms). For paid invoices only safe fields can be updated."
+      "description": "Update invoice\n\nUse when updating invoice metadata or due date (e.g. PDF URL, net terms), or when recalculating this draft invoice's discount from its current standing coupon associations via apply_discount:true (idempotent, does not attach a new coupon). Allowed for invoices in draft or finalized status."
     },
     {
       "name": "trigger-invoice-comms-webhook",
@@ -156,7 +164,11 @@
     },
     {
       "name": "get-huggingface-inference-data",
-      "description": "Get Hugging Face inference data\n\nUse when fetching Hugging Face inference usage or billing data (e.g. for HF-specific reporting or reconciliation)."
+      "description": "Get Hugging Face inference data\n\nUse when fetching Hugging Face inference usage or billing data (e.g. for HF-specific reporting or reconciliation). Reads the meter-usage pipeline."
+    },
+    {
+      "name": "get-event",
+      "description": "Get event\n\nUse when debugging a specific event (e.g. why it failed or how it was aggregated). Reads the meter-usage pipeline; includes processing status and step-by-step debug tracker when unprocessed. Uses ?id= query param because event IDs can contain \"/\"."
     },
     {
       "name": "list-raw-events",
@@ -170,10 +182,6 @@
       "name": "get-usage-by-meter",
       "description": "Get usage by meter\n\nUse when showing usage for a specific meter (e.g. dashboard or overage check). Supports time range, filters, and grouping by customer or subscription."
     },
-    {
-      "name": "get-event",
-      "description": "Get event\n\nUse when debugging a specific event (e.g. why it failed or how it was aggregated). Includes processing status and debug info."
-    },
     {
       "name": "create-plan",
       "description": "Create plan\n\nUse when defining a new pricing plan (e.g. Free, Pro, Enterprise). Attach prices and entitlements; customers subscribe to plans."
@@ -236,11 +244,11 @@
     },
     {
       "name": "add-subscription-addon",
-      "description": "Add addon to subscription\n\nUse when adding an optional product or add-on to an existing subscription (e.g. extra storage or support tier)."
+      "description": "Add addon to subscription\n\nDeprecated: use POST /subscriptions/{id}/modify/execute with type \"addon\" and action \"add\", which also supports previewing the proration charge first.\nUse when adding an optional product or add-on to an existing subscription (e.g. extra storage or support tier)."
     },
     {
       "name": "remove-subscription-addon",
-      "description": "Remove addon from subscription\n\nUse when removing an add-on from a subscription (e.g. downgrade or opt-out)."
+      "description": "Remove addon from subscription\n\nDeprecated: use POST /subscriptions/{id}/modify/execute with type \"addon\" and action \"remove\", which also supports previewing the proration credit first.\nUse when removing an add-on from a subscription (e.g. downgrade or opt-out)."
     },
     {
       "name": "query-subscription-line-items",
@@ -290,6 +298,14 @@
       "name": "preview-subscription-change",
       "description": "Preview subscription plan change\n\nUse when showing a customer the cost of a plan change before they confirm (e.g. upgrade/downgrade preview with proration)."
     },
+    {
+      "name": "execute-subscription-plan-change-v2",
+      "description": "Execute a plan change (v2, swap in place)\n\nChange a subscription's plan in place. Subscription id, billing anchor and period bounds are preserved; line items are sliced and settled in one transaction.\n\nchange_at controls timing. Omitted or 'immediate' applies the change now. 'end_of_period' records a pending schedule that executes at the subscription's current period end: the response returns is_scheduled, schedule_id and scheduled_at instead of a completed change, and nothing is swapped or billed until the boundary.\n\nscheduled_at is resolved from the subscription's current period end at request time. If that period end is already in the past (a backdated start date, a resumed pause, or worker downtime can all leave a subscription behind), the change is due immediately and fires on the next billing scan rather than a period away — inspect scheduled_at to see this.\n\nOnly one plan change may be pending per subscription; request a second one and this returns 400. Cancel the existing schedule via POST /subscriptions/schedules/{schedule_id}/cancel first. Pending schedules are listable via GET /subscriptions/{id}/schedules."
+    },
+    {
+      "name": "preview-subscription-plan-change-v2",
+      "description": "Preview a plan change (v2, swap in place)\n\nPreview a subscription plan change without writing. Swap-in-place: subscription id, billing anchor and period bounds are preserved."
+    },
     {
       "name": "get-subscription-entitlements",
       "description": "Get subscription entitlements\n\nUse when checking what features or limits a subscription has (e.g. entitlement checks or feature gating). Optional feature_ids to filter."
@@ -304,11 +320,11 @@
     },
     {
       "name": "execute-subscription-modify",
-      "description": "Execute subscription modification\n\nExecute a mid-cycle subscription modification (inheritance, quantity change, grouped invoicing, trial end, coupon, or tax)."
+      "description": "Execute subscription modification\n\nExecute a mid-cycle subscription modification (inheritance, quantity change, grouped invoicing, trial end, coupon, tax, or addon add/remove)."
     },
     {
       "name": "preview-subscription-modify",
-      "description": "Preview subscription modification\n\nPreview the impact of a mid-cycle subscription modification (inheritance, quantity change, grouped invoicing, trial end, coupon, or tax) without committing changes."
+      "description": "Preview subscription modification\n\nPreview the impact of a mid-cycle subscription modification (inheritance, quantity change, grouped invoicing, trial end, coupon, tax, or addon add/remove) without committing changes."
     },
     {
       "name": "get-subscription-v2",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flexprice/mcp-server",
-  "version": "2.1.20",
+  "version": "2.1.25",
   "author": "flexprice",
   "type": "module",
   "sideEffects": false,
@@ -22,7 +22,14 @@
     "zod": "^4.0.0"
   },
   "overrides": {
-    "@modelcontextprotocol/sdk": "1.26.0"
+    "@modelcontextprotocol/sdk": "1.26.0",
+    "hono": ">=4.12.34",
+    "fast-uri": ">=4.1.2 <5.0.0",
+    "js-yaml": ">=4.3.1 <5.0.0",
+    "ip-address": ">=10.3.1 <11.0.0",
+    "nanoid@^5.0.0": ">=5.1.16 <6.0.0",
+    "brace-expansion@^2.0.0": ">=2.1.4 <3.0.0",
+    "body-parser": ">=2.3.0 <3.0.0"
   },
   "devDependencies": {
     "@anthropic-ai/mcpb": "^1.2.0",

package/src/funcs/customersGetCustomerEntitlementsByExternalID.ts

@@ -0,0 +1,153 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { FlexpriceCore } from "../core.js";
+import { encodeSimple } from "../lib/encodings.js";
+import { compactMap } from "../lib/primitives.js";
+import { safeParse } from "../lib/schemas.js";
+import { RequestOptions } from "../lib/sdks.js";
+import { extractSecurity, resolveGlobalSecurity } from "../lib/security.js";
+import { pathToFunc } from "../lib/url.js";
+import { APIError } from "../models/errors/apierror.js";
+import {
+  ConnectionError,
+  InvalidRequestError,
+  RequestAbortedError,
+  RequestTimeoutError,
+  UnexpectedClientError,
+} from "../models/errors/httpclienterrors.js";
+import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import {
+  GetCustomerEntitlementsByExternalIDRequest,
+  GetCustomerEntitlementsByExternalIDRequest$zodSchema,
+} from "../models/getcustomerentitlementsbyexternalidop.js";
+import { APICall, APIPromise } from "../types/async.js";
+import { Result } from "../types/fp.js";
+
+/**
+ * Get customer entitlements by external ID
+ *
+ * @remarks
+ * Use when checking entitlements by your app's customer id (e.g. feature gating at the edge). Supports optional filters (feature_ids, subscription_ids).
+ */
+export function customersGetCustomerEntitlementsByExternalID(
+  client$: FlexpriceCore,
+  request: GetCustomerEntitlementsByExternalIDRequest,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    Response,
+    | APIError
+    | SDKValidationError
+    | UnexpectedClientError
+    | InvalidRequestError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | ConnectionError
+  >
+> {
+  return new APIPromise($do(
+    client$,
+    request,
+    options,
+  ));
+}
+
+async function $do(
+  client$: FlexpriceCore,
+  request: GetCustomerEntitlementsByExternalIDRequest,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      Response,
+      | APIError
+      | SDKValidationError
+      | UnexpectedClientError
+      | InvalidRequestError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | ConnectionError
+    >,
+    APICall,
+  ]
+> {
+  const parsed$ = safeParse(
+    request,
+    (value$) =>
+      GetCustomerEntitlementsByExternalIDRequest$zodSchema.parse(value$),
+    "Input validation failed",
+  );
+  if (!parsed$.ok) {
+    return [parsed$, { status: "invalid" }];
+  }
+  const payload$ = parsed$.value;
+  const body$ = null;
+
+  const pathParams$ = {
+    external_id: encodeSimple("external_id", payload$.external_id, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+  };
+  const path$ = pathToFunc("/customers/external/{external_id}/entitlements")(
+    pathParams$,
+  );
+
+  const headers$ = new Headers(compactMap({
+    Accept: "application/json",
+  }));
+  const securityInput = await extractSecurity(client$._options.security);
+  const requestSecurity = resolveGlobalSecurity(securityInput);
+
+  const context = {
+    options: client$._options,
+    baseURL: options?.serverURL ?? client$._baseURL ?? "",
+    operationID: "getCustomerEntitlementsByExternalID",
+    oAuth2Scopes: null,
+    resolvedSecurity: requestSecurity,
+    securitySource: client$._options.security,
+    retryConfig: options?.retries
+      || client$._options.retryConfig
+      || { strategy: "none" },
+    retryCodes: options?.retryCodes || [
+      "429",
+      "500",
+      "502",
+      "503",
+      "504",
+    ],
+  };
+
+  const requestRes = client$._createRequest(context, {
+    security: requestSecurity,
+    method: "GET",
+    baseURL: options?.serverURL,
+    path: path$,
+    headers: headers$,
+    body: body$,
+    userAgent: client$._options.userAgent,
+    timeoutMs: options?.timeoutMs || client$._options.timeoutMs
+      || -1,
+  }, options);
+  if (!requestRes.ok) {
+    return [requestRes, { status: "invalid" }];
+  }
+  const req$ = requestRes.value;
+
+  const doResult = await client$._do(req$, {
+    context,
+    errorCodes: [],
+    retryConfig: context.retryConfig,
+    retryCodes: context.retryCodes,
+  });
+  if (!doResult.ok) {
+    return [doResult, { status: "request-error", request: req$ }];
+  }
+  return [doResult, {
+    status: "complete",
+    "request": req$,
+    response: doResult.value,
+  }];
+}

package/src/funcs/customersGetSubscriptionsForCustomer.ts

@@ -0,0 +1,156 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { FlexpriceCore } from "../core.js";
+import { encodeFormQuery, encodeSimple } from "../lib/encodings.js";
+import { compactMap } from "../lib/primitives.js";
+import { safeParse } from "../lib/schemas.js";
+import { RequestOptions } from "../lib/sdks.js";
+import { extractSecurity, resolveGlobalSecurity } from "../lib/security.js";
+import { pathToFunc } from "../lib/url.js";
+import { APIError } from "../models/errors/apierror.js";
+import {
+  ConnectionError,
+  InvalidRequestError,
+  RequestAbortedError,
+  RequestTimeoutError,
+  UnexpectedClientError,
+} from "../models/errors/httpclienterrors.js";
+import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import {
+  GetSubscriptionsForCustomerRequest,
+  GetSubscriptionsForCustomerRequest$zodSchema,
+} from "../models/getsubscriptionsforcustomerop.js";
+import { APICall, APIPromise } from "../types/async.js";
+import { Result } from "../types/fp.js";
+
+/**
+ * Get subscriptions for customer by external ID
+ *
+ * @remarks
+ * Returns all subscriptions for a customer looked up by external_id, with line-item meters and entitlements attached (no pagination).
+ */
+export function customersGetSubscriptionsForCustomer(
+  client$: FlexpriceCore,
+  request: GetSubscriptionsForCustomerRequest,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    Response,
+    | APIError
+    | SDKValidationError
+    | UnexpectedClientError
+    | InvalidRequestError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | ConnectionError
+  >
+> {
+  return new APIPromise($do(
+    client$,
+    request,
+    options,
+  ));
+}
+
+async function $do(
+  client$: FlexpriceCore,
+  request: GetSubscriptionsForCustomerRequest,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      Response,
+      | APIError
+      | SDKValidationError
+      | UnexpectedClientError
+      | InvalidRequestError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | ConnectionError
+    >,
+    APICall,
+  ]
+> {
+  const parsed$ = safeParse(
+    request,
+    (value$) => GetSubscriptionsForCustomerRequest$zodSchema.parse(value$),
+    "Input validation failed",
+  );
+  if (!parsed$.ok) {
+    return [parsed$, { status: "invalid" }];
+  }
+  const payload$ = parsed$.value;
+  const body$ = null;
+
+  const pathParams$ = {
+    external_id: encodeSimple("external_id", payload$.external_id, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+  };
+  const path$ = pathToFunc("/customers/external/{external_id}/subscriptions")(
+    pathParams$,
+  );
+  const query$ = encodeFormQuery({
+    "expand": payload$.expand,
+  });
+
+  const headers$ = new Headers(compactMap({
+    Accept: "application/json",
+  }));
+  const securityInput = await extractSecurity(client$._options.security);
+  const requestSecurity = resolveGlobalSecurity(securityInput);
+
+  const context = {
+    options: client$._options,
+    baseURL: options?.serverURL ?? client$._baseURL ?? "",
+    operationID: "getSubscriptionsForCustomer",
+    oAuth2Scopes: null,
+    resolvedSecurity: requestSecurity,
+    securitySource: client$._options.security,
+    retryConfig: options?.retries
+      || client$._options.retryConfig
+      || { strategy: "none" },
+    retryCodes: options?.retryCodes || [
+      "429",
+      "500",
+      "502",
+      "503",
+      "504",
+    ],
+  };
+
+  const requestRes = client$._createRequest(context, {
+    security: requestSecurity,
+    method: "GET",
+    baseURL: options?.serverURL,
+    path: path$,
+    headers: headers$,
+    query: query$,
+    body: body$,
+    userAgent: client$._options.userAgent,
+    timeoutMs: options?.timeoutMs || client$._options.timeoutMs
+      || -1,
+  }, options);
+  if (!requestRes.ok) {
+    return [requestRes, { status: "invalid" }];
+  }
+  const req$ = requestRes.value;
+
+  const doResult = await client$._do(req$, {
+    context,
+    errorCodes: [],
+    retryConfig: context.retryConfig,
+    retryCodes: context.retryCodes,
+  });
+  if (!doResult.ok) {
+    return [doResult, { status: "request-error", request: req$ }];
+  }
+  return [doResult, {
+    status: "complete",
+    "request": req$,
+    response: doResult.value,
+  }];
+}

package/src/funcs/eventsGetEvent.ts

@@ -3,7 +3,7 @@
  */
 
 import { FlexpriceCore } from "../core.js";
-import { encodeSimple } from "../lib/encodings.js";
+import { encodeFormQuery } from "../lib/encodings.js";
 import { compactMap } from "../lib/primitives.js";
 import { safeParse } from "../lib/schemas.js";
 import { RequestOptions } from "../lib/sdks.js";
@@ -29,7 +29,7 @@ import { Result } from "../types/fp.js";
  * Get event
  *
  * @remarks
- * Use when debugging a specific event (e.g. why it failed or how it was aggregated). Includes processing status and debug info.
+ * Use when debugging a specific event (e.g. why it failed or how it was aggregated). Reads the meter-usage pipeline; includes processing status and step-by-step debug tracker when unprocessed. Uses ?id= query param because event IDs can contain "/".
  */
 export function eventsGetEvent(
   client$: FlexpriceCore,
@@ -83,16 +83,10 @@ async function $do(
   }
   const payload$ = parsed$.value;
   const body$ = null;
-
-  const pathParams$ = {
-    id: encodeSimple("id", payload$.id, {
-      explode: false,
-      charEncoding: "percent",
-    }),
-  };
-  const path$ = pathToFunc("/events/{id}")(
-    pathParams$,
-  );
+  const path$ = pathToFunc("/events/lookup")();
+  const query$ = encodeFormQuery({
+    "id": payload$.id,
+  });
 
   const headers$ = new Headers(compactMap({
     Accept: "application/json",
@@ -125,6 +119,7 @@ async function $do(
     baseURL: options?.serverURL,
     path: path$,
     headers: headers$,
+    query: query$,
     body: body$,
     userAgent: client$._options.userAgent,
     timeoutMs: options?.timeoutMs || client$._options.timeoutMs

package/src/funcs/eventsGetHuggingfaceInferenceData.ts

@@ -3,7 +3,9 @@
  */
 
 import { FlexpriceCore } from "../core.js";
+import { encodeJSON } from "../lib/encodings.js";
 import { compactMap } from "../lib/primitives.js";
+import { safeParse } from "../lib/schemas.js";
 import { RequestOptions } from "../lib/sdks.js";
 import { extractSecurity, resolveGlobalSecurity } from "../lib/security.js";
 import { pathToFunc } from "../lib/url.js";
@@ -16,6 +18,10 @@ import {
   UnexpectedClientError,
 } from "../models/errors/httpclienterrors.js";
 import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import {
+  GetHuggingFaceBillingDataRequest,
+  GetHuggingFaceBillingDataRequest$zodSchema,
+} from "../models/gethuggingfacebillingdatarequest.js";
 import { APICall, APIPromise } from "../types/async.js";
 import { Result } from "../types/fp.js";
 
@@ -23,10 +29,11 @@ import { Result } from "../types/fp.js";
  * Get Hugging Face inference data
  *
  * @remarks
- * Use when fetching Hugging Face inference usage or billing data (e.g. for HF-specific reporting or reconciliation).
+ * Use when fetching Hugging Face inference usage or billing data (e.g. for HF-specific reporting or reconciliation). Reads the meter-usage pipeline.
  */
 export function eventsGetHuggingfaceInferenceData(
   client$: FlexpriceCore,
+  request: GetHuggingFaceBillingDataRequest,
   options?: RequestOptions,
 ): APIPromise<
   Result<
@@ -42,12 +49,14 @@ export function eventsGetHuggingfaceInferenceData(
 > {
   return new APIPromise($do(
     client$,
+    request,
     options,
   ));
 }
 
 async function $do(
   client$: FlexpriceCore,
+  request: GetHuggingFaceBillingDataRequest,
   options?: RequestOptions,
 ): Promise<
   [
@@ -64,9 +73,20 @@ async function $do(
     APICall,
   ]
 > {
+  const parsed$ = safeParse(
+    request,
+    (value$) => GetHuggingFaceBillingDataRequest$zodSchema.parse(value$),
+    "Input validation failed",
+  );
+  if (!parsed$.ok) {
+    return [parsed$, { status: "invalid" }];
+  }
+  const payload$ = parsed$.value;
+  const body$ = encodeJSON("body", payload$, { explode: true });
   const path$ = pathToFunc("/events/huggingface-inference")();
 
   const headers$ = new Headers(compactMap({
+    "Content-Type": "application/json",
     Accept: "application/json",
   }));
   const securityInput = await extractSecurity(client$._options.security);
@@ -97,6 +117,7 @@ async function $do(
     baseURL: options?.serverURL,
     path: path$,
     headers: headers$,
+    body: body$,
     userAgent: client$._options.userAgent,
     timeoutMs: options?.timeoutMs || client$._options.timeoutMs
       || -1,

package/src/funcs/invoicesGetInvoice.ts

@@ -98,6 +98,7 @@ async function $do(
       "group_by": payload$.group_by,
     }, { explode: false }),
     encodeFormQuery({
+      "expand": payload$.expand,
       "expand_by_source": payload$.expand_by_source,
     }),
   );

package/src/funcs/invoicesUpdateInvoice.ts

@@ -29,7 +29,7 @@ import { Result } from "../types/fp.js";
  * Update invoice
  *
  * @remarks
- * Use when updating invoice metadata or due date (e.g. PDF URL, net terms). For paid invoices only safe fields can be updated.
+ * Use when updating invoice metadata or due date (e.g. PDF URL, net terms), or when recalculating this draft invoice's discount from its current standing coupon associations via apply_discount:true (idempotent, does not attach a new coupon). Allowed for invoices in draft or finalized status.
  */
 export function invoicesUpdateInvoice(
   client$: FlexpriceCore,

package/src/funcs/subscriptionsAddSubscriptionAddon.ts

@@ -29,7 +29,10 @@ import { Result } from "../types/fp.js";
  * Add addon to subscription
  *
  * @remarks
+ * Deprecated: use POST /subscriptions/{id}/modify/execute with type "addon" and action "add", which also supports previewing the proration charge first.
  * Use when adding an optional product or add-on to an existing subscription (e.g. extra storage or support tier).
+ *
+ * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
  */
 export function subscriptionsAddSubscriptionAddon(
   client$: FlexpriceCore,

package/src/funcs/subscriptionsExecuteSubscriptionModify.ts

@@ -29,7 +29,7 @@ import { Result } from "../types/fp.js";
  * Execute subscription modification
  *
  * @remarks
- * Execute a mid-cycle subscription modification (inheritance, quantity change, grouped invoicing, trial end, coupon, or tax).
+ * Execute a mid-cycle subscription modification (inheritance, quantity change, grouped invoicing, trial end, coupon, tax, or addon add/remove).
  */
 export function subscriptionsExecuteSubscriptionModify(
   client$: FlexpriceCore,