conductor-node-mcp 12.14.0 → 12.15.0

package/src/tools/qbd/payroll-wage-items/list-qbd-payroll-wage-items.ts

@@ -1,5 +1,6 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+import { maybeFilter } from 'conductor-node-mcp/filtering';
 import { asTextContentResult } from 'conductor-node-mcp/tools/types';
 
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
@@ -17,7 +18,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'list_qbd_payroll_wage_items',
   description:
-    'Returns a list of payroll wage items. Use the `cursor` parameter to paginate through the results.',
+    "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\nReturns a list of payroll wage items. Use the `cursor` parameter to paginate through the results.\n\n# Response Schema\n```json\n{\n  type: 'object',\n  properties: {\n    data: {\n      type: 'array',\n      description: 'The array of payroll wage items.',\n      items: {\n        $ref: '#/$defs/payroll_wage_item'\n      }\n    },\n    hasMore: {\n      type: 'boolean',\n      description: 'Indicates whether there are more objects to be fetched.'\n    },\n    nextCursor: {\n      type: 'string',\n      description: 'The `nextCursor` is a pagination token returned in the response when you use the `limit` parameter in your request. To retrieve subsequent pages of results, include this token as the value of the `cursor` request parameter in your following API calls.\\n\\n**NOTE**: The `nextCursor` value remains constant throughout the pagination process for a specific list instance; continue to use the same `nextCursor` token in each request to fetch additional pages.'\n    },\n    objectType: {\n      type: 'string',\n      description: 'The type of object. This value is always `\"list\"`.',\n      enum: [        'list'\n      ]\n    },\n    remainingCount: {\n      type: 'number',\n      description: 'The number of objects remaining to be fetched.'\n    },\n    url: {\n      type: 'string',\n      description: 'The endpoint URL where this list can be accessed.'\n    }\n  },\n  required: [    'data',\n    'hasMore',\n    'nextCursor',\n    'objectType',\n    'remainingCount',\n    'url'\n  ],\n  $defs: {\n    payroll_wage_item: {\n      type: 'object',\n      title: 'The Payroll Wage Item object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The unique identifier assigned by QuickBooks to this payroll wage item. This ID is unique across all payroll wage items but not across different QuickBooks object types.'\n        },\n        createdAt: {\n          type: 'string',\n          description: 'The date and time when this payroll wage item was created, in ISO 8601 format (YYYY-MM-DDThh:mm:ss±hh:mm). The time zone is the same as the user\\'s time zone in QuickBooks.'\n        },\n        expenseAccount: {\n          type: 'object',\n          description: 'The expense account used to track wage expenses paid through this payroll wage item.',\n          properties: {\n            id: {\n              type: 'string',\n              description: 'The unique identifier assigned by QuickBooks to this object. This ID is unique across all objects of the same type, but not across different QuickBooks object types.'\n            },\n            fullName: {\n              type: 'string',\n              description: 'The fully-qualified unique name for this object, formed by combining the names of its parent objects with its own `name`, separated by colons. Not case-sensitive.'\n            }\n          },\n          required: [            'id',\n            'fullName'\n          ]\n        },\n        isActive: {\n          type: 'boolean',\n          description: 'Indicates whether this payroll wage item is active. Inactive objects are typically hidden from views and reports in QuickBooks. Defaults to `true`.'\n        },\n        name: {\n          type: 'string',\n          description: 'The case-insensitive unique name of this payroll wage item, unique across all payroll wage items.\\n\\n**NOTE**: Payroll wage items do not have a `fullName` field because they are not hierarchical objects, which is why `name` is unique for them but not for objects that have parents.'\n        },\n        objectType: {\n          type: 'string',\n          description: 'The type of object. This value is always `\"qbd_payroll_wage_item\"`.',\n          enum: [            'qbd_payroll_wage_item'\n          ]\n        },\n        revisionNumber: {\n          type: 'string',\n          description: 'The current QuickBooks-assigned revision number of this payroll wage item object, which changes each time the object is modified. When updating this object, you must provide the most recent `revisionNumber` to ensure you\\'re working with the latest data; otherwise, the update will return an error.'\n        },\n        updatedAt: {\n          type: 'string',\n          description: 'The date and time when this payroll wage item was last updated, in ISO 8601 format (YYYY-MM-DDThh:mm:ss±hh:mm). The time zone is the same as the user\\'s time zone in QuickBooks.'\n        },\n        wageType: {\n          type: 'string',\n          description: 'Categorizes how this payroll wage item calculates pay - can be hourly (regular, overtime, sick, or vacation), salary (regular, sick, or vacation), bonus, or commission based.',\n          enum: [            'bonus',\n            'commission',\n            'hourly_overtime',\n            'hourly_regular',\n            'hourly_sick',\n            'hourly_vacation',\n            'salary_regular',\n            'salary_sick',\n            'salary_vacation'\n          ]\n        }\n      },\n      required: [        'id',\n        'createdAt',\n        'expenseAccount',\n        'isActive',\n        'name',\n        'objectType',\n        'revisionNumber',\n        'updatedAt',\n        'wageType'\n      ]\n    }\n  }\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {
@@ -92,13 +93,20 @@ export const tool: Tool = {
         description:
           'Filter for payroll wage items updated on or before this date and time, in ISO 8601 format (YYYY-MM-DDTHH:mm:ss). If you only provide a date (YYYY-MM-DD), the time is assumed to be 23:59:59 of that day.',
       },
