@metronome/mcp 2.2.0 → 3.4.1

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

@@ -1,106 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-import { isJqError, maybeFilter } from '@metronome/mcp/filtering';
-import { Metadata, asErrorResult, asTextContentResult } from '@metronome/mcp/tools/types';
-
-import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import Metronome from '@metronome/sdk';
-
-export const metadata: Metadata = {
-  resource: 'v1.contracts.rateCards',
-  operation: 'write',
-  tags: [],
-  httpMethod: 'post',
-  httpPath: '/v1/contract-pricing/rate-cards/getRateSchedule',
-  operationId: 'getRateSchedule-v1',
-};
-
-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\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: {
-      rate_card_id: {
-        type: 'string',
-        description: 'ID of the rate card to get the schedule for',
-      },
-      starting_at: {
-        type: 'string',
-        description: 'inclusive starting point for the rates schedule',
-        format: 'date-time',
-      },
-      limit: {
-        type: 'integer',
-        description: 'Max number of results that should be returned',
-      },
-      next_page: {
-        type: 'string',
-        description: 'Cursor that indicates where the next page of results should start.',
-      },
-      ending_before: {
-        type: 'string',
-        description:
-          'optional exclusive end date for the rates schedule. When not specified rates will show all future schedule segments.',
-        format: 'date-time',
-      },
-      selectors: {
-        type: 'array',
-        description:
-          'List of rate selectors, rates matching ANY of the selector will be included in the response Passing no selectors will result in all rates being returned.',
-        items: {
-          type: 'object',
-          properties: {
-            billing_frequency: {
-              type: 'string',
-              description:
-                'Subscription rates matching the billing frequency will be included in the response.',
-              enum: ['MONTHLY', 'QUARTERLY', 'ANNUAL', 'WEEKLY'],
-            },
-            partial_pricing_group_values: {
-              type: 'object',
-              description:
-                'List of pricing group key value pairs, rates containing the matching key / value pairs will be included in the response.',
-              additionalProperties: true,
-            },
-            pricing_group_values: {
-              type: 'object',
-              description:
-                'List of pricing group key value pairs, rates matching all of the key / value pairs will be included in the response.',
-              additionalProperties: true,
-            },
-            product_id: {
-              type: 'string',
-              description: 'Rates matching the product id will be included in the response.',
-            },
-          },
-        },
-      },
-      jq_filter: {
-        type: 'string',
-        title: 'jq Filter',
-        description:
-          'A jq filter to apply to the response to include certain fields. Consult the output schema in the tool description to see the fields that are available.\n\nFor example: to include only the `name` field in every object of a results array, you can provide ".results[].name".\n\nFor more information, see the [jq documentation](https://jqlang.org/manual/).',
-      },
-    },
-    required: ['rate_card_id', 'starting_at'],
-  },
-  annotations: {},
-};
-
-export const handler = async (client: Metronome, args: Record<string, unknown> | undefined) => {
-  const { jq_filter, ...body } = args as any;
-  try {
-    return asTextContentResult(
-      await maybeFilter(jq_filter, await client.v1.contracts.rateCards.retrieveRateSchedule(body)),
-    );
-  } catch (error) {
-    if (error instanceof Metronome.APIError || isJqError(error)) {
-      return asErrorResult(error.message);
-    }
-    throw error;
-  }
-};
-
-export default { metadata, tool, handler };

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

