@metronome/mcp 0.1.0-beta.11

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

@@ -0,0 +1,73 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import type { Metadata } from '../../';
+import Metronome from '@metronome/sdk';
+
+export const metadata: Metadata = {
+  resource: 'v1.contracts',
+  operation: 'write',
+  tags: [],
+  httpMethod: 'post',
+  httpPath: '/v1/contracts/customerBalances/list',
+  operationId: 'listCustomerBalances-v1',
+};
+
+export const tool: Tool = {
+  name: 'list_balances_v1_contracts',
+  description: 'List balances (commits and credits).\n',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      customer_id: {
+        type: 'string',
+      },
+      id: {
+        type: 'string',
+      },
+      covering_date: {
+        type: 'string',
+        description: 'Return only balances that have access schedules that "cover" the provided date',
+        format: 'date-time',
+      },
+      effective_before: {
+        type: 'string',
+        description: 'Include only balances that have any access before the provided date (exclusive)',
+        format: 'date-time',
+      },
+      include_archived: {
+        type: 'boolean',
+        description: 'Include archived credits and credits from archived contracts.',
+      },
+      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_contract_balances: {
+        type: 'boolean',
+        description: 'Include balances on the contract level.',
+      },
+      include_ledgers: {
+        type: 'boolean',
+        description: 'Include ledgers in the response. Setting this flag may cause the query to be slower.',
+      },
+      next_page: {
+        type: 'string',
+        description: 'The next page token from a previous response.',
+      },
+      starting_at: {
+        type: 'string',
+        description: 'Include only balances that have any access on or after the provided date',
+        format: 'date-time',
+      },
+    },
+  },
+};
+
+export const handler = (client: Metronome, args: Record<string, unknown> | undefined) => {
+  const body = args as any;
+  return client.v1.contracts.listBalances(body);
+};
+
+export default { metadata, tool, handler };

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

@@ -0,0 +1,61 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import type { Metadata } from '../../';
+import Metronome from '@metronome/sdk';
+
+export const metadata: Metadata = {
+  resource: 'v1.contracts',
+  operation: 'write',
+  tags: [],
+  httpMethod: 'post',
+  httpPath: '/v1/contracts/list',
+  operationId: 'listContracts-v1',
+};
+
+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.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      customer_id: {
+        type: 'string',
+      },
+      covering_date: {
+        type: 'string',
+        description:
+          'Optional RFC 3339 timestamp. If provided, the response will include only contracts effective on the provided date.  This cannot be provided if the starting_at filter is provided.',
+        format: 'date-time',
+      },
+      include_archived: {
+        type: 'boolean',
+        description: 'Include archived contracts in the response',
+      },
+      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.',
+      },
+      starting_at: {
+        type: 'string',
+        description:
+          'Optional RFC 3339 timestamp. If provided, the response will include only contracts where effective_at is on or after the provided date.  This cannot be provided if the covering_date filter is provided.',
+        format: 'date-time',
+      },
+    },
+  },
+};
+
+export const handler = (client: Metronome, args: Record<string, unknown> | undefined) => {
+  const body = args as any;
+  return client.v1.contracts.list(body);
+};
+
+export default { metadata, tool, handler };

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

@@ -0,0 +1,46 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import type { Metadata } from '../../../';
+import Metronome from '@metronome/sdk';
+
+export const metadata: Metadata = {
+  resource: 'v1.contracts.named_schedules',
+  operation: 'write',
+  tags: [],
+  httpMethod: 'post',
+  httpPath: '/v1/contract-pricing/rate-cards/getNamedSchedule',
+  operationId: 'getRateCardNamedSchedule-v1',
+};
+
+export const tool: Tool = {
+  name: 'retrieve_contracts_v1_named_schedules',
+  description:
+    "Get a named schedule for the given rate card. This endpoint's availability is dependent on your client's configuration.",
+  inputSchema: {
+    type: 'object',
+    properties: {
+      rate_card_id: {
+        type: 'string',
+        description: 'ID of the rate card whose named schedule is to be retrieved',
+      },
+      schedule_name: {
+        type: 'string',
+        description: 'The identifier for the schedule to be retrieved',
+      },
+      covering_date: {
+        type: 'string',
+        description:
+          'If provided, at most one schedule segment will be returned (the one that covers this date). If not provided, all segments will be returned.',
+        format: 'date-time',
+      },
+    },
+  },
+};
+
+export const handler = (client: Metronome, args: Record<string, unknown> | undefined) => {
+  const body = args as any;
+  return client.v1.contracts.namedSchedules.retrieve(body);
+};
+
+export default { metadata, tool, handler };

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