+      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/).',
+      },
     },
   },
 };
 
 export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {
   const body = args as any;
-  return asTextContentResult(await conductor.qbd.payrollWageItems.list(body));
+  const response = await conductor.qbd.payrollWageItems.list(body).asResponse();
+  return asTextContentResult(await maybeFilter(args, await response.json()));
 };
 
 export default { metadata, tool, handler };

package/src/tools/qbd/payroll-wage-items/retrieve-qbd-payroll-wage-items.ts

@@ -1,5 +1,6 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+import { maybeFilter } from 'conductor-node-mcp/filtering';
 import { asTextContentResult } from 'conductor-node-mcp/tools/types';
 
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
@@ -16,7 +17,8 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'retrieve_qbd_payroll_wage_items',
-  description: 'Retrieves a payroll wage item by ID.',
+  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\nRetrieves a payroll wage item by ID.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/payroll_wage_item',\n  $defs: {\n    payroll_wage_item: {\n      type: 'object',\n      title: 'The Payroll Wage Item object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The unique identifier assigned by QuickBooks to this payroll wage item. This ID is unique across all payroll wage items but not across different QuickBooks object types.'\n        },\n        createdAt: {\n          type: 'string',\n          description: 'The date and time when this payroll wage item was created, in ISO 8601 format (YYYY-MM-DDThh:mm:ss±hh:mm). The time zone is the same as the user\\'s time zone in QuickBooks.'\n        },\n        expenseAccount: {\n          type: 'object',\n          description: 'The expense account used to track wage expenses paid through this payroll wage item.',\n          properties: {\n            id: {\n              type: 'string',\n              description: 'The unique identifier assigned by QuickBooks to this object. This ID is unique across all objects of the same type, but not across different QuickBooks object types.'\n            },\n            fullName: {\n              type: 'string',\n              description: 'The fully-qualified unique name for this object, formed by combining the names of its parent objects with its own `name`, separated by colons. Not case-sensitive.'\n            }\n          },\n          required: [            'id',\n            'fullName'\n          ]\n        },\n        isActive: {\n          type: 'boolean',\n          description: 'Indicates whether this payroll wage item is active. Inactive objects are typically hidden from views and reports in QuickBooks. Defaults to `true`.'\n        },\n        name: {\n          type: 'string',\n          description: 'The case-insensitive unique name of this payroll wage item, unique across all payroll wage items.\\n\\n**NOTE**: Payroll wage items do not have a `fullName` field because they are not hierarchical objects, which is why `name` is unique for them but not for objects that have parents.'\n        },\n        objectType: {\n          type: 'string',\n          description: 'The type of object. This value is always `\"qbd_payroll_wage_item\"`.',\n          enum: [            'qbd_payroll_wage_item'\n          ]\n        },\n        revisionNumber: {\n          type: 'string',\n          description: 'The current QuickBooks-assigned revision number of this payroll wage item object, which changes each time the object is modified. When updating this object, you must provide the most recent `revisionNumber` to ensure you\\'re working with the latest data; otherwise, the update will return an error.'\n        },\n        updatedAt: {\n          type: 'string',\n          description: 'The date and time when this payroll wage item was last updated, in ISO 8601 format (YYYY-MM-DDThh:mm:ss±hh:mm). The time zone is the same as the user\\'s time zone in QuickBooks.'\n        },\n        wageType: {\n          type: 'string',\n          description: 'Categorizes how this payroll wage item calculates pay - can be hourly (regular, overtime, sick, or vacation), salary (regular, sick, or vacation), bonus, or commission based.',\n          enum: [            'bonus',\n            'commission',\n            'hourly_overtime',\n            'hourly_regular',\n            'hourly_sick',\n            'hourly_vacation',\n            'salary_regular',\n            'salary_sick',\n            'salary_vacation'\n          ]\n        }\n      },\n      required: [        'id',\n        'createdAt',\n        'expenseAccount',\n        'isActive',\n        'name',\n        'objectType',\n        'revisionNumber',\n        'updatedAt',\n        'wageType'\n      ]\n    }\n  }\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {
@@ -29,13 +31,21 @@ export const tool: Tool = {
         description:
           'The ID of the EndUser to receive this request (e.g., `"Conductor-End-User-Id: {{END_USER_ID}}"`).',
       },
+      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/).',
+      },
     },
   },
 };
 
 export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {
   const { id, ...body } = args as any;
-  return asTextContentResult(await conductor.qbd.payrollWageItems.retrieve(id, body));
+  return asTextContentResult(
+    await maybeFilter(args, await conductor.qbd.payrollWageItems.retrieve(id, body)),
+  );
 };
 
 export default { metadata, tool, handler };

