@metronome/mcp 0.3.0 → 2.0.0

package/src/tools/v1/contracts/list-balances-v1-contracts.ts

@@ -16,7 +16,8 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'list_balances_v1_contracts',
-  description: 'List balances (commits and credits).\n',
+  description:
+    'Retrieve a comprehensive view of all available balances (commits and credits) for a customer. This endpoint provides real-time visibility into prepaid funds, postpaid commitments, promotional credits, and other balance types that can offset usage charges, helping you build transparent billing experiences.\n\n### Use this endpoint to:\n- Display current available balances in customer dashboards\n- Verify available funds before approving high-usage operations\n- Generate balance reports for finance teams\n- Filter balances by contract or date ranges\n\n### Key response fields:\nAn array of balance objects (all credits and commits) containing:\n\n- Balance details: Current available amount for each commit or credit\n- Metadata: Product associations, priorities, applicable date ranges\n- Optional ledger entries: Detailed transaction history (if `include_ledgers=true`)\n- Balance calculations: Including pending transactions and future-dated entries\n- Custom fields: Any additional metadata attached to balances\n\n### Usage guidelines:\n- Date filtering: Use `effective_before` to include only balances with access before a specific date (exclusive)\n- Set `include_balance=true` for calculated balance amounts on each commit or credit\n- Set `include_ledgers=true` for full transaction history\n- Set `include_contract_balances = true` to see contract level balances\n- Balance logic: Reflects currently accessible amounts, excluding expired/future segments\n- Manual adjustments: Includes all manual ledger entries, even future-dated ones\n',
   inputSchema: {
     type: 'object',
     properties: {
@@ -74,7 +75,8 @@ export const tool: Tool = {
 
 export const handler = async (client: Metronome, args: Record<string, unknown> | undefined) => {
   const body = args as any;
-  return asTextContentResult(await client.v1.contracts.listBalances(body));
+  const response = await client.v1.contracts.listBalances(body).asResponse();
+  return asTextContentResult(await response.json());
 };
 
 export default { metadata, tool, handler };

package/src/tools/v1/contracts/list-v1-contracts.ts

@@ -17,7 +17,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'list_v1_contracts',
   description:
-    'This is the v1 endpoint to list all contracts for a customer. New clients should implement using the v2 endpoint.',
+    "Retrieves all contracts for a specific customer, including pricing, terms, credits, and commitments. Use this to view a customer's contract history and current agreements for billing management. Returns contract details with optional ledgers and balance information. \n\n⚠️ Note: This is the legacy v1 endpoint - new integrations should use the v2 endpoint for enhanced features.\n",
   inputSchema: {
     type: 'object',
     properties: {

package/src/tools/v1/contracts/named-schedules/retrieve-contracts-v1-named-schedules.ts

@@ -18,7 +18,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'retrieve_contracts_v1_named_schedules',
   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\nGet a named schedule for the given rate card. This endpoint's availability is dependent on your client's configuration.\n\n# Response Schema\n```json\n{\n  type: 'object',\n  properties: {\n    data: {\n      type: 'array',\n      items: {\n        type: 'object',\n        properties: {\n          starting_at: {\n            type: 'string',\n            format: 'date-time'\n          },\n          value: {\n            type: 'object',\n            additionalProperties: true\n          },\n          ending_before: {\n            type: 'string',\n            format: 'date-time'\n          }\n        },\n        required: [          'starting_at',\n          'value'\n        ]\n      }\n    }\n  },\n  required: [    'data'\n  ]\n}\n```",
+    "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\nGet a named schedule for the given rate card. This endpoint's availability is dependent on your client's configuration.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/named_schedule_retrieve_response',\n  $defs: {\n    named_schedule_retrieve_response: {\n      type: 'object',\n      properties: {\n        data: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              starting_at: {\n                type: 'string',\n                format: 'date-time'\n              },\n              value: {\n                type: 'object',\n                additionalProperties: true\n              },\n              ending_before: {\n                type: 'string',\n                format: 'date-time'\n              }\n            },\n            required: [              'starting_at',\n              'value'\n            ]\n          }\n        }\n      },\n      required: [        'data'\n      ]\n    }\n  }\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {

package/src/tools/v1/contracts/products/archive-contracts-v1-products.ts

@@ -18,7 +18,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'archive_contracts_v1_products',
   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\nArchive a product\n\n\n# Response Schema\n```json\n{\n  type: 'object',\n  properties: {\n    data: {\n      $ref: '#/$defs/id'\n    }\n  },\n  required: [    'data'\n  ],\n  $defs: {\n    id: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string'\n        }\n      },\n      required: [        'id'\n      ]\n    }\n  }\n}\n```",
+    "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\nArchive a product. Any current rate cards associated with this product will continue to function as normal. However, it will no longer be available as an option for newly created rates. Once you archive a product, you can still retrieve it in the UI and API, but you cannot unarchive it.\n\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/product_archive_response',\n  $defs: {\n    product_archive_response: {\n      type: 'object',\n      properties: {\n        data: {\n          $ref: '#/$defs/id'\n        }\n      },\n      required: [        'data'\n      ]\n    },\n    id: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string'\n        }\n      },\n      required: [        'id'\n      ]\n    }\n  }\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {

package/src/tools/v1/contracts/products/create-contracts-v1-products.ts

@@ -18,7 +18,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'create_contracts_v1_products',
   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\nCreate a new product\n\n\n# Response Schema\n```json\n{\n  type: 'object',\n  properties: {\n    data: {\n      $ref: '#/$defs/id'\n    }\n  },\n  required: [    'data'\n  ],\n  $defs: {\n    id: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string'\n        }\n      },\n      required: [        'id'\n      ]\n    }\n  }\n}\n```",
+    "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\nCreate a new product object. Products in Metronome represent your company's individual product or service offerings. A Product can be thought of as the basic unit of a line item on the invoice. This is analogous to SKUs or items in an ERP system. Give the product a meaningful name as they will appear on customer invoices.\n\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/product_create_response',\n  $defs: {\n    product_create_response: {\n      type: 'object',\n      properties: {\n        data: {\n          $ref: '#/$defs/id'\n        }\n      },\n      required: [        'data'\n      ]\n    },\n    id: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string'\n        }\n      },\n      required: [        'id'\n      ]\n    }\n  }\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {
@@ -50,6 +50,7 @@ export const tool: Tool = {
       },
       custom_fields: {
         type: 'object',
+        description: 'Custom fields to be added eg. { "key1": "value1", "key2": "value2" }',
         additionalProperties: true,
       },
       exclude_free_usage: {

package/src/tools/v1/contracts/products/list-contracts-v1-products.ts

@@ -18,7 +18,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'list_contracts_v1_products',
   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\nList products\n\n\n# Response Schema\n```json\n{\n  type: 'object',\n  properties: {\n    data: {\n      type: 'array',\n      items: {\n        type: 'object',\n        properties: {\n          id: {\n            type: 'string'\n          },\n          current: {\n            $ref: '#/$defs/product_list_item_state'\n          },\n          initial: {\n            $ref: '#/$defs/product_list_item_state'\n          },\n          type: {\n            type: 'string',\n            enum: [              'USAGE',\n              'SUBSCRIPTION',\n              'COMPOSITE',\n              'FIXED',\n              'PRO_SERVICE'\n            ]\n          },\n          updates: {\n            type: 'array',\n            items: {\n              type: 'object',\n              properties: {\n                created_at: {\n                  type: 'string',\n                  format: 'date-time'\n                },\n                created_by: {\n                  type: 'string'\n                },\n                billable_metric_id: {\n                  type: 'string'\n                },\n                composite_product_ids: {\n                  type: 'array',\n                  items: {\n                    type: 'string'\n                  }\n                },\n                composite_tags: {\n                  type: 'array',\n                  items: {\n                    type: 'string'\n                  }\n                },\n                exclude_free_usage: {\n                  type: 'boolean'\n                },\n                is_refundable: {\n                  type: 'boolean'\n                },\n                name: {\n                  type: 'string'\n                },\n                netsuite_internal_item_id: {\n                  type: 'string',\n                  description: 'This field\\'s availability is dependent on your client\\'s configuration.'\n                },\n                netsuite_overage_item_id: {\n                  type: 'string',\n                  description: 'This field\\'s availability is dependent on your client\\'s configuration.'\n                },\n                presentation_group_key: {\n                  type: 'array',\n                  description: 'For USAGE products only. Groups usage line items on invoices. The superset of values in the pricing group key and presentation group key must be set as one compound group key on the billable metric.',\n                  items: {\n                    type: 'string'\n                  }\n                },\n                pricing_group_key: {\n                  type: 'array',\n                  description: 'For USAGE products only. If set, pricing for this product will be determined for each pricing_group_key value, as opposed to the product as a whole. The superset of values in the pricing group key and presentation group key must be set as one compound group key on the billable metric.',\n                  items: {\n                    type: 'string'\n                  }\n                },\n                quantity_conversion: {\n                  $ref: '#/$defs/quantity_conversion'\n                },\n                quantity_rounding: {\n                  $ref: '#/$defs/quantity_rounding'\n                },\n                starting_at: {\n                  type: 'string',\n                  format: 'date-time'\n                },\n                tags: {\n                  type: 'array',\n                  items: {\n                    type: 'string'\n                  }\n                }\n              },\n              required: [                'created_at',\n                'created_by'\n              ]\n            }\n          },\n          archived_at: {\n            type: 'string',\n            format: 'date-time'\n          },\n          custom_fields: {\n            type: 'object',\n            additionalProperties: true\n          }\n        },\n        required: [          'id',\n          'current',\n          'initial',\n          'type',\n          'updates'\n        ]\n      }\n    },\n    next_page: {\n      type: 'string'\n    }\n  },\n  required: [    'data',\n    'next_page'\n  ],\n  $defs: {\n    product_list_item_state: {\n      type: 'object',\n      properties: {\n        created_at: {\n          type: 'string',\n          format: 'date-time'\n        },\n        created_by: {\n          type: 'string'\n        },\n        name: {\n          type: 'string'\n        },\n        billable_metric_id: {\n          type: 'string'\n        },\n        composite_product_ids: {\n          type: 'array',\n          items: {\n            type: 'string'\n          }\n        },\n        composite_tags: {\n          type: 'array',\n          items: {\n            type: 'string'\n          }\n        },\n        exclude_free_usage: {\n          type: 'boolean'\n        },\n        is_refundable: {\n          type: 'boolean',\n          description: 'This field\\'s availability is dependent on your client\\'s configuration.'\n        },\n        netsuite_internal_item_id: {\n          type: 'string',\n          description: 'This field\\'s availability is dependent on your client\\'s configuration.'\n        },\n        netsuite_overage_item_id: {\n          type: 'string',\n          description: 'This field\\'s availability is dependent on your client\\'s configuration.'\n        },\n        presentation_group_key: {\n          type: 'array',\n          description: 'For USAGE products only. Groups usage line items on invoices. The superset of values in the pricing group key and presentation group key must be set as one compound group key on the billable metric.',\n          items: {\n            type: 'string'\n          }\n        },\n        pricing_group_key: {\n          type: 'array',\n          description: 'For USAGE products only. If set, pricing for this product will be determined for each pricing_group_key value, as opposed to the product as a whole. The superset of values in the pricing group key and presentation group key must be set as one compound group key on the billable metric.',\n          items: {\n            type: 'string'\n          }\n        },\n        quantity_conversion: {\n          $ref: '#/$defs/quantity_conversion'\n        },\n        quantity_rounding: {\n          $ref: '#/$defs/quantity_rounding'\n        },\n        starting_at: {\n          type: 'string',\n          format: 'date-time'\n        },\n        tags: {\n          type: 'array',\n          items: {\n            type: 'string'\n          }\n        }\n      },\n      required: [        'created_at',\n        'created_by',\n        'name'\n      ]\n    },\n    quantity_conversion: {\n      type: 'object',\n      description: 'Optional. Only valid for USAGE products. If provided, the quantity will be converted using the provided conversion factor and operation. For example, if the operation is \"multiply\" and the conversion factor is 100, then the quantity will be multiplied by 100. This can be used in cases where data is sent in one unit and priced in another.  For example, data could be sent in MB and priced in GB. In this case, the conversion factor would be 1024 and the operation would be \"divide\".',\n      properties: {\n        conversion_factor: {\n          type: 'number',\n          description: 'The factor to multiply or divide the quantity by.'\n        },\n        operation: {\n          type: 'string',\n          description: 'The operation to perform on the quantity',\n          enum: [            'MULTIPLY',\n            'DIVIDE'\n          ]\n        },\n        name: {\n          type: 'string',\n          description: 'Optional name for this conversion.'\n        }\n      },\n      required: [        'conversion_factor',\n        'operation'\n      ]\n    },\n    quantity_rounding: {\n      type: 'object',\n      description: 'Optional. Only valid for USAGE products. If provided, the quantity will be rounded using the provided rounding method and decimal places. For example, if the method is \"round up\" and the decimal places is 0, then the quantity will be rounded up to the nearest integer.',\n      properties: {\n        decimal_places: {\n          type: 'number'\n        },\n        rounding_method: {\n          type: 'string',\n          enum: [            'ROUND_UP',\n            'ROUND_DOWN',\n            'ROUND_HALF_UP'\n          ]\n        }\n      },\n      required: [        'decimal_places',\n        'rounding_method'\n      ]\n    }\n  }\n}\n```",
+    "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\nGet a paginated list of all products in your organization with their complete configuration, version history, and metadata. By default excludes archived products unless explicitly requested via the `archive_filter` parameter.\n\n\n# Response Schema\n```json\n{\n  type: 'object',\n  properties: {\n    data: {\n      type: 'array',\n      items: {\n        $ref: '#/$defs/product_list_response'\n      }\n    },\n    next_page: {\n      type: 'string'\n    }\n  },\n  required: [    'data',\n    'next_page'\n  ],\n  $defs: {\n    product_list_response: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string'\n        },\n        current: {\n          $ref: '#/$defs/product_list_item_state'\n        },\n        initial: {\n          $ref: '#/$defs/product_list_item_state'\n        },\n        type: {\n          type: 'string',\n          enum: [            'USAGE',\n            'SUBSCRIPTION',\n            'COMPOSITE',\n            'FIXED',\n            'PRO_SERVICE'\n          ]\n        },\n        updates: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              created_at: {\n                type: 'string',\n                format: 'date-time'\n              },\n              created_by: {\n                type: 'string'\n              },\n              billable_metric_id: {\n                type: 'string'\n              },\n              composite_product_ids: {\n                type: 'array',\n                items: {\n                  type: 'string'\n                }\n              },\n              composite_tags: {\n                type: 'array',\n                items: {\n                  type: 'string'\n                }\n              },\n              exclude_free_usage: {\n                type: 'boolean'\n              },\n              is_refundable: {\n                type: 'boolean'\n              },\n              name: {\n                type: 'string'\n              },\n              netsuite_internal_item_id: {\n                type: 'string',\n                description: 'This field\\'s availability is dependent on your client\\'s configuration.'\n              },\n              netsuite_overage_item_id: {\n                type: 'string',\n                description: 'This field\\'s availability is dependent on your client\\'s configuration.'\n              },\n              presentation_group_key: {\n                type: 'array',\n                description: 'For USAGE products only. Groups usage line items on invoices. The superset of values in the pricing group key and presentation group key must be set as one compound group key on the billable metric.',\n                items: {\n                  type: 'string'\n                }\n              },\n              pricing_group_key: {\n                type: 'array',\n                description: 'For USAGE products only. If set, pricing for this product will be determined for each pricing_group_key value, as opposed to the product as a whole. The superset of values in the pricing group key and presentation group key must be set as one compound group key on the billable metric.',\n                items: {\n                  type: 'string'\n                }\n              },\n              quantity_conversion: {\n                $ref: '#/$defs/quantity_conversion'\n              },\n              quantity_rounding: {\n                $ref: '#/$defs/quantity_rounding'\n              },\n              starting_at: {\n                type: 'string',\n                format: 'date-time'\n              },\n              tags: {\n                type: 'array',\n                items: {\n                  type: 'string'\n                }\n              }\n            },\n            required: [              'created_at',\n              'created_by'\n            ]\n          }\n        },\n        archived_at: {\n          type: 'string',\n          format: 'date-time'\n        },\n        custom_fields: {\n          type: 'object',\n          description: 'Custom fields to be added eg. { \"key1\": \"value1\", \"key2\": \"value2\" }',\n          additionalProperties: true\n        }\n      },\n      required: [        'id',\n        'current',\n        'initial',\n        'type',\n        'updates'\n      ]\n    },\n    product_list_item_state: {\n      type: 'object',\n      properties: {\n        created_at: {\n          type: 'string',\n          format: 'date-time'\n        },\n        created_by: {\n          type: 'string'\n        },\n        name: {\n          type: 'string'\n        },\n        billable_metric_id: {\n          type: 'string'\n        },\n        composite_product_ids: {\n          type: 'array',\n          items: {\n            type: 'string'\n          }\n        },\n        composite_tags: {\n          type: 'array',\n          items: {\n            type: 'string'\n          }\n        },\n        exclude_free_usage: {\n          type: 'boolean'\n        },\n        is_refundable: {\n          type: 'boolean',\n          description: 'This field\\'s availability is dependent on your client\\'s configuration.'\n        },\n        netsuite_internal_item_id: {\n          type: 'string',\n          description: 'This field\\'s availability is dependent on your client\\'s configuration.'\n        },\n        netsuite_overage_item_id: {\n          type: 'string',\n          description: 'This field\\'s availability is dependent on your client\\'s configuration.'\n        },\n        presentation_group_key: {\n          type: 'array',\n          description: 'For USAGE products only. Groups usage line items on invoices. The superset of values in the pricing group key and presentation group key must be set as one compound group key on the billable metric.',\n          items: {\n            type: 'string'\n          }\n        },\n        pricing_group_key: {\n          type: 'array',\n          description: 'For USAGE products only. If set, pricing for this product will be determined for each pricing_group_key value, as opposed to the product as a whole. The superset of values in the pricing group key and presentation group key must be set as one compound group key on the billable metric.',\n          items: {\n            type: 'string'\n          }\n        },\n        quantity_conversion: {\n          $ref: '#/$defs/quantity_conversion'\n        },\n        quantity_rounding: {\n          $ref: '#/$defs/quantity_rounding'\n        },\n        starting_at: {\n          type: 'string',\n          format: 'date-time'\n        },\n        tags: {\n          type: 'array',\n          items: {\n            type: 'string'\n          }\n        }\n      },\n      required: [        'created_at',\n        'created_by',\n        'name'\n      ]\n    },\n    quantity_conversion: {\n      type: 'object',\n      description: 'Optional. Only valid for USAGE products. If provided, the quantity will be converted using the provided conversion factor and operation. For example, if the operation is \"multiply\" and the conversion factor is 100, then the quantity will be multiplied by 100. This can be used in cases where data is sent in one unit and priced in another.  For example, data could be sent in MB and priced in GB. In this case, the conversion factor would be 1024 and the operation would be \"divide\".',\n      properties: {\n        conversion_factor: {\n          type: 'number',\n          description: 'The factor to multiply or divide the quantity by.'\n        },\n        operation: {\n          type: 'string',\n          description: 'The operation to perform on the quantity',\n          enum: [            'MULTIPLY',\n            'DIVIDE'\n          ]\n        },\n        name: {\n          type: 'string',\n          description: 'Optional name for this conversion.'\n        }\n      },\n      required: [        'conversion_factor',\n        'operation'\n      ]\n    },\n    quantity_rounding: {\n      type: 'object',\n      description: 'Optional. Only valid for USAGE products. If provided, the quantity will be rounded using the provided rounding method and decimal places. For example, if the method is \"round up\" and the decimal places is 0, then the quantity will be rounded up to the nearest integer.',\n      properties: {\n        decimal_places: {\n          type: 'number'\n        },\n        rounding_method: {\n          type: 'string',\n          enum: [            'ROUND_UP',\n            'ROUND_DOWN',\n            'ROUND_HALF_UP'\n          ]\n        }\n      },\n      required: [        'decimal_places',\n        'rounding_method'\n      ]\n    }\n  }\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {

package/src/tools/v1/contracts/products/retrieve-contracts-v1-products.ts

@@ -18,7 +18,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'retrieve_contracts_v1_products',
   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\nGet a specific product\n\n\n# Response Schema\n```json\n{\n  type: 'object',\n  properties: {\n    data: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string'\n        },\n        current: {\n          $ref: '#/$defs/product_list_item_state'\n        },\n        initial: {\n          $ref: '#/$defs/product_list_item_state'\n        },\n        type: {\n          type: 'string',\n          enum: [            'USAGE',\n            'SUBSCRIPTION',\n            'COMPOSITE',\n            'FIXED',\n            'PRO_SERVICE'\n          ]\n        },\n        updates: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              created_at: {\n                type: 'string',\n                format: 'date-time'\n              },\n              created_by: {\n                type: 'string'\n              },\n              billable_metric_id: {\n                type: 'string'\n              },\n              composite_product_ids: {\n                type: 'array',\n                items: {\n                  type: 'string'\n                }\n              },\n              composite_tags: {\n                type: 'array',\n                items: {\n                  type: 'string'\n                }\n              },\n              exclude_free_usage: {\n                type: 'boolean'\n              },\n              is_refundable: {\n                type: 'boolean'\n              },\n              name: {\n                type: 'string'\n              },\n              netsuite_internal_item_id: {\n                type: 'string',\n                description: 'This field\\'s availability is dependent on your client\\'s configuration.'\n              },\n              netsuite_overage_item_id: {\n                type: 'string',\n                description: 'This field\\'s availability is dependent on your client\\'s configuration.'\n              },\n              presentation_group_key: {\n                type: 'array',\n                description: 'For USAGE products only. Groups usage line items on invoices. The superset of values in the pricing group key and presentation group key must be set as one compound group key on the billable metric.',\n                items: {\n                  type: 'string'\n                }\n              },\n              pricing_group_key: {\n                type: 'array',\n                description: 'For USAGE products only. If set, pricing for this product will be determined for each pricing_group_key value, as opposed to the product as a whole. The superset of values in the pricing group key and presentation group key must be set as one compound group key on the billable metric.',\n                items: {\n                  type: 'string'\n                }\n              },\n              quantity_conversion: {\n                $ref: '#/$defs/quantity_conversion'\n              },\n              quantity_rounding: {\n                $ref: '#/$defs/quantity_rounding'\n              },\n              starting_at: {\n                type: 'string',\n                format: 'date-time'\n              },\n              tags: {\n                type: 'array',\n                items: {\n                  type: 'string'\n                }\n              }\n            },\n            required: [              'created_at',\n              'created_by'\n            ]\n          }\n        },\n        archived_at: {\n          type: 'string',\n          format: 'date-time'\n        },\n        custom_fields: {\n          type: 'object',\n          additionalProperties: true\n        }\n      },\n      required: [        'id',\n        'current',\n        'initial',\n        'type',\n        'updates'\n      ]\n    }\n  },\n  required: [    'data'\n  ],\n  $defs: {\n    product_list_item_state: {\n      type: 'object',\n      properties: {\n        created_at: {\n          type: 'string',\n          format: 'date-time'\n        },\n        created_by: {\n          type: 'string'\n        },\n        name: {\n          type: 'string'\n        },\n        billable_metric_id: {\n          type: 'string'\n        },\n        composite_product_ids: {\n          type: 'array',\n          items: {\n            type: 'string'\n          }\n        },\n        composite_tags: {\n          type: 'array',\n          items: {\n            type: 'string'\n          }\n        },\n        exclude_free_usage: {\n          type: 'boolean'\n        },\n        is_refundable: {\n          type: 'boolean',\n          description: 'This field\\'s availability is dependent on your client\\'s configuration.'\n        },\n        netsuite_internal_item_id: {\n          type: 'string',\n          description: 'This field\\'s availability is dependent on your client\\'s configuration.'\n        },\n        netsuite_overage_item_id: {\n          type: 'string',\n          description: 'This field\\'s availability is dependent on your client\\'s configuration.'\n        },\n        presentation_group_key: {\n          type: 'array',\n          description: 'For USAGE products only. Groups usage line items on invoices. The superset of values in the pricing group key and presentation group key must be set as one compound group key on the billable metric.',\n          items: {\n            type: 'string'\n          }\n        },\n        pricing_group_key: {\n          type: 'array',\n          description: 'For USAGE products only. If set, pricing for this product will be determined for each pricing_group_key value, as opposed to the product as a whole. The superset of values in the pricing group key and presentation group key must be set as one compound group key on the billable metric.',\n          items: {\n            type: 'string'\n          }\n        },\n        quantity_conversion: {\n          $ref: '#/$defs/quantity_conversion'\n        },\n        quantity_rounding: {\n          $ref: '#/$defs/quantity_rounding'\n        },\n        starting_at: {\n          type: 'string',\n          format: 'date-time'\n        },\n        tags: {\n          type: 'array',\n          items: {\n            type: 'string'\n          }\n        }\n      },\n      required: [        'created_at',\n        'created_by',\n        'name'\n      ]\n    },\n    quantity_conversion: {\n      type: 'object',\n      description: 'Optional. Only valid for USAGE products. If provided, the quantity will be converted using the provided conversion factor and operation. For example, if the operation is \"multiply\" and the conversion factor is 100, then the quantity will be multiplied by 100. This can be used in cases where data is sent in one unit and priced in another.  For example, data could be sent in MB and priced in GB. In this case, the conversion factor would be 1024 and the operation would be \"divide\".',\n      properties: {\n        conversion_factor: {\n          type: 'number',\n          description: 'The factor to multiply or divide the quantity by.'\n        },\n        operation: {\n          type: 'string',\n          description: 'The operation to perform on the quantity',\n          enum: [            'MULTIPLY',\n            'DIVIDE'\n          ]\n        },\n        name: {\n          type: 'string',\n          description: 'Optional name for this conversion.'\n        }\n      },\n      required: [        'conversion_factor',\n        'operation'\n      ]\n    },\n    quantity_rounding: {\n      type: 'object',\n      description: 'Optional. Only valid for USAGE products. If provided, the quantity will be rounded using the provided rounding method and decimal places. For example, if the method is \"round up\" and the decimal places is 0, then the quantity will be rounded up to the nearest integer.',\n      properties: {\n        decimal_places: {\n          type: 'number'\n        },\n        rounding_method: {\n          type: 'string',\n          enum: [            'ROUND_UP',\n            'ROUND_DOWN',\n            'ROUND_HALF_UP'\n          ]\n        }\n      },\n      required: [        'decimal_places',\n        'rounding_method'\n      ]\n    }\n  }\n}\n```",
+    "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\nRetrieve a product by its ID, including all metadata and historical changes.\n\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/product_retrieve_response',\n  $defs: {\n    product_retrieve_response: {\n      type: 'object',\n      properties: {\n        data: {\n          type: 'object',\n          properties: {\n            id: {\n              type: 'string'\n            },\n            current: {\n              $ref: '#/$defs/product_list_item_state'\n            },\n            initial: {\n              $ref: '#/$defs/product_list_item_state'\n            },\n            type: {\n              type: 'string',\n              enum: [                'USAGE',\n                'SUBSCRIPTION',\n                'COMPOSITE',\n                'FIXED',\n                'PRO_SERVICE'\n              ]\n            },\n            updates: {\n              type: 'array',\n              items: {\n                type: 'object',\n                properties: {\n                  created_at: {\n                    type: 'string',\n                    format: 'date-time'\n                  },\n                  created_by: {\n                    type: 'string'\n                  },\n                  billable_metric_id: {\n                    type: 'string'\n                  },\n                  composite_product_ids: {\n                    type: 'array',\n                    items: {\n                      type: 'string'\n                    }\n                  },\n                  composite_tags: {\n                    type: 'array',\n                    items: {\n                      type: 'string'\n                    }\n                  },\n                  exclude_free_usage: {\n                    type: 'boolean'\n                  },\n                  is_refundable: {\n                    type: 'boolean'\n                  },\n                  name: {\n                    type: 'string'\n                  },\n                  netsuite_internal_item_id: {\n                    type: 'string',\n                    description: 'This field\\'s availability is dependent on your client\\'s configuration.'\n                  },\n                  netsuite_overage_item_id: {\n                    type: 'string',\n                    description: 'This field\\'s availability is dependent on your client\\'s configuration.'\n                  },\n                  presentation_group_key: {\n                    type: 'array',\n                    description: 'For USAGE products only. Groups usage line items on invoices. The superset of values in the pricing group key and presentation group key must be set as one compound group key on the billable metric.',\n                    items: {\n                      type: 'string'\n                    }\n                  },\n                  pricing_group_key: {\n                    type: 'array',\n                    description: 'For USAGE products only. If set, pricing for this product will be determined for each pricing_group_key value, as opposed to the product as a whole. The superset of values in the pricing group key and presentation group key must be set as one compound group key on the billable metric.',\n                    items: {\n                      type: 'string'\n                    }\n                  },\n                  quantity_conversion: {\n                    $ref: '#/$defs/quantity_conversion'\n                  },\n                  quantity_rounding: {\n                    $ref: '#/$defs/quantity_rounding'\n                  },\n                  starting_at: {\n                    type: 'string',\n                    format: 'date-time'\n                  },\n                  tags: {\n                    type: 'array',\n                    items: {\n                      type: 'string'\n                    }\n                  }\n                },\n                required: [                  'created_at',\n                  'created_by'\n                ]\n              }\n            },\n            archived_at: {\n              type: 'string',\n              format: 'date-time'\n            },\n            custom_fields: {\n              type: 'object',\n              description: 'Custom fields to be added eg. { \"key1\": \"value1\", \"key2\": \"value2\" }',\n              additionalProperties: true\n            }\n          },\n          required: [            'id',\n            'current',\n            'initial',\n            'type',\n            'updates'\n          ]\n        }\n      },\n      required: [        'data'\n      ]\n    },\n    product_list_item_state: {\n      type: 'object',\n      properties: {\n        created_at: {\n          type: 'string',\n          format: 'date-time'\n        },\n        created_by: {\n          type: 'string'\n        },\n        name: {\n          type: 'string'\n        },\n        billable_metric_id: {\n          type: 'string'\n        },\n        composite_product_ids: {\n          type: 'array',\n          items: {\n            type: 'string'\n          }\n        },\n        composite_tags: {\n          type: 'array',\n          items: {\n            type: 'string'\n          }\n        },\n        exclude_free_usage: {\n          type: 'boolean'\n        },\n        is_refundable: {\n          type: 'boolean',\n          description: 'This field\\'s availability is dependent on your client\\'s configuration.'\n        },\n        netsuite_internal_item_id: {\n          type: 'string',\n          description: 'This field\\'s availability is dependent on your client\\'s configuration.'\n        },\n        netsuite_overage_item_id: {\n          type: 'string',\n          description: 'This field\\'s availability is dependent on your client\\'s configuration.'\n        },\n        presentation_group_key: {\n          type: 'array',\n          description: 'For USAGE products only. Groups usage line items on invoices. The superset of values in the pricing group key and presentation group key must be set as one compound group key on the billable metric.',\n          items: {\n            type: 'string'\n          }\n        },\n        pricing_group_key: {\n          type: 'array',\n          description: 'For USAGE products only. If set, pricing for this product will be determined for each pricing_group_key value, as opposed to the product as a whole. The superset of values in the pricing group key and presentation group key must be set as one compound group key on the billable metric.',\n          items: {\n            type: 'string'\n          }\n        },\n        quantity_conversion: {\n          $ref: '#/$defs/quantity_conversion'\n        },\n        quantity_rounding: {\n          $ref: '#/$defs/quantity_rounding'\n        },\n        starting_at: {\n          type: 'string',\n          format: 'date-time'\n        },\n        tags: {\n          type: 'array',\n          items: {\n            type: 'string'\n          }\n        }\n      },\n      required: [        'created_at',\n        'created_by',\n        'name'\n      ]\n    },\n    quantity_conversion: {\n      type: 'object',\n      description: 'Optional. Only valid for USAGE products. If provided, the quantity will be converted using the provided conversion factor and operation. For example, if the operation is \"multiply\" and the conversion factor is 100, then the quantity will be multiplied by 100. This can be used in cases where data is sent in one unit and priced in another.  For example, data could be sent in MB and priced in GB. In this case, the conversion factor would be 1024 and the operation would be \"divide\".',\n      properties: {\n        conversion_factor: {\n          type: 'number',\n          description: 'The factor to multiply or divide the quantity by.'\n        },\n        operation: {\n          type: 'string',\n          description: 'The operation to perform on the quantity',\n          enum: [            'MULTIPLY',\n            'DIVIDE'\n          ]\n        },\n        name: {\n          type: 'string',\n          description: 'Optional name for this conversion.'\n        }\n      },\n      required: [        'conversion_factor',\n        'operation'\n      ]\n    },\n    quantity_rounding: {\n      type: 'object',\n      description: 'Optional. Only valid for USAGE products. If provided, the quantity will be rounded using the provided rounding method and decimal places. For example, if the method is \"round up\" and the decimal places is 0, then the quantity will be rounded up to the nearest integer.',\n      properties: {\n        decimal_places: {\n          type: 'number'\n        },\n        rounding_method: {\n          type: 'string',\n          enum: [            'ROUND_UP',\n            'ROUND_DOWN',\n            'ROUND_HALF_UP'\n          ]\n        }\n      },\n      required: [        'decimal_places',\n        'rounding_method'\n      ]\n    }\n  }\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {

package/src/tools/v1/contracts/products/update-contracts-v1-products.ts

@@ -18,7 +18,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'update_contracts_v1_products',
   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\nUpdate a product\n\n\n# Response Schema\n```json\n{\n  type: 'object',\n  properties: {\n    data: {\n      $ref: '#/$defs/id'\n    }\n  },\n  required: [    'data'\n  ],\n  $defs: {\n    id: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string'\n        }\n      },\n      required: [        'id'\n      ]\n    }\n  }\n}\n```",
+    "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\nUpdates a product's configuration while maintaining billing continuity for active customers. Use this endpoint to modify product names, metrics, pricing rules, and composite settings without disrupting ongoing billing cycles. Changes are scheduled using the starting_at timestamp, which must be on an hour boundary—set future dates to schedule updates ahead of time, or past dates for retroactive changes. Returns the updated product ID upon success. \n\n### Usage guidance: \n- Product type cannot be changed after creation. For incorrect product types, create a new product and archive the original instead.\n\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/product_update_response',\n  $defs: {\n    product_update_response: {\n      type: 'object',\n      properties: {\n        data: {\n          $ref: '#/$defs/id'\n        }\n      },\n      required: [        'data'\n      ]\n    },\n    id: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string'\n        }\n      },\n      required: [        'id'\n      ]\n    }\n  }\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {

package/src/tools/v1/contracts/rate-cards/archive-contracts-v1-rate-cards.ts

@@ -18,7 +18,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'archive_contracts_v1_rate_cards',
   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\nArchive a rate card\n\n\n# Response Schema\n```json\n{\n  type: 'object',\n  properties: {\n    data: {\n      $ref: '#/$defs/id'\n    }\n  },\n  required: [    'data'\n  ],\n  $defs: {\n    id: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string'\n        }\n      },\n      required: [        'id'\n      ]\n    }\n  }\n}\n```",
+    "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\nPermanently disable a rate card by archiving it, preventing use in new contracts while preserving existing contract pricing. Use this when retiring old pricing models, consolidating rate cards, or removing outdated pricing structures. Returns the archived rate card ID and stops the rate card from appearing in contract creation workflows.\n\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/rate_card_archive_response',\n  $defs: {\n    rate_card_archive_response: {\n      type: 'object',\n      properties: {\n        data: {\n          $ref: '#/$defs/id'\n        }\n      },\n      required: [        'data'\n      ]\n    },\n    id: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string'\n        }\n      },\n      required: [        'id'\n      ]\n    }\n  }\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {

package/src/tools/v1/contracts/rate-cards/create-contracts-v1-rate-cards.ts

@@ -18,7 +18,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'create_contracts_v1_rate_cards',
   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\nCreate a new rate card\n\n\n# Response Schema\n```json\n{\n  type: 'object',\n  properties: {\n    data: {\n      $ref: '#/$defs/id'\n    }\n  },\n  required: [    'data'\n  ],\n  $defs: {\n    id: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string'\n        }\n      },\n      required: [        'id'\n      ]\n    }\n  }\n}\n```",
+    "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\nIn Metronome, the rate card is the central location for your pricing. Rate cards were built with new product launches and pricing changes in mind - you can update your products and pricing in one place, and that change will be automatically propagated across your customer cohorts. Most clients need only maintain one or a few rate cards within Metronome.\n\n### Use this endpoint to:\n- Create a rate card with a name and description\n- Define the rate card's single underlying fiat currency, and any number of conversion rates between that fiat currency and custom pricing units. You can then add products and associated rates in the fiat currency or custom pricing unit for which you have defined a conversion rate. \n- Set aliases for the rate card. Aliases are human-readable names that you can use in the place of the id of the rate card when provisioning a customer's contract. By using an alias, you can easily create a contract and provision a customer by choosing the paygo rate card, without storing the rate card id in your internal systems. This is helpful when launching a new rate card for paygo customers, you can update the alias for paygo to be scheduled to be assigned to the new rate card without updating your code.\n\n### Key response fields:\n- The ID of the rate card you just created\n\n### Usage guidelines:\n- After creating a rate card, you can now use the addRate or addRates endpoints to add products and their prices to it\n- A rate card alias can only be used by one rate card at a time. If you create a contract with a rate card alias that is already in use by another rate card, the original rate card's alias schedule will be updated. The alias will reference the rate card to which it was most recently assigned.\n\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/rate_card_create_response',\n  $defs: {\n    rate_card_create_response: {\n      type: 'object',\n      properties: {\n        data: {\n          $ref: '#/$defs/id'\n        }\n      },\n      required: [        'data'\n      ]\n    },\n    id: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string'\n        }\n      },\n      required: [        'id'\n      ]\n    }\n  }\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {
@@ -66,6 +66,7 @@ export const tool: Tool = {
       },
       custom_fields: {
         type: 'object',
+        description: 'Custom fields to be added eg. { "key1": "value1", "key2": "value2" }',
         additionalProperties: true,
       },
       description: {

package/src/tools/v1/contracts/rate-cards/list-contracts-v1-rate-cards.ts

@@ -18,7 +18,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'list_contracts_v1_rate_cards',
   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\nList rate cards NOTE: Use `/contract-pricing/rate-cards/getRates` to retrieve rate card rates.\n\n\n# Response Schema\n```json\n{\n  type: 'object',\n  properties: {\n    data: {\n      type: 'array',\n      items: {\n        type: 'object',\n        properties: {\n          id: {\n            type: 'string'\n          },\n          created_at: {\n            type: 'string',\n            format: 'date-time'\n          },\n          created_by: {\n            type: 'string'\n          },\n          name: {\n            type: 'string'\n          },\n          aliases: {\n            type: 'array',\n            items: {\n              type: 'object',\n              properties: {\n                name: {\n                  type: 'string'\n                },\n                ending_before: {\n                  type: 'string',\n                  format: 'date-time'\n                },\n                starting_at: {\n                  type: 'string',\n                  format: 'date-time'\n                }\n              },\n              required: [                'name'\n              ]\n            }\n          },\n          credit_type_conversions: {\n            type: 'array',\n            items: {\n              type: 'object',\n              properties: {\n                custom_credit_type: {\n                  $ref: '#/$defs/credit_type_data'\n                },\n                fiat_per_custom_credit: {\n                  type: 'string'\n                }\n              },\n              required: [                'custom_credit_type',\n                'fiat_per_custom_credit'\n              ]\n            }\n          },\n          custom_fields: {\n            type: 'object',\n            additionalProperties: true\n          },\n          description: {\n            type: 'string'\n          },\n          fiat_credit_type: {\n            $ref: '#/$defs/credit_type_data'\n          }\n        },\n        required: [          'id',\n          'created_at',\n          'created_by',\n          'name'\n        ]\n      }\n    },\n    next_page: {\n      type: 'string'\n    }\n  },\n  required: [    'data',\n    'next_page'\n  ],\n  $defs: {\n    credit_type_data: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string'\n        },\n        name: {\n          type: 'string'\n        }\n      },\n      required: [        'id',\n        'name'\n      ]\n    }\n  }\n}\n```",
+    "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\nList all rate cards. Returns rate card IDs, names, descriptions, aliases, and other details. To view the rates associated with a given rate card, use the getRates or getRateSchedule endpoints.\n\n\n# Response Schema\n```json\n{\n  type: 'object',\n  properties: {\n    data: {\n      type: 'array',\n      items: {\n        $ref: '#/$defs/rate_card_list_response'\n      }\n    },\n    next_page: {\n      type: 'string'\n    }\n  },\n  required: [    'data',\n    'next_page'\n  ],\n  $defs: {\n    rate_card_list_response: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string'\n        },\n        created_at: {\n          type: 'string',\n          format: 'date-time'\n        },\n        created_by: {\n          type: 'string'\n        },\n        name: {\n          type: 'string'\n        },\n        aliases: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              name: {\n                type: 'string'\n              },\n              ending_before: {\n                type: 'string',\n                format: 'date-time'\n              },\n              starting_at: {\n                type: 'string',\n                format: 'date-time'\n              }\n            },\n            required: [              'name'\n            ]\n          }\n        },\n        credit_type_conversions: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              custom_credit_type: {\n                $ref: '#/$defs/credit_type_data'\n              },\n              fiat_per_custom_credit: {\n                type: 'string'\n              }\n            },\n            required: [              'custom_credit_type',\n              'fiat_per_custom_credit'\n            ]\n          }\n        },\n        custom_fields: {\n          type: 'object',\n          description: 'Custom fields to be added eg. { \"key1\": \"value1\", \"key2\": \"value2\" }',\n          additionalProperties: true\n        },\n        description: {\n          type: 'string'\n        },\n        fiat_credit_type: {\n          $ref: '#/$defs/credit_type_data'\n        }\n      },\n      required: [        'id',\n        'created_at',\n        'created_by',\n        'name'\n      ]\n    },\n    credit_type_data: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string'\n        },\n        name: {\n          type: 'string'\n        }\n      },\n      required: [        'id',\n        'name'\n      ]\n    }\n  }\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {

package/src/tools/v1/contracts/rate-cards/named-schedules/retrieve-rate-cards-contracts-v1-named-schedules.ts

@@ -18,7 +18,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'retrieve_rate_cards_contracts_v1_named_schedules',
   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\nGet a named schedule for the given contract. This endpoint's availability is dependent on your client's configuration.\n\n# Response Schema\n```json\n{\n  type: 'object',\n  properties: {\n    data: {\n      type: 'array',\n      items: {\n        type: 'object',\n        properties: {\n          starting_at: {\n            type: 'string',\n            format: 'date-time'\n          },\n          value: {\n            type: 'object',\n            additionalProperties: true\n          },\n          ending_before: {\n            type: 'string',\n            format: 'date-time'\n          }\n        },\n        required: [          'starting_at',\n          'value'\n        ]\n      }\n    }\n  },\n  required: [    'data'\n  ]\n}\n```",
+    "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\nGet a named schedule for the given contract. This endpoint's availability is dependent on your client's configuration.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/named_schedule_retrieve_response',\n  $defs: {\n    named_schedule_retrieve_response: {\n      type: 'object',\n      properties: {\n        data: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              starting_at: {\n                type: 'string',\n                format: 'date-time'\n              },\n              value: {\n                type: 'object',\n                additionalProperties: true\n              },\n              ending_before: {\n                type: 'string',\n                format: 'date-time'\n              }\n            },\n            required: [              'starting_at',\n              'value'\n            ]\n          }\n        }\n      },\n      required: [        'data'\n      ]\n    }\n  }\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {

package/src/tools/v1/contracts/rate-cards/product-orders/set-rate-cards-contracts-v1-product-orders.ts

@@ -18,7 +18,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'set_rate_cards_contracts_v1_product_orders',
   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\nSets the ordering of products within a rate card\n\n\n# Response Schema\n```json\n{\n  type: 'object',\n  properties: {\n    data: {\n      $ref: '#/$defs/id'\n    }\n  },\n  required: [    'data'\n  ],\n  $defs: {\n    id: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string'\n        }\n      },\n      required: [        'id'\n      ]\n    }\n  }\n}\n```",
+    "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\nThe ordering of products on a rate card determines the order in which the products will appear on customers' invoices. Use this endpoint to set the order of products on the rate card.\n\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/product_order_set_response',\n  $defs: {\n    product_order_set_response: {\n      type: 'object',\n      properties: {\n        data: {\n          $ref: '#/$defs/id'\n        }\n      },\n      required: [        'data'\n      ]\n    },\n    id: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string'\n        }\n      },\n      required: [        'id'\n      ]\n    }\n  }\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {

package/src/tools/v1/contracts/rate-cards/product-orders/update-rate-cards-contracts-v1-product-orders.ts

@@ -18,7 +18,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'update_rate_cards_contracts_v1_product_orders',
   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\nUpdates ordering of specified products\n\n\n# Response Schema\n```json\n{\n  type: 'object',\n  properties: {\n    data: {\n      $ref: '#/$defs/id'\n    }\n  },\n  required: [    'data'\n  ],\n  $defs: {\n    id: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string'\n        }\n      },\n      required: [        'id'\n      ]\n    }\n  }\n}\n```",
+    "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\nThe ordering of products on a rate card determines the order in which the products will appear on customers' invoices. Use this endpoint to set the order of specific products on the rate card by moving them relative to their current location.\n\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/product_order_update_response',\n  $defs: {\n    product_order_update_response: {\n      type: 'object',\n      properties: {\n        data: {\n          $ref: '#/$defs/id'\n        }\n      },\n      required: [        'data'\n      ]\n    },\n    id: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string'\n        }\n      },\n      required: [        'id'\n      ]\n    }\n  }\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {

package/src/tools/v1/contracts/rate-cards/rates/add-many-rate-cards-contracts-v1-rates.ts

@@ -18,7 +18,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'add_many_rate_cards_contracts_v1_rates',
   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\nAdd new rates\n\n\n# Response Schema\n```json\n{\n  type: 'object',\n  properties: {\n    data: {\n      $ref: '#/$defs/id'\n    }\n  },\n  required: [    'data'\n  ],\n  $defs: {\n    id: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string'\n        }\n      },\n      required: [        'id'\n      ]\n    }\n  }\n}\n```",
+    "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\nAdd new rates\n\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/rate_add_many_response',\n  $defs: {\n    rate_add_many_response: {\n      type: 'object',\n      properties: {\n        data: {\n          $ref: '#/$defs/id'\n        }\n      },\n      required: [        'data'\n      ]\n    },\n    id: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string'\n        }\n      },\n      required: [        'id'\n      ]\n    }\n  }\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {
@@ -53,27 +53,7 @@ export const tool: Tool = {
               enum: ['MONTHLY', 'QUARTERLY', 'ANNUAL', 'WEEKLY'],
             },
             commit_rate: {
-              type: 'object',
-              description:
-                'A distinct rate on the rate card. You can choose to use this rate rather than list rate when consuming a credit or commit.',
-              properties: {
-                rate_type: {
-                  type: 'string',
-                  enum: ['FLAT', 'PERCENTAGE', 'SUBSCRIPTION', 'TIERED', 'CUSTOM'],
-                },
-                price: {
-                  type: 'number',
-                  description: 'Commit rate price. For FLAT rate_type, this must be >=0.',
-                },
-                tiers: {
-                  type: 'array',
-                  description: 'Only set for TIERED rate_type.',
-                  items: {
-                    $ref: '#/$defs/tier',
-                  },
-                },
-              },
-              required: ['rate_type'],
+              $ref: '#/$defs/commit_rate',
             },
             credit_type_id: {
               type: 'string',
@@ -136,6 +116,29 @@ export const tool: Tool = {
     },
     required: ['rate_card_id', 'rates'],
     $defs: {
+      commit_rate: {
+        type: 'object',
+        description:
+          'A distinct rate on the rate card. You can choose to use this rate rather than list rate when consuming a credit or commit.',
+        properties: {
+          rate_type: {
+            type: 'string',
+            enum: ['FLAT', 'PERCENTAGE', 'SUBSCRIPTION', 'TIERED', 'CUSTOM'],
+          },
+          price: {
+            type: 'number',
+            description: 'Commit rate price. For FLAT rate_type, this must be >=0.',
+          },
+          tiers: {
+            type: 'array',
+            description: 'Only set for TIERED rate_type.',
+            items: {
+              $ref: '#/$defs/tier',
+            },
+          },
+        },
+        required: ['rate_type'],
+      },
       tier: {
         type: 'object',
         properties: {

package/src/tools/v1/contracts/rate-cards/rates/add-rate-cards-contracts-v1-rates.ts

@@ -18,7 +18,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'add_rate_cards_contracts_v1_rates',
   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\nAdd a new rate\n\n\n# Response Schema\n```json\n{\n  type: 'object',\n  properties: {\n    data: {\n      type: 'object',\n      properties: {\n        rate_type: {\n          type: 'string',\n          enum: [            'FLAT',\n            'PERCENTAGE',\n            'SUBSCRIPTION',\n            'CUSTOM',\n            'TIERED'\n          ]\n        },\n        commit_rate: {\n          type: 'object',\n          description: 'A distinct rate on the rate card. You can choose to use this rate rather than list rate when consuming a credit or commit.',\n          properties: {\n            rate_type: {\n              type: 'string',\n              enum: [                'FLAT',\n                'PERCENTAGE',\n                'SUBSCRIPTION',\n                'TIERED',\n                'CUSTOM'\n              ]\n            },\n            price: {\n              type: 'number',\n              description: 'Commit rate price. For FLAT rate_type, this must be >=0.'\n            },\n            tiers: {\n              type: 'array',\n              description: 'Only set for TIERED rate_type.',\n              items: {\n                $ref: '#/$defs/tier'\n              }\n            }\n          },\n          required: [            'rate_type'\n          ]\n        },\n        credit_type: {\n          $ref: '#/$defs/credit_type_data'\n        },\n        custom_rate: {\n          type: 'object',\n          description: 'Only set for CUSTOM rate_type. This field is interpreted by custom rate processors.',\n          additionalProperties: true\n        },\n        is_prorated: {\n          type: 'boolean',\n          description: 'Default proration configuration. Only valid for SUBSCRIPTION rate_type. Must be set to true.'\n        },\n        price: {\n          type: 'number',\n          description: 'Default price. For FLAT rate_type, this must be >=0. For PERCENTAGE rate_type, this is a decimal fraction, e.g. use 0.1 for 10%; this must be >=0 and <=1.'\n        },\n        pricing_group_values: {\n          type: 'object',\n          description: 'if pricing groups are used, this will contain the values used to calculate the price',\n          additionalProperties: true\n        },\n        quantity: {\n          type: 'number',\n          description: 'Default quantity. For SUBSCRIPTION rate_type, this must be >=0.'\n        },\n        tiers: {\n          type: 'array',\n          description: 'Only set for TIERED rate_type.',\n          items: {\n            $ref: '#/$defs/tier'\n          }\n        },\n        use_list_prices: {\n          type: 'boolean',\n          description: 'Only set for PERCENTAGE rate_type. Defaults to false. If true, rate is computed using list prices rather than the standard rates for this product on the contract.'\n        }\n      },\n      required: [        'rate_type'\n      ]\n    }\n  },\n  required: [    'data'\n  ],\n  $defs: {\n    tier: {\n      type: 'object',\n      properties: {\n        price: {\n          type: 'number'\n        },\n        size: {\n          type: 'number'\n        }\n      },\n      required: [        'price'\n      ]\n    },\n    credit_type_data: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string'\n        },\n        name: {\n          type: 'string'\n        }\n      },\n      required: [        'id',\n        'name'\n      ]\n    }\n  }\n}\n```",
+    "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\nAdd a new rate\n\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/rate_add_response',\n  $defs: {\n    rate_add_response: {\n      type: 'object',\n      properties: {\n        data: {\n          type: 'object',\n          properties: {\n            rate_type: {\n              type: 'string',\n              enum: [                'FLAT',\n                'PERCENTAGE',\n                'SUBSCRIPTION',\n                'CUSTOM',\n                'TIERED'\n              ]\n            },\n            commit_rate: {\n              $ref: '#/$defs/commit_rate'\n            },\n            credit_type: {\n              $ref: '#/$defs/credit_type_data'\n            },\n            custom_rate: {\n              type: 'object',\n              description: 'Only set for CUSTOM rate_type. This field is interpreted by custom rate processors.',\n              additionalProperties: true\n            },\n            is_prorated: {\n              type: 'boolean',\n              description: 'Default proration configuration. Only valid for SUBSCRIPTION rate_type. Must be set to true.'\n            },\n            price: {\n              type: 'number',\n              description: 'Default price. For FLAT rate_type, this must be >=0. For PERCENTAGE rate_type, this is a decimal fraction, e.g. use 0.1 for 10%; this must be >=0 and <=1.'\n            },\n            pricing_group_values: {\n              type: 'object',\n              description: 'if pricing groups are used, this will contain the values used to calculate the price',\n              additionalProperties: true\n            },\n            quantity: {\n              type: 'number',\n              description: 'Default quantity. For SUBSCRIPTION rate_type, this must be >=0.'\n            },\n            tiers: {\n              type: 'array',\n              description: 'Only set for TIERED rate_type.',\n              items: {\n                $ref: '#/$defs/tier'\n              }\n            },\n            use_list_prices: {\n              type: 'boolean',\n              description: 'Only set for PERCENTAGE rate_type. Defaults to false. If true, rate is computed using list prices rather than the standard rates for this product on the contract.'\n            }\n          },\n          required: [            'rate_type'\n          ]\n        }\n      },\n      required: [        'data'\n      ]\n    },\n    commit_rate: {\n      type: 'object',\n      description: 'A distinct rate on the rate card. You can choose to use this rate rather than list rate when consuming a credit or commit.',\n      properties: {\n        rate_type: {\n          type: 'string',\n          enum: [            'FLAT',\n            'PERCENTAGE',\n            'SUBSCRIPTION',\n            'TIERED',\n            'CUSTOM'\n          ]\n        },\n        price: {\n          type: 'number',\n          description: 'Commit rate price. For FLAT rate_type, this must be >=0.'\n        },\n        tiers: {\n          type: 'array',\n          description: 'Only set for TIERED rate_type.',\n          items: {\n            $ref: '#/$defs/tier'\n          }\n        }\n      },\n      required: [        'rate_type'\n      ]\n    },\n    tier: {\n      type: 'object',\n      properties: {\n        price: {\n          type: 'number'\n        },\n        size: {\n          type: 'number'\n        }\n      },\n      required: [        'price'\n      ]\n    },\n    credit_type_data: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string'\n        },\n        name: {\n          type: 'string'\n        }\n      },\n      required: [        'id',\n        'name'\n      ]\n    }\n  }\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {
@@ -49,27 +49,7 @@ export const tool: Tool = {
         enum: ['MONTHLY', 'QUARTERLY', 'ANNUAL', 'WEEKLY'],
       },
       commit_rate: {
-        type: 'object',
-        description:
-          'A distinct rate on the rate card. You can choose to use this rate rather than list rate when consuming a credit or commit.',
-        properties: {
-          rate_type: {
-            type: 'string',
-            enum: ['FLAT', 'PERCENTAGE', 'SUBSCRIPTION', 'TIERED', 'CUSTOM'],
-          },
-          price: {
-            type: 'number',
-            description: 'Commit rate price. For FLAT rate_type, this must be >=0.',
-          },
-          tiers: {
-            type: 'array',
-            description: 'Only set for TIERED rate_type.',
-            items: {
-              $ref: '#/$defs/tier',
-            },
-          },
-        },
-        required: ['rate_type'],
+        $ref: '#/$defs/commit_rate',
       },
       credit_type_id: {
         type: 'string',
@@ -127,6 +107,29 @@ export const tool: Tool = {
     },
     required: ['entitled', 'product_id', 'rate_card_id', 'rate_type', 'starting_at'],
     $defs: {
+      commit_rate: {
+        type: 'object',
+        description:
+          'A distinct rate on the rate card. You can choose to use this rate rather than list rate when consuming a credit or commit.',
+        properties: {
+          rate_type: {
+            type: 'string',
+            enum: ['FLAT', 'PERCENTAGE', 'SUBSCRIPTION', 'TIERED', 'CUSTOM'],
+          },
+          price: {
+            type: 'number',
+            description: 'Commit rate price. For FLAT rate_type, this must be >=0.',
+          },
+          tiers: {
+            type: 'array',
+            description: 'Only set for TIERED rate_type.',
+            items: {
+              $ref: '#/$defs/tier',
+            },
+          },
+        },
+        required: ['rate_type'],
+      },
       tier: {
         type: 'object',
         properties: {

package/src/tools/v1/contracts/rate-cards/rates/list-rate-cards-contracts-v1-rates.ts

@@ -18,7 +18,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'list_rate_cards_contracts_v1_rates',
   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\nGet all rates for a rate card at a point in time\n\n\n# Response Schema\n```json\n{\n  type: 'object',\n  properties: {\n    data: {\n      type: 'array',\n      items: {\n        type: 'object',\n        properties: {\n          entitled: {\n            type: 'boolean'\n          },\n          product_custom_fields: {\n            type: 'object',\n            additionalProperties: true\n          },\n          product_id: {\n            type: 'string'\n          },\n          product_name: {\n            type: 'string'\n          },\n          product_tags: {\n            type: 'array',\n            items: {\n              type: 'string'\n            }\n          },\n          rate: {\n            $ref: '#/$defs/rate'\n          },\n          starting_at: {\n            type: 'string',\n            format: 'date-time'\n          },\n          billing_frequency: {\n            type: 'string',\n            enum: [              'MONTHLY',\n              'QUARTERLY',\n              'ANNUAL',\n              'WEEKLY'\n            ]\n          },\n          commit_rate: {\n            type: 'object',\n            description: 'A distinct rate on the rate card. You can choose to use this rate rather than list rate when consuming a credit or commit.',\n            properties: {\n              rate_type: {\n                type: 'string',\n                enum: [                  'FLAT',\n                  'PERCENTAGE',\n                  'SUBSCRIPTION',\n                  'TIERED',\n                  'CUSTOM'\n                ]\n              },\n              price: {\n                type: 'number',\n                description: 'Commit rate price. For FLAT rate_type, this must be >=0.'\n              },\n              tiers: {\n                type: 'array',\n                description: 'Only set for TIERED rate_type.',\n                items: {\n                  $ref: '#/$defs/tier'\n                }\n              }\n            },\n            required: [              'rate_type'\n            ]\n          },\n          ending_before: {\n            type: 'string',\n            format: 'date-time'\n          },\n          pricing_group_values: {\n            type: 'object',\n            additionalProperties: true\n          }\n        },\n        required: [          'entitled',\n          'product_custom_fields',\n          'product_id',\n          'product_name',\n          'product_tags',\n          'rate',\n          'starting_at'\n        ]\n      }\n    },\n    next_page: {\n      type: 'string'\n    }\n  },\n  required: [    'data'\n  ],\n  $defs: {\n    rate: {\n      type: 'object',\n      properties: {\n        rate_type: {\n          type: 'string',\n          enum: [            'FLAT',\n            'PERCENTAGE',\n            'SUBSCRIPTION',\n            'CUSTOM',\n            'TIERED'\n          ]\n        },\n        credit_type: {\n          $ref: '#/$defs/credit_type_data'\n        },\n        custom_rate: {\n          type: 'object',\n          description: 'Only set for CUSTOM rate_type. This field is interpreted by custom rate processors.',\n          additionalProperties: true\n        },\n        is_prorated: {\n          type: 'boolean',\n          description: 'Default proration configuration. Only valid for SUBSCRIPTION rate_type. Must be set to true.'\n        },\n        price: {\n          type: 'number',\n          description: 'Default price. For FLAT rate_type, this must be >=0. For PERCENTAGE rate_type, this is a decimal fraction, e.g. use 0.1 for 10%; this must be >=0 and <=1.'\n        },\n        pricing_group_values: {\n          type: 'object',\n          description: 'if pricing groups are used, this will contain the values used to calculate the price',\n          additionalProperties: true\n        },\n        quantity: {\n          type: 'number',\n          description: 'Default quantity. For SUBSCRIPTION rate_type, this must be >=0.'\n        },\n        tiers: {\n          type: 'array',\n          description: 'Only set for TIERED rate_type.',\n          items: {\n            $ref: '#/$defs/tier'\n          }\n        },\n        use_list_prices: {\n          type: 'boolean',\n          description: 'Only set for PERCENTAGE rate_type. Defaults to false. If true, rate is computed using list prices rather than the standard rates for this product on the contract.'\n        }\n      },\n      required: [        'rate_type'\n      ]\n    },\n    credit_type_data: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string'\n        },\n        name: {\n          type: 'string'\n        }\n      },\n      required: [        'id',\n        'name'\n      ]\n    },\n    tier: {\n      type: 'object',\n      properties: {\n        price: {\n          type: 'number'\n        },\n        size: {\n          type: 'number'\n        }\n      },\n      required: [        'price'\n      ]\n    }\n  }\n}\n```",
+    "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\nUnderstand the rate schedule at a given timestamp, optionally filtering the list of rates returned based on properties such as `product_id` and `pricing_group_values`. For example, you may want to display the current price for a given product in your product experience - use this endpoint to fetch that information from its source of truth in Metronome. \n\nIf you want to understand the rates for a specific customer's contract, inclusive of contract-level overrides, use the `getContractRateSchedule` endpoint.\n\n\n# Response Schema\n```json\n{\n  type: 'object',\n  properties: {\n    data: {\n      type: 'array',\n      items: {\n        $ref: '#/$defs/rate_list_response'\n      }\n    },\n    next_page: {\n      type: 'string'\n    }\n  },\n  required: [    'data'\n  ],\n  $defs: {\n    rate_list_response: {\n      type: 'object',\n      properties: {\n        entitled: {\n          type: 'boolean'\n        },\n        product_custom_fields: {\n          type: 'object',\n          description: 'Custom fields to be added eg. { \"key1\": \"value1\", \"key2\": \"value2\" }',\n          additionalProperties: true\n        },\n        product_id: {\n          type: 'string'\n        },\n        product_name: {\n          type: 'string'\n        },\n        product_tags: {\n          type: 'array',\n          items: {\n            type: 'string'\n          }\n        },\n        rate: {\n          $ref: '#/$defs/rate'\n        },\n        starting_at: {\n          type: 'string',\n          format: 'date-time'\n        },\n        billing_frequency: {\n          type: 'string',\n          enum: [            'MONTHLY',\n            'QUARTERLY',\n            'ANNUAL',\n            'WEEKLY'\n          ]\n        },\n        commit_rate: {\n          $ref: '#/$defs/commit_rate'\n        },\n        ending_before: {\n          type: 'string',\n          format: 'date-time'\n        },\n        pricing_group_values: {\n          type: 'object',\n          additionalProperties: true\n        }\n      },\n      required: [        'entitled',\n        'product_custom_fields',\n        'product_id',\n        'product_name',\n        'product_tags',\n        'rate',\n        'starting_at'\n      ]\n    },\n    rate: {\n      type: 'object',\n      properties: {\n        rate_type: {\n          type: 'string',\n          enum: [            'FLAT',\n            'PERCENTAGE',\n            'SUBSCRIPTION',\n            'CUSTOM',\n            'TIERED'\n          ]\n        },\n        credit_type: {\n          $ref: '#/$defs/credit_type_data'\n        },\n        custom_rate: {\n          type: 'object',\n          description: 'Only set for CUSTOM rate_type. This field is interpreted by custom rate processors.',\n          additionalProperties: true\n        },\n        is_prorated: {\n          type: 'boolean',\n          description: 'Default proration configuration. Only valid for SUBSCRIPTION rate_type. Must be set to true.'\n        },\n        price: {\n          type: 'number',\n          description: 'Default price. For FLAT rate_type, this must be >=0. For PERCENTAGE rate_type, this is a decimal fraction, e.g. use 0.1 for 10%; this must be >=0 and <=1.'\n        },\n        pricing_group_values: {\n          type: 'object',\n          description: 'if pricing groups are used, this will contain the values used to calculate the price',\n          additionalProperties: true\n        },\n        quantity: {\n          type: 'number',\n          description: 'Default quantity. For SUBSCRIPTION rate_type, this must be >=0.'\n        },\n        tiers: {\n          type: 'array',\n          description: 'Only set for TIERED rate_type.',\n          items: {\n            $ref: '#/$defs/tier'\n          }\n        },\n        use_list_prices: {\n          type: 'boolean',\n          description: 'Only set for PERCENTAGE rate_type. Defaults to false. If true, rate is computed using list prices rather than the standard rates for this product on the contract.'\n        }\n      },\n      required: [        'rate_type'\n      ]\n    },\n    credit_type_data: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string'\n        },\n        name: {\n          type: 'string'\n        }\n      },\n      required: [        'id',\n        'name'\n      ]\n    },\n    tier: {\n      type: 'object',\n      properties: {\n        price: {\n          type: 'number'\n        },\n        size: {\n          type: 'number'\n        }\n      },\n      required: [        'price'\n      ]\n    },\n    commit_rate: {\n      type: 'object',\n      description: 'A distinct rate on the rate card. You can choose to use this rate rather than list rate when consuming a credit or commit.',\n      properties: {\n        rate_type: {\n          type: 'string',\n          enum: [            'FLAT',\n            'PERCENTAGE',\n            'SUBSCRIPTION',\n            'TIERED',\n            'CUSTOM'\n          ]\n        },\n        price: {\n          type: 'number',\n          description: 'Commit rate price. For FLAT rate_type, this must be >=0.'\n        },\n        tiers: {\n          type: 'array',\n          description: 'Only set for TIERED rate_type.',\n          items: {\n            $ref: '#/$defs/tier'\n          }\n        }\n      },\n      required: [        'rate_type'\n      ]\n    }\n  }\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {

package/src/tools/v1/contracts/rate-cards/retrieve-contracts-v1-rate-cards.ts

@@ -18,7 +18,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'retrieve_contracts_v1_rate_cards',
   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\nGet a specific rate card NOTE: Use `/contract-pricing/rate-cards/getRates` to retrieve rate card rates.\n\n\n# Response Schema\n```json\n{\n  type: 'object',\n  properties: {\n    data: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string'\n        },\n        created_at: {\n          type: 'string',\n          format: 'date-time'\n        },\n        created_by: {\n          type: 'string'\n        },\n        name: {\n          type: 'string'\n        },\n        aliases: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              name: {\n                type: 'string'\n              },\n              ending_before: {\n                type: 'string',\n                format: 'date-time'\n              },\n              starting_at: {\n                type: 'string',\n                format: 'date-time'\n              }\n            },\n            required: [              'name'\n            ]\n          }\n        },\n        credit_type_conversions: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              custom_credit_type: {\n                $ref: '#/$defs/credit_type_data'\n              },\n              fiat_per_custom_credit: {\n                type: 'string'\n              }\n            },\n            required: [              'custom_credit_type',\n              'fiat_per_custom_credit'\n            ]\n          }\n        },\n        custom_fields: {\n          type: 'object',\n          additionalProperties: true\n        },\n        description: {\n          type: 'string'\n        },\n        fiat_credit_type: {\n          $ref: '#/$defs/credit_type_data'\n        }\n      },\n      required: [        'id',\n        'created_at',\n        'created_by',\n        'name'\n      ]\n    }\n  },\n  required: [    'data'\n  ],\n  $defs: {\n    credit_type_data: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string'\n        },\n        name: {\n          type: 'string'\n        }\n      },\n      required: [        'id',\n        'name'\n      ]\n    }\n  }\n}\n```",
+    "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\nReturn details for a specific rate card including name, description, and aliases. This endpoint does not return rates - use the dedicated getRates or getRateSchedule endpoints to understand the rates on a rate card.\n\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/rate_card_retrieve_response',\n  $defs: {\n    rate_card_retrieve_response: {\n      type: 'object',\n      properties: {\n        data: {\n          type: 'object',\n          properties: {\n            id: {\n              type: 'string'\n            },\n            created_at: {\n              type: 'string',\n              format: 'date-time'\n            },\n            created_by: {\n              type: 'string'\n            },\n            name: {\n              type: 'string'\n            },\n            aliases: {\n              type: 'array',\n              items: {\n                type: 'object',\n                properties: {\n                  name: {\n                    type: 'string'\n                  },\n                  ending_before: {\n                    type: 'string',\n                    format: 'date-time'\n                  },\n                  starting_at: {\n                    type: 'string',\n                    format: 'date-time'\n                  }\n                },\n                required: [                  'name'\n                ]\n              }\n            },\n            credit_type_conversions: {\n              type: 'array',\n              items: {\n                type: 'object',\n                properties: {\n                  custom_credit_type: {\n                    $ref: '#/$defs/credit_type_data'\n                  },\n                  fiat_per_custom_credit: {\n                    type: 'string'\n                  }\n                },\n                required: [                  'custom_credit_type',\n                  'fiat_per_custom_credit'\n                ]\n              }\n            },\n            custom_fields: {\n              type: 'object',\n              description: 'Custom fields to be added eg. { \"key1\": \"value1\", \"key2\": \"value2\" }',\n              additionalProperties: true\n            },\n            description: {\n              type: 'string'\n            },\n            fiat_credit_type: {\n              $ref: '#/$defs/credit_type_data'\n            }\n          },\n          required: [            'id',\n            'created_at',\n            'created_by',\n            'name'\n          ]\n        }\n      },\n      required: [        'data'\n      ]\n    },\n    credit_type_data: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string'\n        },\n        name: {\n          type: 'string'\n        }\n      },\n      required: [        'id',\n        'name'\n      ]\n    }\n  }\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {

package/src/tools/v1/contracts/rate-cards/retrieve-rate-schedule-contracts-v1-rate-cards.ts

@@ -18,7 +18,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'retrieve_rate_schedule_contracts_v1_rate_cards',
   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\nGet all rates for a rate card from starting_at (either in perpetuity or until ending_before, if provided)\n\n\n# Response Schema\n```json\n{\n  type: 'object',\n  properties: {\n    data: {\n      type: 'array',\n      items: {\n        type: 'object',\n        properties: {\n          entitled: {\n            type: 'boolean'\n          },\n          product_custom_fields: {\n            type: 'object',\n            additionalProperties: true\n          },\n          product_id: {\n            type: 'string'\n          },\n          product_name: {\n            type: 'string'\n          },\n          product_tags: {\n            type: 'array',\n            items: {\n              type: 'string'\n            }\n          },\n          rate: {\n            $ref: '#/$defs/rate'\n          },\n          starting_at: {\n            type: 'string',\n            format: 'date-time'\n          },\n          billing_frequency: {\n            type: 'string',\n            enum: [              'MONTHLY',\n              'QUARTERLY',\n              'ANNUAL',\n              'WEEKLY'\n            ]\n          },\n          commit_rate: {\n            type: 'object',\n            description: 'A distinct rate on the rate card. You can choose to use this rate rather than list rate when consuming a credit or commit.',\n            properties: {\n              rate_type: {\n                type: 'string',\n                enum: [                  'FLAT',\n                  'PERCENTAGE',\n                  'SUBSCRIPTION',\n                  'TIERED',\n                  'CUSTOM'\n                ]\n              },\n              price: {\n                type: 'number',\n                description: 'Commit rate price. For FLAT rate_type, this must be >=0.'\n              },\n              tiers: {\n                type: 'array',\n                description: 'Only set for TIERED rate_type.',\n                items: {\n                  $ref: '#/$defs/tier'\n                }\n              }\n            },\n            required: [              'rate_type'\n            ]\n          },\n          ending_before: {\n            type: 'string',\n            format: 'date-time'\n          },\n          pricing_group_values: {\n            type: 'object',\n            additionalProperties: true\n          }\n        },\n        required: [          'entitled',\n          'product_custom_fields',\n          'product_id',\n          'product_name',\n          'product_tags',\n          'rate',\n          'starting_at'\n        ]\n      }\n    },\n    next_page: {\n      type: 'string'\n    }\n  },\n  required: [    'data'\n  ],\n  $defs: {\n    rate: {\n      type: 'object',\n      properties: {\n        rate_type: {\n          type: 'string',\n          enum: [            'FLAT',\n            'PERCENTAGE',\n            'SUBSCRIPTION',\n            'CUSTOM',\n            'TIERED'\n          ]\n        },\n        credit_type: {\n          $ref: '#/$defs/credit_type_data'\n        },\n        custom_rate: {\n          type: 'object',\n          description: 'Only set for CUSTOM rate_type. This field is interpreted by custom rate processors.',\n          additionalProperties: true\n        },\n        is_prorated: {\n          type: 'boolean',\n          description: 'Default proration configuration. Only valid for SUBSCRIPTION rate_type. Must be set to true.'\n        },\n        price: {\n          type: 'number',\n          description: 'Default price. For FLAT rate_type, this must be >=0. For PERCENTAGE rate_type, this is a decimal fraction, e.g. use 0.1 for 10%; this must be >=0 and <=1.'\n        },\n        pricing_group_values: {\n          type: 'object',\n          description: 'if pricing groups are used, this will contain the values used to calculate the price',\n          additionalProperties: true\n        },\n        quantity: {\n          type: 'number',\n          description: 'Default quantity. For SUBSCRIPTION rate_type, this must be >=0.'\n        },\n        tiers: {\n          type: 'array',\n          description: 'Only set for TIERED rate_type.',\n          items: {\n            $ref: '#/$defs/tier'\n          }\n        },\n        use_list_prices: {\n          type: 'boolean',\n          description: 'Only set for PERCENTAGE rate_type. Defaults to false. If true, rate is computed using list prices rather than the standard rates for this product on the contract.'\n        }\n      },\n      required: [        'rate_type'\n      ]\n    },\n    credit_type_data: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string'\n        },\n        name: {\n          type: 'string'\n        }\n      },\n      required: [        'id',\n        'name'\n      ]\n    },\n    tier: {\n      type: 'object',\n      properties: {\n        price: {\n          type: 'number'\n        },\n        size: {\n          type: 'number'\n        }\n      },\n      required: [        'price'\n      ]\n    }\n  }\n}\n```",
+    "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\nA rate card defines the prices that you charge for your products. Rate cards support scheduled changes over time, to allow you to easily roll out pricing changes and new product launches across your customer base. Use this endpoint to understand the rate schedule `starting_at` a given date, optionally filtering the list of rates returned based on product id or pricing group values. For example, you may want to display a schedule of upcoming price changes for a given product in your product experience - use this endpoint to fetch that information from its source of truth in Metronome. \n\nIf you want to understand the rates for a specific customer's contract, inclusive of contract-level overrides, use the `getContractRateSchedule` endpoint.\n\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/rate_card_retrieve_rate_schedule_response',\n  $defs: {\n    rate_card_retrieve_rate_schedule_response: {\n      type: 'object',\n      properties: {\n        data: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              entitled: {\n                type: 'boolean'\n              },\n              product_custom_fields: {\n                type: 'object',\n                description: 'Custom fields to be added eg. { \"key1\": \"value1\", \"key2\": \"value2\" }',\n                additionalProperties: true\n              },\n              product_id: {\n                type: 'string'\n              },\n              product_name: {\n                type: 'string'\n              },\n              product_tags: {\n                type: 'array',\n                items: {\n                  type: 'string'\n                }\n              },\n              rate: {\n                $ref: '#/$defs/rate'\n              },\n              starting_at: {\n                type: 'string',\n                format: 'date-time'\n              },\n              billing_frequency: {\n                type: 'string',\n                enum: [                  'MONTHLY',\n                  'QUARTERLY',\n                  'ANNUAL',\n                  'WEEKLY'\n                ]\n              },\n              commit_rate: {\n                $ref: '#/$defs/commit_rate'\n              },\n              ending_before: {\n                type: 'string',\n                format: 'date-time'\n              },\n              pricing_group_values: {\n                type: 'object',\n                additionalProperties: true\n              }\n            },\n            required: [              'entitled',\n              'product_custom_fields',\n              'product_id',\n              'product_name',\n              'product_tags',\n              'rate',\n              'starting_at'\n            ]\n          }\n        },\n        next_page: {\n          type: 'string'\n        }\n      },\n      required: [        'data'\n      ]\n    },\n    rate: {\n      type: 'object',\n      properties: {\n        rate_type: {\n          type: 'string',\n          enum: [            'FLAT',\n            'PERCENTAGE',\n            'SUBSCRIPTION',\n            'CUSTOM',\n            'TIERED'\n          ]\n        },\n        credit_type: {\n          $ref: '#/$defs/credit_type_data'\n        },\n        custom_rate: {\n          type: 'object',\n          description: 'Only set for CUSTOM rate_type. This field is interpreted by custom rate processors.',\n          additionalProperties: true\n        },\n        is_prorated: {\n          type: 'boolean',\n          description: 'Default proration configuration. Only valid for SUBSCRIPTION rate_type. Must be set to true.'\n        },\n        price: {\n          type: 'number',\n          description: 'Default price. For FLAT rate_type, this must be >=0. For PERCENTAGE rate_type, this is a decimal fraction, e.g. use 0.1 for 10%; this must be >=0 and <=1.'\n        },\n        pricing_group_values: {\n          type: 'object',\n          description: 'if pricing groups are used, this will contain the values used to calculate the price',\n          additionalProperties: true\n        },\n        quantity: {\n          type: 'number',\n          description: 'Default quantity. For SUBSCRIPTION rate_type, this must be >=0.'\n        },\n        tiers: {\n          type: 'array',\n          description: 'Only set for TIERED rate_type.',\n          items: {\n            $ref: '#/$defs/tier'\n          }\n        },\n        use_list_prices: {\n          type: 'boolean',\n          description: 'Only set for PERCENTAGE rate_type. Defaults to false. If true, rate is computed using list prices rather than the standard rates for this product on the contract.'\n        }\n      },\n      required: [        'rate_type'\n      ]\n    },\n    credit_type_data: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string'\n        },\n        name: {\n          type: 'string'\n        }\n      },\n      required: [        'id',\n        'name'\n      ]\n    },\n    tier: {\n      type: 'object',\n      properties: {\n        price: {\n          type: 'number'\n        },\n        size: {\n          type: 'number'\n        }\n      },\n      required: [        'price'\n      ]\n    },\n    commit_rate: {\n      type: 'object',\n      description: 'A distinct rate on the rate card. You can choose to use this rate rather than list rate when consuming a credit or commit.',\n      properties: {\n        rate_type: {\n          type: 'string',\n          enum: [            'FLAT',\n            'PERCENTAGE',\n            'SUBSCRIPTION',\n            'TIERED',\n            'CUSTOM'\n          ]\n        },\n        price: {\n          type: 'number',\n          description: 'Commit rate price. For FLAT rate_type, this must be >=0.'\n        },\n        tiers: {\n          type: 'array',\n          description: 'Only set for TIERED rate_type.',\n          items: {\n            $ref: '#/$defs/tier'\n          }\n        }\n      },\n      required: [        'rate_type'\n      ]\n    }\n  }\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {