@metronome/mcp 2.2.0 → 3.4.1

package/src/tools/v1/contracts/update-end-date-v1-contracts.ts

@@ -1,68 +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/updateEndDate',
-  operationId: 'updateContractEndDate-v1',
-};
-
-export const tool: Tool = {
-  name: 'update_end_date_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\nUpdate or add an end date to a contract. Ending a contract early will impact draft usage statements, truncate any terms, and remove upcoming scheduled invoices. Moving the date into the future will only extend the contract length. Terms and scheduled invoices are not extended. In-advance subscriptions will not be extended. Use this if a contract's end date has changed or if a perpetual contract ends.\n\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/contract_update_end_date_response',\n  $defs: {\n    contract_update_end_date_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: {
-      contract_id: {
-        type: 'string',
-        description: 'ID of the contract to update',
-      },
-      customer_id: {
-        type: 'string',
-        description: 'ID of the customer whose contract is to be updated',
-      },
-      allow_ending_before_finalized_invoice: {
-        type: 'boolean',
-        description:
-          'If true, allows setting the contract end date earlier than the end_timestamp of existing finalized invoices. Finalized invoices will be unchanged; if you want to incorporate the new end date, you can void and regenerate finalized usage invoices. Defaults to true.',
-      },
-      ending_before: {
-        type: 'string',
-        description:
-          'RFC 3339 timestamp indicating when the contract will end (exclusive). If not provided, the contract will be updated to be open-ended.',
-        format: 'date-time',
-      },
-      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.updateEndDate(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/credit-grants/create-v1-credit-grants.ts

@@ -1,188 +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.credit_grants',
-  operation: 'write',
-  tags: [],
-  httpMethod: 'post',
-  httpPath: '/v1/credits/createGrant',
-  operationId: 'createGrant-v1',
-};
-
-export const tool: Tool = {
-  name: 'create_v1_credit_grants',
-  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 credit grant. This is a Plans (deprecated) endpoint. New clients should implement using Contracts.\n\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/credit_grant_create_response',\n  $defs: {\n    credit_grant_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: {
-      customer_id: {
-        type: 'string',
-        description: 'the Metronome ID of the customer',
-      },
-      expires_at: {
-        type: 'string',
-        description: 'The credit grant will only apply to usage or charges dated before this timestamp',
-        format: 'date-time',
-      },
-      grant_amount: {
-        type: 'object',
-        description: 'the amount of credits granted',
-        properties: {
-          amount: {
-            type: 'number',
-          },
-          credit_type_id: {
-            type: 'string',
-            description: 'the ID of the pricing unit to be used. Defaults to USD (cents) if not passed.',
-          },
-        },
-        required: ['amount', 'credit_type_id'],
-      },
-      name: {
-        type: 'string',
-        description: 'the name of the credit grant as it will appear on invoices',
-      },
-      paid_amount: {
-        type: 'object',
-        description: 'the amount paid for this credit grant',
-        properties: {
-          amount: {
-            type: 'number',
-          },
-          credit_type_id: {
-            type: 'string',
-            description: 'the ID of the pricing unit to be used. Defaults to USD (cents) if not passed.',
-          },
-        },
-        required: ['amount', 'credit_type_id'],
-      },
-      priority: {
-        type: 'number',
-      },
-      credit_grant_type: {
-        type: 'string',
-      },
-      custom_fields: {
-        type: 'object',
-        description: 'Custom fields to attach to the credit grant.',
-        additionalProperties: true,
-      },
-      effective_at: {
-        type: 'string',
-        description: 'The credit grant will only apply to usage or charges dated on or after this timestamp',
-        format: 'date-time',
-      },
-      invoice_date: {
-        type: 'string',
-        description: 'The date to issue an invoice for the paid_amount.',
-        format: 'date-time',
-      },
-      product_ids: {
-        type: 'array',
-        description:
-          'The product(s) which these credits will be applied to. (If unspecified, the credits will be applied to charges for all products.). The array ordering specified here will be used to determine the order in which credits will be applied to invoice line items',
-        items: {
-          type: 'string',
-        },
-      },
-      reason: {
-        type: 'string',
-      },
-      rollover_settings: {
-        type: 'object',
-        description:
-          'Configure a rollover for this credit grant so if it expires it rolls over a configured amount to a new credit grant. This feature is currently opt-in only. Contact Metronome to be added to the beta.',
-        properties: {
-          expires_at: {
-            type: 'string',
-            description: 'The date to expire the rollover credits.',
-            format: 'date-time',
-          },
-          priority: {
-            type: 'number',
-            description:
-              'The priority to give the rollover credit grant that gets created when a rollover happens.',
-          },
-          rollover_amount: {
-            anyOf: [
-              {
-                $ref: '#/$defs/rollover_amount_max_percentage',
-              },
-              {
-                $ref: '#/$defs/rollover_amount_max_amount',
-              },
-            ],
-            description: 'Specify how much to rollover to the rollover credit grant',
-          },
-        },
-        required: ['expires_at', 'priority', 'rollover_amount'],
-      },
-      uniqueness_key: {
-        type: 'string',
-        description:
-          'Prevents the creation of duplicates. If a request to create a record is made with a previously used uniqueness key, a new record will not be created and the request will fail with a 409 error.',
-      },
-      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: ['customer_id', 'expires_at', 'grant_amount', 'name', 'paid_amount', 'priority'],
-    $defs: {
-      rollover_amount_max_percentage: {
-        type: 'object',
-        properties: {
-          type: {
-            type: 'string',
-            description: 'Rollover up to a percentage of the original credit grant amount.',
-            enum: ['MAX_PERCENTAGE'],
-          },
-          value: {
-            type: 'number',
-            description: 'The maximum percentage (0-1) of the original credit grant to rollover.',
-          },
-        },
-        required: ['type', 'value'],
-      },
-      rollover_amount_max_amount: {
-        type: 'object',
-        properties: {
-          type: {
-            type: 'string',
-            description: 'Rollover up to a fixed amount of the original credit grant amount.',
-            enum: ['MAX_AMOUNT'],
-          },
-          value: {
-            type: 'number',
-            description: 'The maximum amount to rollover.',
-          },
-        },
-        required: ['type', 'value'],
-      },
-    },
-  },
-  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.creditGrants.create(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/credit-grants/edit-v1-credit-grants.ts

@@ -1,66 +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.credit_grants',
-  operation: 'write',
-  tags: [],
-  httpMethod: 'post',
-  httpPath: '/v1/credits/editGrant',
-  operationId: 'editGrant-v1',
-};
-
-export const tool: Tool = {
-  name: 'edit_v1_credit_grants',
-  description:
-    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nEdit an existing credit grant. This is a Plans (deprecated) endpoint. New clients should implement using Contracts.\n\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/credit_grant_edit_response',\n  $defs: {\n    credit_grant_edit_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: {
-      id: {
-        type: 'string',
-        description: 'the ID of the credit grant',
-      },
-      credit_grant_type: {
-        type: 'string',
-        description: 'the updated credit grant type',
-      },
-      expires_at: {
-        type: 'string',
-        description: 'the updated expiration date for the credit grant',
-        format: 'date-time',
-      },
-      name: {
-        type: 'string',
-        description: 'the updated name for the credit grant',
-      },
-      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: ['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.creditGrants.edit(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/credit-grants/list-entries-v1-credit-grants.ts

@@ -1,86 +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.credit_grants',
-  operation: 'write',
-  tags: [],
-  httpMethod: 'post',
-  httpPath: '/v1/credits/listEntries',
-  operationId: 'listCreditLedgerEntries-v1',
-};
-
-export const tool: Tool = {
-  name: 'list_entries_v1_credit_grants',
-  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\nFetches a list of credit ledger entries. Returns lists of ledgers per customer. Ledger entries are returned in chronological order. Ledger entries associated with voided credit grants are not included. This is a Plans (deprecated) endpoint. New clients should implement using Contracts.\n\n\n# Response Schema\n```json\n{\n  type: 'object',\n  properties: {\n    data: {\n      type: 'array',\n      items: {\n        $ref: '#/$defs/credit_grant_list_entries_response'\n      }\n    },\n    next_page: {\n      type: 'string'\n    }\n  },\n  required: [    'data',\n    'next_page'\n  ],\n  $defs: {\n    credit_grant_list_entries_response: {\n      type: 'object',\n      properties: {\n        customer_id: {\n          type: 'string'\n        },\n        ledgers: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              credit_type: {\n                $ref: '#/$defs/credit_type_data'\n              },\n              ending_balance: {\n                type: 'object',\n                description: 'the effective balances at the end of the specified time window',\n                properties: {\n                  effective_at: {\n                    type: 'string',\n                    description: 'the ending_before request parameter (if supplied) or the current billing period\\'s end date',\n                    format: 'date-time'\n                  },\n                  excluding_pending: {\n                    type: 'number',\n                    description: 'the ending balance, including the balance of all grants that have not expired before the effective_at date and deductions that happened before the effective_at date'\n                  },\n                  including_pending: {\n                    type: 'number',\n                    description: 'the excluding_pending balance plus any pending invoice deductions and expirations that will happen by the effective_at date'\n                  }\n                },\n                required: [                  'effective_at',\n                  'excluding_pending',\n                  'including_pending'\n                ]\n              },\n              entries: {\n                type: 'array',\n                items: {\n                  $ref: '#/$defs/credit_ledger_entry'\n                }\n              },\n              pending_entries: {\n                type: 'array',\n                items: {\n                  $ref: '#/$defs/credit_ledger_entry'\n                }\n              },\n              starting_balance: {\n                type: 'object',\n                properties: {\n                  effective_at: {\n                    type: 'string',\n                    description: 'the starting_on request parameter (if supplied) or the first credit grant\\'s effective_at date',\n                    format: 'date-time'\n                  },\n                  excluding_pending: {\n                    type: 'number',\n                    description: 'the starting balance, including all posted grants, deductions, and expirations that happened at or before the effective_at timestamp'\n                  },\n                  including_pending: {\n                    type: 'number',\n                    description: 'the excluding_pending balance plus any pending activity that has not been posted at the time of the query'\n                  }\n                },\n                required: [                  'effective_at',\n                  'excluding_pending',\n                  'including_pending'\n                ]\n              }\n            },\n            required: [              'credit_type',\n              'ending_balance',\n              'entries',\n              'pending_entries',\n              'starting_balance'\n            ]\n          }\n        }\n      },\n      required: [        'customer_id',\n        'ledgers'\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    credit_ledger_entry: {\n      type: 'object',\n      properties: {\n        amount: {\n          type: 'number',\n          description: 'an amount representing the change to the customer\\'s credit balance'\n        },\n        created_by: {\n          type: 'string'\n        },\n        credit_grant_id: {\n          type: 'string',\n          description: 'the credit grant this entry is related to'\n        },\n        effective_at: {\n          type: 'string',\n          format: 'date-time'\n        },\n        reason: {\n          type: 'string'\n        },\n        running_balance: {\n          type: 'number',\n          description: 'the running balance for this credit type at the time of the ledger entry, including all preceding charges'\n        },\n        invoice_id: {\n          type: 'string',\n          description: 'if this entry is a deduction, the Metronome ID of the invoice where the credit deduction was consumed; if this entry is a grant, the Metronome ID of the invoice where the grant\\'s paid_amount was charged'\n        }\n      },\n      required: [        'amount',\n        'created_by',\n        'credit_grant_id',\n        'effective_at',\n        'reason',\n        'running_balance'\n      ]\n    }\n  }\n}\n```",
-  inputSchema: {
-    type: 'object',
-    properties: {
-      next_page: {
-        type: 'string',
-        description: 'Cursor that indicates where the next page of results should start.',
-      },
-      sort: {
-        type: 'string',
-        description: 'Ledgers sort order by date, asc or desc. Defaults to asc.',
-        enum: ['asc', 'desc'],
-      },
-      credit_type_ids: {
-        type: 'array',
-        description:
-          'A list of Metronome credit type IDs to fetch ledger entries for. If absent, ledger entries for all credit types will be returned.',
-        items: {
-          type: 'string',
-        },
-      },
-      customer_ids: {
-        type: 'array',
-        description:
-          'A list of Metronome customer IDs to fetch ledger entries for. If absent, ledger entries for all customers will be returned.',
-        items: {
-          type: 'string',
-        },
-      },
-      ending_before: {
-        type: 'string',
-        description:
-          "If supplied, ledger entries will only be returned with an effective_at before this time. This timestamp must not be in the future. If no timestamp is supplied, all entries up to the start of the customer's next billing period will be returned.",
-        format: 'date-time',
-      },
-      starting_on: {
-        type: 'string',
-        description: 'If supplied, only ledger entries effective at or after this time will be returned.',
-        format: 'date-time',
-      },
-      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: [],
-  },
-  annotations: {},
-};
-
-export const handler = async (client: Metronome, args: Record<string, unknown> | undefined) => {
-  const { jq_filter, ...body } = args as any;
-  const response = await client.v1.creditGrants.listEntries(body).asResponse();
-  try {
-    return asTextContentResult(await maybeFilter(jq_filter, await response.json()));
-  } catch (error) {
-    if (error instanceof Metronome.APIError || isJqError(error)) {
-      return asErrorResult(error.message);
-    }
-    throw error;
-  }
-};
-
-export default { metadata, tool, handler };

package/src/tools/v1/credit-grants/list-v1-credit-grants.ts

@@ -1,92 +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.credit_grants',
-  operation: 'write',
-  tags: [],
-  httpMethod: 'post',
-  httpPath: '/v1/credits/listGrants',
-  operationId: 'listGrants-v1',
-};
-
-export const tool: Tool = {
-  name: 'list_v1_credit_grants',
-  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 credit grants. This list does not included voided grants. This is a Plans (deprecated) endpoint. New clients should implement using Contracts.\n\n\n# Response Schema\n```json\n{\n  type: 'object',\n  properties: {\n    data: {\n      type: 'array',\n      items: {\n        $ref: '#/$defs/credit_grant_list_response'\n      }\n    },\n    next_page: {\n      type: 'string'\n    }\n  },\n  required: [    'data',\n    'next_page'\n  ],\n  $defs: {\n    credit_grant_list_response: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'the Metronome ID of the credit grant'\n        },\n        balance: {\n          type: 'object',\n          description: 'The effective balance of the grant as of the end of the customer\\'s current billing period. Expiration deductions will be included only if the grant expires before the end of the current billing period.',\n          properties: {\n            effective_at: {\n              type: 'string',\n              description: 'The end_date of the customer\\'s current billing period.',\n              format: 'date-time'\n            },\n            excluding_pending: {\n              type: 'number',\n              description: 'The grant\\'s current balance including all posted deductions. If the grant has expired, this amount will be 0.'\n            },\n            including_pending: {\n              type: 'number',\n              description: 'The grant\\'s current balance including all posted and pending deductions. If the grant expires before the end of the customer\\'s current billing period, this amount will be 0.'\n            }\n          },\n          required: [            'effective_at',\n            'excluding_pending',\n            'including_pending'\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        customer_id: {\n          type: 'string',\n          description: 'the Metronome ID of the customer'\n        },\n        deductions: {\n          type: 'array',\n          items: {\n            $ref: '#/$defs/credit_ledger_entry'\n          }\n        },\n        effective_at: {\n          type: 'string',\n          format: 'date-time'\n        },\n        expires_at: {\n          type: 'string',\n          format: 'date-time'\n        },\n        grant_amount: {\n          type: 'object',\n          description: 'the amount of credits initially granted',\n          properties: {\n            amount: {\n              type: 'number'\n            },\n            credit_type: {\n              $ref: '#/$defs/credit_type_data'\n            }\n          },\n          required: [            'amount',\n            'credit_type'\n          ]\n        },\n        name: {\n          type: 'string'\n        },\n        paid_amount: {\n          type: 'object',\n          description: 'the amount paid for this credit grant',\n          properties: {\n            amount: {\n              type: 'number'\n            },\n            credit_type: {\n              $ref: '#/$defs/credit_type_data'\n            }\n          },\n          required: [            'amount',\n            'credit_type'\n          ]\n        },\n        pending_deductions: {\n          type: 'array',\n          items: {\n            $ref: '#/$defs/credit_ledger_entry'\n          }\n        },\n        priority: {\n          type: 'number'\n        },\n        credit_grant_type: {\n          type: 'string'\n        },\n        invoice_id: {\n          type: 'string',\n          description: 'the Metronome ID of the invoice with the purchase charge for this credit grant, if applicable'\n        },\n        products: {\n          type: 'array',\n          description: 'The products which these credits will be applied to. (If unspecified, the credits will be applied to charges for all products.)',\n          items: {\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        reason: {\n          type: 'string'\n        },\n        uniqueness_key: {\n          type: 'string',\n          description: 'Prevents the creation of duplicates. If a request to create a record is made with a previously used uniqueness key, a new record will not be created and the request will fail with a 409 error.'\n        }\n      },\n      required: [        'id',\n        'balance',\n        'custom_fields',\n        'customer_id',\n        'deductions',\n        'effective_at',\n        'expires_at',\n        'grant_amount',\n        'name',\n        'paid_amount',\n        'pending_deductions',\n        'priority'\n      ]\n    },\n    credit_ledger_entry: {\n      type: 'object',\n      properties: {\n        amount: {\n          type: 'number',\n          description: 'an amount representing the change to the customer\\'s credit balance'\n        },\n        created_by: {\n          type: 'string'\n        },\n        credit_grant_id: {\n          type: 'string',\n          description: 'the credit grant this entry is related to'\n        },\n        effective_at: {\n          type: 'string',\n          format: 'date-time'\n        },\n        reason: {\n          type: 'string'\n        },\n        running_balance: {\n          type: 'number',\n          description: 'the running balance for this credit type at the time of the ledger entry, including all preceding charges'\n        },\n        invoice_id: {\n          type: 'string',\n          description: 'if this entry is a deduction, the Metronome ID of the invoice where the credit deduction was consumed; if this entry is a grant, the Metronome ID of the invoice where the grant\\'s paid_amount was charged'\n        }\n      },\n      required: [        'amount',\n        'created_by',\n        'credit_grant_id',\n        'effective_at',\n        'reason',\n        'running_balance'\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: {
-      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.',
-      },
-      credit_grant_ids: {
-        type: 'array',
-        description:
-          'An array of credit grant IDs. If this is specified, neither credit_type_ids nor customer_ids may be specified.',
-        items: {
-          type: 'string',
-        },
-      },
-      credit_type_ids: {
-        type: 'array',
-        description:
-          'An array of credit type IDs. This must not be specified if credit_grant_ids is specified.',
-        items: {
-          type: 'string',
-        },
-      },
-      customer_ids: {
-        type: 'array',
-        description:
-          'An array of Metronome customer IDs. This must not be specified if credit_grant_ids is specified.',
-        items: {
-          type: 'string',
-        },
-      },
-      effective_before: {
-        type: 'string',
-        description: 'Only return credit grants that are effective before this timestamp (exclusive).',
-        format: 'date-time',
-      },
-      not_expiring_before: {
-        type: 'string',
-        description: 'Only return credit grants that expire at or after this timestamp.',
-        format: 'date-time',
-      },
-      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: [],
-  },
-  annotations: {},
-};
-
-export const handler = async (client: Metronome, args: Record<string, unknown> | undefined) => {
-  const { jq_filter, ...body } = args as any;
-  const response = await client.v1.creditGrants.list(body).asResponse();
-  try {
-    return asTextContentResult(await maybeFilter(jq_filter, await response.json()));
-  } catch (error) {
-    if (error instanceof Metronome.APIError || isJqError(error)) {
-      return asErrorResult(error.message);
-    }
-    throw error;
-  }
-};
-
-export default { metadata, tool, handler };

