@metronome/mcp 0.3.0 → 2.0.0

package/tools/v1/contracts/create-v1-contracts.mjs

@@ -10,7 +10,7 @@ export const metadata = {
 };
 export const tool = {
     name: 'create_v1_contracts',
-    description: 'Create a new contract\n',
+    description: "Contracts define a customer's products, pricing, discounts, access duration, and billing configuration. Contracts serve as the central billing agreement for both PLG and Enterprise customers, you can automatically customers access to your products and services directly from your product or CRM.\n\n### Use this endpoint to:\n- PLG onboarding: Automatically provision new self-serve customers with contracts when they sign up.\n- Enterprise sales: Push negotiated contracts from Salesforce with custom pricing and commitments\n- Promotional pricing: Implement time-limited discounts and free trials through overrides\n\n### Key components:\n#### Contract Term and Billing Schedule\n- Set contract duration using `starting_at` and `ending_before` fields. PLG contracts typically use perpetual agreements (no end date), while Enterprise contracts have fixed end dates which can be edited over time in the case of co-term upsells.\n\n#### Rate Card\nIf you are offering usage based pricing, you can set a rate card for the contract to reference through `rate_card_id` or `rate_card_alias`. The rate card is a store of all of your usage based products and their centralized pricing. Any new products or price changes on the rate card can be set to automatically propagate to all associated contracts - this ensures consistent pricing and product launches flow to contracts without manual updates and migrations. The `usage_statement_schedule` determines the cadence on which Metronome will finalize a usage invoice for the customer. This defaults to monthly on the 1st, with options for custom dates, quarterly, or annual cadences. Note: Most usage based billing companies align usage statements to be evaluated aligned to the first of the month.\nRead more about [Rate Cards](https://docs.metronome.com/pricing-packaging/create-manage-rate-cards/).\n\n#### Overrides and discounts\nCustomize pricing on the contract through time-bounded overrides that can target specific products, product families, or complex usage scenarios. Overrides enable two key capabilities:\n- Discounts: Apply percentage discounts, fixed rate reductions, or quantity-based pricing tiers\n- Entitlements: Provide special pricing or access to specific products for negotiated deals\n\nRead more about [Contract Overrides](https://docs.metronome.com/manage-product-access/add-contract-override/).\n\n#### Commits and Credits\nUsing commits, configure prepaid or postpaid spending commitments where customers promise to spend a certain amount over the contract period paid in advance or in arrears. Use credits to provide free spending allowances. Under the hood these are the same mechanisms, however, credits are typically offered for free (SLA or promotional) or as a part of an allotment associated with a Subscription.\n\nIn Metronome, you can set commits and credits to only be applicable for a subset of usage. Use `applicable_product_ids` or `applicable_product_tags` to create product or product-family specific commits or credits, or you can build complex boolean logic specifiers to target usage based on pricing  and presentation group values using `override_specifiers`.\n\nThese objects can also also be configured to have a recurrence schedule to easily model customer packaging which includes recurring monthly or quarterly allotments.\n\nCommits support rollover settings (`rollover_fraction`) to transfer unused balances between contract periods, either entirely or as a percentage.\n\nRead more about [Credits and Commits](https://docs.metronome.com/pricing-packaging/apply-credits-commits/).\n\n#### Subscriptions\nYou can add a fixed recurring charge to a contract, like monthly licenses or seat-based fees, using the subscription charge. Subscription charges are defined on your rate card and you can select which subscription is applicable to add to each contract.         When you add a subscription to a contract you need to:\n- Define whether the subscription is paid for in-advance or in-arrears (`collection_schedule`)\n- Define the proration behavior (`proration`)\n- Specify an initial quantity (`initial_quantity`)\n- Define which subscription rate on the rate card should be used (`subscription_rate`)\n\nRead more about [Subscriptions](https://docs.metronome.com/manage-product-access/create-subscription/).\n\n#### Scheduled Charges\nSet up one-time, recurring, or entirely custom charges that occur on specific dates, separate from usage-based billing or commitments. These can be used to model non-recurring platform charges or professional services.\n\n#### Threshold Billing\nMetronome allows you to configure automatic billing triggers when customers reach spending thresholds to prevent fraud and manage risk. You can use `spend_threshold_configuration` to trigger an invoice to cover current charges whenever the threshold is reached or you can ensure the customer maintains a minimum prepaid balance using the `prepaid_balance_configuration`.\n\nRead more about [Spend Threshold](https://docs.metronome.com/manage-product-access/spend-thresholds/) and [Prepaid Balance Thresholds](https://docs.metronome.com/manage-product-access/prepaid-balance-thresholds/).\n\n### Usage guidelines:\n- You can always [Edit Contracts](https://docs.metronome.com/manage-product-access/edit-contract/) after it has been created, using the `editContract` endpoint. Metronome keeps track of all edits, both in the audit log and over the `getEditHistory` endpoint.\n- Customers in Metronome can have multiple concurrent contracts at one time. Use `usage_filters` to route the correct usage to each contract. [Read more about usage filters](https://docs.metronome.com/manage-product-access/provision-customer/#create-a-usage-filter).\n",
     inputSchema: {
         type: 'object',
         properties: {
@@ -107,6 +107,7 @@ export const tool = {
                         },
                         custom_fields: {
                             type: 'object',
+                            description: 'Custom fields to be added eg. { "key1": "value1", "key2": "value2" }',
                             additionalProperties: true,
                         },
                         description: {
@@ -114,51 +115,7 @@ export const tool = {
                             description: 'Used only in UI/API. It is not exposed to end customers.',
                         },
                         hierarchy_configuration: {
-                            type: 'object',
-                            description: 'Optional configuration for commit hierarchy access control',
-                            properties: {
-                                child_access: {
-                                    anyOf: [
-                                        {
-                                            type: 'object',
-                                            properties: {
-                                                type: {
-                                                    type: 'string',
-                                                    enum: ['ALL'],
-                                                },
-                                            },
-                                            required: ['type'],
-                                        },
-                                        {
-                                            type: 'object',
-                                            properties: {
-                                                type: {
-                                                    type: 'string',
-                                                    enum: ['NONE'],
-                                                },
-                                            },
-                                            required: ['type'],
-                                        },
-                                        {
-                                            type: 'object',
-                                            properties: {
-                                                contract_ids: {
-                                                    type: 'array',
-                                                    items: {
-                                                        type: 'string',
-                                                    },
-                                                },
-                                                type: {
-                                                    type: 'string',
-                                                    enum: ['CONTRACT_IDS'],
-                                                },
-                                            },
-                                            required: ['contract_ids', 'type'],
-                                        },
-                                    ],
-                                },
-                            },
-                            required: ['child_access'],
+                            $ref: '#/$defs/commit_hierarchy_configuration',
                         },
                         invoice_schedule: {
                             type: 'object',
@@ -294,7 +251,7 @@ export const tool = {
                                 tax_type: {
                                     type: 'string',
                                     description: 'Stripe tax is only supported for Stripe payment gateway. Select NONE if you do not wish Metronome to calculate tax on your behalf. Leaving this field blank will default to NONE.',
-                                    enum: ['NONE', 'STRIPE', 'ANROK', 'PRECALCULATED'],
+                                    enum: ['NONE', 'STRIPE', 'ANROK', 'AVALARA', 'PRECALCULATED'],
                                 },
                             },
                             required: ['payment_gate_type'],
@@ -315,28 +272,7 @@ export const tool = {
                             type: 'array',
                             description: "List of filters that determine what kind of customer usage draws down a commit or credit. A customer's usage needs to meet the condition of at least one of the specifiers to contribute to a commit's or credit's drawdown. This field cannot be used together with `applicable_product_ids` or `applicable_product_tags`.",
                             items: {
-                                type: 'object',
-                                properties: {
-                                    presentation_group_values: {
-                                        type: 'object',
-                                        additionalProperties: true,
-                                    },
-                                    pricing_group_values: {
-                                        type: 'object',
-                                        additionalProperties: true,
-                                    },
-                                    product_id: {
-                                        type: 'string',
-                                        description: 'If provided, the specifier will only apply to the product with the specified ID.',
-                                    },
-                                    product_tags: {
-                                        type: 'array',
-                                        description: 'If provided, the specifier will only apply to products with all the specified tags.',
-                                        items: {
-                                            type: 'string',
-                                        },
-                                    },
-                                },
+                                $ref: '#/$defs/commit_specifier_input',
                             },
                         },
                         temporary_id: {
@@ -404,6 +340,7 @@ export const tool = {
                         },
                         custom_fields: {
                             type: 'object',
+                            description: 'Custom fields to be added eg. { "key1": "value1", "key2": "value2" }',
                             additionalProperties: true,
                         },
                         description: {
@@ -411,51 +348,7 @@ export const tool = {
                             description: 'Used only in UI/API. It is not exposed to end customers.',
                         },
                         hierarchy_configuration: {
-                            type: 'object',
-                            description: 'Optional configuration for credit hierarchy access control',
-                            properties: {
-                                child_access: {
-                                    anyOf: [
-                                        {
-                                            type: 'object',
-                                            properties: {
-                                                type: {
-                                                    type: 'string',
-                                                    enum: ['ALL'],
-                                                },
-                                            },
-                                            required: ['type'],
-                                        },
-                                        {
-                                            type: 'object',
-                                            properties: {
-                                                type: {
-                                                    type: 'string',
-                                                    enum: ['NONE'],
-                                                },
-                                            },
-                                            required: ['type'],
-                                        },
-                                        {
-                                            type: 'object',
-                                            properties: {
-                                                contract_ids: {
-                                                    type: 'array',
-                                                    items: {
-                                                        type: 'string',
-                                                    },
-                                                },
-                                                type: {
-                                                    type: 'string',
-                                                    enum: ['CONTRACT_IDS'],
-                                                },
-                                            },
-                                            required: ['contract_ids', 'type'],
-                                        },
-                                    ],
-                                },
-                            },
-                            required: ['child_access'],
+                            $ref: '#/$defs/commit_hierarchy_configuration',
                         },
                         name: {
                             type: 'string',
@@ -477,28 +370,7 @@ export const tool = {
                             type: 'array',
                             description: "List of filters that determine what kind of customer usage draws down a commit or credit. A customer's usage needs to meet the condition of at least one of the specifiers to contribute to a commit's or credit's drawdown. This field cannot be used together with `applicable_product_ids` or `applicable_product_tags`.",
                             items: {
-                                type: 'object',
-                                properties: {
-                                    presentation_group_values: {
-                                        type: 'object',
-                                        additionalProperties: true,
-                                    },
-                                    pricing_group_values: {
-                                        type: 'object',
-                                        additionalProperties: true,
-                                    },
-                                    product_id: {
-                                        type: 'string',
-                                        description: 'If provided, the specifier will only apply to the product with the specified ID.',
-                                    },
-                                    product_tags: {
-                                        type: 'array',
-                                        description: 'If provided, the specifier will only apply to products with all the specified tags.',
-                                        items: {
-                                            type: 'string',
-                                        },
-                                    },
-                                },
+                                $ref: '#/$defs/commit_specifier_input',
                             },
                         },
                     },
@@ -507,6 +379,7 @@ export const tool = {
             },
             custom_fields: {
                 type: 'object',
+                description: 'Custom fields to be added eg. { "key1": "value1", "key2": "value2" }',
                 additionalProperties: true,
             },
             discounts: {
@@ -598,6 +471,7 @@ export const tool = {
                         },
                         custom_fields: {
                             type: 'object',
+                            description: 'Custom fields to be added eg. { "key1": "value1", "key2": "value2" }',
                             additionalProperties: true,
                         },
                         name: {
@@ -632,8 +506,27 @@ export const tool = {
                         },
                         required: ['contract_id', 'customer_id'],
                     },
+                    parent_behavior: {
+                        type: 'object',
+                        properties: {
+                            invoice_consolidation_type: {
+                                type: 'string',
+                                description: 'Indicates the desired behavior of consolidated invoices generated by the parent in a customer hierarchy\n**CONCATENATE**: Statements on the invoices of child customers will be appended to the consolidated invoice\n**NONE**: Do not generate consolidated invoices',
+                                enum: ['CONCATENATE', 'NONE'],
+                            },
+                        },
+                    },
+                    payer: {
+                        type: 'string',
+                        description: "Indicates whether the parent should pay for the child's invoice charges",
+                        enum: ['SELF', 'PARENT'],
+                    },
+                    usage_statement_behavior: {
+                        type: 'string',
+                        description: "Indicates the behavior of the child's invoice statements on the parent's invoices\n**CONSOLIDATE**: Child's invoice statements will be added to parent's consolidated invoices\n**SEPARATE**: Child's invoice statements will appear not appear on parent's consolidated invoices",
+                        enum: ['CONSOLIDATE', 'SEPARATE'],
+                    },
                 },
-                required: ['parent'],
             },
             multiplier_override_prioritization: {
                 type: 'string',
@@ -695,7 +588,7 @@ export const tool = {
                                     },
                                     commit_ids: {
                                         type: 'array',
-                                        description: 'Can only be used for commit specific overrides. Must be used in conjunction with one of product_id, product_tags, pricing_group_values, or presentation_group_values. If provided, the override will only apply to the specified commits. If not provided, the override will apply to all commits.',
+                                        description: 'Can only be used for commit specific overrides. Must be used in conjunction with one of `product_id`, `product_tags`, `pricing_group_values`, or `presentation_group_values`. If provided, the override will only apply to the specified commits. If not provided, the override will apply to all commits.',
                                         items: {
                                             type: 'string',
                                         },
@@ -723,14 +616,14 @@ export const tool = {
                                     },
                                     recurring_commit_ids: {
                                         type: 'array',
-                                        description: 'Can only be used for commit specific overrides. Must be used in conjunction with one of product_id, product_tags, pricing_group_values, or presentation_group_values. If provided, the override will only apply to commits created by the specified recurring commit ids.',
+                                        description: 'Can only be used for commit specific overrides. Must be used in conjunction with one of `product_id`, `product_tags`, `pricing_group_values`, or `presentation_group_values`. If provided, the override will only apply to commits created by the specified recurring commit ids.',
                                         items: {
                                             type: 'string',
                                         },
                                     },
                                     recurring_credit_ids: {
                                         type: 'array',
-                                        description: 'Can only be used for commit specific overrides. Must be used in conjunction with one of product_id, product_tags, pricing_group_values, or presentation_group_values. If provided, the override will only apply to credits created by the specified recurring credit ids.',
+                                        description: 'Can only be used for commit specific overrides. Must be used in conjunction with one of `product_id`, `product_tags`, `pricing_group_values`, or `presentation_group_values`. If provided, the override will only apply to credits created by the specified recurring credit ids.',
                                         items: {
                                             type: 'string',
                                         },
@@ -815,133 +708,7 @@ export const tool = {
                 },
             },
             prepaid_balance_threshold_configuration: {
-                type: 'object',
-                properties: {
-                    commit: {
-                        type: 'object',
-                        properties: {
-                            product_id: {
-                                type: 'string',
-                                description: 'The commit product that will be used to generate the line item for commit payment.',
-                            },
-                            applicable_product_ids: {
-                                type: 'array',
-                                description: 'Which products the threshold commit applies to. If applicable_product_ids, applicable_product_tags or specifiers are not provided, the commit applies to all products.',
-                                items: {
-                                    type: 'string',
-                                },
-                            },
-                            applicable_product_tags: {
-                                type: 'array',
-                                description: 'Which tags the threshold commit applies to. If applicable_product_ids, applicable_product_tags or specifiers are not provided, the commit applies to all products.',
-                                items: {
-                                    type: 'string',
-                                },
-                            },
-                            description: {
-                                type: 'string',
-                            },
-                            name: {
-                                type: 'string',
-                                description: 'Specify the name of the line item for the threshold charge. If left blank, it will default to the commit product name.',
-                            },
-                            specifiers: {
-                                type: 'array',
-                                description: "List of filters that determine what kind of customer usage draws down a commit or credit. A customer's usage needs to meet the condition of at least one of the specifiers to contribute to a commit's or credit's drawdown. This field cannot be used together with `applicable_product_ids` or `applicable_product_tags`.",
-                                items: {
-                                    type: 'object',
-                                    properties: {
-                                        presentation_group_values: {
-                                            type: 'object',
-                                            additionalProperties: true,
-                                        },
-                                        pricing_group_values: {
-                                            type: 'object',
-                                            additionalProperties: true,
-                                        },
-                                        product_id: {
-                                            type: 'string',
-                                            description: 'If provided, the specifier will only apply to the product with the specified ID.',
-                                        },
-                                        product_tags: {
-                                            type: 'array',
-                                            description: 'If provided, the specifier will only apply to products with all the specified tags.',
-                                            items: {
-                                                type: 'string',
-                                            },
-                                        },
-                                    },
-                                },
-                            },
-                        },
-                        required: ['product_id'],
-                    },
-                    is_enabled: {
-                        type: 'boolean',
-                        description: 'When set to false, the contract will not be evaluated against the threshold_amount. Toggling to true will result an immediate evaluation, regardless of prior state.',
-                    },
-                    payment_gate_config: {
-                        type: 'object',
-                        properties: {
-                            payment_gate_type: {
-                                type: 'string',
-                                description: 'Gate access to the commit balance based on successful collection of payment. Select STRIPE for Metronome to facilitate payment via Stripe. Select EXTERNAL to facilitate payment using your own payment integration. Select NONE if you do not wish to payment gate the commit balance.',
-                                enum: ['NONE', 'STRIPE', 'EXTERNAL'],
-                            },
-                            precalculated_tax_config: {
-                                type: 'object',
-                                description: 'Only applicable if using PRECALCULATED as your tax type.',
-                                properties: {
-                                    tax_amount: {
-                                        type: 'number',
-                                        description: "Amount of tax to be applied. This should be in the same currency and denomination  as the commit's invoice schedule",
-                                    },
-                                    tax_name: {
-                                        type: 'string',
-                                        description: 'Name of the tax to be applied. This may be used in an invoice line item description.',
-                                    },
-                                },
-                                required: ['tax_amount'],
-                            },
-                            stripe_config: {
-                                type: 'object',
-                                description: 'Only applicable if using STRIPE as your payment gate type.',
-                                properties: {
-                                    payment_type: {
-                                        type: 'string',
-                                        description: 'If left blank, will default to INVOICE',
-                                        enum: ['INVOICE', 'PAYMENT_INTENT'],
-                                    },
-                                    invoice_metadata: {
-                                        type: 'object',
-                                        description: 'Metadata to be added to the Stripe invoice. Only applicable if using INVOICE as your payment type.',
-                                        additionalProperties: true,
-                                    },
-                                },
-                                required: ['payment_type'],
-                            },
-                            tax_type: {
-                                type: 'string',
-                                description: 'Stripe tax is only supported for Stripe payment gateway. Select NONE if you do not wish Metronome to calculate tax on your behalf. Leaving this field blank will default to NONE.',
-                                enum: ['NONE', 'STRIPE', 'ANROK', 'PRECALCULATED'],
-                            },
-                        },
-                        required: ['payment_gate_type'],
-                    },
-                    recharge_to_amount: {
-                        type: 'number',
-                        description: 'Specify the amount the balance should be recharged to.',
-                    },
-                    threshold_amount: {
-                        type: 'number',
-                        description: "Specify the threshold amount for the contract. Each time the contract's prepaid balance lowers to this amount, a threshold charge will be initiated.",
-                    },
-                    custom_credit_type_id: {
-                        type: 'string',
-                        description: 'If provided, the threshold, recharge-to amount, and the resulting threshold commit amount will be in terms of this credit type instead of the fiat currency.',
-                    },
-                },
-                required: ['commit', 'is_enabled', 'payment_gate_config', 'recharge_to_amount', 'threshold_amount'],
+                $ref: '#/$defs/prepaid_balance_threshold_configuration',
             },
             priority: {
                 type: 'number',
@@ -970,6 +737,7 @@ export const tool = {
                         },
                         custom_fields: {
                             type: 'object',
+                            description: 'Custom fields to be added eg. { "key1": "value1", "key2": "value2" }',
                             additionalProperties: true,
                         },
                         description: {
@@ -1062,51 +830,7 @@ export const tool = {
                             format: 'date-time',
                         },
                         hierarchy_configuration: {
-                            type: 'object',
-                            description: 'Optional configuration for recurring commit/credit hierarchy access control',
-                            properties: {
-                                child_access: {
-                                    anyOf: [
-                                        {
-                                            type: 'object',
-                                            properties: {
-                                                type: {
-                                                    type: 'string',
-                                                    enum: ['ALL'],
-                                                },
-                                            },
-                                            required: ['type'],
-                                        },
-                                        {
-                                            type: 'object',
-                                            properties: {
-                                                type: {
-                                                    type: 'string',
-                                                    enum: ['NONE'],
-                                                },
-                                            },
-                                            required: ['type'],
-                                        },
-                                        {
-                                            type: 'object',
-                                            properties: {
-                                                contract_ids: {
-                                                    type: 'array',
-                                                    items: {
-                                                        type: 'string',
-                                                    },
-                                                },
-                                                type: {
-                                                    type: 'string',
-                                                    enum: ['CONTRACT_IDS'],
-                                                },
-                                            },
-                                            required: ['contract_ids', 'type'],
-                                        },
-                                    ],
-                                },
-                            },
-                            required: ['child_access'],
+                            $ref: '#/$defs/commit_hierarchy_configuration',
                         },
                         invoice_amount: {
                             type: 'object',
@@ -1155,28 +879,7 @@ export const tool = {
                             type: 'array',
                             description: "List of filters that determine what kind of customer usage draws down a commit or credit. A customer's usage needs to meet the condition of at least one of the specifiers to contribute to a commit's or credit's drawdown. This field cannot be used together with `applicable_product_ids` or `applicable_product_tags`.",
                             items: {
-                                type: 'object',
-                                properties: {
-                                    presentation_group_values: {
-                                        type: 'object',
-                                        additionalProperties: true,
-                                    },
-                                    pricing_group_values: {
-                                        type: 'object',
-                                        additionalProperties: true,
-                                    },
-                                    product_id: {
-                                        type: 'string',
-                                        description: 'If provided, the specifier will only apply to the product with the specified ID.',
-                                    },
-                                    product_tags: {
-                                        type: 'array',
-                                        description: 'If provided, the specifier will only apply to products with all the specified tags.',
-                                        items: {
-                                            type: 'string',
-                                        },
-                                    },
-                                },
+                                $ref: '#/$defs/commit_specifier_input',
                             },
                         },
                         subscription_config: {
@@ -1200,7 +903,7 @@ export const tool = {
                                 allocation: {
                                     type: 'string',
                                     description: 'If set to POOLED, allocation added per seat is pooled across the account.',
-                                    enum: ['POOLED'],
+                                    enum: ['INDIVIDUAL', 'POOLED'],
                                 },
                             },
                             required: ['apply_seat_increase_config', 'subscription_id'],
@@ -1285,51 +988,7 @@ export const tool = {
                             format: 'date-time',
                         },
                         hierarchy_configuration: {
-                            type: 'object',
-                            description: 'Optional configuration for recurring commit/credit hierarchy access control',
-                            properties: {
-                                child_access: {
-                                    anyOf: [
-                                        {
-                                            type: 'object',
-                                            properties: {
-                                                type: {
-                                                    type: 'string',
-                                                    enum: ['ALL'],
-                                                },
-                                            },
-                                            required: ['type'],
-                                        },
-                                        {
-                                            type: 'object',
-                                            properties: {
-                                                type: {
-                                                    type: 'string',
-                                                    enum: ['NONE'],
-                                                },
-                                            },
-                                            required: ['type'],
-                                        },
-                                        {
-                                            type: 'object',
-                                            properties: {
-                                                contract_ids: {
-                                                    type: 'array',
-                                                    items: {
-                                                        type: 'string',
-                                                    },
-                                                },
-                                                type: {
-                                                    type: 'string',
-                                                    enum: ['CONTRACT_IDS'],
-                                                },
-                                            },
-                                            required: ['contract_ids', 'type'],
-                                        },
-                                    ],
-                                },
-                            },
-                            required: ['child_access'],
+                            $ref: '#/$defs/commit_hierarchy_configuration',
                         },
                         name: {
                             type: 'string',
@@ -1362,28 +1021,7 @@ export const tool = {
                             type: 'array',
                             description: "List of filters that determine what kind of customer usage draws down a commit or credit. A customer's usage needs to meet the condition of at least one of the specifiers to contribute to a commit's or credit's drawdown. This field cannot be used together with `applicable_product_ids` or `applicable_product_tags`.",
                             items: {
-                                type: 'object',
-                                properties: {
-                                    presentation_group_values: {
-                                        type: 'object',
-                                        additionalProperties: true,
-                                    },
-                                    pricing_group_values: {
-                                        type: 'object',
-                                        additionalProperties: true,
-                                    },
-                                    product_id: {
-                                        type: 'string',
-                                        description: 'If provided, the specifier will only apply to the product with the specified ID.',
-                                    },
-                                    product_tags: {
-                                        type: 'array',
-                                        description: 'If provided, the specifier will only apply to products with all the specified tags.',
-                                        items: {
-                                            type: 'string',
-                                        },
-                                    },
-                                },
+                                $ref: '#/$defs/commit_specifier_input',
                             },
                         },
                         subscription_config: {
@@ -1407,7 +1045,7 @@ export const tool = {
                                 allocation: {
                                     type: 'string',
                                     description: 'If set to POOLED, allocation added per seat is pooled across the account.',
-                                    enum: ['POOLED'],
+                                    enum: ['INDIVIDUAL', 'POOLED'],
                                 },
                             },
                             required: ['apply_seat_increase_config', 'subscription_id'],
@@ -1582,6 +1220,7 @@ export const tool = {
                         },
                         custom_fields: {
                             type: 'object',
+                            description: 'Custom fields to be added eg. { "key1": "value1", "key2": "value2" }',
                             additionalProperties: true,
                         },
                         name: {
@@ -1602,83 +1241,7 @@ export const tool = {
                 enum: ['ALL'],
             },
             spend_threshold_configuration: {
-                type: 'object',
-                properties: {
-                    commit: {
-                        type: 'object',
-                        properties: {
-                            product_id: {
-                                type: 'string',
-                                description: 'The commit product that will be used to generate the line item for commit payment.',
-                            },
-                            description: {
-                                type: 'string',
-                            },
-                            name: {
-                                type: 'string',
-                                description: 'Specify the name of the line item for the threshold charge. If left blank, it will default to the commit product name.',
-                            },
-                        },
-                        required: ['product_id'],
-                    },
-                    is_enabled: {
-                        type: 'boolean',
-                        description: 'When set to false, the contract will not be evaluated against the threshold_amount. Toggling to true will result an immediate evaluation, regardless of prior state.',
-                    },
-                    payment_gate_config: {
-                        type: 'object',
-                        properties: {
-                            payment_gate_type: {
-                                type: 'string',
-                                description: 'Gate access to the commit balance based on successful collection of payment. Select STRIPE for Metronome to facilitate payment via Stripe. Select EXTERNAL to facilitate payment using your own payment integration. Select NONE if you do not wish to payment gate the commit balance.',
-                                enum: ['NONE', 'STRIPE', 'EXTERNAL'],
-                            },
-                            precalculated_tax_config: {
-                                type: 'object',
-                                description: 'Only applicable if using PRECALCULATED as your tax type.',
-                                properties: {
-                                    tax_amount: {
-                                        type: 'number',
-                                        description: "Amount of tax to be applied. This should be in the same currency and denomination  as the commit's invoice schedule",
-                                    },
-                                    tax_name: {
-                                        type: 'string',
-                                        description: 'Name of the tax to be applied. This may be used in an invoice line item description.',
-                                    },
-                                },
-                                required: ['tax_amount'],
-                            },
-                            stripe_config: {
-                                type: 'object',
-                                description: 'Only applicable if using STRIPE as your payment gate type.',
-                                properties: {
-                                    payment_type: {
-                                        type: 'string',
-                                        description: 'If left blank, will default to INVOICE',
-                                        enum: ['INVOICE', 'PAYMENT_INTENT'],
-                                    },
-                                    invoice_metadata: {
-                                        type: 'object',
-                                        description: 'Metadata to be added to the Stripe invoice. Only applicable if using INVOICE as your payment type.',
-                                        additionalProperties: true,
-                                    },
-                                },
-                                required: ['payment_type'],
-                            },
-                            tax_type: {
-                                type: 'string',
-                                description: 'Stripe tax is only supported for Stripe payment gateway. Select NONE if you do not wish Metronome to calculate tax on your behalf. Leaving this field blank will default to NONE.',
-                                enum: ['NONE', 'STRIPE', 'ANROK', 'PRECALCULATED'],
-                            },
-                        },
-                        required: ['payment_gate_type'],
-                    },
-                    threshold_amount: {
-                        type: 'number',
-                        description: "Specify the threshold amount for the contract. Each time the contract's usage hits this amount, a threshold charge will be initiated.",
-                    },
-                },
-                required: ['commit', 'is_enabled', 'payment_gate_config', 'threshold_amount'],
+                $ref: '#/$defs/spend_threshold_configuration',
             },
             subscriptions: {
                 type: 'array',
@@ -1690,10 +1253,6 @@ export const tool = {
                             type: 'string',
                             enum: ['ADVANCE', 'ARREARS'],
                         },
-                        initial_quantity: {
-                            type: 'number',
-                            description: 'The initial quantity for the subscription. It must be non-negative value.',
-                        },
                         proration: {
                             type: 'object',
                             properties: {
@@ -1725,6 +1284,7 @@ export const tool = {
                         },
                         custom_fields: {
                             type: 'object',
+                            description: 'Custom fields to be added eg. { "key1": "value1", "key2": "value2" }',
                             additionalProperties: true,
                         },
                         description: {
@@ -1735,9 +1295,18 @@ export const tool = {
                             description: 'Exclusive end time for the subscription. If not provided, subscription inherits contract end date.',
                             format: 'date-time',
                         },
+                        initial_quantity: {
+                            type: 'number',
+                            description: 'The initial quantity for the subscription. It must be non-negative value. Required if quantity_management_mode is QUANTITY_ONLY.',
+                        },
                         name: {
                             type: 'string',
                         },
+                        quantity_management_mode: {
+                            type: 'string',
+                            description: "Determines how the subscription's quantity is controlled. Defaults to QUANTITY_ONLY. **QUANTITY_ONLY**: The subscription quantity is specified directly on the subscription. `initial_quantity` must be provided with this option. Compatible with recurring commits/credits that use POOLED allocation.",
+                            enum: ['SEAT_BASED', 'QUANTITY_ONLY'],
+                        },
                         starting_at: {
                             type: 'string',
                             description: 'Inclusive start time for the subscription. If not provided, defaults to contract start date',
@@ -1748,7 +1317,7 @@ export const tool = {
                             description: 'A temporary ID used to reference the subscription in recurring commit/credit subscription configs created within the same payload.',
                         },
                     },
-                    required: ['collection_schedule', 'initial_quantity', 'proration', 'subscription_rate'],
+                    required: ['collection_schedule', 'proration', 'subscription_rate'],
                 },
             },
             total_contract_value: {
@@ -1814,6 +1383,76 @@ export const tool = {
         },
         required: ['customer_id', 'starting_at'],
         $defs: {
+            commit_hierarchy_configuration: {
+                type: 'object',
+                properties: {
+                    child_access: {
+                        anyOf: [
+                            {
+                                type: 'object',
+                                properties: {
+                                    type: {
+                                        type: 'string',
+                                        enum: ['ALL'],
+                                    },
+                                },
+                                required: ['type'],
+                            },
+                            {
+                                type: 'object',
+                                properties: {
+                                    type: {
+                                        type: 'string',
+                                        enum: ['NONE'],
+                                    },
+                                },
+                                required: ['type'],
+                            },
+                            {
+                                type: 'object',
+                                properties: {
+                                    contract_ids: {
+                                        type: 'array',
+                                        items: {
+                                            type: 'string',
+                                        },
+                                    },
+                                    type: {
+                                        type: 'string',
+                                        enum: ['CONTRACT_IDS'],
+                                    },
+                                },
+                                required: ['contract_ids', 'type'],
+                            },
+                        ],
+                    },
+                },
+                required: ['child_access'],
+            },
+            commit_specifier_input: {
+                type: 'object',
+                properties: {
+                    presentation_group_values: {
+                        type: 'object',
+                        additionalProperties: true,
+                    },
+                    pricing_group_values: {
+                        type: 'object',
+                        additionalProperties: true,
+                    },
+                    product_id: {
+                        type: 'string',
+                        description: 'If provided, the specifier will only apply to the product with the specified ID.',
+                    },
+                    product_tags: {
+                        type: 'array',
+                        description: 'If provided, the specifier will only apply to products with all the specified tags.',
+                        items: {
+                            type: 'string',
+                        },
+                    },
+                },
+            },
             tier: {
                 type: 'object',
                 properties: {
@@ -1826,6 +1465,123 @@ export const tool = {
                 },
                 required: ['price'],
             },
+            prepaid_balance_threshold_configuration: {
+                type: 'object',
+                properties: {
+                    commit: {
+                        allOf: [
+                            {
+                                $ref: '#/$defs/base_threshold_commit',
+                            },
+                        ],
+                    },
+                    is_enabled: {
+                        type: 'boolean',
+                        description: 'When set to false, the contract will not be evaluated against the threshold_amount. Toggling to true will result an immediate evaluation, regardless of prior state.',
+                    },
+                    payment_gate_config: {
+                        $ref: '#/$defs/payment_gate_config',
+                    },
+                    recharge_to_amount: {
+                        type: 'number',
+                        description: 'Specify the amount the balance should be recharged to.',
+                    },
+                    threshold_amount: {
+                        type: 'number',
+                        description: "Specify the threshold amount for the contract. Each time the contract's prepaid balance lowers to this amount, a threshold charge will be initiated.",
+                    },
+                    custom_credit_type_id: {
+                        type: 'string',
+                        description: 'If provided, the threshold, recharge-to amount, and the resulting threshold commit amount will be in terms of this credit type instead of the fiat currency.',
+                    },
+                },
+                required: ['commit', 'is_enabled', 'payment_gate_config', 'recharge_to_amount', 'threshold_amount'],
+            },
+            base_threshold_commit: {
+                type: 'object',
+                properties: {
+                    product_id: {
+                        type: 'string',
+                        description: 'The commit product that will be used to generate the line item for commit payment.',
+                    },
+                    description: {
+                        type: 'string',
+                    },
+                    name: {
+                        type: 'string',
+                        description: 'Specify the name of the line item for the threshold charge. If left blank, it will default to the commit product name.',
+                    },
+                },
+                required: ['product_id'],
+            },
+            payment_gate_config: {
+                type: 'object',
+                properties: {
+                    payment_gate_type: {
+                        type: 'string',
+                        description: 'Gate access to the commit balance based on successful collection of payment. Select STRIPE for Metronome to facilitate payment via Stripe. Select EXTERNAL to facilitate payment using your own payment integration. Select NONE if you do not wish to payment gate the commit balance.',
+                        enum: ['NONE', 'STRIPE', 'EXTERNAL'],
+                    },
+                    precalculated_tax_config: {
+                        type: 'object',
+                        description: 'Only applicable if using PRECALCULATED as your tax type.',
+                        properties: {
+                            tax_amount: {
+                                type: 'number',
+                                description: "Amount of tax to be applied. This should be in the same currency and denomination  as the commit's invoice schedule",
+                            },
+                            tax_name: {
+                                type: 'string',
+                                description: 'Name of the tax to be applied. This may be used in an invoice line item description.',
+                            },
+                        },
+                        required: ['tax_amount'],
+                    },
+                    stripe_config: {
+                        type: 'object',
+                        description: 'Only applicable if using STRIPE as your payment gate type.',
+                        properties: {
+                            payment_type: {
+                                type: 'string',
+                                description: 'If left blank, will default to INVOICE',
+                                enum: ['INVOICE', 'PAYMENT_INTENT'],
+                            },
+                            invoice_metadata: {
+                                type: 'object',
+                                description: 'Metadata to be added to the Stripe invoice. Only applicable if using INVOICE as your payment type.',
+                                additionalProperties: true,
+                            },
+                        },
+                        required: ['payment_type'],
+                    },
+                    tax_type: {
+                        type: 'string',
+                        description: 'Stripe tax is only supported for Stripe payment gateway. Select NONE if you do not wish Metronome to calculate tax on your behalf. Leaving this field blank will default to NONE.',
+                        enum: ['NONE', 'STRIPE', 'ANROK', 'AVALARA', 'PRECALCULATED'],
+                    },
+                },
+                required: ['payment_gate_type'],
+            },
+            spend_threshold_configuration: {
+                type: 'object',
+                properties: {
+                    commit: {
+                        $ref: '#/$defs/base_threshold_commit',
+                    },
+                    is_enabled: {
+                        type: 'boolean',
+                        description: 'When set to false, the contract will not be evaluated against the threshold_amount. Toggling to true will result an immediate evaluation, regardless of prior state.',
+                    },
+                    payment_gate_config: {
+                        $ref: '#/$defs/payment_gate_config',
+                    },
+                    threshold_amount: {
+                        type: 'number',
+                        description: "Specify the threshold amount for the contract. Each time the contract's usage hits this amount, a threshold charge will be initiated.",
+                    },
+                },
+                required: ['commit', 'is_enabled', 'payment_gate_config', 'threshold_amount'],
+            },
             base_usage_filter: {
                 type: 'object',
                 properties: {