conductor-node-mcp 12.14.0 → 12.15.0

package/src/tools/qbd/inventory-adjustments/delete-qbd-inventory-adjustments.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_inventory_adjustments',
   description:
-    'Permanently deletes a an inventory adjustment. The deletion will fail if the inventory adjustment 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 an inventory adjustment. The deletion will fail if the inventory adjustment 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 inventory adjustment.'\n    },\n    deleted: {\n      type: 'boolean',\n      description: 'Indicates whether the inventory adjustment was deleted.'\n    },\n    objectType: {\n      type: 'string',\n      description: 'The type of object. This value is always `\"qbd_inventory_adjustment\"`.',\n      enum: [        'qbd_inventory_adjustment'\n      ]\n    },\n    refNumber: {\n      type: 'string',\n      description: 'The case-sensitive user-defined reference number of the deleted inventory adjustment.'\n    }\n  },\n  required: [    'id',\n    'deleted',\n    'objectType',\n    'refNumber'\n  ]\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {
@@ -30,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.inventoryAdjustments.delete(id, body));
+  return asTextContentResult(
+    await maybeFilter(args, await conductor.qbd.inventoryAdjustments.delete(id, body)),
+  );
 };
 
 export default { metadata, tool, handler };

package/src/tools/qbd/inventory-adjustments/list-qbd-inventory-adjustments.ts

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

package/src/tools/qbd/inventory-adjustments/retrieve-qbd-inventory-adjustments.ts