@@ -0,0 +1,53 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import type { Metadata } from '../../../';
+import Metronome from '@metronome/sdk';
+
+export const metadata: Metadata = {
+  resource: 'v1.contracts.named_schedules',
+  operation: 'write',
+  tags: [],
+  httpMethod: 'post',
+  httpPath: '/v1/contract-pricing/rate-cards/updateNamedSchedule',
+  operationId: 'updateRateCardNamedSchedule-v1',
+};
+
+export const tool: Tool = {
+  name: 'update_contracts_v1_named_schedules',
+  description:
+    "Update a named schedule for the given rate card. This endpoint's availability is dependent on your client's configuration.",
+  inputSchema: {
+    type: 'object',
+    properties: {
+      rate_card_id: {
+        type: 'string',
+        description: 'ID of the rate card whose named schedule is to be updated',
+      },
+      schedule_name: {
+        type: 'string',
+        description: 'The identifier for the schedule to be updated',
+      },
+      starting_at: {
+        type: 'string',
+        format: 'date-time',
+      },
+      value: {
+        type: 'object',
+        description:
+          'The value to set for the named schedule. The structure of this object is specific to the named schedule.',
+      },
+      ending_before: {
+        type: 'string',
+        format: 'date-time',
+      },
+    },
+  },
+};
+
+export const handler = (client: Metronome, args: Record<string, unknown> | undefined) => {
+  const body = args as any;
+  return client.v1.contracts.namedSchedules.update(body);
+};
+
+export default { metadata, tool, handler };

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

@@ -0,0 +1,35 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import type { Metadata } from '../../../';
+import Metronome from '@metronome/sdk';
+
+export const metadata: Metadata = {
+  resource: 'v1.contracts.products',
+  operation: 'write',
+  tags: [],
+  httpMethod: 'post',
+  httpPath: '/v1/contract-pricing/products/archive',
+  operationId: 'archiveProductListItem-v1',
+};
+
+export const tool: Tool = {
+  name: 'archive_contracts_v1_products',
+  description: 'Archive a product\n',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      product_id: {
+        type: 'string',
+        description: 'ID of the product to be archived',
+      },
+    },
+  },
+};
+
+export const handler = (client: Metronome, args: Record<string, unknown> | undefined) => {
+  const body = args as any;
+  return client.v1.contracts.products.archive(body);
+};
+
+export default { metadata, tool, handler };

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

