@metronome/mcp 0.1.0-beta.11 → 0.1.0

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

@@ -1,7 +1,8 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+import { Metadata, asTextContentResult } from '@metronome/mcp/tools/types';
+
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import type { Metadata } from '../../';
 import Metronome from '@metronome/sdk';
 
 export const metadata: Metadata = {
@@ -15,7 +16,8 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'list_balances_v1_contracts',
-  description: 'List balances (commits and credits).\n',
+  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 balances (commits and credits).\n",
   inputSchema: {
     type: 'object',
     properties: {
@@ -52,6 +54,10 @@ export const tool: Tool = {
         type: 'boolean',
         description: 'Include ledgers in the response. Setting this flag may cause the query to be slower.',
       },
+      limit: {
+        type: 'integer',
+        description: 'The maximum number of commits to return. Defaults to 25.',
+      },
       next_page: {
         type: 'string',
         description: 'The next page token from a previous response.',
@@ -62,12 +68,14 @@ export const tool: Tool = {
         format: 'date-time',
       },
     },
+    required: ['customer_id'],
   },
+  annotations: {},
 };
 
-export const handler = (client: Metronome, args: Record<string, unknown> | undefined) => {
+export const handler = async (client: Metronome, args: Record<string, unknown> | undefined) => {
   const body = args as any;
-  return client.v1.contracts.listBalances(body);
+  return asTextContentResult(await client.v1.contracts.listBalances(body));
 };
 
 export default { metadata, tool, handler };

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

@@ -1,7 +1,8 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+import { Metadata, asTextContentResult } from '@metronome/mcp/tools/types';
+
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import type { Metadata } from '../../';
 import Metronome from '@metronome/sdk';
 
 export const metadata: Metadata = {
@@ -16,7 +17,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'list_v1_contracts',
   description:
-    'This is the v1 endpoint to list all contracts for a customer. New clients should implement using the v2 endpoint.',
+    "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\nThis is the v1 endpoint to list all contracts for a customer. New clients should implement using the v2 endpoint.",
   inputSchema: {
     type: 'object',
     properties: {
@@ -50,12 +51,14 @@ export const tool: Tool = {
         format: 'date-time',
       },
     },
+    required: ['customer_id'],
   },
+  annotations: {},
 };
 
-export const handler = (client: Metronome, args: Record<string, unknown> | undefined) => {
+export const handler = async (client: Metronome, args: Record<string, unknown> | undefined) => {
   const body = args as any;
-  return client.v1.contracts.list(body);
+  return asTextContentResult(await client.v1.contracts.list(body));
 };
 
 export default { metadata, tool, handler };

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

@@ -1,7 +1,9 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+import { maybeFilter } from '@metronome/mcp/filtering';
+import { Metadata, asTextContentResult } from '@metronome/mcp/tools/types';
+
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import type { Metadata } from '../../../';
 import Metronome from '@metronome/sdk';
 
 export const metadata: Metadata = {
@@ -16,7 +18,7 @@ export const metadata: Metadata = {
 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.",
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nGet a named schedule for the given rate card. This endpoint's availability is dependent on your client's configuration.\n\n# Response Schema\n```json\n{\n  type: 'object',\n  properties: {\n    data: {\n      type: 'array',\n      items: {\n        type: 'object',\n        properties: {\n          starting_at: {\n            type: 'string',\n            format: 'date-time'\n          },\n          value: {\n            type: 'object'\n          },\n          ending_before: {\n            type: 'string',\n            format: 'date-time'\n          }\n        },\n        required: [          'starting_at',\n          'value'\n        ]\n      }\n    }\n  },\n  required: [    'data'\n  ]\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {
@@ -34,13 +36,23 @@ export const tool: Tool = {
           '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',
       },
+      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', 'schedule_name'],
   },
+  annotations: {},
 };
 
-export const handler = (client: Metronome, args: Record<string, unknown> | undefined) => {
+export const handler = async (client: Metronome, args: Record<string, unknown> | undefined) => {
   const body = args as any;
-  return client.v1.contracts.namedSchedules.retrieve(body);
+  return asTextContentResult(
+    await maybeFilter(args, await client.v1.contracts.namedSchedules.retrieve(body)),
+  );
 };
 
 export default { metadata, tool, handler };

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

@@ -1,7 +1,8 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+import { Metadata, asTextContentResult } from '@metronome/mcp/tools/types';
+
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import type { Metadata } from '../../../';
 import Metronome from '@metronome/sdk';
 
 export const metadata: Metadata = {
@@ -16,7 +17,7 @@ export const metadata: Metadata = {
 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.",
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nUpdate a named schedule for the given rate card. This endpoint's availability is dependent on your client's configuration.\n\n# Response Schema\n```json\n{\n  type: 'object',\n  properties: {}\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {
@@ -41,13 +42,22 @@ export const tool: Tool = {
         type: 'string',
         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: ['rate_card_id', 'schedule_name', 'starting_at', 'value'],
   },
+  annotations: {},
 };
 
-export const handler = (client: Metronome, args: Record<string, unknown> | undefined) => {
+export const handler = async (client: Metronome, args: Record<string, unknown> | undefined) => {
   const body = args as any;
-  return client.v1.contracts.namedSchedules.update(body);
+  const response = await client.v1.contracts.namedSchedules.update(body).asResponse();
+  return asTextContentResult(await response.text());
 };
 
 export default { metadata, tool, handler };

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

@@ -1,7 +1,9 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+import { maybeFilter } from '@metronome/mcp/filtering';
+import { Metadata, asTextContentResult } from '@metronome/mcp/tools/types';
+
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import type { Metadata } from '../../../';
 import Metronome from '@metronome/sdk';
 
 export const metadata: Metadata = {
@@ -15,7 +17,8 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'archive_contracts_v1_products',
-  description: 'Archive a product\n',
+  description:
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nArchive a product\n\n\n# Response Schema\n```json\n{\n  type: 'object',\n  properties: {\n    data: {\n      $ref: '#/$defs/id'\n    }\n  },\n  required: [    'data'\n  ],\n  $defs: {\n    id: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string'\n        }\n      },\n      required: [        'id'\n      ]\n    }\n  }\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {
@@ -23,13 +26,21 @@ export const tool: Tool = {
         type: 'string',
         description: 'ID of the product to be archived',
       },
+      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: ['product_id'],
   },
+  annotations: {},
 };
 
-export const handler = (client: Metronome, args: Record<string, unknown> | undefined) => {
+export const handler = async (client: Metronome, args: Record<string, unknown> | undefined) => {
   const body = args as any;
-  return client.v1.contracts.products.archive(body);
+  return asTextContentResult(await maybeFilter(args, await client.v1.contracts.products.archive(body)));
 };
 
 export default { metadata, tool, handler };

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

@@ -1,7 +1,9 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+import { maybeFilter } from '@metronome/mcp/filtering';
+import { Metadata, asTextContentResult } from '@metronome/mcp/tools/types';
+
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import type { Metadata } from '../../../';
 import Metronome from '@metronome/sdk';
 
 export const metadata: Metadata = {
@@ -15,7 +17,8 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'create_contracts_v1_products',
-  description: 'Create a new product\n',
+  description:
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nCreate a new product\n\n\n# Response Schema\n```json\n{\n  type: 'object',\n  properties: {\n    data: {\n      $ref: '#/$defs/id'\n    }\n  },\n  required: [    'data'\n  ],\n  $defs: {\n    id: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string'\n        }\n      },\n      required: [        'id'\n      ]\n    }\n  }\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {
@@ -91,7 +94,14 @@ export const tool: Tool = {
           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: ['name', 'type'],
     $defs: {
       quantity_conversion: {
         type: 'object',
@@ -131,11 +141,12 @@ export const tool: Tool = {
       },
     },
   },
+  annotations: {},
 };
 
-export const handler = (client: Metronome, args: Record<string, unknown> | undefined) => {
+export const handler = async (client: Metronome, args: Record<string, unknown> | undefined) => {
   const body = args as any;
-  return client.v1.contracts.products.create(body);
+  return asTextContentResult(await maybeFilter(args, await client.v1.contracts.products.create(body)));
 };
 
 export default { metadata, tool, handler };

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

@@ -1,7 +1,9 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+import { maybeFilter } from '@metronome/mcp/filtering';
+import { Metadata, asTextContentResult } from '@metronome/mcp/tools/types';
+
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import type { Metadata } from '../../../';
 import Metronome from '@metronome/sdk';
 
 export const metadata: Metadata = {
@@ -15,7 +17,8 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'list_contracts_v1_products',
-  description: 'List products\n',
+  description:
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nList products\n\n\n# Response Schema\n```json\n{\n  type: 'object',\n  properties: {\n    data: {\n      type: 'array',\n      items: {\n        type: 'object',\n        properties: {\n          id: {\n            type: 'string'\n          },\n          current: {\n            $ref: '#/$defs/product_list_item_state'\n          },\n          initial: {\n            $ref: '#/$defs/product_list_item_state'\n          },\n          type: {\n            type: 'string',\n            enum: [              'USAGE',\n              'SUBSCRIPTION',\n              'COMPOSITE',\n              'FIXED',\n              'PRO_SERVICE'\n            ]\n          },\n          updates: {\n            type: 'array',\n            items: {\n              type: 'object',\n              properties: {\n                created_at: {\n                  type: 'string',\n                  format: 'date-time'\n                },\n                created_by: {\n                  type: 'string'\n                },\n                billable_metric_id: {\n                  type: 'string'\n                },\n                composite_product_ids: {\n                  type: 'array',\n                  items: {\n                    type: 'string'\n                  }\n                },\n                composite_tags: {\n                  type: 'array',\n                  items: {\n                    type: 'string'\n                  }\n                },\n                exclude_free_usage: {\n                  type: 'boolean'\n                },\n                is_refundable: {\n                  type: 'boolean'\n                },\n                name: {\n                  type: 'string'\n                },\n                netsuite_internal_item_id: {\n                  type: 'string',\n                  description: 'This field\\'s availability is dependent on your client\\'s configuration.'\n                },\n                netsuite_overage_item_id: {\n                  type: 'string',\n                  description: 'This field\\'s availability is dependent on your client\\'s configuration.'\n                },\n                presentation_group_key: {\n                  type: 'array',\n                  description: 'For USAGE products only. Groups usage line items on invoices. The superset of values in the pricing group key and presentation group key must be set as one compound group key on the billable metric.',\n                  items: {\n                    type: 'string'\n                  }\n                },\n                pricing_group_key: {\n                  type: 'array',\n                  description: 'For USAGE products only. If set, pricing for this product will be determined for each pricing_group_key value, as opposed to the product as a whole. The superset of values in the pricing group key and presentation group key must be set as one compound group key on the billable metric.',\n                  items: {\n                    type: 'string'\n                  }\n                },\n                quantity_conversion: {\n                  $ref: '#/$defs/quantity_conversion'\n                },\n                quantity_rounding: {\n                  $ref: '#/$defs/quantity_rounding'\n                },\n                starting_at: {\n                  type: 'string',\n                  format: 'date-time'\n                },\n                tags: {\n                  type: 'array',\n                  items: {\n                    type: 'string'\n                  }\n                }\n              },\n              required: [                'created_at',\n                'created_by'\n              ]\n            }\n          },\n          archived_at: {\n            type: 'string',\n            format: 'date-time'\n          },\n          custom_fields: {\n            type: 'object'\n          }\n        },\n        required: [          'id',\n          'current',\n          'initial',\n          'type',\n          'updates'\n        ]\n      }\n    },\n    next_page: {\n      type: 'string'\n    }\n  },\n  required: [    'data',\n    'next_page'\n  ],\n  $defs: {\n    product_list_item_state: {\n      type: 'object',\n      properties: {\n        created_at: {\n          type: 'string',\n          format: 'date-time'\n        },\n        created_by: {\n          type: 'string'\n        },\n        name: {\n          type: 'string'\n        },\n        billable_metric_id: {\n          type: 'string'\n        },\n        composite_product_ids: {\n          type: 'array',\n          items: {\n            type: 'string'\n          }\n        },\n        composite_tags: {\n          type: 'array',\n          items: {\n            type: 'string'\n          }\n        },\n        exclude_free_usage: {\n          type: 'boolean'\n        },\n        is_refundable: {\n          type: 'boolean',\n          description: 'This field\\'s availability is dependent on your client\\'s configuration.'\n        },\n        netsuite_internal_item_id: {\n          type: 'string',\n          description: 'This field\\'s availability is dependent on your client\\'s configuration.'\n        },\n        netsuite_overage_item_id: {\n          type: 'string',\n          description: 'This field\\'s availability is dependent on your client\\'s configuration.'\n        },\n        presentation_group_key: {\n          type: 'array',\n          description: 'For USAGE products only. Groups usage line items on invoices. The superset of values in the pricing group key and presentation group key must be set as one compound group key on the billable metric.',\n          items: {\n            type: 'string'\n          }\n        },\n        pricing_group_key: {\n          type: 'array',\n          description: 'For USAGE products only. If set, pricing for this product will be determined for each pricing_group_key value, as opposed to the product as a whole. The superset of values in the pricing group key and presentation group key must be set as one compound group key on the billable metric.',\n          items: {\n            type: 'string'\n          }\n        },\n        quantity_conversion: {\n          $ref: '#/$defs/quantity_conversion'\n        },\n        quantity_rounding: {\n          $ref: '#/$defs/quantity_rounding'\n        },\n        starting_at: {\n          type: 'string',\n          format: 'date-time'\n        },\n        tags: {\n          type: 'array',\n          items: {\n            type: 'string'\n          }\n        }\n      },\n      required: [        'created_at',\n        'created_by',\n        'name'\n      ]\n    },\n    quantity_conversion: {\n      type: 'object',\n      description: 'Optional. Only valid for USAGE products. If provided, the quantity will be converted using the provided conversion factor and operation. For example, if the operation is \"multiply\" and the conversion factor is 100, then the quantity will be multiplied by 100. This can be used in cases where data is sent in one unit and priced in another.  For example, data could be sent in MB and priced in GB. In this case, the conversion factor would be 1024 and the operation would be \"divide\".',\n      properties: {\n        conversion_factor: {\n          type: 'number',\n          description: 'The factor to multiply or divide the quantity by.'\n        },\n        operation: {\n          type: 'string',\n          description: 'The operation to perform on the quantity',\n          enum: [            'MULTIPLY',\n            'DIVIDE'\n          ]\n        },\n        name: {\n          type: 'string',\n          description: 'Optional name for this conversion.'\n        }\n      },\n      required: [        'conversion_factor',\n        'operation'\n      ]\n    },\n    quantity_rounding: {\n      type: 'object',\n      description: 'Optional. Only valid for USAGE products. If provided, the quantity will be rounded using the provided rounding method and decimal places. For example, if the method is \"round up\" and the decimal places is 0, then the quantity will be rounded up to the nearest integer.',\n      properties: {\n        decimal_places: {\n          type: 'number'\n        },\n        rounding_method: {\n          type: 'string',\n          enum: [            'ROUND_UP',\n            'ROUND_DOWN',\n            'ROUND_HALF_UP'\n          ]\n        }\n      },\n      required: [        'decimal_places',\n        'rounding_method'\n      ]\n    }\n  }\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {
@@ -32,13 +35,22 @@ export const tool: Tool = {
         description: 'Filter options for the product list. If not provided, defaults to not archived.',
         enum: ['ARCHIVED', 'NOT_ARCHIVED', 'ALL'],
       },
+      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 = (client: Metronome, args: Record<string, unknown> | undefined) => {
+export const handler = async (client: Metronome, args: Record<string, unknown> | undefined) => {
   const body = args as any;
-  return client.v1.contracts.products.list(body);
+  const response = await client.v1.contracts.products.list(body).asResponse();
+  return asTextContentResult(await maybeFilter(args, await response.json()));
 };
 
 export default { metadata, tool, handler };

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

@@ -1,7 +1,9 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+import { maybeFilter } from '@metronome/mcp/filtering';
+import { Metadata, asTextContentResult } from '@metronome/mcp/tools/types';
+
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import type { Metadata } from '../../../';
 import Metronome from '@metronome/sdk';
 
 export const metadata: Metadata = {
@@ -15,20 +17,29 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'retrieve_contracts_v1_products',
-  description: 'Get a specific product\n',
+  description:
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nGet a specific product\n\n\n# Response Schema\n```json\n{\n  type: 'object',\n  properties: {\n    data: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string'\n        },\n        current: {\n          $ref: '#/$defs/product_list_item_state'\n        },\n        initial: {\n          $ref: '#/$defs/product_list_item_state'\n        },\n        type: {\n          type: 'string',\n          enum: [            'USAGE',\n            'SUBSCRIPTION',\n            'COMPOSITE',\n            'FIXED',\n            'PRO_SERVICE'\n          ]\n        },\n        updates: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              created_at: {\n                type: 'string',\n                format: 'date-time'\n              },\n              created_by: {\n                type: 'string'\n              },\n              billable_metric_id: {\n                type: 'string'\n              },\n              composite_product_ids: {\n                type: 'array',\n                items: {\n                  type: 'string'\n                }\n              },\n              composite_tags: {\n                type: 'array',\n                items: {\n                  type: 'string'\n                }\n              },\n              exclude_free_usage: {\n                type: 'boolean'\n              },\n              is_refundable: {\n                type: 'boolean'\n              },\n              name: {\n                type: 'string'\n              },\n              netsuite_internal_item_id: {\n                type: 'string',\n                description: 'This field\\'s availability is dependent on your client\\'s configuration.'\n              },\n              netsuite_overage_item_id: {\n                type: 'string',\n                description: 'This field\\'s availability is dependent on your client\\'s configuration.'\n              },\n              presentation_group_key: {\n                type: 'array',\n                description: 'For USAGE products only. Groups usage line items on invoices. The superset of values in the pricing group key and presentation group key must be set as one compound group key on the billable metric.',\n                items: {\n                  type: 'string'\n                }\n              },\n              pricing_group_key: {\n                type: 'array',\n                description: 'For USAGE products only. If set, pricing for this product will be determined for each pricing_group_key value, as opposed to the product as a whole. The superset of values in the pricing group key and presentation group key must be set as one compound group key on the billable metric.',\n                items: {\n                  type: 'string'\n                }\n              },\n              quantity_conversion: {\n                $ref: '#/$defs/quantity_conversion'\n              },\n              quantity_rounding: {\n                $ref: '#/$defs/quantity_rounding'\n              },\n              starting_at: {\n                type: 'string',\n                format: 'date-time'\n              },\n              tags: {\n                type: 'array',\n                items: {\n                  type: 'string'\n                }\n              }\n            },\n            required: [              'created_at',\n              'created_by'\n            ]\n          }\n        },\n        archived_at: {\n          type: 'string',\n          format: 'date-time'\n        },\n        custom_fields: {\n          type: 'object'\n        }\n      },\n      required: [        'id',\n        'current',\n        'initial',\n        'type',\n        'updates'\n      ]\n    }\n  },\n  required: [    'data'\n  ],\n  $defs: {\n    product_list_item_state: {\n      type: 'object',\n      properties: {\n        created_at: {\n          type: 'string',\n          format: 'date-time'\n        },\n        created_by: {\n          type: 'string'\n        },\n        name: {\n          type: 'string'\n        },\n        billable_metric_id: {\n          type: 'string'\n        },\n        composite_product_ids: {\n          type: 'array',\n          items: {\n            type: 'string'\n          }\n        },\n        composite_tags: {\n          type: 'array',\n          items: {\n            type: 'string'\n          }\n        },\n        exclude_free_usage: {\n          type: 'boolean'\n        },\n        is_refundable: {\n          type: 'boolean',\n          description: 'This field\\'s availability is dependent on your client\\'s configuration.'\n        },\n        netsuite_internal_item_id: {\n          type: 'string',\n          description: 'This field\\'s availability is dependent on your client\\'s configuration.'\n        },\n        netsuite_overage_item_id: {\n          type: 'string',\n          description: 'This field\\'s availability is dependent on your client\\'s configuration.'\n        },\n        presentation_group_key: {\n          type: 'array',\n          description: 'For USAGE products only. Groups usage line items on invoices. The superset of values in the pricing group key and presentation group key must be set as one compound group key on the billable metric.',\n          items: {\n            type: 'string'\n          }\n        },\n        pricing_group_key: {\n          type: 'array',\n          description: 'For USAGE products only. If set, pricing for this product will be determined for each pricing_group_key value, as opposed to the product as a whole. The superset of values in the pricing group key and presentation group key must be set as one compound group key on the billable metric.',\n          items: {\n            type: 'string'\n          }\n        },\n        quantity_conversion: {\n          $ref: '#/$defs/quantity_conversion'\n        },\n        quantity_rounding: {\n          $ref: '#/$defs/quantity_rounding'\n        },\n        starting_at: {\n          type: 'string',\n          format: 'date-time'\n        },\n        tags: {\n          type: 'array',\n          items: {\n            type: 'string'\n          }\n        }\n      },\n      required: [        'created_at',\n        'created_by',\n        'name'\n      ]\n    },\n    quantity_conversion: {\n      type: 'object',\n      description: 'Optional. Only valid for USAGE products. If provided, the quantity will be converted using the provided conversion factor and operation. For example, if the operation is \"multiply\" and the conversion factor is 100, then the quantity will be multiplied by 100. This can be used in cases where data is sent in one unit and priced in another.  For example, data could be sent in MB and priced in GB. In this case, the conversion factor would be 1024 and the operation would be \"divide\".',\n      properties: {\n        conversion_factor: {\n          type: 'number',\n          description: 'The factor to multiply or divide the quantity by.'\n        },\n        operation: {\n          type: 'string',\n          description: 'The operation to perform on the quantity',\n          enum: [            'MULTIPLY',\n            'DIVIDE'\n          ]\n        },\n        name: {\n          type: 'string',\n          description: 'Optional name for this conversion.'\n        }\n      },\n      required: [        'conversion_factor',\n        'operation'\n      ]\n    },\n    quantity_rounding: {\n      type: 'object',\n      description: 'Optional. Only valid for USAGE products. If provided, the quantity will be rounded using the provided rounding method and decimal places. For example, if the method is \"round up\" and the decimal places is 0, then the quantity will be rounded up to the nearest integer.',\n      properties: {\n        decimal_places: {\n          type: 'number'\n        },\n        rounding_method: {\n          type: 'string',\n          enum: [            'ROUND_UP',\n            'ROUND_DOWN',\n            'ROUND_HALF_UP'\n          ]\n        }\n      },\n      required: [        'decimal_places',\n        'rounding_method'\n      ]\n    }\n  }\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {
       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: ['id'],
   },
+  annotations: {},
 };
 
-export const handler = (client: Metronome, args: Record<string, unknown> | undefined) => {
+export const handler = async (client: Metronome, args: Record<string, unknown> | undefined) => {
   const body = args as any;
-  return client.v1.contracts.products.retrieve(body);
+  return asTextContentResult(await maybeFilter(args, await client.v1.contracts.products.retrieve(body)));
 };
 
 export default { metadata, tool, handler };

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

@@ -1,7 +1,9 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+import { maybeFilter } from '@metronome/mcp/filtering';
+import { Metadata, asTextContentResult } from '@metronome/mcp/tools/types';
+
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import type { Metadata } from '../../../';
 import Metronome from '@metronome/sdk';
 
 export const metadata: Metadata = {
@@ -15,7 +17,8 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'update_contracts_v1_products',
-  description: 'Update a product\n',
+  description:
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nUpdate a product\n\n\n# Response Schema\n```json\n{\n  type: 'object',\n  properties: {\n    data: {\n      $ref: '#/$defs/id'\n    }\n  },\n  required: [    'data'\n  ],\n  $defs: {\n    id: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string'\n        }\n      },\n      required: [        'id'\n      ]\n    }\n  }\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {
@@ -103,7 +106,14 @@ export const tool: Tool = {
           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: ['product_id', 'starting_at'],
     $defs: {
       quantity_conversion: {
         type: 'object',
@@ -143,11 +153,12 @@ export const tool: Tool = {
       },
     },
   },
+  annotations: {},
 };
 
-export const handler = (client: Metronome, args: Record<string, unknown> | undefined) => {
+export const handler = async (client: Metronome, args: Record<string, unknown> | undefined) => {
   const body = args as any;
-  return client.v1.contracts.products.update(body);
+  return asTextContentResult(await maybeFilter(args, await client.v1.contracts.products.update(body)));
 };
 
 export default { metadata, tool, handler };

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

@@ -1,7 +1,9 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+import { maybeFilter } from '@metronome/mcp/filtering';
+import { Metadata, asTextContentResult } from '@metronome/mcp/tools/types';
+
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import type { Metadata } from '../../../';
 import Metronome from '@metronome/sdk';
 
 export const metadata: Metadata = {
@@ -15,20 +17,29 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'archive_contracts_v1_rate_cards',
-  description: 'Archive a rate card\n',
+  description:
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nArchive a rate card\n\n\n# Response Schema\n```json\n{\n  type: 'object',\n  properties: {\n    data: {\n      $ref: '#/$defs/id'\n    }\n  },\n  required: [    'data'\n  ],\n  $defs: {\n    id: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string'\n        }\n      },\n      required: [        'id'\n      ]\n    }\n  }\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {
       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: ['id'],
   },
+  annotations: {},
 };
 
-export const handler = (client: Metronome, args: Record<string, unknown> | undefined) => {
+export const handler = async (client: Metronome, args: Record<string, unknown> | undefined) => {
   const body = args as any;
-  return client.v1.contracts.rateCards.archive(body);
+  return asTextContentResult(await maybeFilter(args, await client.v1.contracts.rateCards.archive(body)));
 };
 
 export default { metadata, tool, handler };

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

@@ -1,7 +1,9 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+import { maybeFilter } from '@metronome/mcp/filtering';
+import { Metadata, asTextContentResult } from '@metronome/mcp/tools/types';
+
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import type { Metadata } from '../../../';
 import Metronome from '@metronome/sdk';
 
 export const metadata: Metadata = {
@@ -15,7 +17,8 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'create_contracts_v1_rate_cards',
-  description: 'Create a new rate card\n',
+  description:
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nCreate a new rate card\n\n\n# Response Schema\n```json\n{\n  type: 'object',\n  properties: {\n    data: {\n      $ref: '#/$defs/id'\n    }\n  },\n  required: [    'data'\n  ],\n  $defs: {\n    id: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string'\n        }\n      },\n      required: [        'id'\n      ]\n    }\n  }\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {
@@ -72,13 +75,21 @@ export const tool: Tool = {
         description:
           'The Metronome ID of the credit type to associate with the rate card, defaults to USD (cents) if not passed.',
       },
+      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: ['name'],
   },
+  annotations: {},
 };
 
-export const handler = (client: Metronome, args: Record<string, unknown> | undefined) => {
+export const handler = async (client: Metronome, args: Record<string, unknown> | undefined) => {
   const body = args as any;
-  return client.v1.contracts.rateCards.create(body);
+  return asTextContentResult(await maybeFilter(args, await client.v1.contracts.rateCards.create(body)));
 };
 
 export default { metadata, tool, handler };

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

@@ -1,7 +1,9 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+import { maybeFilter } from '@metronome/mcp/filtering';
+import { Metadata, asTextContentResult } from '@metronome/mcp/tools/types';
+
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import type { Metadata } from '../../../';
 import Metronome from '@metronome/sdk';
 
 export const metadata: Metadata = {
@@ -16,7 +18,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'list_contracts_v1_rate_cards',
   description:
-    'List rate cards NOTE: Use `/contract-pricing/rate-cards/getRates` to retrieve rate card rates.\n',
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nList rate cards NOTE: Use `/contract-pricing/rate-cards/getRates` to retrieve rate card rates.\n\n\n# Response Schema\n```json\n{\n  type: 'object',\n  properties: {\n    data: {\n      type: 'array',\n      items: {\n        type: 'object',\n        properties: {\n          id: {\n            type: 'string'\n          },\n          created_at: {\n            type: 'string',\n            format: 'date-time'\n          },\n          created_by: {\n            type: 'string'\n          },\n          name: {\n            type: 'string'\n          },\n          aliases: {\n            type: 'array',\n            items: {\n              type: 'object',\n              properties: {\n                name: {\n                  type: 'string'\n                },\n                ending_before: {\n                  type: 'string',\n                  format: 'date-time'\n                },\n                starting_at: {\n                  type: 'string',\n                  format: 'date-time'\n                }\n              },\n              required: [                'name'\n              ]\n            }\n          },\n          credit_type_conversions: {\n            type: 'array',\n            items: {\n              type: 'object',\n              properties: {\n                custom_credit_type: {\n                  $ref: '#/$defs/credit_type_data'\n                },\n                fiat_per_custom_credit: {\n                  type: 'string'\n                }\n              },\n              required: [                'custom_credit_type',\n                'fiat_per_custom_credit'\n              ]\n            }\n          },\n          custom_fields: {\n            type: 'object'\n          },\n          description: {\n            type: 'string'\n          },\n          fiat_credit_type: {\n            $ref: '#/$defs/credit_type_data'\n          }\n        },\n        required: [          'id',\n          'created_at',\n          'created_by',\n          'name'\n        ]\n      }\n    },\n    next_page: {\n      type: 'string'\n    }\n  },\n  required: [    'data',\n    'next_page'\n  ],\n  $defs: {\n    credit_type_data: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string'\n        },\n        name: {\n          type: 'string'\n        }\n      },\n      required: [        'id',\n        'name'\n      ]\n    }\n  }\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {
@@ -31,13 +33,22 @@ export const tool: Tool = {
       body: {
         type: 'object',
       },
+      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 = (client: Metronome, args: Record<string, unknown> | undefined) => {
+export const handler = async (client: Metronome, args: Record<string, unknown> | undefined) => {
   const body = args as any;
-  return client.v1.contracts.rateCards.list(body);
+  const response = await client.v1.contracts.rateCards.list(body).asResponse();
+  return asTextContentResult(await maybeFilter(args, await response.json()));
 };
 
 export default { metadata, tool, handler };

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

@@ -1,7 +1,9 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+import { maybeFilter } from '@metronome/mcp/filtering';
+import { Metadata, asTextContentResult } from '@metronome/mcp/tools/types';
+
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import type { Metadata } from '../../../../';
 import Metronome from '@metronome/sdk';
 
 export const metadata: Metadata = {
@@ -16,7 +18,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'retrieve_rate_cards_contracts_v1_named_schedules',
   description:
-    "Get a named schedule for the given contract. This endpoint's availability is dependent on your client's configuration.",
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nGet a named schedule for the given contract. This endpoint's availability is dependent on your client's configuration.\n\n# Response Schema\n```json\n{\n  type: 'object',\n  properties: {\n    data: {\n      type: 'array',\n      items: {\n        type: 'object',\n        properties: {\n          starting_at: {\n            type: 'string',\n            format: 'date-time'\n          },\n          value: {\n            type: 'object'\n          },\n          ending_before: {\n            type: 'string',\n            format: 'date-time'\n          }\n        },\n        required: [          'starting_at',\n          'value'\n        ]\n      }\n    }\n  },\n  required: [    'data'\n  ]\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {
@@ -38,13 +40,23 @@ export const tool: Tool = {
           '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',
       },
+      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', 'schedule_name'],
   },
+  annotations: {},
 };
 
-export const handler = (client: Metronome, args: Record<string, unknown> | undefined) => {
+export const handler = async (client: Metronome, args: Record<string, unknown> | undefined) => {
   const body = args as any;
-  return client.v1.contracts.rateCards.namedSchedules.retrieve(body);
+  return asTextContentResult(
+    await maybeFilter(args, await client.v1.contracts.rateCards.namedSchedules.retrieve(body)),
+  );
 };
 
 export default { metadata, tool, handler };