@@ -16,7 +16,8 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'retrieve_qbd_inventory_adjustments',
-  description: 'Retrieves an inventory adjustment 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 an inventory adjustment by ID.",
   inputSchema: {
     type: 'object',
     properties: {

package/src/tools/qbd/inventory-adjustments/update-qbd-inventory-adjustments.ts

@@ -16,7 +16,8 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'update_qbd_inventory_adjustments',
-  description: 'Updates an existing inventory adjustment.',
+  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 inventory adjustment.",
   inputSchema: {
     type: 'object',
     properties: {

package/src/tools/qbd/inventory-assembly-items/create-qbd-inventory-assembly-items.ts

@@ -16,7 +16,8 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'create_qbd_inventory_assembly_items',
-  description: 'Creates a new inventory assembly item.',
+  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 inventory assembly item.",
   inputSchema: {
     type: 'object',
     properties: {

package/src/tools/qbd/inventory-assembly-items/list-qbd-inventory-assembly-items.ts

@@ -17,7 +17,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'list_qbd_inventory_assembly_items',
   description:
-    'Returns a list of inventory assembly 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 inventory assembly items. Use the `cursor` parameter to paginate through the results.",
   inputSchema: {
     type: 'object',
     properties: {
@@ -106,7 +106,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.inventoryAssemblyItems.list(body));
+  const response = await conductor.qbd.inventoryAssemblyItems.list(body).asResponse();
+  return asTextContentResult(await response.json());
 };
 
 export default { metadata, tool, handler };

package/src/tools/qbd/inventory-assembly-items/retrieve-qbd-inventory-assembly-items.ts

@@ -16,7 +16,8 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'retrieve_qbd_inventory_assembly_items',
-  description: 'Retrieves an inventory assembly 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 an inventory assembly item by ID.",
   inputSchema: {
     type: 'object',
     properties: {

package/src/tools/qbd/inventory-assembly-items/update-qbd-inventory-assembly-items.ts

@@ -16,7 +16,8 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'update_qbd_inventory_assembly_items',
-  description: 'Updates an existing inventory assembly item.',
+  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 inventory assembly item.",
   inputSchema: {
     type: 'object',
     properties: {

package/src/tools/qbd/inventory-items/create-qbd-inventory-items.ts

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

package/src/tools/qbd/inventory-items/list-qbd-inventory-items.ts

@@ -17,7 +17,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'list_qbd_inventory_items',
   description:
-    'Returns a list of inventory 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 inventory items. Use the `cursor` parameter to paginate through the results.",
   inputSchema: {
     type: 'object',
     properties: {
@@ -106,7 +106,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.inventoryItems.list(body));
+  const response = await conductor.qbd.inventoryItems.list(body).asResponse();
+  return asTextContentResult(await response.json());
 };
 
 export default { metadata, tool, handler };

package/src/tools/qbd/inventory-items/retrieve-qbd-inventory-items.ts

@@ -16,7 +16,8 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'retrieve_qbd_inventory_items',
-  description: 'Retrieves an inventory 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 an inventory item by ID.",
   inputSchema: {
     type: 'object',
     properties: {

package/src/tools/qbd/inventory-items/update-qbd-inventory-items.ts

@@ -16,7 +16,8 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'update_qbd_inventory_items',
-  description: 'Updates an existing inventory item.',
+  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 inventory item.",
   inputSchema: {
     type: 'object',
     properties: {

package/src/tools/qbd/inventory-sites/create-qbd-inventory-sites.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_inventory_sites',
-  description: 'Creates a new inventory site.',
+  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 inventory site.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/inventory_site',\n  $defs: {\n    inventory_site: {\n      type: 'object',\n      title: 'The Inventory Site object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The unique identifier assigned by QuickBooks to this inventory site. This ID is unique across all inventory sites but not across different QuickBooks object types.'\n        },\n        address: {\n          type: 'object',\n          title: 'The Site Address object',\n          description: 'The inventory site\\'s address.',\n          properties: {\n            city: {\n              type: 'string',\n              description: 'The city, district, suburb, town, or village name of the site address.'\n            },\n            country: {\n              type: 'string',\n              description: 'The country name of the site address.'\n            },\n            line1: {\n              type: 'string',\n              description: 'The first line of the site address (e.g., street, PO Box, or company name).'\n            },\n            line2: {\n              type: 'string',\n              description: 'The second line of the site address, if needed (e.g., apartment, suite, unit, or building).'\n            },\n            line3: {\n              type: 'string',\n              description: 'The third line of the site address, if needed.'\n            },\n            line4: {\n              type: 'string',\n              description: 'The fourth line of the site address, if needed.'\n            },\n            line5: {\n              type: 'string',\n              description: 'The fifth line of the site address, if needed.'\n            },\n            postalCode: {\n              type: 'string',\n              description: 'The postal code or ZIP code of the site address.'\n            },\n            state: {\n              type: 'string',\n              description: 'The state, county, province, or region name of the site address.'\n            }\n          },\n          required: [            'city',\n            'country',\n            'line1',\n            'line2',\n            'line3',\n            'line4',\n            'line5',\n            'postalCode',\n            'state'\n          ]\n        },\n        contact: {\n          type: 'string',\n          description: 'The name of the primary contact person for this inventory site.'\n        },\n        createdAt: {\n          type: 'string',\n          description: 'The date and time when this inventory site 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        description: {\n          type: 'string',\n          description: 'A description of this inventory site.'\n        },\n        email: {\n          type: 'string',\n          description: 'The inventory site\\'s email address.'\n        },\n        fax: {\n          type: 'string',\n          description: 'The inventory site\\'s fax number.'\n        },\n        isActive: {\n          type: 'boolean',\n          description: 'Indicates whether this inventory site is active. Inactive objects are typically hidden from views and reports in QuickBooks. Defaults to `true`.'\n        },\n        isDefault: {\n          type: 'boolean',\n          description: 'Indicates whether this inventory site is the default site used when no specific site is provided during the creation of other objects.'\n        },\n        name: {\n          type: 'string',\n          description: 'The case-insensitive unique name of this inventory site, unique across all inventory sites.\\n\\n**NOTE**: Inventory sites 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_inventory_site\"`.',\n          enum: [            'qbd_inventory_site'\n          ]\n        },\n        parent: {\n          type: 'object',\n          description: 'The parent inventory site one level above this one in the hierarchy.',\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        phone: {\n          type: 'string',\n          description: 'The inventory site\\'s primary telephone number.'\n        },\n        revisionNumber: {\n          type: 'string',\n          description: 'The current QuickBooks-assigned revision number of this inventory site 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 inventory site 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        'address',\n        'contact',\n        'createdAt',\n        'description',\n        'email',\n        'fax',\n        'isActive',\n        'isDefault',\n        'name',\n        'objectType',\n        'parent',\n        'phone',\n        'revisionNumber',\n        'updatedAt'\n      ]\n    }\n  }\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {
@@ -94,13 +96,19 @@ export const tool: Tool = {
         type: 'string',
         description: 'The parent inventory site one level above this one in the hierarchy.',
       },
+      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.inventorySites.create(body));
+  return asTextContentResult(await maybeFilter(args, await conductor.qbd.inventorySites.create(body)));
 };
 
 export default { metadata, tool, handler };

package/src/tools/qbd/inventory-sites/list-qbd-inventory-sites.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_inventory_sites',
   description:
-    'Returns a list of inventory sites. NOTE: QuickBooks Desktop does not support pagination for inventory sites; hence, there is no `cursor` parameter. Users typically have few inventory sites.',
+    "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 inventory sites. NOTE: QuickBooks Desktop does not support pagination for inventory sites; hence, there is no `cursor` parameter. Users typically have few inventory sites.\n\n# Response Schema\n```json\n{\n  type: 'object',\n  properties: {\n    data: {\n      type: 'array',\n      description: 'The array of inventory sites.',\n      items: {\n        $ref: '#/$defs/inventory_site'\n      }\n    },\n    objectType: {\n      type: 'string',\n      description: 'The type of object. This value is always `\"list\"`.',\n      enum: [        'list'\n      ]\n    },\n    url: {\n      type: 'string',\n      description: 'The endpoint URL where this list can be accessed.'\n    }\n  },\n  required: [    'data',\n    'objectType',\n    'url'\n  ],\n  $defs: {\n    inventory_site: {\n      type: 'object',\n      title: 'The Inventory Site object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The unique identifier assigned by QuickBooks to this inventory site. This ID is unique across all inventory sites but not across different QuickBooks object types.'\n        },\n        address: {\n          type: 'object',\n          title: 'The Site Address object',\n          description: 'The inventory site\\'s address.',\n          properties: {\n            city: {\n              type: 'string',\n              description: 'The city, district, suburb, town, or village name of the site address.'\n            },\n            country: {\n              type: 'string',\n              description: 'The country name of the site address.'\n            },\n            line1: {\n              type: 'string',\n              description: 'The first line of the site address (e.g., street, PO Box, or company name).'\n            },\n            line2: {\n              type: 'string',\n              description: 'The second line of the site address, if needed (e.g., apartment, suite, unit, or building).'\n            },\n            line3: {\n              type: 'string',\n              description: 'The third line of the site address, if needed.'\n            },\n            line4: {\n              type: 'string',\n              description: 'The fourth line of the site address, if needed.'\n            },\n            line5: {\n              type: 'string',\n              description: 'The fifth line of the site address, if needed.'\n            },\n            postalCode: {\n              type: 'string',\n              description: 'The postal code or ZIP code of the site address.'\n            },\n            state: {\n              type: 'string',\n              description: 'The state, county, province, or region name of the site address.'\n            }\n          },\n          required: [            'city',\n            'country',\n            'line1',\n            'line2',\n            'line3',\n            'line4',\n            'line5',\n            'postalCode',\n            'state'\n          ]\n        },\n        contact: {\n          type: 'string',\n          description: 'The name of the primary contact person for this inventory site.'\n        },\n        createdAt: {\n          type: 'string',\n          description: 'The date and time when this inventory site 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        description: {\n          type: 'string',\n          description: 'A description of this inventory site.'\n        },\n        email: {\n          type: 'string',\n          description: 'The inventory site\\'s email address.'\n        },\n        fax: {\n          type: 'string',\n          description: 'The inventory site\\'s fax number.'\n        },\n        isActive: {\n          type: 'boolean',\n          description: 'Indicates whether this inventory site is active. Inactive objects are typically hidden from views and reports in QuickBooks. Defaults to `true`.'\n        },\n        isDefault: {\n          type: 'boolean',\n          description: 'Indicates whether this inventory site is the default site used when no specific site is provided during the creation of other objects.'\n        },\n        name: {\n          type: 'string',\n          description: 'The case-insensitive unique name of this inventory site, unique across all inventory sites.\\n\\n**NOTE**: Inventory sites 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_inventory_site\"`.',\n          enum: [            'qbd_inventory_site'\n          ]\n        },\n        parent: {\n          type: 'object',\n          description: 'The parent inventory site one level above this one in the hierarchy.',\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        phone: {\n          type: 'string',\n          description: 'The inventory site\\'s primary telephone number.'\n        },\n        revisionNumber: {\n          type: 'string',\n          description: 'The current QuickBooks-assigned revision number of this inventory site 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 inventory site 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        'address',\n        'contact',\n        'createdAt',\n        'description',\n        'email',\n        'fax',\n        'isActive',\n        'isDefault',\n        'name',\n        'objectType',\n        'parent',\n        'phone',\n        'revisionNumber',\n        'updatedAt'\n      ]\n    }\n  }\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {
@@ -82,13 +83,19 @@ export const tool: Tool = {
         description:
           'Filter for inventory sites 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.inventorySites.list(body));
+  return asTextContentResult(await maybeFilter(args, await conductor.qbd.inventorySites.list(body)));
 };
 
 export default { metadata, tool, handler };

package/src/tools/qbd/inventory-sites/retrieve-qbd-inventory-sites.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_inventory_sites',
-  description: 'Retrieves an inventory site 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 an inventory site by ID.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/inventory_site',\n  $defs: {\n    inventory_site: {\n      type: 'object',\n      title: 'The Inventory Site object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The unique identifier assigned by QuickBooks to this inventory site. This ID is unique across all inventory sites but not across different QuickBooks object types.'\n        },\n        address: {\n          type: 'object',\n          title: 'The Site Address object',\n          description: 'The inventory site\\'s address.',\n          properties: {\n            city: {\n              type: 'string',\n              description: 'The city, district, suburb, town, or village name of the site address.'\n            },\n            country: {\n              type: 'string',\n              description: 'The country name of the site address.'\n            },\n            line1: {\n              type: 'string',\n              description: 'The first line of the site address (e.g., street, PO Box, or company name).'\n            },\n            line2: {\n              type: 'string',\n              description: 'The second line of the site address, if needed (e.g., apartment, suite, unit, or building).'\n            },\n            line3: {\n              type: 'string',\n              description: 'The third line of the site address, if needed.'\n            },\n            line4: {\n              type: 'string',\n              description: 'The fourth line of the site address, if needed.'\n            },\n            line5: {\n              type: 'string',\n              description: 'The fifth line of the site address, if needed.'\n            },\n            postalCode: {\n              type: 'string',\n              description: 'The postal code or ZIP code of the site address.'\n            },\n            state: {\n              type: 'string',\n              description: 'The state, county, province, or region name of the site address.'\n            }\n          },\n          required: [            'city',\n            'country',\n            'line1',\n            'line2',\n            'line3',\n            'line4',\n            'line5',\n            'postalCode',\n            'state'\n          ]\n        },\n        contact: {\n          type: 'string',\n          description: 'The name of the primary contact person for this inventory site.'\n        },\n        createdAt: {\n          type: 'string',\n          description: 'The date and time when this inventory site 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        description: {\n          type: 'string',\n          description: 'A description of this inventory site.'\n        },\n        email: {\n          type: 'string',\n          description: 'The inventory site\\'s email address.'\n        },\n        fax: {\n          type: 'string',\n          description: 'The inventory site\\'s fax number.'\n        },\n        isActive: {\n          type: 'boolean',\n          description: 'Indicates whether this inventory site is active. Inactive objects are typically hidden from views and reports in QuickBooks. Defaults to `true`.'\n        },\n        isDefault: {\n          type: 'boolean',\n          description: 'Indicates whether this inventory site is the default site used when no specific site is provided during the creation of other objects.'\n        },\n        name: {\n          type: 'string',\n          description: 'The case-insensitive unique name of this inventory site, unique across all inventory sites.\\n\\n**NOTE**: Inventory sites 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_inventory_site\"`.',\n          enum: [            'qbd_inventory_site'\n          ]\n        },\n        parent: {\n          type: 'object',\n          description: 'The parent inventory site one level above this one in the hierarchy.',\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        phone: {\n          type: 'string',\n          description: 'The inventory site\\'s primary telephone number.'\n        },\n        revisionNumber: {\n          type: 'string',\n          description: 'The current QuickBooks-assigned revision number of this inventory site 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 inventory site 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        'address',\n        'contact',\n        'createdAt',\n        'description',\n        'email',\n        'fax',\n        'isActive',\n        'isDefault',\n        'name',\n        'objectType',\n        'parent',\n        'phone',\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.inventorySites.retrieve(id, body));
+  return asTextContentResult(await maybeFilter(args, await conductor.qbd.inventorySites.retrieve(id, body)));
 };
 
 export default { metadata, tool, handler };

package/src/tools/qbd/inventory-sites/update-qbd-inventory-sites.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: 'update_qbd_inventory_sites',
-  description: 'Updates an existing inventory site.',
+  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 inventory site.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/inventory_site',\n  $defs: {\n    inventory_site: {\n      type: 'object',\n      title: 'The Inventory Site object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The unique identifier assigned by QuickBooks to this inventory site. This ID is unique across all inventory sites but not across different QuickBooks object types.'\n        },\n        address: {\n          type: 'object',\n          title: 'The Site Address object',\n          description: 'The inventory site\\'s address.',\n          properties: {\n            city: {\n              type: 'string',\n              description: 'The city, district, suburb, town, or village name of the site address.'\n            },\n            country: {\n              type: 'string',\n              description: 'The country name of the site address.'\n            },\n            line1: {\n              type: 'string',\n              description: 'The first line of the site address (e.g., street, PO Box, or company name).'\n            },\n            line2: {\n              type: 'string',\n              description: 'The second line of the site address, if needed (e.g., apartment, suite, unit, or building).'\n            },\n            line3: {\n              type: 'string',\n              description: 'The third line of the site address, if needed.'\n            },\n            line4: {\n              type: 'string',\n              description: 'The fourth line of the site address, if needed.'\n            },\n            line5: {\n              type: 'string',\n              description: 'The fifth line of the site address, if needed.'\n            },\n            postalCode: {\n              type: 'string',\n              description: 'The postal code or ZIP code of the site address.'\n            },\n            state: {\n              type: 'string',\n              description: 'The state, county, province, or region name of the site address.'\n            }\n          },\n          required: [            'city',\n            'country',\n            'line1',\n            'line2',\n            'line3',\n            'line4',\n            'line5',\n            'postalCode',\n            'state'\n          ]\n        },\n        contact: {\n          type: 'string',\n          description: 'The name of the primary contact person for this inventory site.'\n        },\n        createdAt: {\n          type: 'string',\n          description: 'The date and time when this inventory site 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        description: {\n          type: 'string',\n          description: 'A description of this inventory site.'\n        },\n        email: {\n          type: 'string',\n          description: 'The inventory site\\'s email address.'\n        },\n        fax: {\n          type: 'string',\n          description: 'The inventory site\\'s fax number.'\n        },\n        isActive: {\n          type: 'boolean',\n          description: 'Indicates whether this inventory site is active. Inactive objects are typically hidden from views and reports in QuickBooks. Defaults to `true`.'\n        },\n        isDefault: {\n          type: 'boolean',\n          description: 'Indicates whether this inventory site is the default site used when no specific site is provided during the creation of other objects.'\n        },\n        name: {\n          type: 'string',\n          description: 'The case-insensitive unique name of this inventory site, unique across all inventory sites.\\n\\n**NOTE**: Inventory sites 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_inventory_site\"`.',\n          enum: [            'qbd_inventory_site'\n          ]\n        },\n        parent: {\n          type: 'object',\n          description: 'The parent inventory site one level above this one in the hierarchy.',\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        phone: {\n          type: 'string',\n          description: 'The inventory site\\'s primary telephone number.'\n        },\n        revisionNumber: {\n          type: 'string',\n          description: 'The current QuickBooks-assigned revision number of this inventory site 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 inventory site 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        'address',\n        'contact',\n        'createdAt',\n        'description',\n        'email',\n        'fax',\n        'isActive',\n        'isDefault',\n        'name',\n        'objectType',\n        'parent',\n        'phone',\n        'revisionNumber',\n        'updatedAt'\n      ]\n    }\n  }\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {
@@ -115,13 +117,19 @@ export const tool: Tool = {
         type: 'string',
         description: "The inventory site's primary telephone number.",
       },
+      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.inventorySites.update(id, body));
+  return asTextContentResult(await maybeFilter(args, await conductor.qbd.inventorySites.update(id, body)));
 };
 
 export default { metadata, tool, handler };

package/src/tools/qbd/invoices/create-qbd-invoices.ts

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

package/src/tools/qbd/invoices/delete-qbd-invoices.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_invoices',
   description:
-    'Permanently deletes a an invoice. The deletion will fail if the invoice 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 an invoice. The deletion will fail if the invoice 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 invoice.'\n    },\n    deleted: {\n      type: 'boolean',\n      description: 'Indicates whether the invoice was deleted.'\n    },\n    objectType: {\n      type: 'string',\n      description: 'The type of object. This value is always `\"qbd_invoice\"`.',\n      enum: [        'qbd_invoice'\n      ]\n    },\n    refNumber: {\n      type: 'string',\n      description: 'The case-sensitive user-defined reference number of the deleted invoice.'\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.invoices.delete(id, body));
+  return asTextContentResult(await maybeFilter(args, await conductor.qbd.invoices.delete(id, body)));
 };
 
 export default { metadata, tool, handler };

package/src/tools/qbd/invoices/list-qbd-invoices.ts

@@ -16,7 +16,8 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'list_qbd_invoices',
-  description: 'Returns a list of invoices. 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 invoices. Use the `cursor` parameter to paginate through the results.",
   inputSchema: {
     type: 'object',
     properties: {
@@ -139,7 +140,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.invoices.list(body));
+  const response = await conductor.qbd.invoices.list(body).asResponse();
+  return asTextContentResult(await response.json());
 };
 
 export default { metadata, tool, handler };

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

@@ -16,7 +16,8 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'retrieve_qbd_invoices',
-  description: 'Retrieves an invoice 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 an invoice by ID.",
   inputSchema: {
     type: 'object',
     properties: {

package/src/tools/qbd/invoices/update-qbd-invoices.ts

@@ -16,7 +16,8 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'update_qbd_invoices',
-  description: 'Updates an existing invoice.',
+  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 invoice.",
   inputSchema: {
     type: 'object',
     properties: {

package/src/tools/qbd/item-groups/create-qbd-item-groups.ts

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

package/src/tools/qbd/item-groups/list-qbd-item-groups.ts

@@ -16,7 +16,8 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'list_qbd_item_groups',
-  description: 'Returns a list of item groups. 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 item groups. Use the `cursor` parameter to paginate through the results.",
   inputSchema: {
     type: 'object',
     properties: {
@@ -97,7 +98,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.itemGroups.list(body));
+  const response = await conductor.qbd.itemGroups.list(body).asResponse();
+  return asTextContentResult(await response.json());
 };
 
 export default { metadata, tool, handler };

package/src/tools/qbd/item-groups/retrieve-qbd-item-groups.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_item_groups',
-  description: 'Retrieves an item group 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 an item group by ID.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/item_group',\n  $defs: {\n    item_group: {\n      type: 'object',\n      title: 'The Item Group object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The unique identifier assigned by QuickBooks to this item group. This ID is unique across all item groups but not across different QuickBooks object types.'\n        },\n        barcode: {\n          type: 'string',\n          description: 'The item group\\'s barcode.'\n        },\n        createdAt: {\n          type: 'string',\n          description: 'The date and time when this item group 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        customFields: {\n          type: 'array',\n          description: 'The custom fields for the item group object, added as user-defined data extensions, not included in the standard QuickBooks object.',\n          items: {\n            type: 'object',\n            title: 'The Custom Field object',\n            properties: {\n              name: {\n                type: 'string',\n                description: 'The name of the custom field, unique for the specified `ownerId`. For public custom fields, this name is visible as a label in the QuickBooks UI.'\n              },\n              ownerId: {\n                type: 'string',\n                description: 'The identifier of the owner of the custom field, which QuickBooks internally calls a \"data extension\". For public custom fields visible in the UI, such as those added by the QuickBooks user, this is always \"0\". For private custom fields that are only visible to the application that created them, this is a valid GUID identifying the owning application. Internally, Conductor always fetches all public custom fields (those with an `ownerId` of \"0\") for all objects.'\n              },\n              type: {\n                type: 'string',\n                description: 'The data type of this custom field.',\n                enum: [                  'amount_type',\n                  'date_time_type',\n                  'integer_type',\n                  'percent_type',\n                  'price_type',\n                  'quantity_type',\n                  'string_1024_type',\n                  'string_255_type'\n                ]\n              },\n              value: {\n                type: 'string',\n                description: 'The value of this custom field. The maximum length depends on the field\\'s data type.'\n              }\n            },\n            required: [              'name',\n              'ownerId',\n              'type',\n              'value'\n            ]\n          }\n        },\n        description: {\n          type: 'string',\n          description: 'The item group\\'s description that will appear on sales forms that include this item.'\n        },\n        externalId: {\n          type: 'string',\n          description: 'A globally unique identifier (GUID) you, the developer, can provide for tracking this object in your external system. This field is immutable and can only be set during object creation.'\n        },\n        isActive: {\n          type: 'boolean',\n          description: 'Indicates whether this item group is active. Inactive objects are typically hidden from views and reports in QuickBooks. Defaults to `true`.'\n        },\n        lines: {\n          type: 'array',\n          description: 'The item lines in this item group.',\n          items: {\n            type: 'object',\n            title: 'The Item Group Line object',\n            properties: {\n              item: {\n                type: 'object',\n                description: 'The item associated with this item group line. 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              quantity: {\n                type: 'number',\n                description: 'The quantity of the item group associated with this item group line. This field cannot be cleared.\\n\\n**NOTE**: Do not use this field if the associated item group is a discount item group.'\n              },\n              unitOfMeasure: {\n                type: 'string',\n                description: 'The unit-of-measure used for the `quantity` in this item group line. Must be a valid unit within the item\\'s available units of measure.'\n              }\n            },\n            required: [              'item',\n              'quantity',\n              'unitOfMeasure'\n            ]\n          }\n        },\n        name: {\n          type: 'string',\n          description: 'The case-insensitive unique name of this item group, unique across all item groups.\\n\\n**NOTE**: Item groups 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_item_group\"`.',\n          enum: [            'qbd_item_group'\n          ]\n        },\n        revisionNumber: {\n          type: 'string',\n          description: 'The current QuickBooks-assigned revision number of this item group 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        shouldPrintItemsInGroup: {\n          type: 'boolean',\n          description: 'Indicates whether the individual items in this item group and their separate amounts appear on printed forms.'\n        },\n        specialItemType: {\n          type: 'string',\n          description: 'The type of special item for this item group.',\n          enum: [            'finance_charge',\n            'reimbursable_expense_group',\n            'reimbursable_expense_subtotal'\n          ]\n        },\n        unitOfMeasureSet: {\n          type: 'object',\n          description: 'The unit-of-measure set associated with this item group, which consists of a base unit and related units.',\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        updatedAt: {\n          type: 'string',\n          description: 'The date and time when this item group 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        'barcode',\n        'createdAt',\n        'customFields',\n        'description',\n        'externalId',\n        'isActive',\n        'lines',\n        'name',\n        'objectType',\n        'revisionNumber',\n        'shouldPrintItemsInGroup',\n        'specialItemType',\n        'unitOfMeasureSet',\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.itemGroups.retrieve(id, body));
+  return asTextContentResult(await maybeFilter(args, await conductor.qbd.itemGroups.retrieve(id, body)));
 };
 
 export default { metadata, tool, handler };

package/src/tools/qbd/item-groups/update-qbd-item-groups.ts

@@ -16,7 +16,8 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'update_qbd_item_groups',
-  description: 'Updates an existing item group.',
+  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 item group.",
   inputSchema: {
     type: 'object',
     properties: {

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

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