package/src/tools/v1/credit-grants/void-v1-credit-grants.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.credit_grants',
-  operation: 'write',
-  tags: [],
-  httpMethod: 'post',
-  httpPath: '/v1/credits/voidGrant',
-  operationId: 'voidGrant-v1',
-};
-
-export const tool: Tool = {
-  name: 'void_v1_credit_grants',
-  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\nVoid a credit grant. This is a Plans (deprecated) endpoint. New clients should implement using Contracts.\n\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/credit_grant_void_response',\n  $defs: {\n    credit_grant_void_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: {
-      id: {
-        type: 'string',
-      },
-      release_uniqueness_key: {
-        type: 'boolean',
-        description: 'If true, resets the uniqueness key on this grant so it can be re-used',
-      },
-      void_credit_purchase_invoice: {
-        type: 'boolean',
-        description: 'If true, void the purchase invoice associated with the grant',
-      },
-      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: ['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.creditGrants.void(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/custom-fields/add-key-v1-custom-fields.ts

@@ -1,65 +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.custom_fields',
-  operation: 'write',
-  tags: [],
-  httpMethod: 'post',
-  httpPath: '/v1/customFields/addKey',
-  operationId: 'addCustomFieldKey-v1',
-};
-
-export const tool: Tool = {
-  name: 'add_key_v1_custom_fields',
-  description:
-    'Creates a new custom field key for a given entity (e.g. billable metric, contract, alert).\n\nCustom fields are properties that you can add to Metronome objects to store metadata like foreign keys or other descriptors. This metadata can get transferred to or accessed by other systems to contextualize Metronome data and power business processes. For example, to service workflows like revenue recognition, reconciliation, and invoicing, custom fields help Metronome know the relationship between entities in the platform and third-party systems.\n\n### Use this endpoint to:\n- Create a new custom field key for Customer objects in Metronome. You can then use the Set Custom Field Values endpoint to set the value of this key for a specific customer. \n- Specify whether the key should enforce uniqueness. If the key is set to enforce uniqueness and you attempt to set a custom field value for the key that already exists, it will fail. \n\n### Usage guidelines:\n- Custom fields set on commits, credits, and contracts can be used to scope alert evaluation. For example, you can create a spend threshold alert that only considers spend associated with contracts with custom field key `contract_type` and value `paygo`\n- Custom fields set on products can be used in the Stripe integration to set metadata on invoices.\n- Custom fields for customers, contracts, invoices, products, commits, scheduled charges, and subscriptions are passed down to the invoice.\n',
-  inputSchema: {
-    type: 'object',
-    properties: {
-      enforce_uniqueness: {
-        type: 'boolean',
-      },
-      entity: {
-        type: 'string',
-        enum: [
-          'alert',
-          'billable_metric',
-          'charge',
-          'commit',
-          'contract_credit',
-          'contract_product',
-          'contract',
-          'credit_grant',
-          'customer_plan',
-          'customer',
-          'discount',
-          'invoice',
-          'plan',
-          'professional_service',
-          'product',
-          'rate_card',
-          'scheduled_charge',
-          'subscription',
-        ],
-      },
-      key: {
-        type: 'string',
-      },
-    },
-    required: ['enforce_uniqueness', 'entity', 'key'],
-  },
-  annotations: {},
-};
-
-export const handler = async (client: Metronome, args: Record<string, unknown> | undefined) => {
-  const body = args as any;
-  const response = await client.v1.customFields.addKey(body).asResponse();
-  return asTextContentResult(await response.text());
-};
-
-export default { metadata, tool, handler };