@flexprice/mcp-server 2.0.6 → 2.0.7

package/manifest.json

@@ -48,150 +48,406 @@
       "sensitive": true
     }
   },
-  "version": "2.0.6",
+  "version": "2.0.7",
   "tools": [
     {
-      "name": "update-customer",
+      "name": "addons-create-addon",
+      "description": "Create addon\n\nUse when defining an optional purchasable item (e.g. extra storage or support tier). Ideal for add-ons that customers can attach to a subscription."
+    },
+    {
+      "name": "addons-get-addon-by-lookup-key",
+      "description": "Get addon by lookup key\n\nUse when resolving an addon by external id (e.g. from your product catalog). Ideal for integrations."
+    },
+    {
+      "name": "addons-query-addon",
+      "description": "Query addons\n\nUse when listing or searching addons (e.g. catalog or subscription builder). Returns a paginated list; supports filtering and sorting."
+    },
+    {
+      "name": "addons-get-addon",
+      "description": "Get addon\n\nUse when you need to load a single addon (e.g. for display or to attach to a subscription)."
+    },
+    {
+      "name": "addons-update-addon",
+      "description": "Update addon\n\nUse when changing addon details (e.g. name, pricing, or metadata)."
+    },
+    {
+      "name": "addons-delete-addon",
+      "description": "Delete addon\n\nUse when retiring an addon (e.g. end-of-life). Returns 200 with success message."
+    },
+    {
+      "name": "entitlements-get-addon-entitlements",
+      "description": "Get addon entitlements\n\nUse when checking what features or limits an addon grants (e.g. for display or entitlement logic)."
+    },
+    {
+      "name": "entitlements-create-entitlement",
+      "description": "Create entitlement\n\nUse when attaching a feature (and its limit) to a plan or addon (e.g. \"10 seats\" or \"1000 API calls\"). Defines what the plan/addon includes."
+    },
+    {
+      "name": "entitlements-create-entitlements-bulk",
+      "description": "Create entitlements in bulk\n\nUse when attaching many features to a plan or addon at once (e.g. initial plan setup or import). Bulk version of create entitlement."
+    },
+    {
+      "name": "entitlements-query-entitlement",
+      "description": "Query entitlements\n\nUse when listing or searching entitlements (e.g. plan editor or audit). Returns a paginated list; supports filtering by plan, addon, feature."
+    },
+    {
+      "name": "entitlements-get-entitlement",
+      "description": "Get entitlement\n\nUse when you need to load a single entitlement (e.g. to display or edit a feature limit)."
+    },
+    {
+      "name": "entitlements-update-entitlement",
+      "description": "Update entitlement\n\nUse when changing an entitlement (e.g. increasing or decreasing a limit). Request body contains the fields to update."
+    },
+    {
+      "name": "entitlements-delete-entitlement",
+      "description": "Delete entitlement\n\nUse when removing a feature from a plan or addon (e.g. deprecating a capability). Returns 200 with success message."
+    },
+    {
+      "name": "entitlements-get-plan-entitlements",
+      "description": "Get plan entitlements\n\nUse when checking what a plan includes (e.g. feature list or limits for display or gating)."
+    },
+    {
+      "name": "alerts-query-alert-log",
+      "description": "Query alert logs\n\nUse when viewing or searching alert history (e.g. support triage or customer-facing alert log). Returns a paginated list; supports filtering by type, customer, subscription."
+    },
+    {
+      "name": "costs-create-costsheet",
+      "description": "Create costsheet\n\nUse when setting up a new pricing configuration (e.g. a new product or region). Costsheets group prices and define the default for the environment."
+    },
+    {
+      "name": "costs-get-active-costsheet",
+      "description": "Get active costsheet\n\nUse when you need the tenant's default pricing configuration (e.g. for checkout or plan display). Returns the active costsheet for the environment."
+    },
+    {
+      "name": "costs-get-detailed-cost-analytics",
+      "description": "Get combined revenue and cost analytics\n\nUse when building dashboards or reports that need revenue vs cost, ROI, and margin over a time period (e.g. finance views or executive summaries)."
+    },
+    {
+      "name": "costs-get-detailed-cost-analytics-v2",
+      "description": "Get combined revenue and cost analytics (V2)\n\nUse when you need the same revenue/cost/ROI analytics but computed from the costsheet usage-tracking pipeline (e.g. for consistency with usage-based cost data)."
+    },
+    {
+      "name": "costs-query-costsheet",
+      "description": "Query costsheets\n\nUse when listing or searching costsheets (e.g. admin catalog). Returns a paginated list; supports filtering and sorting."
+    },
+    {
+      "name": "costs-get-costsheet",
+      "description": "Get costsheet\n\nUse when you need to load a single costsheet (e.g. for editing or display). Supports optional expand for related prices."
+    },
+    {
+      "name": "costs-update-costsheet",
+      "description": "Update costsheet\n\nUse when changing costsheet name or metadata."
+    },
+    {
+      "name": "costs-delete-costsheet",
+      "description": "Delete costsheet\n\nUse when retiring a costsheet (e.g. end-of-life product). Soft-deletes; status set to deleted."
+    },
+    {
+      "name": "coupons-create-coupon",
+      "description": "Create coupon\n\nUse when creating a discount (e.g. promo code or referral). Ideal for percent or fixed value, with optional validity and usage limits."
+    },
+    {
+      "name": "coupons-query-coupon",
+      "description": "Query coupons\n\nUse when listing or searching coupons (e.g. promo management). Returns a paginated list; supports filtering and sorting."
+    },
+    {
+      "name": "coupons-get-coupon",
+      "description": "Get coupon\n\nUse when you need to load a single coupon (e.g. for display or to validate a code)."
+    },
+    {
+      "name": "coupons-update-coupon",
+      "description": "Update coupon\n\nUse when changing coupon config (e.g. value, validity, or usage limits)."
+    },
+    {
+      "name": "coupons-delete-coupon",
+      "description": "Delete coupon\n\nUse when retiring a coupon (e.g. campaign ended). Returns 200 with success message."
+    },
+    {
+      "name": "credit-grants-create-credit-grant",
+      "description": "Create credit grant\n\nUse when giving a customer or plan credits (e.g. prepaid balance or promotional credits). Scope can be plan or subscription; supports start/end dates."
+    },
+    {
+      "name": "credit-grants-get-credit-grant",
+      "description": "Get credit grant\n\nUse when you need to load a single credit grant (e.g. for display or to check balance)."
+    },
+    {
+      "name": "credit-grants-update-credit-grant",
+      "description": "Update credit grant\n\nUse when changing a credit grant (e.g. amount or end date). Request body contains the fields to update."
+    },
+    {
+      "name": "credit-grants-delete-credit-grant",
+      "description": "Delete credit grant\n\nUse when removing or ending a credit grant (e.g. revoke promo or close prepaid). Plan-scoped grants are archived; subscription-scoped supports optional effective_date in body."
+    },
+    {
+      "name": "credit-grants-get-plan-credit-grants",
+      "description": "Get plan credit grants\n\nUse when listing credits attached to a plan (e.g. included prepaid or promo credits)."
+    },
+    {
+      "name": "credit-notes-create-credit-note",
+      "description": "Create credit note\n\nUse when issuing a refund or adjustment (e.g. customer dispute or proration). Links to an invoice; create as draft then finalize."
+    },
+    {
+      "name": "credit-notes-get-credit-note",
+      "description": "Get credit note\n\nUse when you need to load a single credit note (e.g. for display or reconciliation)."
+    },
+    {
+      "name": "credit-notes-process-credit-note",
+      "description": "Finalize credit note\n\nUse when locking a draft credit note and applying the credit (e.g. after approval). Once finalized, applied per billing provider."
+    },
+    {
+      "name": "credit-notes-void-credit-note",
+      "description": "Void credit note\n\nUse when cancelling a draft credit note (e.g. created by mistake). Only draft credit notes can be voided."
+    },
+    {
+      "name": "customers-update-customer",
       "description": "Update customer\n\nUse when updating customer details (e.g. name, email, or metadata). Identify by id or external_customer_id."
     },
     {
-      "name": "create-customer",
+      "name": "customers-create-customer",
       "description": "Create customer\n\nUse when onboarding a new billing customer (e.g. sign-up or CRM sync). Ideal for linking via external_customer_id to your app's user id."
     },
     {
-      "name": "get-customer-by-external-id",
+      "name": "customers-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": "query-customer",
+      "name": "customers-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."
     },
     {
-      "name": "get-customer-usage-summary",
+      "name": "customers-get-customer-usage-summary",
       "description": "Get customer usage summary\n\nUse when showing a customer's usage (e.g. portal or overage alerts). Identify by customer_id or customer_lookup_key; supports filters."
     },
     {
-      "name": "get-customer",
+      "name": "customers-get-customer",
       "description": "Get customer\n\nUse when you need to load a single customer (e.g. for a billing portal or to attach a subscription)."
     },
     {
-      "name": "delete-customer",
+      "name": "customers-delete-customer",
       "description": "Delete customer\n\nUse when removing a customer (e.g. GDPR or churn). Returns 204 No Content on success."
     },
     {
-      "name": "get-customer-entitlements",
+      "name": "customers-get-customer-entitlements",
       "description": "Get customer entitlements\n\nUse when checking what a customer can access (e.g. feature gating or usage limits). Supports optional filters (feature_ids, subscription_ids)."
     },
     {
-      "name": "get-customer-upcoming-grants",
+      "name": "customers-get-customer-upcoming-grants",
       "description": "Get upcoming credit grant applications\n\nUse when showing upcoming or pending credits for a customer (e.g. in a portal or for forecasting)."
     },
     {
-      "name": "get-customer-invoice-summary",
+      "name": "wallets-get-customer-wallets",
+      "description": "Get Customer Wallets\n\nUse when resolving wallets by external customer id or lookup key (e.g. from your app's user id). Supports optional real-time balance and expand."
+    },
+    {
+      "name": "wallets-get-wallets-by-customer-id",
+      "description": "Get wallets by customer ID\n\nUse when showing a customer's wallets (e.g. balance overview by currency or in a billing portal). Supports optional expand for balance breakdown."
+    },
+    {
+      "name": "wallets-create-wallet",
+      "description": "Create a new wallet\n\nUse when giving a customer a prepaid or credit balance (e.g. prepaid plans or promotional credits)."
+    },
+    {
+      "name": "wallets-query-wallet",
+      "description": "Query wallets\n\nUse when listing or searching wallets (e.g. admin view or reporting). Returns a paginated list; supports filtering by customer and status."
+    },
+    {
+      "name": "wallets-query-wallet-transaction",
+      "description": "Query wallet transactions\n\nUse when searching or reporting on wallet transactions (e.g. cross-wallet history or reconciliation). Returns a paginated list; supports filtering by wallet, customer, type, date range."
+    },
+    {
+      "name": "wallets-get-wallet",
+      "description": "Get wallet\n\nUse when you need to load a single wallet (e.g. for a balance or settings view)."
+    },
+    {
+      "name": "wallets-update-wallet",
+      "description": "Update a wallet\n\nUse when changing wallet settings (e.g. enabling or updating auto top-up thresholds)."
+    },
+    {
+      "name": "wallets-get-wallet-balance",
+      "description": "Get wallet balance\n\nUse when displaying or checking current wallet balance (e.g. before charging or in a portal). Supports optional expand for credits breakdown and from_cache."
+    },
+    {
+      "name": "wallets-terminate-wallet",
+      "description": "Terminate a wallet\n\nUse when closing a customer wallet (e.g. churn or migration). Closes the wallet and applies remaining balance per policy (refund or forfeit)."
+    },
+    {
+      "name": "wallets-top-up-wallet",
+      "description": "Top up wallet\n\nUse when adding funds to a wallet (e.g. top-up, refund, or manual credit). Supports optional idempotency via reference."
+    },
+    {
+      "name": "wallets-get-wallet-transactions",
+      "description": "Get wallet transactions\n\nUse when showing transaction history for a wallet (e.g. credit/debit log or audit). Returns a paginated list; supports limit, offset, and filters."
+    },
+    {
+      "name": "invoices-get-customer-invoice-summary",
       "description": "Get customer invoice summary\n\nUse when showing a customer's invoice overview (e.g. billing portal or balance summary). Includes totals and multi-currency breakdown."
     },
     {
-      "name": "create-invoice",
+      "name": "invoices-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."
     },
     {
-      "name": "get-invoice-preview",
+      "name": "invoices-get-invoice-preview",
       "description": "Get invoice preview\n\nUse when showing a customer what they will be charged (e.g. preview before checkout or plan change). No invoice is created."
     },
     {
-      "name": "query-invoice",
+      "name": "invoices-query-invoice",
       "description": "Query invoices\n\nUse when listing or searching invoices (e.g. admin view or customer history). Returns a paginated list; supports filtering by customer, status, date range."
     },
     {
-      "name": "get-invoice",
+      "name": "invoices-get-invoice",
       "description": "Get invoice\n\nUse when loading an invoice for display or editing (e.g. portal or reconciliation). Supports group_by for usage breakdown and force_runtime_recalculation."
     },
     {
-      "name": "update-invoice",
+      "name": "invoices-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."
     },
     {
-      "name": "trigger-invoice-comms-webhook",
+      "name": "invoices-trigger-invoice-comms-webhook",
       "description": "Trigger invoice communication webhook\n\nUse when sending an invoice to the customer (e.g. trigger email or Slack). Payload includes full invoice details for your integration."
     },
     {
-      "name": "finalize-invoice",
+      "name": "invoices-finalize-invoice",
       "description": "Finalize invoice\n\nUse when locking an invoice for payment (e.g. after review). Once finalized, line items are locked; invoice can be paid or voided."
     },
     {
-      "name": "update-invoice-payment-status",
+      "name": "invoices-update-invoice-payment-status",
       "description": "Update invoice payment status\n\nUse when reconciling payment status from an external gateway or manual entry (e.g. mark paid after bank confirmation)."
     },
     {
-      "name": "attempt-invoice-payment",
+      "name": "invoices-attempt-invoice-payment",
       "description": "Attempt invoice payment\n\nUse when paying an invoice with the customer's wallet balance (e.g. prepaid credits or balance applied at checkout)."
     },
     {
-      "name": "get-invoice-pdf",
+      "name": "invoices-get-invoice-pdf",
       "description": "Get invoice PDF\n\nUse when delivering an invoice PDF to the customer (e.g. email attachment or download). Use url=true for a presigned URL instead of binary."
     },
     {
-      "name": "recalculate-invoice",
+      "name": "invoices-recalculate-invoice",
       "description": "Recalculate invoice (voided invoice)\n\nStarts an async workflow that creates a fresh replacement invoice for a voided SUBSCRIPTION invoice (same billing period). Returns workflow_id and run_id; poll workflow status or GET the new invoice via recalculated_invoice_id after completion."
     },
     {
-      "name": "recalculate-invoice-v2",
+      "name": "invoices-recalculate-invoice-v2",
       "description": "Recalculate draft invoice (v2)\n\nRecalculates a draft SUBSCRIPTION invoice in-place (replaces line items, reapplies credits/coupons/taxes). Use when subscription or usage data changed before finalizing."
     },
     {
-      "name": "void-invoice",
+      "name": "invoices-void-invoice",
       "description": "Void invoice\n\nUse when cancelling an invoice (e.g. order cancelled or duplicate). Only unpaid invoices can be voided."
     },
     {
-      "name": "ingest-event",
+      "name": "entity-integration-mappings-create-entity-8da",
+      "description": "Create entity integration mapping\n\nUse when linking a FlexPrice entity to an external system (e.g. CRM or payment provider) so you can sync or reconcile by external ID."
+    },
+    {
+      "name": "entity-integration-mappings-delete-entity-a57",
+      "description": "Delete entity integration mapping\n\nUse when unlinking a FlexPrice entity from an external system or cleaning up stale integration mappings."
+    },
+    {
+      "name": "events-ingest-event",
       "description": "Ingest event\n\nUse when sending a single usage event from your app (e.g. one API call or one GB stored). Events are processed asynchronously; returns 202 with event_id."
     },
     {
-      "name": "get-usage-analytics",
+      "name": "events-get-usage-analytics",
       "description": "Get usage analytics\n\nUse when building analytics views (e.g. usage by feature or customer over time). Supports filtering, grouping, and time-series breakdown."
     },
     {
-      "name": "ingest-events-bulk",
+      "name": "events-ingest-events-bulk",
       "description": "Bulk ingest events\n\nUse when batching usage events (e.g. backfill or high-volume ingestion). More efficient than single event calls; returns 202 when accepted."
     },
     {
-      "name": "get-huggingface-inference-data",
+      "name": "events-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)."
     },
     {
-      "name": "list-raw-events",
+      "name": "events-list-raw-events",
       "description": "List raw events\n\nUse when debugging ingestion or exporting raw event data (e.g. support or audit). Returns a paginated list; supports time range and sorting."
     },
     {
-      "name": "get-usage-statistics",
+      "name": "events-get-usage-statistics",
       "description": "Get usage statistics\n\nUse when building usage reports or dashboards across events. Supports filters and grouping; defaults to last 7 days if no range provided."
     },
     {
-      "name": "get-usage-by-meter",
+      "name": "events-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",
+      "name": "events-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",
+      "name": "features-create-feature",
+      "description": "Create feature\n\nUse when defining a new feature or capability to gate or meter (e.g. feature flags or usage-based limits). Ideal for boolean or usage features."
+    },
+    {
+      "name": "features-query-feature",
+      "description": "Query features\n\nUse when listing or searching features (e.g. catalog or entitlement setup). Returns a paginated list; supports filtering and sorting."
+    },
+    {
+      "name": "features-update-feature",
+      "description": "Update feature\n\nUse when changing feature definition (e.g. name, type, or meter). Request body contains the fields to update."
+    },
+    {
+      "name": "features-delete-feature",
+      "description": "Delete feature\n\nUse when retiring a feature (e.g. deprecated capability). Returns 200 with success message."
+    },
+    {
+      "name": "groups-create-group",
+      "description": "Create group\n\nUse when organizing entities into a group (e.g. for filtering prices or plans by product line or region)."
+    },
+    {
+      "name": "groups-query-group",
+      "description": "Query groups\n\nUse when listing or searching groups (e.g. admin catalog). Returns a paginated list; supports filtering and sorting."
+    },
+    {
+      "name": "groups-get-group",
+      "description": "Get group\n\nUse when you need to load a single group (e.g. for display or to assign entities)."
+    },
+    {
+      "name": "groups-delete-group",
+      "description": "Delete group\n\nUse when removing a group and clearing its entity associations (e.g. retiring a product line). Returns 204 or 200 on success."
+    },
+    {
+      "name": "payments-list-payments",
+      "description": "List payments\n\nUse when listing or searching payments (e.g. reconciliation UI or customer payment history). Returns a paginated list; supports filtering by customer, invoice, status."
+    },
+    {
+      "name": "payments-create-payment",
+      "description": "Create payment\n\nUse when recording a payment against an invoice (e.g. after receiving funds via a gateway or manual entry)."
+    },
+    {
+      "name": "payments-get-payment",
+      "description": "Get payment\n\nUse when you need to load a single payment (e.g. for a receipt view or reconciliation)."
+    },
+    {
+      "name": "payments-update-payment",
+      "description": "Update payment\n\nUse when updating payment status or metadata (e.g. after reconciliation or adding a reference)."
+    },
+    {
+      "name": "payments-delete-payment",
+      "description": "Delete payment\n\nUse when removing or voiding a payment record (e.g. correcting erroneous entries). Returns 200 with success message."
+    },
+    {
+      "name": "payments-process-payment",
+      "description": "Process payment\n\nUse when you need to charge or process a payment (e.g. trigger the payment provider to capture funds). Returns updated payment with status."
+    },
+    {
+      "name": "plans-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."
     },
     {
-      "name": "query-plan",
+      "name": "plans-query-plan",
       "description": "Query plans\n\nUse when listing or searching plans (e.g. plan picker or admin catalog). Returns a paginated list; supports filtering and sorting."
     },
     {
-      "name": "get-plan",
+      "name": "plans-get-plan",
       "description": "Get plan\n\nUse when you need to load a single plan (e.g. for display or to create a subscription)."
     },
     {
-      "name": "update-plan",
+      "name": "plans-update-plan",
       "description": "Update plan\n\nUse when changing plan details (e.g. name, interval, or metadata). Partial update supported."
     },
     {
-      "name": "delete-plan",
+      "name": "plans-delete-plan",
       "description": "Delete plan\n\nUse when retiring a plan (e.g. end-of-life). Existing subscriptions may be affected. Returns 200 with success message."
     },
     {
@@ -199,36 +455,348 @@
       "description": "Clone a plan\n\nClone an existing plan, copying its active prices, published entitlements, and published credit grants"
     },
     {
-      "name": "sync-plan-prices",
+      "name": "plans-sync-plan-prices",
       "description": "Synchronize plan prices\n\nUse when you have changed plan prices and need to push them to all active subscriptions (e.g. global price update). Returns workflow ID."
     },
     {
-      "name": "create-price",
+      "name": "prices-create-price",
       "description": "Create price\n\nUse when adding a new price to a plan or catalog (e.g. per-seat, flat, or metered). Ideal for both simple and usage-based pricing."
     },
     {
-      "name": "create-prices-bulk",
+      "name": "prices-create-prices-bulk",
       "description": "Create prices in bulk\n\nUse when creating many prices at once (e.g. importing a catalog or setting up a plan with multiple tiers)."
     },
     {
-      "name": "get-price-by-lookup-key",
+      "name": "prices-get-price-by-lookup-key",
       "description": "Get price by lookup key\n\nUse when resolving a price by external id (e.g. from your catalog or CMS). Ideal for integrations."
     },
     {
-      "name": "query-price",
+      "name": "prices-query-price",
       "description": "Query prices\n\nUse when listing or searching prices (e.g. plan builder or catalog). Returns a paginated list; supports filtering and sorting."
     },
     {
-      "name": "get-price",
+      "name": "prices-get-price",
       "description": "Get price\n\nUse when you need to load a single price (e.g. for display or editing). Response includes expanded meter and price unit when applicable."
     },
     {
-      "name": "update-price",
+      "name": "prices-update-price",
       "description": "Update price\n\nUse when changing price configuration (e.g. amount, billing scheme, or metadata)."
     },
     {
-      "name": "delete-price",
+      "name": "prices-delete-price",
       "description": "Delete price\n\nUse when retiring a price (e.g. end-of-life or replacement). Optional effective date or cascade for subscriptions."
+    },
+    {
+      "name": "price-units-list-price-units",
+      "description": "List price units\n\nUse when listing price units (e.g. in a catalog or when creating prices). Returns a paginated list; supports status, sort, and pagination."
+    },
+    {
+      "name": "price-units-create-price-unit",
+      "description": "Create price unit\n\nUse when defining a new unit of measure for pricing (e.g. GB, API call, seat). Ideal for metered or usage-based prices."
+    },
+    {
+      "name": "price-units-get-price-unit-by-code",
+      "description": "Get price unit by code\n\nUse when resolving a price unit by code (e.g. from an external catalog or config). Ideal for integrations."
+    },
+    {
+      "name": "price-units-query-price-unit",
+      "description": "Query price units\n\nUse when searching or listing price units (e.g. admin catalog). Returns a paginated list; supports filtering and sorting."
+    },
+    {
+      "name": "price-units-get-price-unit",
+      "description": "Get price unit\n\nUse when you need to load a single price unit (e.g. for display or when creating a price)."
+    },
+    {
+      "name": "price-units-update-price-unit",
+      "description": "Update price unit\n\nUse when renaming or updating metadata for a price unit. Code is immutable once created."
+    },
+    {
+      "name": "price-units-delete-price-unit",
+      "description": "Delete price unit\n\nUse when removing a price unit that is no longer needed. Fails if any price references this unit."
+    },
+    {
+      "name": "rbac-list-rbac-roles",
+      "description": "List all RBAC roles\n\nUse when building role pickers or permission UIs. Returns all roles with permissions and descriptions."
+    },
+    {
+      "name": "rbac-get-rbac-role",
+      "description": "Get a specific RBAC role\n\nUse when you need to show or edit a single role (e.g. role detail page). Includes permissions, name, and description."
+    },
+    {
+      "name": "secrets-list-api-keys",
+      "description": "List API keys\n\nUse when listing API keys (e.g. admin view or rotating keys). Returns a paginated list."
+    },
+    {
+      "name": "secrets-create-api-key",
+      "description": "Create a new API key\n\nUse when issuing a new API key (e.g. for a service account or for the current user). Provide service_account_id to create for a service account."
+    },
+    {
+      "name": "secrets-delete-api-key",
+      "description": "Delete an API key\n\nUse when revoking an API key (e.g. rotation or compromise). Permanently invalidates the key."
+    },
+    {
+      "name": "integrations-get-integration",
+      "description": "Get integration details\n\nUse when you need to check or display integration config (e.g. which provider is linked). Sensitive values may be redacted."
+    },
+    {
+      "name": "integrations-create-or-update-integration",
+      "description": "Create or update an integration\n\nUse when storing or updating credentials for an external integration (e.g. Stripe, HubSpot). Secrets are encrypted at rest."
+    },
+    {
+      "name": "integrations-list-linked-integrations",
+      "description": "List linked integrations\n\nUse when showing which integrations are connected (e.g. settings page). Returns providers that have valid linked credentials."
+    },
+    {
+      "name": "integrations-delete-integration",
+      "description": "Delete an integration\n\nUse when disconnecting an integration (e.g. switching provider or removing OAuth). Deletes stored credentials."
+    },
+    {
+      "name": "subscriptions-create-subscription",
+      "description": "Create subscription\n\nUse when onboarding a customer to a plan or starting a new subscription. Ideal for draft subscriptions (activate later) or active from start."
+    },
+    {
+      "name": "subscriptions-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)."
+    },
+    {
+      "name": "subscriptions-remove-subscription-addon",
+      "description": "Remove addon from subscription\n\nUse when removing an add-on from a subscription (e.g. downgrade or opt-out)."
+    },
+    {
+      "name": "subscriptions-update-subscription-line-item",
+      "description": "Update subscription line item\n\nUse when changing a subscription line item (e.g. quantity or price). Implemented by ending the current line and creating a new one for clean billing."
+    },
+    {
+      "name": "subscriptions-delete-subscription-line-item",
+      "description": "Delete subscription line item\n\nUse when removing a charge or seat from a subscription (e.g. downgrade). Line item ends; retained for history but no longer billed."
+    },
+    {
+      "name": "subscriptions-query-subscription",
+      "description": "Query subscriptions\n\nUse when listing or searching subscriptions (e.g. admin view or customer subscription list). Returns a paginated list; supports filtering by customer, plan, status."
+    },
+    {
+      "name": "subscriptions-get-subscription-usage",
+      "description": "Get usage by subscription\n\nUse when showing usage for a subscription (e.g. in a portal or for overage checks). Supports time range and filters."
+    },
+    {
+      "name": "subscriptions-get-subscription",
+      "description": "Get subscription\n\nUse when you need to load a single subscription (e.g. for a billing portal or to check status)."
+    },
+    {
+      "name": "subscriptions-update-subscription",
+      "description": "Update subscription\n\nUse when changing subscription details (e.g. quantity, billing anchor, or parent). Supports partial update; send \"\" to clear parent_subscription_id."
+    },
+    {
+      "name": "subscriptions-activate-subscription",
+      "description": "Activate draft subscription\n\nUse when turning a draft subscription live (e.g. after collecting payment or completing setup). Once activated, billing and entitlements apply."
+    },
+    {
+      "name": "subscriptions-get-subscription-addon-associations",
+      "description": "Get active addon associations\n\nUse when listing which add-ons are currently attached to a subscription (e.g. for display or editing)."
+    },
+    {
+      "name": "subscriptions-cancel-subscription",
+      "description": "Cancel subscription\n\nUse when a customer churns or downgrades. Supports immediate or end-of-period cancellation and proration. Ideal for self-serve or support-driven cancellations."
+    },
+    {
+      "name": "subscriptions-execute-subscription-change",
+      "description": "Execute subscription plan change\n\nUse when applying a plan change (e.g. upgrade or downgrade). Executes proration and generates invoice or credit as needed."
+    },
+    {
+      "name": "subscriptions-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": "subscriptions-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."
+    },
+    {
+      "name": "subscriptions-get-subscription-upcoming-grants",
+      "description": "Get upcoming credit grant applications\n\nUse when showing upcoming or pending credits for a subscription (e.g. in a portal or for forecasting)."
+    },
+    {
+      "name": "subscriptions-create-subscription-line-item",
+      "description": "Create subscription line item\n\nUse when adding a new charge or seat to a subscription (e.g. extra seat or one-time add). Supports price_id or inline price."
+    },
+    {
+      "name": "subscriptions-pause-subscription",
+      "description": "Pause a subscription\n\nUse when temporarily stopping a subscription (e.g. customer hold or seasonal pause). Billing and access pause; resume when ready."
+    },
+    {
+      "name": "subscriptions-list-subscription-pauses",
+      "description": "List all pauses for a subscription\n\nUse when showing pause history for a subscription (e.g. support or audit). Returns all past and future pauses."
+    },
+    {
+      "name": "subscriptions-resume-subscription",
+      "description": "Resume a paused subscription\n\nUse when reactivating a paused subscription (e.g. end of hold). Billing and access resume from the resume date."
+    },
+    {
+      "name": "subscriptions-get-subscription-v2",
+      "description": "Get subscription (V2)\n\nUse when you need a subscription with related data (line items, prices, plan). Supports expand for detailed payloads without extra round-trips."
+    },
+    {
+      "name": "subscriptions-list-all-subscription-schedules",
+      "description": "List all subscription schedules\n\nUse when listing or searching scheduled changes across subscriptions (e.g. admin view). Returns schedules with optional filtering."
+    },
+    {
+      "name": "subscriptions-get-subscription-schedule",
+      "description": "Get subscription schedule\n\nUse when you need to load a single scheduled change (e.g. to show when a plan change or renewal takes effect)."
+    },
+    {
+      "name": "subscriptions-cancel-subscription-schedule",
+      "description": "Cancel subscription schedule\n\nUse when cancelling a scheduled change (e.g. customer changed mind). Identify by schedule ID in path or by subscription ID + schedule type in body."
+    },
+    {
+      "name": "subscriptions-list-subscription-schedules",
+      "description": "List subscription schedules\n\nUse when listing scheduled changes for a subscription (e.g. upcoming plan change or renewal). Returns all schedules for that subscription."
+    },
+    {
+      "name": "tasks-list-tasks",
+      "description": "List tasks\n\nUse when listing or searching async tasks (e.g. admin queue view). Returns list with optional filtering."
+    },
+    {
+      "name": "tasks-create-task",
+      "description": "Create a new task\n\nUse when submitting a file or job for async processing (e.g. export or import). Returns task ID to poll for status and result."
+    },
+    {
+      "name": "tasks-get-task-result",
+      "description": "Get task processing result\n\nUse when fetching the outcome of a completed task (e.g. export URL or error message). Call after task status is complete."
+    },
+    {
+      "name": "tasks-get-task",
+      "description": "Get a task\n\nUse when checking task status or progress (e.g. polling after create). Returns task by ID."
+    },
+    {
+      "name": "tasks-download-task-export",
+      "description": "Download task export file\n\nUse when letting a user download an exported file (e.g. report or data export). Returns a presigned URL; supports FlexPrice or customer-owned S3."
+    },
+    {
+      "name": "tasks-update-task-status",
+      "description": "Update task status\n\nUse when updating task status (e.g. marking complete or failed from a worker). Typically called by backend processors."
+    },
+    {
+      "name": "scheduled-tasks-list-scheduled-tasks",
+      "description": "List scheduled tasks\n\nUse when listing or managing scheduled tasks in an admin UI. Returns a list; supports filtering by status, type, and pagination."
+    },
+    {
+      "name": "scheduled-tasks-create-scheduled-task",
+      "description": "Create scheduled task\n\nUse when setting up recurring data exports or other scheduled jobs. Ideal for report generation or syncing data on a schedule."
+    },
+    {
+      "name": "scheduled-tasks-schedule-update-billing-period",
+      "description": "Schedule update billing period\n\nUse when you need to trigger a billing-period update workflow (e.g. to recalculate or sync billing windows)."
+    },
+    {
+      "name": "scheduled-tasks-get-scheduled-task",
+      "description": "Get scheduled task\n\nUse when you need to load a single scheduled task (e.g. to show details in a UI or check its configuration)."
+    },
+    {
+      "name": "scheduled-tasks-update-scheduled-task",
+      "description": "Update a scheduled task\n\nUse when pausing or resuming a scheduled task. Only the enabled field can be changed."
+    },
+    {
+      "name": "scheduled-tasks-delete-scheduled-task",
+      "description": "Delete a scheduled task\n\nUse when removing a scheduled task from the active roster. Archives the task and removes it from the scheduler (soft delete)."
+    },
+    {
+      "name": "scheduled-tasks-trigger-scheduled-task-run",
+      "description": "Trigger force run\n\nUse when you need to run a scheduled export immediately (e.g. on-demand report or catch-up). Supports optional custom time range."
+    },
+    {
+      "name": "tax-associations-list-tax-associations",
+      "description": "List tax associations\n\nUse when listing tax associations (e.g. tax config or audit). Returns list with optional filtering."
+    },
+    {
+      "name": "tax-associations-create-tax-association",
+      "description": "Create Tax Association\n\nUse when linking a tax rate to an entity (e.g. customer, product, or region) so that rate applies on invoices."
+    },
+    {
+      "name": "tax-associations-get-tax-association",
+      "description": "Get Tax Association\n\nUse when you need to load a single tax association (e.g. for display or editing)."
+    },
+    {
+      "name": "tax-associations-update-tax-association",
+      "description": "Update tax association\n\nUse when changing a tax association (e.g. switch rate or entity). Request body contains the fields to update."
+    },
+    {
+      "name": "tax-associations-delete-tax-association",
+      "description": "Delete tax association\n\nUse when removing a tax association (e.g. entity no longer subject to that rate)."
+    },
+    {
+      "name": "tax-rates-get-tax-rates",
+      "description": "Get tax rates\n\nUse when listing tax rates (e.g. tax config UI). Returns tax rates with optional filters."
+    },
+    {
+      "name": "tax-rates-create-tax-rate",
+      "description": "Create a tax rate\n\nUse when defining a new tax rate (e.g. VAT or sales tax) for use in invoices. Attach to customers or products via tax associations."
+    },
+    {
+      "name": "tax-rates-get-tax-rate",
+      "description": "Get a tax rate\n\nUse when you need to load a single tax rate (e.g. for display or when creating an association)."
+    },
+    {
+      "name": "tax-rates-update-tax-rate",
+      "description": "Update a tax rate\n\nUse when changing a tax rate (e.g. rate value or name). Request body contains the fields to update."
+    },
+    {
+      "name": "tax-rates-delete-tax-rate",
+      "description": "Delete a tax rate\n\nUse when retiring a tax rate (e.g. no longer applicable). Fails if still referenced by associations."
+    },
+    {
+      "name": "tenants-get-tenant-billing-usage",
+      "description": "Get billing usage for the current tenant\n\nUse when showing the current tenant's billing usage (e.g. admin billing page or usage caps). Returns subscription and usage for the tenant."
+    },
+    {
+      "name": "tenants-update-tenant",
+      "description": "Update a tenant\n\nUse when changing tenant details (e.g. name or billing info). Request body contains the fields to update."
+    },
+    {
+      "name": "tenants-get-tenant-by-id",
+      "description": "Get tenant by ID\n\nGet tenant by ID"
+    },
+    {
+      "name": "users-create-user",
+      "description": "Create user or service account\n\nCreate a user account (type=user, email required; returns user + password for login) or a service account (type=service_account, roles required) for API/automation access."
+    },
+    {
+      "name": "users-get-user-info",
+      "description": "Get current user\n\nUse to show the logged-in user's profile in the UI or to check permissions and roles for the current session."
+    },
+    {
+      "name": "users-query-user",
+      "description": "Query users\n\nUse when listing or searching service accounts in an admin UI, or when auditing who has API access and which roles they have."
+    },
+    {
+      "name": "webhooks-handle-chargebee-webhook",
+      "description": "Handle Chargebee webhook events\n\nUse as the Chargebee webhook endpoint URL. Receives payment and subscription events from Chargebee to sync status into FlexPrice."
+    },
+    {
+      "name": "webhooks-handle-hubspot-webhook",
+      "description": "Handle HubSpot webhook events\n\nUse as the HubSpot webhook endpoint URL. Receives deal and customer events (e.g. deal closed won) to create or update customers in FlexPrice."
+    },
+    {
+      "name": "webhooks-handle-moyasar-webhook",
+      "description": "Handle Moyasar webhook events\n\nUse as the Moyasar webhook endpoint URL. Receives payment events from Moyasar to update payment status in FlexPrice."
+    },
+    {
+      "name": "webhooks-handle-nomod-webhook",
+      "description": "Handle Nomod webhook events\n\nUse as the Nomod webhook endpoint URL. Receives payment and invoice events from Nomod to keep FlexPrice in sync."
+    },
+    {
+      "name": "webhooks-handle-quickbooks-webhook",
+      "description": "Handle QuickBooks webhook events\n\nUse as the QuickBooks webhook endpoint URL. Receives payment events from QuickBooks to sync payment status into FlexPrice."
+    },
+    {
+      "name": "webhooks-handle-razorpay-webhook",
+      "description": "Handle Razorpay webhook events\n\nUse as the Razorpay webhook endpoint URL. Receives payment capture and failure events to update invoice or payment status in FlexPrice."
+    },
+    {
+      "name": "webhooks-handle-stripe-webhook",
+      "description": "Handle Stripe webhook events\n\nUse as the Stripe webhook endpoint URL. Receives payment and customer events from Stripe to keep FlexPrice in sync (e.g. payment succeeded, customer created)."
+    },
+    {
+      "name": "workflows-query-workflow",
+      "description": "Query workflows\n\nUse when listing or auditing workflow runs (e.g. ops dashboard or debugging). Returns a paginated list; supports filtering by workflow type and status."
     }
   ]
 }