package/src/tools/qbd/preferences/retrieve-qbd-preferences.ts

@@ -17,7 +17,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'retrieve_qbd_preferences',
   description:
-    'Returns the preferences that the QuickBooks administrator has set for all users of the connected company file. Note that preferences cannot be modified through the API, only through the QuickBooks Desktop user interface.',
+    "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\nReturns the preferences that the QuickBooks administrator has set for all users of the connected company file. Note that preferences cannot be modified through the API, only through the QuickBooks Desktop user interface.",
   inputSchema: {
     type: 'object',
     properties: {

package/src/tools/qbd/price-levels/create-qbd-price-levels.ts

@@ -1,5 +1,6 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+import { maybeFilter } from 'conductor-node-mcp/filtering';
 import { asTextContentResult } from 'conductor-node-mcp/tools/types';
 
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
@@ -16,7 +17,8 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'create_qbd_price_levels',
-  description: 'Creates a new price level.',
+  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\nCreates a new price level.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/price_level',\n  $defs: {\n    price_level: {\n      type: 'object',\n      title: 'The Price Level object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The unique identifier assigned by QuickBooks to this price level. This ID is unique across all price levels but not across different QuickBooks object types.'\n        },\n        createdAt: {\n          type: 'string',\n          description: 'The date and time when this price level was created, in ISO 8601 format (YYYY-MM-DDThh:mm:ss±hh:mm). The time zone is the same as the user\\'s time zone in QuickBooks.'\n        },\n        currency: {\n          type: 'object',\n          description: 'The price level\\'s currency. For built-in currencies, the name and code are standard international values. For user-defined currencies, all values are editable.',\n          properties: {\n            id: {\n              type: 'string',\n              description: 'The unique identifier assigned by QuickBooks to this object. This ID is unique across all objects of the same type, but not across different QuickBooks object types.'\n            },\n            fullName: {\n              type: 'string',\n              description: 'The fully-qualified unique name for this object, formed by combining the names of its parent objects with its own `name`, separated by colons. Not case-sensitive.'\n            }\n          },\n          required: [            'id',\n            'fullName'\n          ]\n        },\n        fixedPercentage: {\n          type: 'string',\n          description: 'The fixed percentage adjustment applied to all items for this price level (instead of a per-item price level). Once you create the price level, you cannot change this.\\n\\nWhen this price level is applied to a customer, it automatically adjusts the `rate` and `amount` columns for applicable line items in sales orders and invoices for that customer. This value supports both positive and negative values - a value of \"20\" increases prices by 20%, while \"-10\" decreases prices by 10%.'\n        },\n        isActive: {\n          type: 'boolean',\n          description: 'Indicates whether this price level is active. Inactive objects are typically hidden from views and reports in QuickBooks. Defaults to `true`.'\n        },\n        name: {\n          type: 'string',\n          description: 'The case-insensitive unique name of this price level, unique across all price levels.\\n\\n**NOTE**: Price levels do not have a `fullName` field because they are not hierarchical objects, which is why `name` is unique for them but not for objects that have parents.'\n        },\n        objectType: {\n          type: 'string',\n          description: 'The type of object. This value is always `\"qbd_price_level\"`.',\n          enum: [            'qbd_price_level'\n          ]\n        },\n        perItemPriceLevels: {\n          type: 'array',\n          description: 'The per-item price level configurations for this price level.',\n          items: {\n            type: 'object',\n            title: 'The Per-Item Price Level object',\n            properties: {\n              customPrice: {\n                type: 'string',\n                description: 'The fixed amount custom price for this per-item price level that overrides the standard price for the specified item. Used when setting an absolute price value for the item in this price level.'\n              },\n              customPricePercent: {\n                type: 'string',\n                description: 'The fixed discount percentage for this per-item price level that modifies the specified item\\'s standard price. Used to create a fixed percentage markup or discount specific to this item within this price level.'\n              },\n              item: {\n                type: 'object',\n                description: 'The item associated with this per-item price level. This can refer to any good or service that the business buys or sells, including item types such as a service item, inventory item, or special calculation item like a discount item or sales-tax item.',\n                properties: {\n                  id: {\n                    type: 'string',\n                    description: 'The unique identifier assigned by QuickBooks to this object. This ID is unique across all objects of the same type, but not across different QuickBooks object types.'\n                  },\n                  fullName: {\n                    type: 'string',\n                    description: 'The fully-qualified unique name for this object, formed by combining the names of its parent objects with its own `name`, separated by colons. Not case-sensitive.'\n                  }\n                },\n                required: [                  'id',\n                  'fullName'\n                ]\n              }\n            },\n            required: [              'customPrice',\n              'customPricePercent',\n              'item'\n            ]\n          }\n        },\n        priceLevelType: {\n          type: 'string',\n          description: 'The price level\\'s type.',\n          enum: [            'fixed_percentage',\n            'per_item'\n          ]\n        },\n        revisionNumber: {\n          type: 'string',\n          description: 'The current QuickBooks-assigned revision number of this price level object, which changes each time the object is modified. When updating this object, you must provide the most recent `revisionNumber` to ensure you\\'re working with the latest data; otherwise, the update will return an error.'\n        },\n        updatedAt: {\n          type: 'string',\n          description: 'The date and time when this price level was last updated, in ISO 8601 format (YYYY-MM-DDThh:mm:ss±hh:mm). The time zone is the same as the user\\'s time zone in QuickBooks.'\n        }\n      },\n      required: [        'id',\n        'createdAt',\n        'currency',\n        'fixedPercentage',\n        'isActive',\n        'name',\n        'objectType',\n        'perItemPriceLevels',\n        'priceLevelType',\n        'revisionNumber',\n        'updatedAt'\n      ]\n    }\n  }\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {
@@ -81,13 +83,19 @@ export const tool: Tool = {
           required: ['adjustPercentage', 'adjustRelativeTo', 'itemId'],
         },
       },
+      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/).',
+      },
     },
   },
 };
 
 export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {
   const body = args as any;
-  return asTextContentResult(await conductor.qbd.priceLevels.create(body));
+  return asTextContentResult(await maybeFilter(args, await conductor.qbd.priceLevels.create(body)));
 };
 
 export default { metadata, tool, handler };