@@ -0,0 +1,141 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import type { Metadata } from '../../../';
+import Metronome from '@metronome/sdk';
+
+export const metadata: Metadata = {
+  resource: 'v1.contracts.products',
+  operation: 'write',
+  tags: [],
+  httpMethod: 'post',
+  httpPath: '/v1/contract-pricing/products/create',
+  operationId: 'createProduct-v1',
+};
+
+export const tool: Tool = {
+  name: 'create_contracts_v1_products',
+  description: 'Create a new product\n',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      name: {
+        type: 'string',
+        description: 'displayed on invoices',
+      },
+      type: {
+        type: 'string',
+        enum: ['FIXED', 'USAGE', 'COMPOSITE', 'SUBSCRIPTION', 'PROFESSIONAL_SERVICE', 'PRO_SERVICE'],
+      },
+      billable_metric_id: {
+        type: 'string',
+        description: 'Required for USAGE products',
+      },
+      composite_product_ids: {
+        type: 'array',
+        description: 'Required for COMPOSITE products',
+        items: {
+          type: 'string',
+        },
+      },
+      composite_tags: {
+        type: 'array',
+        description: 'Required for COMPOSITE products',
+        items: {
+          type: 'string',
+        },
+      },
+      exclude_free_usage: {
+        type: 'boolean',
+        description:
+          'Beta feature only available for composite products. If true, products with $0 will not be included when computing composite usage. Defaults to false',
+      },
+      is_refundable: {
+        type: 'boolean',
+        description:
+          "This field's availability is dependent on your client's configuration. Defaults to true.",
+      },
+      netsuite_internal_item_id: {
+        type: 'string',
+        description: "This field's availability is dependent on your client's configuration.",
+      },
+      netsuite_overage_item_id: {
+        type: 'string',
+        description: "This field's availability is dependent on your client's configuration.",
+      },
+      presentation_group_key: {
+        type: 'array',
+        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.',
+        items: {
+          type: 'string',
+        },
+      },
+      pricing_group_key: {
+        type: 'array',
+        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.',
+        items: {
+          type: 'string',
+        },
+      },
+      quantity_conversion: {
+        $ref: '#/$defs/quantity_conversion',
+      },
+      quantity_rounding: {
+        $ref: '#/$defs/quantity_rounding',
+      },
+      tags: {
+        type: 'array',
+        items: {
+          type: 'string',
+        },
+      },
+    },
+    $defs: {
+      quantity_conversion: {
+        type: 'object',
+        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".',
+        properties: {
+          conversion_factor: {
+            type: 'number',
+            description: 'The factor to multiply or divide the quantity by.',
+          },
+          operation: {
+            type: 'string',
+            description: 'The operation to perform on the quantity',
+            enum: ['MULTIPLY', 'DIVIDE'],
+          },
+          name: {
+            type: 'string',
+            description: 'Optional name for this conversion.',
+          },
+        },
+        required: ['conversion_factor', 'operation'],
+      },
+      quantity_rounding: {
+        type: 'object',
+        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.',
+        properties: {
+          decimal_places: {
+            type: 'number',
+          },
+          rounding_method: {
+            type: 'string',
+            enum: ['ROUND_UP', 'ROUND_DOWN', 'ROUND_HALF_UP'],
+          },
+        },
+        required: ['decimal_places', 'rounding_method'],
+      },
+    },
+  },
+};
+
+export const handler = (client: Metronome, args: Record<string, unknown> | undefined) => {
+  const body = args as any;
+  return client.v1.contracts.products.create(body);
+};
+
+export default { metadata, tool, handler };

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

@@ -0,0 +1,44 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import type { Metadata } from '../../../';
+import Metronome from '@metronome/sdk';
+
+export const metadata: Metadata = {
+  resource: 'v1.contracts.products',
+  operation: 'write',
+  tags: [],
+  httpMethod: 'post',
+  httpPath: '/v1/contract-pricing/products/list',
+  operationId: 'listProducts-v1',
+};
+
+export const tool: Tool = {
+  name: 'list_contracts_v1_products',
+  description: 'List products\n',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      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.',
+      },
+      archive_filter: {
+        type: 'string',
+        description: 'Filter options for the product list. If not provided, defaults to not archived.',
+        enum: ['ARCHIVED', 'NOT_ARCHIVED', 'ALL'],
+      },
+    },
+  },
+};
+
+export const handler = (client: Metronome, args: Record<string, unknown> | undefined) => {
+  const body = args as any;
+  return client.v1.contracts.products.list(body);
+};
+
+export default { metadata, tool, handler };

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

@@ -0,0 +1,34 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import type { Metadata } from '../../../';
+import Metronome from '@metronome/sdk';
+
+export const metadata: Metadata = {
+  resource: 'v1.contracts.products',
+  operation: 'write',
+  tags: [],
+  httpMethod: 'post',
+  httpPath: '/v1/contract-pricing/products/get',
+  operationId: 'getProduct-v1',
+};
+
+export const tool: Tool = {
+  name: 'retrieve_contracts_v1_products',
+  description: 'Get a specific product\n',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      id: {
+        type: 'string',
+      },
+    },
+  },
+};
+
+export const handler = (client: Metronome, args: Record<string, unknown> | undefined) => {
+  const body = args as any;
+  return client.v1.contracts.products.retrieve(body);
+};
+
+export default { metadata, tool, handler };

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