@@ -1,84 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-import { isJqError, maybeFilter } from '@metronome/mcp/filtering';
-import { Metadata, asErrorResult, asTextContentResult } from '@metronome/mcp/tools/types';
-
-import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import Metronome from '@metronome/sdk';
-
-export const metadata: Metadata = {
-  resource: 'v1.contracts.rateCards',
-  operation: 'write',
-  tags: [],
-  httpMethod: 'post',
-  httpPath: '/v1/contract-pricing/rate-cards/update',
-  operationId: 'updateRateCard-v1',
-};
-
-export const tool: Tool = {
-  name: 'update_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\nUpdate the metadata properties of an existing rate card, including its name, description, and aliases. This endpoint is designed for managing rate card identity and reference aliases rather than modifying pricing rates.\n\nModifies the descriptive properties and alias configuration of a rate card without affecting the underlying pricing rates or schedules. This allows you to update how a rate card is identified and referenced throughout your system.\n\n### Use this endpoint to:\n- Rate card renaming: Update display names or descriptions for organizational clarity\n- Alias management: Add, modify, or schedule alias transitions for seamless rate card migrations\n- Documentation updates: Keep rate card descriptions current with business context\n- Self-serve provisioning setup: Configure aliases to enable code-free rate card transitions\n\n#### Active contract impact:\n- Alias changes: Already-created contracts continue using their originally assigned rate cards.\n- Other changes made using this endpoint will only impact the Metronome UI.\n\n#### Grandfathering existing PLG customer pricing:\n- Rate card aliases support scheduled transitions, enabling seamless rate card migrations for new customers, allowing existing customers to be grandfathered into their existing prices without code. Note that there are multiple mechanisms to support grandfathering in Metronome. \n\n#### How scheduled aliases work for PLG grandfathering:\nInitial setup:\n- Add alias to current rate card: Assign a stable alias (e.g., \"standard-pricing\") to your active rate card\n- Reference alias during contract creation: Configure your self-serve workflow to create contracts using `rate_card_alias` instead of direct `rate_card_id`\n- Automatic resolution: New contracts referencing the alias automatically resolve to the rate card associated with the alias at the point in time of provisioning\n\n#### Grandfathering process:\n- Create new rate card: Build your new rate card with updated pricing structure\n- Schedule alias transition: Add the same alias to the new rate card with a `starting_at` timestamp\n- Automatic cutover: Starting at the scheduled time, new contracts created in your PLG workflow using that alias will automatically reference the new rate card\n\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/rate_card_update_response',\n  $defs: {\n    rate_card_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: {
-      rate_card_id: {
-        type: 'string',
-        description: 'ID of the rate card to update',
-      },
-      aliases: {
-        type: 'array',
-        description:
-          'Reference this alias when creating a contract. If the same alias is assigned to multiple rate cards, it will reference the rate card to which it was most recently assigned. It is not exposed to end customers.',
-        items: {
-          type: 'object',
-          properties: {
-            name: {
-              type: 'string',
-            },
-            ending_before: {
-              type: 'string',
-              format: 'date-time',
-            },
-            starting_at: {
-              type: 'string',
-              format: 'date-time',
-            },
-          },
-          required: ['name'],
-        },
-      },
-      description: {
-        type: 'string',
-      },
-      name: {
-        type: 'string',
-        description: 'Used only in UI/API. It is not exposed to end customers.',
-      },
-      jq_filter: {
-        type: 'string',
-        title: 'jq Filter',
-        description:
-          'A jq filter to apply to the response to include certain fields. Consult the output schema in the tool description to see the fields that are available.\n\nFor example: to include only the `name` field in every object of a results array, you can provide ".results[].name".\n\nFor more information, see the [jq documentation](https://jqlang.org/manual/).',
-      },
-    },
-    required: ['rate_card_id'],
-  },
-  annotations: {},
-};
-
-export const handler = async (client: Metronome, args: Record<string, unknown> | undefined) => {
-  const { jq_filter, ...body } = args as any;
-  try {
-    return asTextContentResult(
-      await maybeFilter(jq_filter, await client.v1.contracts.rateCards.update(body)),
-    );
-  } catch (error) {
-    if (error instanceof Metronome.APIError || isJqError(error)) {
-      return asErrorResult(error.message);
-    }
-    throw error;
-  }
-};
-
-export default { metadata, tool, handler };

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

