@metronome/mcp 0.3.0 → 2.0.0

package/tools/v2/contracts/edit-v2-contracts.js

@@ -13,7 +13,7 @@ exports.metadata = {
 };
 exports.tool = {
     name: 'edit_v2_contracts',
-    description: 'Edit a contract. Contract editing must be enabled to use this endpoint.',
+    description: 'The ability to edit a contract helps you react quickly to the needs of your customers and your business.\n\n### Use this endpoint to:\n- Encode mid-term commitment and discount changes\n- Fix configuration mistakes and easily roll back packaging changes\n\n### Key response fields:\n- The `id` of the edit\n- Complete edit details. For example, if you edited the contract to add new overrides and credits, you will receive the IDs of those overrides and credits in the response.\n\n### Usage guidelines:\n- When you edit a contract, any draft invoices update immediately to reflect that edit. Finalized invoices remain unchanged - you must void and regenerate them in the UI or API to reflect the edit.\n- Contract editing must be enabled to use this endpoint. Reach out to your Metronome representative to learn more.\n',
     inputSchema: {
         type: 'object',
         properties: {
@@ -25,6 +25,50 @@ exports.tool = {
                 type: 'string',
                 description: 'ID of the customer whose contract is being edited',
             },
+            add_billing_provider_configuration_update: {
+                type: 'object',
+                description: 'Update the billing provider configuration on the contract. Currently only supports adding a billing provider configuration to a contract that does not already have one.',
+                properties: {
+                    billing_provider_configuration: {
+                        type: 'object',
+                        properties: {
+                            billing_provider: {
+                                type: 'string',
+                                enum: [
+                                    'aws_marketplace',
+                                    'stripe',
+                                    'netsuite',
+                                    'custom',
+                                    'azure_marketplace',
+                                    'quickbooks_online',
+                                    'workday',
+                                    'gcp_marketplace',
+                                ],
+                            },
+                            billing_provider_configuration_id: {
+                                type: 'string',
+                            },
+                            delivery_method: {
+                                type: 'string',
+                                enum: ['direct_to_billing_provider', 'aws_sqs', 'tackle', 'aws_sns'],
+                            },
+                        },
+                    },
+                    schedule: {
+                        type: 'object',
+                        description: 'Indicates when the billing provider will be active on the contract. Any charges accrued during the schedule will be billed to the indicated billing provider.',
+                        properties: {
+                            effective_at: {
+                                type: 'string',
+                                description: 'When the billing provider update will take effect.',
+                                enum: ['START_OF_CURRENT_PERIOD'],
+                            },
+                        },
+                        required: ['effective_at'],
+                    },
+                },
+                required: ['billing_provider_configuration', 'schedule'],
+            },
             add_commits: {
                 type: 'array',
                 items: {
@@ -89,6 +133,7 @@ exports.tool = {
                         },
                         custom_fields: {
                             type: 'object',
+                            description: 'Custom fields to be added eg. { "key1": "value1", "key2": "value2" }',
                             additionalProperties: true,
                         },
                         description: {
@@ -96,51 +141,7 @@ exports.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',
@@ -276,7 +277,7 @@ exports.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'],
@@ -297,28 +298,7 @@ exports.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`. Instead, to target usage by product or product tag, pass those values in the body of `specifiers`.",
                             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: {
@@ -385,6 +365,7 @@ exports.tool = {
                         },
                         custom_fields: {
                             type: 'object',
+                            description: 'Custom fields to be added eg. { "key1": "value1", "key2": "value2" }',
                             additionalProperties: true,
                         },
                         description: {
@@ -392,51 +373,7 @@ exports.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',
@@ -458,28 +395,7 @@ exports.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`. Instead, to target usage by product or product tag, pass those values in the body of `specifiers`.",
                             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',
                             },
                         },
                     },
@@ -574,6 +490,7 @@ exports.tool = {
                         },
                         custom_fields: {
                             type: 'object',
+                            description: 'Custom fields to be added eg. { "key1": "value1", "key2": "value2" }',
                             additionalProperties: true,
                         },
                         name: {
@@ -753,133 +670,7 @@ exports.tool = {
                 },
             },
             add_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`. Instead, to target usage by product or product tag, pass those values in the body of `specifiers`.",
-                                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 gateway 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 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_v2',
             },
             add_professional_services: {
                 type: 'array',
@@ -904,6 +695,7 @@ exports.tool = {
                         },
                         custom_fields: {
                             type: 'object',
+                            description: 'Custom fields to be added eg. { "key1": "value1", "key2": "value2" }',
                             additionalProperties: true,
                         },
                         description: {
@@ -989,51 +781,7 @@ exports.tool = {
                             format: 'date-time',
                         },
                         hierarchy_configuration: {
-                            type: 'object',
-                            description: 'Optional configuration for recurring 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',
@@ -1082,28 +830,7 @@ exports.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`. Instead, to target usage by product or product tag, pass those values in the body of `specifiers`.",
                             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: {
@@ -1127,7 +854,7 @@ exports.tool = {
                                 allocation: {
                                     type: 'string',
                                     description: 'If set to POOLED, allocation added per seat is pooled across the account.',
-                                    enum: ['POOLED'],
+                                    enum: ['POOLED', 'INDIVIDUAL'],
                                 },
                             },
                             required: ['apply_seat_increase_config', 'subscription_id'],
@@ -1212,51 +939,7 @@ exports.tool = {
                             format: 'date-time',
                         },
                         hierarchy_configuration: {
-                            type: 'object',
-                            description: 'Optional configuration for recurring 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',
@@ -1289,28 +972,7 @@ exports.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`. Instead, to target usage by product or product tag, pass those values in the body of `specifiers`.",
                             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: {
@@ -1334,7 +996,7 @@ exports.tool = {
                                 allocation: {
                                     type: 'string',
                                     description: 'If set to POOLED, allocation added per seat is pooled across the account.',
-                                    enum: ['POOLED'],
+                                    enum: ['POOLED', 'INDIVIDUAL'],
                                 },
                             },
                             required: ['apply_seat_increase_config', 'subscription_id'],
@@ -1505,6 +1167,7 @@ exports.tool = {
                         },
                         custom_fields: {
                             type: 'object',
+                            description: 'Custom fields to be added eg. { "key1": "value1", "key2": "value2" }',
                             additionalProperties: true,
                         },
                         name: {
@@ -1520,96 +1183,17 @@ exports.tool = {
                 },
             },
             add_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 gateway 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'],
-            },
-            add_subscriptions: {
-                type: 'array',
-                description: 'Optional list of [subscriptions](https://docs.metronome.com/manage-product-access/create-subscription/) to add to the contract.',
-                items: {
-                    type: 'object',
-                    properties: {
-                        collection_schedule: {
-                            type: 'string',
-                            enum: ['ADVANCE', 'ARREARS'],
-                        },
-                        initial_quantity: {
-                            type: 'number',
+                $ref: '#/$defs/spend_threshold_configuration_v2',
+            },
+            add_subscriptions: {
+                type: 'array',
+                description: 'Optional list of [subscriptions](https://docs.metronome.com/manage-product-access/create-subscription/) to add to the contract.',
+                items: {
+                    type: 'object',
+                    properties: {
+                        collection_schedule: {
+                            type: 'string',
+                            enum: ['ADVANCE', 'ARREARS'],
                         },
                         proration: {
                             type: 'object',
@@ -1642,6 +1226,7 @@ exports.tool = {
                         },
                         custom_fields: {
                             type: 'object',
+                            description: 'Custom fields to be added eg. { "key1": "value1", "key2": "value2" }',
                             additionalProperties: true,
                         },
                         description: {
@@ -1652,9 +1237,18 @@ exports.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',
@@ -1665,7 +1259,7 @@ exports.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'],
                 },
             },
             allow_contract_ending_before_finalized_invoice: {
@@ -1724,6 +1318,10 @@ exports.tool = {
                     required: ['id'],
                 },
             },
+            uniqueness_key: {
+                type: 'string',
+                description: 'Optional uniqueness key to prevent duplicate contract edits.',
+            },
             update_commits: {
                 type: 'array',
                 items: {
@@ -1807,51 +1405,7 @@ exports.tool = {
                             },
                         },
                         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',
@@ -1926,6 +1480,11 @@ exports.tool = {
                         product_id: {
                             type: 'string',
                         },
+                        rate_type: {
+                            type: 'string',
+                            description: 'If provided, updates the commit to use the specified rate type for current and future invoices. Previously finalized invoices will need to be voided and regenerated to reflect the rate type change.',
+                            enum: ['LIST_RATE', 'COMMIT_RATE'],
+                        },
                         rollover_fraction: {
                             type: 'number',
                         },
@@ -2025,51 +1584,7 @@ exports.tool = {
                             },
                         },
                         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',
                         },
                         netsuite_sales_order_id: {
                             type: 'string',
@@ -2080,6 +1595,11 @@ exports.tool = {
                         product_id: {
                             type: 'string',
                         },
+                        rate_type: {
+                            type: 'string',
+                            description: 'If provided, updates the credit to use the specified rate type for current and future invoices. Previously finalized invoices will need to be voided and regenerated to reflect the rate type change.',
+                            enum: ['LIST_RATE', 'COMMIT_RATE'],
+                        },
                     },
                     required: ['credit_id'],
                 },
@@ -2088,62 +1608,11 @@ exports.tool = {
                 type: 'object',
                 properties: {
                     commit: {
-                        type: 'object',
-                        properties: {
-                            applicable_product_ids: {
-                                type: 'array',
-                                description: 'Which products the threshold commit applies to. If both applicable_product_ids and applicable_product_tags 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 both applicable_product_ids and applicable_product_tags 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.',
-                            },
-                            product_id: {
-                                type: 'string',
-                                description: 'The commit product that will be used to generate the line item for commit payment.',
-                            },
-                            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`. Instead, to target usage by product or product tag, pass those values in the body of `specifiers`.",
-                                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',
-                                            },
-                                        },
-                                    },
-                                },
+                        allOf: [
+                            {
+                                $ref: '#/$defs/update_base_threshold_commit',
                             },
-                        },
+                        ],
                     },
                     custom_credit_type_id: {
                         type: 'string',
@@ -2154,52 +1623,7 @@ exports.tool = {
                         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 gateway 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'],
+                        $ref: '#/$defs/payment_gate_config_v2',
                     },
                     recharge_to_amount: {
                         type: 'number',
@@ -2246,6 +1670,11 @@ exports.tool = {
                                 },
                             },
                         },