package/src/tools/qbd/price-levels/list-qbd-price-levels.ts

@@ -17,7 +17,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'list_qbd_price_levels',
   description:
-    'Returns a list of price levels. NOTE: QuickBooks Desktop does not support pagination for price levels; hence, there is no `cursor` parameter. Users typically have few price levels.',
+    "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\nReturns a list of price levels. NOTE: QuickBooks Desktop does not support pagination for price levels; hence, there is no `cursor` parameter. Users typically have few price levels.",
   inputSchema: {
     type: 'object',
     properties: {

package/src/tools/qbd/price-levels/retrieve-qbd-price-levels.ts

@@ -1,5 +1,6 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+import { maybeFilter } from 'conductor-node-mcp/filtering';
 import { asTextContentResult } from 'conductor-node-mcp/tools/types';
 
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
@@ -16,7 +17,8 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'retrieve_qbd_price_levels',
-  description: 'Retrieves a price level by ID.',
+  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\nRetrieves a price level by ID.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/price_level',\n  $defs: {\n    price_level: {\n      type: 'object',\n      title: 'The Price Level object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The unique identifier assigned by QuickBooks to this price level. This ID is unique across all price levels but not across different QuickBooks object types.'\n        },\n        createdAt: {\n          type: 'string',\n          description: 'The date and time when this price level was created, in ISO 8601 format (YYYY-MM-DDThh:mm:ss±hh:mm). The time zone is the same as the user\\'s time zone in QuickBooks.'\n        },\n        currency: {\n          type: 'object',\n          description: 'The price level\\'s currency. For built-in currencies, the name and code are standard international values. For user-defined currencies, all values are editable.',\n          properties: {\n            id: {\n              type: 'string',\n              description: 'The unique identifier assigned by QuickBooks to this object. This ID is unique across all objects of the same type, but not across different QuickBooks object types.'\n            },\n            fullName: {\n              type: 'string',\n              description: 'The fully-qualified unique name for this object, formed by combining the names of its parent objects with its own `name`, separated by colons. Not case-sensitive.'\n            }\n          },\n          required: [            'id',\n            'fullName'\n          ]\n        },\n        fixedPercentage: {\n          type: 'string',\n          description: 'The fixed percentage adjustment applied to all items for this price level (instead of a per-item price level). Once you create the price level, you cannot change this.\\n\\nWhen this price level is applied to a customer, it automatically adjusts the `rate` and `amount` columns for applicable line items in sales orders and invoices for that customer. This value supports both positive and negative values - a value of \"20\" increases prices by 20%, while \"-10\" decreases prices by 10%.'\n        },\n        isActive: {\n          type: 'boolean',\n          description: 'Indicates whether this price level is active. Inactive objects are typically hidden from views and reports in QuickBooks. Defaults to `true`.'\n        },\n        name: {\n          type: 'string',\n          description: 'The case-insensitive unique name of this price level, unique across all price levels.\\n\\n**NOTE**: Price levels do not have a `fullName` field because they are not hierarchical objects, which is why `name` is unique for them but not for objects that have parents.'\n        },\n        objectType: {\n          type: 'string',\n          description: 'The type of object. This value is always `\"qbd_price_level\"`.',\n          enum: [            'qbd_price_level'\n          ]\n        },\n        perItemPriceLevels: {\n          type: 'array',\n          description: 'The per-item price level configurations for this price level.',\n          items: {\n            type: 'object',\n            title: 'The Per-Item Price Level object',\n            properties: {\n              customPrice: {\n                type: 'string',\n                description: 'The fixed amount custom price for this per-item price level that overrides the standard price for the specified item. Used when setting an absolute price value for the item in this price level.'\n              },\n              customPricePercent: {\n                type: 'string',\n                description: 'The fixed discount percentage for this per-item price level that modifies the specified item\\'s standard price. Used to create a fixed percentage markup or discount specific to this item within this price level.'\n              },\n              item: {\n                type: 'object',\n                description: 'The item associated with this per-item price level. This can refer to any good or service that the business buys or sells, including item types such as a service item, inventory item, or special calculation item like a discount item or sales-tax item.',\n                properties: {\n                  id: {\n                    type: 'string',\n                    description: 'The unique identifier assigned by QuickBooks to this object. This ID is unique across all objects of the same type, but not across different QuickBooks object types.'\n                  },\n                  fullName: {\n                    type: 'string',\n                    description: 'The fully-qualified unique name for this object, formed by combining the names of its parent objects with its own `name`, separated by colons. Not case-sensitive.'\n                  }\n                },\n                required: [                  'id',\n                  'fullName'\n                ]\n              }\n            },\n            required: [              'customPrice',\n              'customPricePercent',\n              'item'\n            ]\n          }\n        },\n        priceLevelType: {\n          type: 'string',\n          description: 'The price level\\'s type.',\n          enum: [            'fixed_percentage',\n            'per_item'\n          ]\n        },\n        revisionNumber: {\n          type: 'string',\n          description: 'The current QuickBooks-assigned revision number of this price level object, which changes each time the object is modified. When updating this object, you must provide the most recent `revisionNumber` to ensure you\\'re working with the latest data; otherwise, the update will return an error.'\n        },\n        updatedAt: {\n          type: 'string',\n          description: 'The date and time when this price level was last updated, in ISO 8601 format (YYYY-MM-DDThh:mm:ss±hh:mm). The time zone is the same as the user\\'s time zone in QuickBooks.'\n        }\n      },\n      required: [        'id',\n        'createdAt',\n        'currency',\n        'fixedPercentage',\n        'isActive',\n        'name',\n        'objectType',\n        'perItemPriceLevels',\n        'priceLevelType',\n        'revisionNumber',\n        'updatedAt'\n      ]\n    }\n  }\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {
@@ -29,13 +31,19 @@ export const tool: Tool = {
         description:
           'The ID of the EndUser to receive this request (e.g., `"Conductor-End-User-Id: {{END_USER_ID}}"`).',
       },
+      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/).',
+      },
     },
   },
 };
 
 export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {
   const { id, ...body } = args as any;
-  return asTextContentResult(await conductor.qbd.priceLevels.retrieve(id, body));
+  return asTextContentResult(await maybeFilter(args, await conductor.qbd.priceLevels.retrieve(id, body)));
 };
 
 export default { metadata, tool, handler };