@@ -1,113 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-import { isJqError, maybeFilter } from '@metronome/mcp/filtering';
-import { Metadata, asErrorResult, asTextContentResult } from '@metronome/mcp/tools/types';
-
-import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import Metronome from '@metronome/sdk';
-
-export const metadata: Metadata = {
-  resource: 'v1.contracts',
-  operation: 'write',
-  tags: [],
-  httpMethod: 'post',
-  httpPath: '/v1/contracts/getContractRateSchedule',
-  operationId: 'getContractRateSchedule-v1',
-};
-
-export const tool: Tool = {
-  name: 'retrieve_rate_schedule_v1_contracts',
-  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\nFor a specific customer and contract, get the rates at a specific point in time. This endpoint takes the contract's rate card into consideration, including scheduled changes. It also takes into account overrides on the contract. \n\nFor example, if you want to show your customer a summary of the prices they are paying, inclusive of any negotiated discounts or promotions, use this endpoint. This endpoint only returns rates that are entitled.\n\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/contract_retrieve_rate_schedule_response',\n  $defs: {\n    contract_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              list_rate: {\n                $ref: '#/$defs/rate'\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_card_id: {\n                type: 'string'\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              override_rate: {\n                $ref: '#/$defs/rate'\n              },\n              pricing_group_values: {\n                type: 'object',\n                additionalProperties: true\n              }\n            },\n            required: [              'entitled',\n              'list_rate',\n              'product_custom_fields',\n              'product_id',\n              'product_name',\n              'product_tags',\n              'rate_card_id',\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: {
-      contract_id: {
-        type: 'string',
-        description: 'ID of the contract to get the rate schedule for.',
-      },
-      customer_id: {
-        type: 'string',
-        description: 'ID of the customer for whose contract to get the rate schedule for.',
-      },
-      limit: {
-        type: 'integer',
-        description: 'Max number of results that should be returned',
-      },
-      next_page: {
-        type: 'string',
-        description: 'Cursor that indicates where the next page of results should start.',
-      },
-      at: {
-        type: 'string',
-        description:
-          'optional timestamp which overlaps with the returned rate schedule segments. When not specified, the current timestamp will be used.',
-        format: 'date-time',
-      },
-      selectors: {
-        type: 'array',
-        description:
-          'List of rate selectors, rates matching ANY of the selectors will be included in the response. Passing no selectors will result in all rates being returned.',
-        items: {
-          type: 'object',
-          properties: {
-            billing_frequency: {
-              type: 'string',
-              description:
-                'Subscription rates matching the billing frequency will be included in the response.',
-              enum: ['MONTHLY', 'QUARTERLY', 'ANNUAL', 'WEEKLY'],
-            },
-            partial_pricing_group_values: {
-              type: 'object',
-              description:
-                'List of pricing group key value pairs, rates containing the matching key / value pairs will be included in the response.',
-              additionalProperties: true,
-            },
-            pricing_group_values: {
-              type: 'object',
-              description:
-                'List of pricing group key value pairs, rates matching all of the key / value pairs will be included in the response.',
-              additionalProperties: true,
-            },
-            product_id: {
-              type: 'string',
-              description: 'Rates matching the product id will be included in the response.',
-            },
-            product_tags: {
-              type: 'array',
-              description:
-                'List of product tags, rates matching any of the tags will be included in the response.',
-              items: {
-                type: 'string',
-              },
-            },
-          },
-        },
-      },
-      jq_filter: {
-        type: 'string',
-        title: 'jq Filter',
-        description:
-          'A jq filter to apply to the response to include certain fields. Consult the output schema in the tool description to see the fields that are available.\n\nFor example: to include only the `name` field in every object of a results array, you can provide ".results[].name".\n\nFor more information, see the [jq documentation](https://jqlang.org/manual/).',
-      },
-    },
-    required: ['contract_id', 'customer_id'],
-  },
-  annotations: {},
-};
-
-export const handler = async (client: Metronome, args: Record<string, unknown> | undefined) => {
-  const { jq_filter, ...body } = args as any;
-  try {
-    return asTextContentResult(
-      await maybeFilter(jq_filter, await client.v1.contracts.retrieveRateSchedule(body)),
-    );
-  } catch (error) {
-    if (error instanceof Metronome.APIError || isJqError(error)) {
-      return asErrorResult(error.message);
-    }
-    throw error;
-  }
-};
-
-export default { metadata, tool, handler };

package/src/tools/v1/contracts/retrieve-subscription-quantity-history-v1-contracts.ts

@@ -1,60 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-import { isJqError, maybeFilter } from '@metronome/mcp/filtering';
-import { Metadata, asErrorResult, asTextContentResult } from '@metronome/mcp/tools/types';
-
-import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import Metronome from '@metronome/sdk';
-
-export const metadata: Metadata = {
-  resource: 'v1.contracts',
-  operation: 'write',
-  tags: [],
-  httpMethod: 'post',
-  httpPath: '/v1/contracts/getSubscriptionQuantityHistory',
-  operationId: 'getSubscriptionQuantityHistory-v1',
-};
-
-export const tool: Tool = {
-  name: 'retrieve_subscription_quantity_history_v1_contracts',
-  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 the history of subscription quantities and prices over time for a given `subscription_id`. This endpoint can be used to power an in-product experience where you show a customer their historical changes to seat count. Future changes are not included in this endpoint - use the `getContract` endpoint to view the future scheduled changes to a subscription's quantity. \n\nSubscriptions are used to model fixed recurring fees as well as seat-based recurring fees. To model changes to the number of seats in Metronome, you can increment or decrement the quantity on a subscription at any point in the past or future.\n\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/contract_retrieve_subscription_quantity_history_response',\n  $defs: {\n    contract_retrieve_subscription_quantity_history_response: {\n      type: 'object',\n      properties: {\n        data: {\n          type: 'object',\n          properties: {\n            fiat_credit_type_id: {\n              type: 'string'\n            },\n            history: {\n              type: 'array',\n              items: {\n                type: 'object',\n                properties: {\n                  data: {\n                    type: 'array',\n                    items: {\n                      type: 'object',\n                      properties: {\n                        quantity: {\n                          type: 'number'\n                        },\n                        total: {\n                          type: 'number'\n                        },\n                        unit_price: {\n                          type: 'number'\n                        }\n                      },\n                      required: [                        'quantity',\n                        'total',\n                        'unit_price'\n                      ]\n                    }\n                  },\n                  starting_at: {\n                    type: 'string',\n                    format: 'date-time'\n                  }\n                },\n                required: [                  'data',\n                  'starting_at'\n                ]\n              }\n            },\n            subscription_id: {\n              type: 'string'\n            }\n          }\n        }\n      },\n      required: [        'data'\n      ]\n    }\n  }\n}\n```",
-  inputSchema: {
-    type: 'object',
-    properties: {
-      contract_id: {
-        type: 'string',
-      },
-      customer_id: {
-        type: 'string',
-      },
-      subscription_id: {
-        type: 'string',
-      },
-      jq_filter: {
-        type: 'string',
-        title: 'jq Filter',
-        description:
-          'A jq filter to apply to the response to include certain fields. Consult the output schema in the tool description to see the fields that are available.\n\nFor example: to include only the `name` field in every object of a results array, you can provide ".results[].name".\n\nFor more information, see the [jq documentation](https://jqlang.org/manual/).',
-      },
-    },
-    required: ['contract_id', 'customer_id', 'subscription_id'],
-  },
-  annotations: {},
-};
-
-export const handler = async (client: Metronome, args: Record<string, unknown> | undefined) => {
-  const { jq_filter, ...body } = args as any;
-  try {
-    return asTextContentResult(
-      await maybeFilter(jq_filter, await client.v1.contracts.retrieveSubscriptionQuantityHistory(body)),
-    );
-  } catch (error) {
-    if (error instanceof Metronome.APIError || isJqError(error)) {
-      return asErrorResult(error.message);
-    }
-    throw error;
-  }
-};
-
-export default { metadata, tool, handler };

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

@@ -1,58 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-import { Metadata, asErrorResult, asTextContentResult } from '@metronome/mcp/tools/types';
-
-import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import Metronome from '@metronome/sdk';
-
-export const metadata: Metadata = {
-  resource: 'v1.contracts',
-  operation: 'write',
-  tags: [],
-  httpMethod: 'post',
-  httpPath: '/v1/contracts/get',
-  operationId: 'getContract-v1',
-};
-
-export const tool: Tool = {
-  name: 'retrieve_v1_contracts',
-  description:
-    'This is the v1 endpoint to get a contract. New clients should implement using the v2 endpoint.\n',
-  inputSchema: {
-    type: 'object',
-    properties: {
-      contract_id: {
-        type: 'string',
-      },
-      customer_id: {
-        type: 'string',
-      },
-      include_balance: {
-        type: 'boolean',
-        description:
-          'Include the balance of credits and commits in the response. Setting this flag may cause the query to be slower.',
-      },
-      include_ledgers: {
-        type: 'boolean',
-        description:
-          'Include commit ledgers in the response. Setting this flag may cause the query to be slower.',
-      },
-    },
-    required: ['contract_id', 'customer_id'],
-  },
-  annotations: {},
-};
-
-export const handler = async (client: Metronome, args: Record<string, unknown> | undefined) => {
-  const body = args as any;
-  try {
-    return asTextContentResult(await client.v1.contracts.retrieve(body));
-  } catch (error) {
-    if (error instanceof Metronome.APIError) {
-      return asErrorResult(error.message);
-    }
-    throw error;
-  }
-};
-
-export default { metadata, tool, handler };

package/src/tools/v1/contracts/schedule-pro-services-invoice-v1-contracts.ts

@@ -1,109 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-import { Metadata, asErrorResult, asTextContentResult } from '@metronome/mcp/tools/types';
-
-import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import Metronome from '@metronome/sdk';
-
-export const metadata: Metadata = {
-  resource: 'v1.contracts',
-  operation: 'write',
-  tags: [],
-  httpMethod: 'post',
-  httpPath: '/v1/contracts/scheduleProServicesInvoice',
-  operationId: 'scheduleProServicesInvoice-v1',
-};
-
-export const tool: Tool = {
-  name: 'schedule_pro_services_invoice_v1_contracts',
-  description:
-    "Create a new scheduled invoice for Professional Services terms on a contract. This endpoint's availability is dependent on your client's configuration.\n",
-  inputSchema: {
-    type: 'object',
-    properties: {
-      contract_id: {
-        type: 'string',
-      },
-      customer_id: {
-        type: 'string',
-      },
-      issued_at: {
-        type: 'string',
-        description: 'The date the invoice is issued',
-        format: 'date-time',
-      },
-      line_items: {
-        type: 'array',
-        description: 'Each line requires an amount or both unit_price and quantity.',
-        items: {
-          type: 'object',
-          description: 'Describes the line item for a professional service charge on an invoice.',
-          properties: {
-            professional_service_id: {
-              type: 'string',
-            },
-            amendment_id: {
-              type: 'string',
-              description: 'If the professional_service_id was added on an amendment, this is required.',
-            },
-            amount: {
-              type: 'number',
-              description: 'Amount for the term on the new invoice.',
-            },
-            metadata: {
-              type: 'string',
-              description: 'For client use.',
-            },
-            netsuite_invoice_billing_end: {
-              type: 'string',
-              description: 'The end date for the billing period on the invoice.',
-              format: 'date-time',
-            },
-            netsuite_invoice_billing_start: {
-              type: 'string',
-              description: 'The start date for the billing period on the invoice.',
-              format: 'date-time',
-            },
-            quantity: {
-              type: 'number',
-              description:
-                'Quantity for the charge. Will be multiplied by unit_price to determine the amount.',
-            },
-            unit_price: {
-              type: 'number',
-              description:
-                'If specified, this overrides the unit price on the pro service term. Must also provide quantity (but not amount) if providing unit_price.',
-            },
-          },
-          required: ['professional_service_id'],
-        },
-      },
-      netsuite_invoice_header_end: {
-        type: 'string',
-        description: 'The end date of the invoice header in Netsuite',
-        format: 'date-time',
-      },
-      netsuite_invoice_header_start: {
-        type: 'string',
-        description: 'The start date of the invoice header in Netsuite',
-        format: 'date-time',
-      },
-    },
-    required: ['contract_id', 'customer_id', 'issued_at', 'line_items'],
-  },
-  annotations: {},
-};
-
-export const handler = async (client: Metronome, args: Record<string, unknown> | undefined) => {
-  const body = args as any;
-  try {
-    return asTextContentResult(await client.v1.contracts.scheduleProServicesInvoice(body));
-  } catch (error) {
-    if (error instanceof Metronome.APIError) {
-      return asErrorResult(error.message);
-    }
-    throw error;
-  }
-};
-
-export default { metadata, tool, handler };

package/src/tools/v1/contracts/set-usage-filter-v1-contracts.ts

@@ -1,55 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-import { Metadata, asTextContentResult } from '@metronome/mcp/tools/types';
-
-import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import Metronome from '@metronome/sdk';
-
-export const metadata: Metadata = {
-  resource: 'v1.contracts',
-  operation: 'write',
-  tags: [],
-  httpMethod: 'post',
-  httpPath: '/v1/contracts/setUsageFilter',
-  operationId: 'setUsageFilter-v1',
-};
-
-export const tool: Tool = {
-  name: 'set_usage_filter_v1_contracts',
-  description:
-    'If a customer has multiple contracts with overlapping rates, the usage filter routes usage to the appropriate contract based on a predefined group key. \n\nAs an example, imagine you have a customer associated with two projects. Each project is associated with its own contract. You can create a usage filter with group key `project_id`\non each contract, and route usage for `project_1` to the first contract and `project_2` to the second contract. \n\n### Use this endpoint to:\n- Support enterprise contracting scenarios where multiple contracts are associated to the same customer with the same rates.\n- Update the usage filter associated with the contract over time. \n\n### Usage guidelines:\nTo use usage filters, the `group_key` must be defined on the billable metrics underlying the rate card on the contracts.\n',
-  inputSchema: {
-    type: 'object',
-    properties: {
-      contract_id: {
-        type: 'string',
-      },
-      customer_id: {
-        type: 'string',
-      },
-      group_key: {
-        type: 'string',
-      },
-      group_values: {
-        type: 'array',
-        items: {
-          type: 'string',
-        },
-      },
-      starting_at: {
-        type: 'string',
-        format: 'date-time',
-      },
-    },
-    required: ['contract_id', 'customer_id', 'group_key', 'group_values', 'starting_at'],
-  },
-  annotations: {},
-};
-
-export const handler = async (client: Metronome, args: Record<string, unknown> | undefined) => {
-  const body = args as any;
-  const response = await client.v1.contracts.setUsageFilter(body).asResponse();
-  return asTextContentResult(await response.text());
-};
-
-export default { metadata, tool, handler };