conductor-node-mcp 12.14.0 → 12.15.1

package/src/tools/qbd/bill-check-payments/delete-qbd-bill-check-payments.ts

@@ -1,9 +1,9 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { asTextContentResult } from 'conductor-node-mcp/tools/types';
+import { maybeFilter } from 'conductor-node-mcp/filtering';
+import { Metadata, asTextContentResult } from 'conductor-node-mcp/tools/types';
 
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import type { Metadata } from '../../';
 import Conductor from 'conductor-node';
 
 export const metadata: Metadata = {
@@ -17,7 +17,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'delete_qbd_bill_check_payments',
   description:
-    'Permanently deletes a a bill check payment. The deletion will fail if the bill check 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 bill check payment. The deletion will fail if the bill check 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 bill check payment.'\n    },\n    deleted: {\n      type: 'boolean',\n      description: 'Indicates whether the bill check payment was deleted.'\n    },\n    objectType: {\n      type: 'string',\n      description: 'The type of object. This value is always `\"qbd_bill_check_payment\"`.',\n      enum: [        'qbd_bill_check_payment'\n      ]\n    },\n    refNumber: {\n      type: 'string',\n      description: 'The case-sensitive user-defined reference number of the deleted bill check payment.'\n    }\n  },\n  required: [    'id',\n    'deleted',\n    'objectType',\n    'refNumber'\n  ]\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {
@@ -25,10 +25,16 @@ export const tool: Tool = {
         type: 'string',
         description: 'The QuickBooks-assigned unique identifier of the bill check payment to delete.',
       },
-      'Conductor-End-User-Id': {
+      conductorEndUserId: {
         type: 'string',
         description:
-          'The ID of the EndUser to receive this request (e.g., `"Conductor-End-User-Id: {{END_USER_ID}}"`).',
+          'The ID of the EndUser to receive this request (e.g., `"conductorEndUserId:{{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/).',
       },
     },
   },