package/src/tools/qbd/price-levels/update-qbd-price-levels.ts

@@ -16,7 +16,8 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'update_qbd_price_levels',
-  description: 'Updates an existing price level.',
+  description:
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nUpdates an existing price level.",
   inputSchema: {
     type: 'object',
     properties: {

package/src/tools/qbd/purchase-orders/create-qbd-purchase-orders.ts

@@ -16,7 +16,8 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'create_qbd_purchase_orders',
-  description: 'Creates a new purchase order.',
+  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\nCreates a new purchase order.",
   inputSchema: {
     type: 'object',
     properties: {

package/src/tools/qbd/purchase-orders/delete-qbd-purchase-orders.ts

@@ -1,5 +1,6 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+import { maybeFilter } from 'conductor-node-mcp/filtering';
 import { asTextContentResult } from 'conductor-node-mcp/tools/types';
 
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
@@ -17,7 +18,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'delete_qbd_purchase_orders',
   description:
-    'Permanently deletes a a purchase order. The deletion will fail if the purchase order is currently in use or has any linked transactions that are in use.',
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nPermanently deletes a a purchase order. The deletion will fail if the purchase order is currently in use or has any linked transactions that are in use.\n\n# Response Schema\n```json\n{\n  type: 'object',\n  properties: {\n    id: {\n      type: 'string',\n      description: 'The QuickBooks-assigned unique identifier of the deleted purchase order.'\n    },\n    deleted: {\n      type: 'boolean',\n      description: 'Indicates whether the purchase order was deleted.'\n    },\n    objectType: {\n      type: 'string',\n      description: 'The type of object. This value is always `\"qbd_purchase_order\"`.',\n      enum: [        'qbd_purchase_order'\n      ]\n    },\n    refNumber: {\n      type: 'string',\n      description: 'The case-sensitive user-defined reference number of the deleted purchase order.'\n    }\n  },\n  required: [    'id',\n    'deleted',\n    'objectType',\n    'refNumber'\n  ]\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {
@@ -30,13 +31,19 @@ export const tool: Tool = {
         description:
           'The ID of the EndUser to receive this request (e.g., `"Conductor-End-User-Id: {{END_USER_ID}}"`).',
       },
+      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/).',
+      },
     },
   },
 };
 
 export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {
   const { id, ...body } = args as any;
-  return asTextContentResult(await conductor.qbd.purchaseOrders.delete(id, body));
+  return asTextContentResult(await maybeFilter(args, await conductor.qbd.purchaseOrders.delete(id, body)));
 };
 
 export default { metadata, tool, handler };