+                        rate_type: {
+                            type: 'string',
+                            description: 'If provided, updates the recurring commit to use the specified rate type when generating future commits.',
+                            enum: ['LIST_RATE', 'COMMIT_RATE'],
+                        },
                     },
                     required: ['recurring_commit_id'],
                 },
@@ -2274,6 +1703,11 @@ exports.tool = {
                             type: 'string',
                             format: 'date-time',
                         },
+                        rate_type: {
+                            type: 'string',
+                            description: 'If provided, updates the recurring credit to use the specified rate type when generating future credits.',
+                            enum: ['LIST_RATE', 'COMMIT_RATE'],
+                        },
                     },
                     required: ['recurring_credit_id'],
                 },
@@ -2361,72 +1795,14 @@ exports.tool = {
                 type: 'object',
                 properties: {
                     commit: {
-                        type: 'object',
-                        properties: {
-                            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.',
-                            },
-                            product_id: {
-                                type: 'string',
-                                description: 'The commit product that will be used to generate the line item for commit payment.',
-                            },
-                        },
+                        $ref: '#/$defs/update_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: {
-                        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 gateway 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'],
+                        $ref: '#/$defs/payment_gate_config_v2',
                     },
                     threshold_amount: {
                         type: 'number',
@@ -2476,6 +1852,76 @@ exports.tool = {
         },
         required: ['contract_id', 'customer_id'],
         $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: {
@@ -2488,6 +1934,122 @@ exports.tool = {
                 },
                 required: ['price'],
             },
+            prepaid_balance_threshold_configuration_v2: {
+                type: 'object',
+                properties: {
+                    commit: {
+                        allOf: [
+                            {
+                                $ref: '#/$defs/update_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_v2',
+                    },
+                    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 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'],
+            },
+            update_base_threshold_commit: {
+                type: 'object',
+                properties: {
+                    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.',
+                    },
+                    product_id: {
+                        type: 'string',
+                        description: 'The commit product that will be used to generate the line item for commit payment.',
+                    },
+                },
+            },
+            payment_gate_config_v2: {
+                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 gateway 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_v2: {
+                type: 'object',
+                properties: {
+                    commit: {
+                        $ref: '#/$defs/update_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_v2',
+                    },
+                    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'],
+            },
         },
     },
     annotations: {},