@@ -36,7 +42,7 @@ export const tool: Tool = {
 
 export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {
   const { id, ...body } = args as any;
-  return asTextContentResult(await conductor.qbd.billCheckPayments.delete(id, body));
+  return asTextContentResult(await maybeFilter(args, await conductor.qbd.billCheckPayments.delete(id, body)));
 };
 
 export default { metadata, tool, handler };

package/src/tools/qbd/bill-check-payments/list-qbd-bill-check-payments.ts

@@ -1,9 +1,8 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { asTextContentResult } from 'conductor-node-mcp/tools/types';
+import { Metadata, asTextContentResult } from 'conductor-node-mcp/tools/types';
 
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import type { Metadata } from '../../';
 import Conductor from 'conductor-node';
 
 export const metadata: Metadata = {
@@ -17,14 +16,14 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'list_qbd_bill_check_payments',
   description:
-    'Returns a list of bill check 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 bill check payments. Use the `cursor` parameter to paginate through the results.",
   inputSchema: {
     type: 'object',
     properties: {
-      'Conductor-End-User-Id': {
+      conductorEndUserId: {
         type: 'string',
         description:
-          'The ID of the EndUser to receive this request (e.g., `"Conductor-End-User-Id: {{END_USER_ID}}"`).',
+          'The ID of the EndUser to receive this request (e.g., `"conductorEndUserId:{{END_USER_ID}}"`).',
       },
       accountIds: {
         type: 'array',
@@ -131,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.billCheckPayments.list(body));
+  const response = await conductor.qbd.billCheckPayments.list(body).asResponse();
+  return asTextContentResult(await response.json());
 };
 
 export default { metadata, tool, handler };

package/src/tools/qbd/bill-check-payments/retrieve-qbd-bill-check-payments.ts

@@ -1,9 +1,8 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { asTextContentResult } from 'conductor-node-mcp/tools/types';
+import { Metadata, asTextContentResult } from 'conductor-node-mcp/tools/types';
 
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import type { Metadata } from '../../';
 import Conductor from 'conductor-node';
 
 export const metadata: Metadata = {
@@ -16,7 +15,8 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'retrieve_qbd_bill_check_payments',
-  description: 'Retrieves a bill check 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 bill check payment by ID.",
   inputSchema: {
     type: 'object',
     properties: {
@@ -24,10 +24,10 @@ export const tool: Tool = {
         type: 'string',
         description: 'The QuickBooks-assigned unique identifier of the bill check payment to retrieve.',
       },
-      'Conductor-End-User-Id': {
+      conductorEndUserId: {
         type: 'string',
         description:
-          'The ID of the EndUser to receive this request (e.g., `"Conductor-End-User-Id: {{END_USER_ID}}"`).',
+          'The ID of the EndUser to receive this request (e.g., `"conductorEndUserId:{{END_USER_ID}}"`).',
       },
     },
   },

package/src/tools/qbd/bill-check-payments/update-qbd-bill-check-payments.ts

@@ -1,9 +1,8 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { asTextContentResult } from 'conductor-node-mcp/tools/types';
+import { Metadata, asTextContentResult } from 'conductor-node-mcp/tools/types';
 
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import type { Metadata } from '../../';
 import Conductor from 'conductor-node';
 
 export const metadata: Metadata = {
@@ -16,7 +15,8 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'update_qbd_bill_check_payments',
-  description: 'Updates an existing bill check 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 bill check payment.",
   inputSchema: {
     type: 'object',
     properties: {
@@ -29,10 +29,10 @@ export const tool: Tool = {
         description:
           "The current QuickBooks-assigned revision number of the bill check payment object you are updating, which you can get by fetching the object first. Provide the most recent `revisionNumber` to ensure you're working with the latest data; otherwise, the update will return an error.",
       },
-      'Conductor-End-User-Id': {
+      conductorEndUserId: {
         type: 'string',
         description:
-          'The ID of the EndUser to receive this request (e.g., `"Conductor-End-User-Id: {{END_USER_ID}}"`).',
+          'The ID of the EndUser to receive this request (e.g., `"conductorEndUserId:{{END_USER_ID}}"`).',
       },
       amount: {
         type: 'string',

package/src/tools/qbd/bill-credit-card-payments/create-qbd-bill-credit-card-payments.ts

@@ -1,9 +1,8 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { asTextContentResult } from 'conductor-node-mcp/tools/types';
+import { Metadata, asTextContentResult } from 'conductor-node-mcp/tools/types';
 
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import type { Metadata } from '../../';
 import Conductor from 'conductor-node';
 
 export const metadata: Metadata = {
@@ -16,7 +15,8 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'create_qbd_bill_credit_card_payments',
-  description: 'Creates a new bill credit card 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 bill credit card payment.",
   inputSchema: {
     type: 'object',
     properties: {
@@ -93,10 +93,10 @@ export const tool: Tool = {
         description:
           'The vendor who sent the bill(s) that this bill credit card payment is paying and who will receive this payment.\n\n**IMPORTANT**: This vendor must match the `vendor` on the bill(s) specified in `applyToTransactions`; otherwise, QuickBooks will say the `transactionId` in `applyToTransactions` "does not exist".',
       },
-      'Conductor-End-User-Id': {
+      conductorEndUserId: {
         type: 'string',
         description:
-          'The ID of the EndUser to receive this request (e.g., `"Conductor-End-User-Id: {{END_USER_ID}}"`).',
+          'The ID of the EndUser to receive this request (e.g., `"conductorEndUserId:{{END_USER_ID}}"`).',
       },
       exchangeRate: {
         type: 'number',

package/src/tools/qbd/bill-credit-card-payments/delete-qbd-bill-credit-card-payments.ts

@@ -1,9 +1,9 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { asTextContentResult } from 'conductor-node-mcp/tools/types';
+import { maybeFilter } from 'conductor-node-mcp/filtering';
+import { Metadata, asTextContentResult } from 'conductor-node-mcp/tools/types';
 
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import type { Metadata } from '../../';
 import Conductor from 'conductor-node';
 
 export const metadata: Metadata = {
@@ -17,7 +17,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'delete_qbd_bill_credit_card_payments',
   description:
-    'Permanently deletes a a bill credit card payment. The deletion will fail if the bill credit card 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 bill credit card payment. The deletion will fail if the bill credit card 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 bill credit card payment.'\n    },\n    deleted: {\n      type: 'boolean',\n      description: 'Indicates whether the bill credit card payment was deleted.'\n    },\n    objectType: {\n      type: 'string',\n      description: 'The type of object. This value is always `\"qbd_bill_credit_card_payment\"`.',\n      enum: [        'qbd_bill_credit_card_payment'\n      ]\n    },\n    refNumber: {\n      type: 'string',\n      description: 'The case-sensitive user-defined reference number of the deleted bill credit card payment.'\n    }\n  },\n  required: [    'id',\n    'deleted',\n    'objectType',\n    'refNumber'\n  ]\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {
@@ -25,10 +25,16 @@ export const tool: Tool = {
         type: 'string',
         description: 'The QuickBooks-assigned unique identifier of the bill credit card payment to delete.',
       },
-      'Conductor-End-User-Id': {
+      conductorEndUserId: {
         type: 'string',
         description:
-          'The ID of the EndUser to receive this request (e.g., `"Conductor-End-User-Id: {{END_USER_ID}}"`).',
+          'The ID of the EndUser to receive this request (e.g., `"conductorEndUserId:{{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/).',
       },
     },
   },
@@ -36,7 +42,9 @@ export const tool: Tool = {
 
 export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {
   const { id, ...body } = args as any;
-  return asTextContentResult(await conductor.qbd.billCreditCardPayments.delete(id, body));
+  return asTextContentResult(
+    await maybeFilter(args, await conductor.qbd.billCreditCardPayments.delete(id, body)),
+  );
 };
 
 export default { metadata, tool, handler };

package/src/tools/qbd/bill-credit-card-payments/list-qbd-bill-credit-card-payments.ts

@@ -1,9 +1,8 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { asTextContentResult } from 'conductor-node-mcp/tools/types';
+import { Metadata, asTextContentResult } from 'conductor-node-mcp/tools/types';
 
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import type { Metadata } from '../../';
 import Conductor from 'conductor-node';
 
 export const metadata: Metadata = {
@@ -17,14 +16,14 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'list_qbd_bill_credit_card_payments',
   description:
-    'Returns a list of bill credit card 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 bill credit card payments. Use the `cursor` parameter to paginate through the results.",
   inputSchema: {
     type: 'object',
     properties: {
-      'Conductor-End-User-Id': {
+      conductorEndUserId: {
         type: 'string',
         description:
-          'The ID of the EndUser to receive this request (e.g., `"Conductor-End-User-Id: {{END_USER_ID}}"`).',
+          'The ID of the EndUser to receive this request (e.g., `"conductorEndUserId:{{END_USER_ID}}"`).',
       },
       accountIds: {
         type: 'array',
@@ -131,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.billCreditCardPayments.list(body));
+  const response = await conductor.qbd.billCreditCardPayments.list(body).asResponse();
+  return asTextContentResult(await response.json());
 };
 
 export default { metadata, tool, handler };

package/src/tools/qbd/bill-credit-card-payments/retrieve-qbd-bill-credit-card-payments.ts

@@ -1,9 +1,8 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { asTextContentResult } from 'conductor-node-mcp/tools/types';
+import { Metadata, asTextContentResult } from 'conductor-node-mcp/tools/types';
 
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import type { Metadata } from '../../';
 import Conductor from 'conductor-node';
 
 export const metadata: Metadata = {
@@ -16,7 +15,8 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'retrieve_qbd_bill_credit_card_payments',
-  description: 'Retrieves a bill credit card 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 bill credit card payment by ID.",
   inputSchema: {
     type: 'object',
     properties: {
@@ -24,10 +24,10 @@ export const tool: Tool = {
         type: 'string',
         description: 'The QuickBooks-assigned unique identifier of the bill credit card payment to retrieve.',
       },
-      'Conductor-End-User-Id': {
+      conductorEndUserId: {
         type: 'string',
         description:
-          'The ID of the EndUser to receive this request (e.g., `"Conductor-End-User-Id: {{END_USER_ID}}"`).',
+          'The ID of the EndUser to receive this request (e.g., `"conductorEndUserId:{{END_USER_ID}}"`).',
       },
     },
   },

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

@@ -1,9 +1,8 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { asTextContentResult } from 'conductor-node-mcp/tools/types';
+import { Metadata, asTextContentResult } from 'conductor-node-mcp/tools/types';
 
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import type { Metadata } from '../../';
 import Conductor from 'conductor-node';
 
 export const metadata: Metadata = {
@@ -16,7 +15,8 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'create_qbd_bills',
-  description: 'Creates a new bill.',
+  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 bill.",
   inputSchema: {
     type: 'object',
     properties: {
@@ -29,10 +29,10 @@ export const tool: Tool = {
         type: 'string',
         description: 'The vendor who sent this bill for goods or services purchased.',
       },
-      'Conductor-End-User-Id': {
+      conductorEndUserId: {
         type: 'string',
         description:
-          'The ID of the EndUser to receive this request (e.g., `"Conductor-End-User-Id: {{END_USER_ID}}"`).',
+          'The ID of the EndUser to receive this request (e.g., `"conductorEndUserId:{{END_USER_ID}}"`).',
       },
       dueDate: {
         type: 'string',

package/src/tools/qbd/bills/delete-qbd-bills.ts

@@ -1,9 +1,9 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { asTextContentResult } from 'conductor-node-mcp/tools/types';
+import { maybeFilter } from 'conductor-node-mcp/filtering';
+import { Metadata, asTextContentResult } from 'conductor-node-mcp/tools/types';
 
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import type { Metadata } from '../../';
 import Conductor from 'conductor-node';
 
 export const metadata: Metadata = {
@@ -17,7 +17,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'delete_qbd_bills',
   description:
-    'Permanently deletes a a bill. The deletion will fail if the bill 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 bill. The deletion will fail if the bill 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 bill.'\n    },\n    deleted: {\n      type: 'boolean',\n      description: 'Indicates whether the bill was deleted.'\n    },\n    objectType: {\n      type: 'string',\n      description: 'The type of object. This value is always `\"qbd_bill\"`.',\n      enum: [        'qbd_bill'\n      ]\n    },\n    refNumber: {\n      type: 'string',\n      description: 'The case-sensitive user-defined reference number of the deleted bill.'\n    }\n  },\n  required: [    'id',\n    'deleted',\n    'objectType',\n    'refNumber'\n  ]\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {
@@ -25,10 +25,16 @@ export const tool: Tool = {
         type: 'string',
         description: 'The QuickBooks-assigned unique identifier of the bill to delete.',
       },
-      'Conductor-End-User-Id': {
+      conductorEndUserId: {
         type: 'string',
         description:
-          'The ID of the EndUser to receive this request (e.g., `"Conductor-End-User-Id: {{END_USER_ID}}"`).',
+          'The ID of the EndUser to receive this request (e.g., `"conductorEndUserId:{{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/).',
       },
     },
   },
@@ -36,7 +42,7 @@ export const tool: Tool = {
 
 export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {
   const { id, ...body } = args as any;
-  return asTextContentResult(await conductor.qbd.bills.delete(id, body));
+  return asTextContentResult(await maybeFilter(args, await conductor.qbd.bills.delete(id, body)));
 };
 
 export default { metadata, tool, handler };

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

@@ -1,9 +1,8 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { asTextContentResult } from 'conductor-node-mcp/tools/types';
+import { Metadata, asTextContentResult } from 'conductor-node-mcp/tools/types';
 
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import type { Metadata } from '../../';
 import Conductor from 'conductor-node';
 
 export const metadata: Metadata = {
@@ -16,14 +15,15 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'list_qbd_bills',
-  description: 'Returns a list of bills. 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 bills. Use the `cursor` parameter to paginate through the results.",
   inputSchema: {
     type: 'object',
     properties: {
-      'Conductor-End-User-Id': {
+      conductorEndUserId: {
         type: 'string',
         description:
-          'The ID of the EndUser to receive this request (e.g., `"Conductor-End-User-Id: {{END_USER_ID}}"`).',
+          'The ID of the EndUser to receive this request (e.g., `"conductorEndUserId:{{END_USER_ID}}"`).',
       },
       accountIds: {
         type: 'array',
@@ -139,7 +139,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.bills.list(body));
+  const response = await conductor.qbd.bills.list(body).asResponse();
+  return asTextContentResult(await response.json());
 };
 
 export default { metadata, tool, handler };

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

@@ -1,9 +1,8 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { asTextContentResult } from 'conductor-node-mcp/tools/types';
+import { Metadata, asTextContentResult } from 'conductor-node-mcp/tools/types';
 
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import type { Metadata } from '../../';
 import Conductor from 'conductor-node';
 
 export const metadata: Metadata = {
@@ -16,7 +15,8 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'retrieve_qbd_bills',
-  description: 'Retrieves a bill 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 bill by ID.",
   inputSchema: {
     type: 'object',
     properties: {
@@ -24,10 +24,10 @@ export const tool: Tool = {
         type: 'string',
         description: 'The QuickBooks-assigned unique identifier of the bill to retrieve.',
       },
-      'Conductor-End-User-Id': {
+      conductorEndUserId: {
         type: 'string',
         description:
-          'The ID of the EndUser to receive this request (e.g., `"Conductor-End-User-Id: {{END_USER_ID}}"`).',
+          'The ID of the EndUser to receive this request (e.g., `"conductorEndUserId:{{END_USER_ID}}"`).',
       },
     },
   },

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

@@ -1,9 +1,8 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { asTextContentResult } from 'conductor-node-mcp/tools/types';
+import { Metadata, asTextContentResult } from 'conductor-node-mcp/tools/types';
 
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import type { Metadata } from '../../';
 import Conductor from 'conductor-node';
 
 export const metadata: Metadata = {
@@ -16,7 +15,8 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'update_qbd_bills',
-  description: 'Updates an existing bill.',
+  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 bill.",
   inputSchema: {
     type: 'object',
     properties: {
@@ -29,10 +29,10 @@ export const tool: Tool = {
         description:
           "The current QuickBooks-assigned revision number of the bill object you are updating, which you can get by fetching the object first. Provide the most recent `revisionNumber` to ensure you're working with the latest data; otherwise, the update will return an error.",
       },
-      'Conductor-End-User-Id': {
+      conductorEndUserId: {
         type: 'string',
         description:
-          'The ID of the EndUser to receive this request (e.g., `"Conductor-End-User-Id: {{END_USER_ID}}"`).',
+          'The ID of the EndUser to receive this request (e.g., `"conductorEndUserId:{{END_USER_ID}}"`).',
       },
       clearExpenseLines: {
         type: 'boolean',

package/src/tools/qbd/build-assemblies/create-qbd-build-assemblies.ts

@@ -1,9 +1,8 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { asTextContentResult } from 'conductor-node-mcp/tools/types';
+import { Metadata, asTextContentResult } from 'conductor-node-mcp/tools/types';
 
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import type { Metadata } from '../../';
 import Conductor from 'conductor-node';
 
 export const metadata: Metadata = {
@@ -16,7 +15,8 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'create_qbd_build_assemblies',
-  description: 'Creates a new build assembly.',
+  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 build assembly.",
   inputSchema: {
     type: 'object',
     properties: {
@@ -35,10 +35,10 @@ export const tool: Tool = {
         description: 'The date of this build assembly, in ISO 8601 format (YYYY-MM-DD).',
         format: 'date',
       },
-      'Conductor-End-User-Id': {
+      conductorEndUserId: {
         type: 'string',
         description:
-          'The ID of the EndUser to receive this request (e.g., `"Conductor-End-User-Id: {{END_USER_ID}}"`).',
+          'The ID of the EndUser to receive this request (e.g., `"conductorEndUserId:{{END_USER_ID}}"`).',
       },
       expirationDate: {
         type: 'string',

package/src/tools/qbd/build-assemblies/delete-qbd-build-assemblies.ts

@@ -1,9 +1,9 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { asTextContentResult } from 'conductor-node-mcp/tools/types';
+import { maybeFilter } from 'conductor-node-mcp/filtering';
+import { Metadata, asTextContentResult } from 'conductor-node-mcp/tools/types';
 
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import type { Metadata } from '../../';
 import Conductor from 'conductor-node';
 
 export const metadata: Metadata = {
@@ -17,7 +17,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'delete_qbd_build_assemblies',
   description:
-    'Permanently deletes a a build assembly. The deletion will fail if the build assembly 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 build assembly. The deletion will fail if the build assembly 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 build assembly.'\n    },\n    deleted: {\n      type: 'boolean',\n      description: 'Indicates whether the build assembly was deleted.'\n    },\n    objectType: {\n      type: 'string',\n      description: 'The type of object. This value is always `\"qbd_build_assembly\"`.',\n      enum: [        'qbd_build_assembly'\n      ]\n    },\n    refNumber: {\n      type: 'string',\n      description: 'The case-sensitive user-defined reference number of the deleted build assembly.'\n    }\n  },\n  required: [    'id',\n    'deleted',\n    'objectType',\n    'refNumber'\n  ]\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {
@@ -25,10 +25,16 @@ export const tool: Tool = {
         type: 'string',
         description: 'The QuickBooks-assigned unique identifier of the build assembly to delete.',
       },
-      'Conductor-End-User-Id': {
+      conductorEndUserId: {
         type: 'string',
         description:
-          'The ID of the EndUser to receive this request (e.g., `"Conductor-End-User-Id: {{END_USER_ID}}"`).',
+          'The ID of the EndUser to receive this request (e.g., `"conductorEndUserId:{{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/).',
       },
     },
   },
@@ -36,7 +42,7 @@ export const tool: Tool = {
 
 export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {
   const { id, ...body } = args as any;
-  return asTextContentResult(await conductor.qbd.buildAssemblies.delete(id, body));
+  return asTextContentResult(await maybeFilter(args, await conductor.qbd.buildAssemblies.delete(id, body)));
 };
 
 export default { metadata, tool, handler };

package/src/tools/qbd/build-assemblies/list-qbd-build-assemblies.ts

@@ -1,9 +1,8 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { asTextContentResult } from 'conductor-node-mcp/tools/types';
+import { Metadata, asTextContentResult } from 'conductor-node-mcp/tools/types';
 
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import type { Metadata } from '../../';
 import Conductor from 'conductor-node';
 
 export const metadata: Metadata = {
@@ -17,14 +16,14 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'list_qbd_build_assemblies',
   description:
-    'Returns a list of build assemblies. 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 build assemblies. Use the `cursor` parameter to paginate through the results.",
   inputSchema: {
     type: 'object',
     properties: {
-      'Conductor-End-User-Id': {
+      conductorEndUserId: {
         type: 'string',
         description:
-          'The ID of the EndUser to receive this request (e.g., `"Conductor-End-User-Id: {{END_USER_ID}}"`).',
+          'The ID of the EndUser to receive this request (e.g., `"conductorEndUserId:{{END_USER_ID}}"`).',
       },
       cursor: {
         type: 'string',
@@ -121,7 +120,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.buildAssemblies.list(body));
+  const response = await conductor.qbd.buildAssemblies.list(body).asResponse();
+  return asTextContentResult(await response.json());
 };
 
 export default { metadata, tool, handler };