@metronome/mcp 0.1.0-beta.11 → 0.1.0

package/src/tools/v2/contracts/edit-v2-contracts.ts

@@ -1,7 +1,8 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+import { Metadata, asTextContentResult } from '@metronome/mcp/tools/types';
+
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import type { Metadata } from '../../';
 import Metronome from '@metronome/sdk';
 
 export const metadata: Metadata = {
@@ -15,7 +16,8 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'edit_v2_contracts',
-  description: 'Edit a contract. Contract editing must be enabled to use this endpoint.',
+  description:
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nEdit a contract. Contract editing must be enabled to use this endpoint.",
   inputSchema: {
     type: 'object',
     properties: {
@@ -79,7 +81,7 @@ export const tool: Tool = {
             applicable_product_ids: {
               type: 'array',
               description:
-                'Which products the commit applies to. If both applicable_product_ids and applicable_product_tags are not provided, the commit applies to all products.',
+                'Which products the commit applies to. If applicable_product_ids, applicable_product_tags or specifiers are not provided, the commit applies to all products.',
               items: {
                 type: 'string',
               },
@@ -87,7 +89,7 @@ export const tool: Tool = {
             applicable_product_tags: {
               type: 'array',
               description:
-                'Which tags the commit applies to. If both applicable_product_ids and applicable_product_tags are not provided, the commit applies to all products.',
+                'Which tags the commit applies to. If applicable_product_ids, applicable_product_tags or specifiers are not provided, the commit applies to all products.',
               items: {
                 type: 'string',
               },
@@ -99,6 +101,53 @@ export const tool: Tool = {
               type: 'string',
               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'],
+            },
             invoice_schedule: {
               type: 'object',
               description:
@@ -180,7 +229,6 @@ export const tool: Tool = {
                   },
                 },
               },
-              required: [],
             },
             name: {
               type: 'string',
@@ -200,23 +248,45 @@ export const tool: Tool = {
                     '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 through Metronome.',
+                  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.',
+                    },
                   },
                   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'],
+                    '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'],
@@ -261,7 +331,6 @@ export const tool: Tool = {
                     },
                   },
                 },
-                required: [],
               },
             },
             temporary_id: {
@@ -336,6 +405,53 @@ export const tool: Tool = {
               type: 'string',
               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'],
+            },
             name: {
               type: 'string',
               description: 'displayed on invoices',
@@ -380,7 +496,6 @@ export const tool: Tool = {
                     },
                   },
                 },
-                required: [],
               },
             },
           },
@@ -475,7 +590,6 @@ export const tool: Tool = {
                   },
                 },
               },
-              required: [],
             },
             custom_fields: {
               type: 'object',
@@ -585,7 +699,6 @@ export const tool: Tool = {
                     },
                   },
                 },
-                required: [],
               },
             },
             overwrite_rate: {
@@ -682,7 +795,7 @@ export const tool: Tool = {
               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.',
+                  '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',
                 },
@@ -690,7 +803,7 @@ export const tool: Tool = {
               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.',
+                  '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',
                 },
@@ -730,7 +843,6 @@ export const tool: Tool = {
                       },
                     },
                   },
-                  required: [],
                 },
               },
             },
@@ -750,23 +862,45 @@ export const tool: Tool = {
                   '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 through Metronome.',
+                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.',
+                  },
                 },
                 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'],
+                  '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'],
@@ -780,6 +914,11 @@ export const tool: Tool = {
             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'],
       },