@@ -0,0 +1,153 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import type { Metadata } from '../../../';
+import Metronome from '@metronome/sdk';
+
+export const metadata: Metadata = {
+  resource: 'v1.contracts.products',
+  operation: 'write',
+  tags: [],
+  httpMethod: 'post',
+  httpPath: '/v1/contract-pricing/products/update',
+  operationId: 'updateProduct-v1',
+};
+
+export const tool: Tool = {
+  name: 'update_contracts_v1_products',
+  description: 'Update a product\n',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      product_id: {
+        type: 'string',
+        description: 'ID of the product to update',
+      },
+      starting_at: {
+        type: 'string',
+        description:
+          'Timestamp representing when the update should go into effect. It must be on an hour boundary (e.g. 1:00, not 1:30).',
+        format: 'date-time',
+      },
+      billable_metric_id: {
+        type: 'string',
+        description:
+          "Available for USAGE products only. If not provided, defaults to product's current billable metric.",
+      },
+      composite_product_ids: {
+        type: 'array',
+        description:
+          "Available for COMPOSITE products only. If not provided, defaults to product's current composite_product_ids.",
+        items: {
+          type: 'string',
+        },
+      },
+      composite_tags: {
+        type: 'array',
+        description:
+          "Available for COMPOSITE products only. If not provided, defaults to product's current composite_tags.",
+        items: {
+          type: 'string',
+        },
+      },
+      exclude_free_usage: {
+        type: 'boolean',
+        description:
+          'Beta feature only available for composite products. If true, products with $0 will not be included when computing composite usage. Defaults to false',
+      },
+      is_refundable: {
+        type: 'boolean',
+        description:
+          "Defaults to product's current refundability status. This field's availability is dependent on your client's configuration.",
+      },
+      name: {
+        type: 'string',
+        description: "displayed on invoices. If not provided, defaults to product's current name.",
+      },
+      netsuite_internal_item_id: {
+        type: 'string',
+        description:
+          "If not provided, defaults to product's current netsuite_internal_item_id. This field's availability is dependent on your client's configuration.",
+      },
+      netsuite_overage_item_id: {
+        type: 'string',
+        description:
+          "Available for USAGE and COMPOSITE products only. If not provided, defaults to product's current netsuite_overage_item_id. This field's availability is dependent on your client's configuration.",
+      },
+      presentation_group_key: {
+        type: 'array',
+        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.',
+        items: {
+          type: 'string',
+        },
+      },
+      pricing_group_key: {
+        type: 'array',
+        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.',
+        items: {
+          type: 'string',
+        },
+      },
+      quantity_conversion: {
+        $ref: '#/$defs/quantity_conversion',
+      },
+      quantity_rounding: {
+        $ref: '#/$defs/quantity_rounding',
+      },
+      tags: {
+        type: 'array',
+        description: "If not provided, defaults to product's current tags",
+        items: {
+          type: 'string',
+        },
+      },
+    },
+    $defs: {
+      quantity_conversion: {
+        type: 'object',
+        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".',
+        properties: {
+          conversion_factor: {
+            type: 'number',
+            description: 'The factor to multiply or divide the quantity by.',
+          },
+          operation: {
+            type: 'string',
+            description: 'The operation to perform on the quantity',
+            enum: ['MULTIPLY', 'DIVIDE'],
+          },
+          name: {
+            type: 'string',
+            description: 'Optional name for this conversion.',
+          },
+        },
+        required: ['conversion_factor', 'operation'],
+      },
+      quantity_rounding: {
+        type: 'object',
+        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.',
+        properties: {
+          decimal_places: {
+            type: 'number',
+          },
+          rounding_method: {
+            type: 'string',
+            enum: ['ROUND_UP', 'ROUND_DOWN', 'ROUND_HALF_UP'],
+          },
+        },
+        required: ['decimal_places', 'rounding_method'],
+      },
+    },
+  },
+};
+
+export const handler = (client: Metronome, args: Record<string, unknown> | undefined) => {
+  const body = args as any;
+  return client.v1.contracts.products.update(body);
+};
+
+export default { metadata, tool, handler };

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

@@ -0,0 +1,34 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import type { Metadata } from '../../../';
+import Metronome from '@metronome/sdk';
+
+export const metadata: Metadata = {
+  resource: 'v1.contracts.rateCards',
+  operation: 'write',
+  tags: [],
+  httpMethod: 'post',
+  httpPath: '/v1/contract-pricing/rate-cards/archive',
+  operationId: 'archiveRateCard-v1',
+};
+
+export const tool: Tool = {
+  name: 'archive_contracts_v1_rate_cards',
+  description: 'Archive a rate card\n',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      id: {
+        type: 'string',
+      },
+    },
+  },
+};
+
+export const handler = (client: Metronome, args: Record<string, unknown> | undefined) => {
+  const body = args as any;
+  return client.v1.contracts.rateCards.archive(body);
+};
+
+export default { metadata, tool, handler };