package/src/tools/qbd/purchase-orders/list-qbd-purchase-orders.ts

@@ -17,7 +17,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'list_qbd_purchase_orders',
   description:
-    'Returns a list of purchase orders. Use the `cursor` parameter to paginate through the results.',
+    "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\nReturns a list of purchase orders. Use the `cursor` parameter to paginate through the results.",
   inputSchema: {
     type: 'object',
     properties: {
@@ -135,7 +135,8 @@ export const tool: Tool = {
 
 export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {
   const body = args as any;
-  return asTextContentResult(await conductor.qbd.purchaseOrders.list(body));
+  const response = await conductor.qbd.purchaseOrders.list(body).asResponse();
+  return asTextContentResult(await response.json());
 };
 
 export default { metadata, tool, handler };

package/src/tools/qbd/purchase-orders/retrieve-qbd-purchase-orders.ts

@@ -16,7 +16,8 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'retrieve_qbd_purchase_orders',
-  description: 'Retrieves a purchase order by ID.',
+  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\nRetrieves a purchase order by ID.",
   inputSchema: {
     type: 'object',
     properties: {

package/src/tools/qbd/purchase-orders/update-qbd-purchase-orders.ts

@@ -16,7 +16,8 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'update_qbd_purchase_orders',
-  description: 'Updates an existing purchase order.',
+  description:
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nUpdates an existing purchase order.",
   inputSchema: {
     type: 'object',
     properties: {

package/src/tools/qbd/receive-payments/create-qbd-receive-payments.ts

@@ -16,7 +16,8 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'create_qbd_receive_payments',
-  description: 'Creates a new receive-payment.',
+  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\nCreates a new receive-payment.",
   inputSchema: {
     type: 'object',
     properties: {

package/src/tools/qbd/receive-payments/delete-qbd-receive-payments.ts

@@ -1,5 +1,6 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+import { maybeFilter } from 'conductor-node-mcp/filtering';
 import { asTextContentResult } from 'conductor-node-mcp/tools/types';
 
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
@@ -17,7 +18,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'delete_qbd_receive_payments',
   description:
-    'Permanently deletes a a receive-payment. The deletion will fail if the receive-payment is currently in use or has any linked transactions that are in use.',
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nPermanently deletes a a receive-payment. The deletion will fail if the receive-payment is currently in use or has any linked transactions that are in use.\n\n# Response Schema\n```json\n{\n  type: 'object',\n  properties: {\n    id: {\n      type: 'string',\n      description: 'The QuickBooks-assigned unique identifier of the deleted receive-payment.'\n    },\n    deleted: {\n      type: 'boolean',\n      description: 'Indicates whether the receive-payment was deleted.'\n    },\n    objectType: {\n      type: 'string',\n      description: 'The type of object. This value is always `\"qbd_receive_payment\"`.',\n      enum: [        'qbd_receive_payment'\n      ]\n    },\n    refNumber: {\n      type: 'string',\n      description: 'The case-sensitive user-defined reference number of the deleted receive-payment.'\n    }\n  },\n  required: [    'id',\n    'deleted',\n    'objectType',\n    'refNumber'\n  ]\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {
@@ -30,13 +31,19 @@ export const tool: Tool = {
         description:
           'The ID of the EndUser to receive this request (e.g., `"Conductor-End-User-Id: {{END_USER_ID}}"`).',
       },
+      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/).',
+      },
     },
   },
 };
 
 export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {
   const { id, ...body } = args as any;
-  return asTextContentResult(await conductor.qbd.receivePayments.delete(id, body));
+  return asTextContentResult(await maybeFilter(args, await conductor.qbd.receivePayments.delete(id, body)));
 };
 
 export default { metadata, tool, handler };

package/src/tools/qbd/receive-payments/list-qbd-receive-payments.ts

@@ -17,7 +17,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'list_qbd_receive_payments',
   description:
-    'Returns a list of receive-payments. Use the `cursor` parameter to paginate through the results.',
+    "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\nReturns a list of receive-payments. Use the `cursor` parameter to paginate through the results.",
   inputSchema: {
     type: 'object',
     properties: {
@@ -130,7 +130,8 @@ export const tool: Tool = {
 
 export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {
   const body = args as any;
-  return asTextContentResult(await conductor.qbd.receivePayments.list(body));
+  const response = await conductor.qbd.receivePayments.list(body).asResponse();
+  return asTextContentResult(await response.json());
 };
 
 export default { metadata, tool, handler };

package/src/tools/qbd/receive-payments/retrieve-qbd-receive-payments.ts

@@ -16,7 +16,8 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'retrieve_qbd_receive_payments',
-  description: 'Retrieves a receive-payment by ID.',
+  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\nRetrieves a receive-payment by ID.",
   inputSchema: {
     type: 'object',
     properties: {

package/src/tools/qbd/receive-payments/update-qbd-receive-payments.ts

@@ -16,7 +16,8 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'update_qbd_receive_payments',
-  description: 'Updates an existing receive-payment.',
+  description:
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nUpdates an existing receive-payment.",
   inputSchema: {
     type: 'object',
     properties: {

package/src/tools/qbd/sales-orders/create-qbd-sales-orders.ts

@@ -16,7 +16,8 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'create_qbd_sales_orders',
-  description: 'Creates a new sales order.',
+  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\nCreates a new sales order.",
   inputSchema: {
     type: 'object',
     properties: {

package/src/tools/qbd/sales-orders/delete-qbd-sales-orders.ts

@@ -1,5 +1,6 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+import { maybeFilter } from 'conductor-node-mcp/filtering';
 import { asTextContentResult } from 'conductor-node-mcp/tools/types';
 
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
@@ -17,7 +18,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'delete_qbd_sales_orders',
   description:
-    'Permanently deletes a a sales order. The deletion will fail if the sales order is currently in use or has any linked transactions that are in use.',
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nPermanently deletes a a sales order. The deletion will fail if the sales order is currently in use or has any linked transactions that are in use.\n\n# Response Schema\n```json\n{\n  type: 'object',\n  properties: {\n    id: {\n      type: 'string',\n      description: 'The QuickBooks-assigned unique identifier of the deleted sales order.'\n    },\n    deleted: {\n      type: 'boolean',\n      description: 'Indicates whether the sales order was deleted.'\n    },\n    objectType: {\n      type: 'string',\n      description: 'The type of object. This value is always `\"qbd_sales_order\"`.',\n      enum: [        'qbd_sales_order'\n      ]\n    },\n    refNumber: {\n      type: 'string',\n      description: 'The case-sensitive user-defined reference number of the deleted sales order.'\n    }\n  },\n  required: [    'id',\n    'deleted',\n    'objectType',\n    'refNumber'\n  ]\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {
@@ -30,13 +31,19 @@ export const tool: Tool = {
         description:
           'The ID of the EndUser to receive this request (e.g., `"Conductor-End-User-Id: {{END_USER_ID}}"`).',
       },
+      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/).',
+      },
     },
   },
 };
 
 export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {
   const { id, ...body } = args as any;
-  return asTextContentResult(await conductor.qbd.salesOrders.delete(id, body));
+  return asTextContentResult(await maybeFilter(args, await conductor.qbd.salesOrders.delete(id, body)));
 };
 
 export default { metadata, tool, handler };

package/src/tools/qbd/sales-orders/list-qbd-sales-orders.ts

@@ -16,7 +16,8 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'list_qbd_sales_orders',
-  description: 'Returns a list of sales orders. Use the `cursor` parameter to paginate through the results.',
+  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\nReturns a list of sales orders. Use the `cursor` parameter to paginate through the results.",
   inputSchema: {
     type: 'object',
     properties: {
@@ -127,7 +128,8 @@ export const tool: Tool = {
 
 export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {
   const body = args as any;
-  return asTextContentResult(await conductor.qbd.salesOrders.list(body));
+  const response = await conductor.qbd.salesOrders.list(body).asResponse();
+  return asTextContentResult(await response.json());
 };
 
 export default { metadata, tool, handler };

package/src/tools/qbd/sales-orders/retrieve-qbd-sales-orders.ts

@@ -16,7 +16,8 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'retrieve_qbd_sales_orders',
-  description: 'Retrieves a sales order by ID.',
+  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\nRetrieves a sales order by ID.",
   inputSchema: {
     type: 'object',
     properties: {

package/src/tools/qbd/sales-orders/update-qbd-sales-orders.ts

@@ -16,7 +16,8 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'update_qbd_sales_orders',
-  description: 'Updates an existing sales order.',
+  description:
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nUpdates an existing sales order.",
   inputSchema: {
     type: 'object',
     properties: {

package/src/tools/qbd/sales-receipts/create-qbd-sales-receipts.ts

@@ -16,7 +16,8 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'create_qbd_sales_receipts',
-  description: 'Creates a new sales receipt.',
+  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\nCreates a new sales receipt.",
   inputSchema: {
     type: 'object',
     properties: {

package/src/tools/qbd/sales-receipts/delete-qbd-sales-receipts.ts

@@ -1,5 +1,6 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+import { maybeFilter } from 'conductor-node-mcp/filtering';
 import { asTextContentResult } from 'conductor-node-mcp/tools/types';
 
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
@@ -17,7 +18,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'delete_qbd_sales_receipts',
   description:
-    'Permanently deletes a a sales receipt. The deletion will fail if the sales receipt is currently in use or has any linked transactions that are in use.',
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nPermanently deletes a a sales receipt. The deletion will fail if the sales receipt is currently in use or has any linked transactions that are in use.\n\n# Response Schema\n```json\n{\n  type: 'object',\n  properties: {\n    id: {\n      type: 'string',\n      description: 'The QuickBooks-assigned unique identifier of the deleted sales receipt.'\n    },\n    deleted: {\n      type: 'boolean',\n      description: 'Indicates whether the sales receipt was deleted.'\n    },\n    objectType: {\n      type: 'string',\n      description: 'The type of object. This value is always `\"qbd_sales_receipt\"`.',\n      enum: [        'qbd_sales_receipt'\n      ]\n    },\n    refNumber: {\n      type: 'string',\n      description: 'The case-sensitive user-defined reference number of the deleted sales receipt.'\n    }\n  },\n  required: [    'id',\n    'deleted',\n    'objectType',\n    'refNumber'\n  ]\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {
@@ -30,13 +31,19 @@ export const tool: Tool = {
         description:
           'The ID of the EndUser to receive this request (e.g., `"Conductor-End-User-Id: {{END_USER_ID}}"`).',
       },
+      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/).',
+      },
     },
   },
 };
 
 export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {
   const { id, ...body } = args as any;
-  return asTextContentResult(await conductor.qbd.salesReceipts.delete(id, body));
+  return asTextContentResult(await maybeFilter(args, await conductor.qbd.salesReceipts.delete(id, body)));
 };
 
 export default { metadata, tool, handler };

package/src/tools/qbd/sales-receipts/list-qbd-sales-receipts.ts

@@ -17,7 +17,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'list_qbd_sales_receipts',
   description:
-    'Returns a list of sales receipts. Use the `cursor` parameter to paginate through the results.',
+    "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\nReturns a list of sales receipts. Use the `cursor` parameter to paginate through the results.",
   inputSchema: {
     type: 'object',
     properties: {
@@ -130,7 +130,8 @@ export const tool: Tool = {
 
 export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {
   const body = args as any;
-  return asTextContentResult(await conductor.qbd.salesReceipts.list(body));
+  const response = await conductor.qbd.salesReceipts.list(body).asResponse();
+  return asTextContentResult(await response.json());
 };
 
 export default { metadata, tool, handler };

package/src/tools/qbd/sales-receipts/retrieve-qbd-sales-receipts.ts

@@ -16,7 +16,8 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'retrieve_qbd_sales_receipts',
-  description: 'Retrieves a sales receipt by ID.',
+  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\nRetrieves a sales receipt by ID.",
   inputSchema: {
     type: 'object',
     properties: {

package/src/tools/qbd/sales-receipts/update-qbd-sales-receipts.ts

@@ -16,7 +16,8 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'update_qbd_sales_receipts',
-  description: 'Updates an existing sales receipt.',
+  description:
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nUpdates an existing sales receipt.",
   inputSchema: {
     type: 'object',
     properties: {