@@ -832,28 +971,31 @@ export const tool: Tool = {
                 credit_type_id: {
                   type: 'string',
                 },
-                quantity: {
+                unit_price: {
                   type: 'number',
                 },
-                unit_price: {
+                quantity: {
                   type: 'number',
+                  description:
+                    'This field is currently required. Upcoming recurring commit/credit configuration options will allow it to be optional.',
                 },
               },
-              required: ['credit_type_id', 'quantity', 'unit_price'],
+              required: ['credit_type_id', 'unit_price'],
             },
             commit_duration: {
               type: 'object',
-              description: 'The amount of time the created commits will be valid for.',
+              description:
+                'Defines the length of the access schedule for each created commit/credit. The value represents the number of units. Unit defaults to "PERIODS", where the length of a period is determined by the recurrence_frequency.',
               properties: {
+                value: {
+                  type: 'number',
+                },
                 unit: {
                   type: 'string',
                   enum: ['PERIODS'],
                 },
-                value: {
-                  type: 'number',
-                },
               },
-              required: ['unit', 'value'],
+              required: ['value'],
             },
             priority: {
               type: 'number',
@@ -890,6 +1032,53 @@ export const tool: Tool = {
               description: 'Determines when the contract will stop creating recurring commits. optional',
               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'],
+            },
             invoice_amount: {
               type: 'object',
               description: 'The amount the customer should be billed for the commit. Not required.',
@@ -963,7 +1152,6 @@ export const tool: Tool = {
                     },
                   },
                 },
-                required: [],
               },
             },
             temporary_id: {
@@ -987,28 +1175,31 @@ export const tool: Tool = {
                 credit_type_id: {
                   type: 'string',
                 },
-                quantity: {
+                unit_price: {
                   type: 'number',
                 },
-                unit_price: {
+                quantity: {
                   type: 'number',
+                  description:
+                    'This field is currently required. Upcoming recurring commit/credit configuration options will allow it to be optional.',
                 },
               },
-              required: ['credit_type_id', 'quantity', 'unit_price'],
+              required: ['credit_type_id', 'unit_price'],
             },
             commit_duration: {
               type: 'object',
-              description: 'The amount of time the created commits will be valid for.',
+              description:
+                'Defines the length of the access schedule for each created commit/credit. The value represents the number of units. Unit defaults to "PERIODS", where the length of a period is determined by the recurrence_frequency.',
               properties: {
+                value: {
+                  type: 'number',
+                },
                 unit: {
                   type: 'string',
                   enum: ['PERIODS'],
                 },
-                value: {
-                  type: 'number',
-                },
               },
-              required: ['unit', 'value'],
+              required: ['value'],
             },
             priority: {
               type: 'number',
@@ -1045,6 +1236,53 @@ export const tool: Tool = {
               description: 'Determines when the contract will stop creating recurring commits. optional',
               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'],
+            },
             name: {
               type: 'string',
               description: 'displayed on invoices. will be passed through to the individual commits',
@@ -1102,7 +1340,6 @@ export const tool: Tool = {
                     },
                   },
                 },
-                required: [],
               },
             },
             temporary_id: {
@@ -1150,7 +1387,6 @@ export const tool: Tool = {
                   type: 'string',
                 },
               },
-              required: [],
             },
             ending_before: {
               type: 'string',
@@ -1170,7 +1406,6 @@ export const tool: Tool = {
                   type: 'string',
                 },
               },
-              required: [],
             },
             netsuite_reseller_id: {
               type: 'string',
@@ -1274,7 +1509,6 @@ export const tool: Tool = {
                   },
                 },
               },
-              required: [],
             },
             name: {
               type: 'string',
@@ -1324,23 +1558,45 @@ export const tool: Tool = {
                   '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 through Metronome.',
+                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.',
+                  },
                 },
                 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'],
+                  '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'],
@@ -1356,7 +1612,7 @@ export const tool: Tool = {
       add_subscriptions: {
         type: 'array',
         description:
-          '(beta) Optional list of [subscriptions](https://docs.metronome.com/manage-product-access/create-subscription/) to add to the contract.',
+          'Optional list of [subscriptions](https://docs.metronome.com/manage-product-access/create-subscription/) to add to the contract.',
         items: {
           type: 'object',
           properties: {
@@ -1381,7 +1637,6 @@ export const tool: Tool = {
                   description: 'Indicates if the partial period will be prorated or charged a full amount.',
                 },
               },
-              required: [],
             },
             subscription_rate: {
               type: 'object',
@@ -1548,12 +1803,11 @@ export const tool: Tool = {
                   },
                 },
               },
-              required: [],
             },
             applicable_product_ids: {
               type: 'array',
               description:
-                'Which products the commit applies to. If both applicable_product_ids and applicable_product_tags are not provided, the commit applies to all products.',
+                'Which products the commit applies to. If applicable_product_ids, applicable_product_tags or specifiers are not provided, the commit applies to all products.',
               items: {
                 type: 'string',
               },
@@ -1561,11 +1815,58 @@ export const tool: Tool = {
             applicable_product_tags: {
               type: 'array',
               description:
-                'Which tags the commit applies to. If both applicable_product_ids and applicable_product_tags are not provided, the commit applies to all products.',
+                'Which tags the commit applies to. If applicable_product_ids, applicable_product_tags or specifiers are not provided, the commit applies to all products.',
               items: {
                 type: 'string',
               },
             },
+            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'],
+            },
             invoice_schedule: {
               type: 'object',
               properties: {
@@ -1629,7 +1930,6 @@ export const tool: Tool = {
                   },
                 },
               },
-              required: [],
             },
             netsuite_sales_order_id: {
               type: 'string',
@@ -1649,6 +1949,11 @@ export const tool: Tool = {
         description: 'RFC 3339 timestamp indicating when the contract will end (exclusive).',
         format: 'date-time',
       },
+      update_contract_name: {
+        type: 'string',
+        description:
+          'Value to update the contract name to. If not provided, the contract name will remain unchanged.',
+      },
       update_credits: {
         type: 'array',
         items: {
@@ -1716,12 +2021,11 @@ export const tool: Tool = {
                   },
                 },
               },
-              required: [],
             },
             applicable_product_ids: {
               type: 'array',
               description:
-                'Which products the commit applies to. If both applicable_product_ids and applicable_product_tags are not provided, the commit applies to all products.',
+                'Which products the commit applies to. If applicable_product_ids, applicable_product_tags or specifiers are not provided, the commit applies to all products.',
               items: {
                 type: 'string',
               },
@@ -1729,11 +2033,58 @@ export const tool: Tool = {
             applicable_product_tags: {
               type: 'array',
               description:
-                'Which tags the commit applies to. If both applicable_product_ids and applicable_product_tags are not provided, the commit applies to all products.',
+                'Which tags the commit applies to. If applicable_product_ids, applicable_product_tags or specifiers are not provided, the commit applies to all products.',
               items: {
                 type: 'string',
               },
             },
+            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'],
+            },
             netsuite_sales_order_id: {
               type: 'string',
             },
@@ -1806,11 +2157,14 @@ export const tool: Tool = {
                       },
                     },
                   },
-                  required: [],
                 },
               },
             },
-            required: [],
+          },
+          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.',
           },
           is_enabled: {
             type: 'boolean',
@@ -1826,23 +2180,45 @@ export const tool: Tool = {
                   '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 through Metronome.',
+                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.',
+                  },
                 },
                 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'],
+                  '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'],
@@ -1857,7 +2233,6 @@ export const tool: Tool = {
               "Specify the threshold amount for the contract. Each time the contract's balance lowers to this amount, a threshold charge will be initiated.",
           },
         },
-        required: [],
       },
       update_recurring_commits: {
         type: 'array',
@@ -1879,7 +2254,6 @@ export const tool: Tool = {
                   type: 'number',
                 },
               },
-              required: [],
             },
             ending_before: {
               type: 'string',
@@ -1895,7 +2269,6 @@ export const tool: Tool = {
                   type: 'number',
                 },
               },
-              required: [],
             },
           },
           required: ['recurring_commit_id'],
@@ -1921,7 +2294,6 @@ export const tool: Tool = {
                   type: 'number',
                 },
               },
-              required: [],
             },
             ending_before: {
               type: 'string',
@@ -2002,7 +2374,6 @@ export const tool: Tool = {
                   },
                 },
               },
-              required: [],
             },
             netsuite_sales_order_id: {
               type: 'string',
@@ -2031,7 +2402,6 @@ export const tool: Tool = {
                   'The commit product that will be used to generate the line item for commit payment.',
               },
             },
-            required: [],
           },
           is_enabled: {
             type: 'boolean',
@@ -2047,23 +2417,45 @@ export const tool: Tool = {
                   '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 through Metronome.',
+                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.',
+                  },
                 },
                 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'],
+                  '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'],
@@ -2074,11 +2466,10 @@ export const tool: Tool = {
               "Specify the threshold amount for the contract. Each time the contract's usage hits this amount, a threshold charge will be initiated.",
           },
         },
-        required: [],
       },
       update_subscriptions: {
         type: 'array',
-        description: '(beta) Optional list of subscriptions to update.',
+        description: 'Optional list of subscriptions to update.',
         items: {
           type: 'object',
           properties: {
@@ -2119,6 +2510,7 @@ export const tool: Tool = {
         },
       },
     },
+    required: ['contract_id', 'customer_id'],
     $defs: {
       tier: {
         type: 'object',
@@ -2134,11 +2526,12 @@ export const tool: Tool = {
       },
     },
   },
+  annotations: {},
 };
 
-export const handler = (client: Metronome, args: Record<string, unknown> | undefined) => {
+export const handler = async (client: Metronome, args: Record<string, unknown> | undefined) => {
   const body = args as any;
-  return client.v2.contracts.edit(body);
+  return asTextContentResult(await client.v2.contracts.edit(body));
 };
 
 export default { metadata, tool, handler };