conductor-node-mcp 12.13.0 → 12.15.0

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

package/src/tools/qbd/time-tracking-activities/list-qbd-time-tracking-activities.ts

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

package/src/tools/qbd/time-tracking-activities/retrieve-qbd-time-tracking-activities.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_time_tracking_activities',
-  description: 'Retrieves a time tracking activity 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 time tracking activity by ID.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/time_tracking_activity',\n  $defs: {\n    time_tracking_activity: {\n      type: 'object',\n      title: 'The Time Tracking Activity object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The unique identifier assigned by QuickBooks to this time tracking activity. This ID is unique across all transaction types.'\n        },\n        billingStatus: {\n          type: 'string',\n          description: 'The billing status of this time tracking activity.\\n\\n**IMPORTANT**: When this field is set to \"billable\" for time tracking activities, both `customer` and `serviceItem` are required so that an invoice can be created.',\n          enum: [            'billable',\n            'has_been_billed',\n            'not_billable'\n          ]\n        },\n        class: {\n          type: 'object',\n          description: 'The time tracking activity\\'s class. Classes can be used to categorize objects into meaningful segments, such as department, location, or type of work. In QuickBooks, class tracking is off by default.',\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        createdAt: {\n          type: 'string',\n          description: 'The date and time when this time tracking activity 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        customer: {\n          type: 'object',\n          description: 'The customer or customer-job to which this time tracking activity could be billed. If `billingStatus` is set to \"billable\", this field is required.',\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        duration: {\n          type: 'string',\n          description: 'The time spent performing the service during this time tracking activity, in ISO 8601 format for time intervals (PTnHnMnS). For example, 1 hour and 30 minutes is represented as PT1H30M.\\n\\n**NOTE**: Although seconds can be specified when creating a time tracking activity, they are not returned in responses since QuickBooks Desktop\\'s UI does not display seconds.\\n\\n**IMPORTANT**: This field is required for updating time tracking activities, even if the field is not being modified, because of a bug in QuickBooks itself.'\n        },\n        entity: {\n          type: 'object',\n          description: 'The employee, vendor, or person on QuickBooks\\'s \"Other Names\" list whose time is being tracked in this time tracking activity. This cannot refer to a customer - use the `customer` field to associate a customer or customer-job with this time tracking activity.',\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        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        isBilled: {\n          type: 'boolean',\n          description: 'Indicates whether this time tracking activity has been billed.'\n        },\n        note: {\n          type: 'string',\n          description: 'A note or comment about this time tracking activity.'\n        },\n        objectType: {\n          type: 'string',\n          description: 'The type of object. This value is always `\"qbd_time_tracking_activity\"`.',\n          enum: [            'qbd_time_tracking_activity'\n          ]\n        },\n        payrollWageItem: {\n          type: 'object',\n          description: 'The payroll wage item (e.g., Regular Pay, Overtime Pay) to use for this time tracking activity. This field can only be used for time tracking if: (1) the person specified in `entity` is an employee in QuickBooks, and (2) the \"Use time data to create paychecks\" preference is enabled in their payroll settings.',\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        revisionNumber: {\n          type: 'string',\n          description: 'The current QuickBooks-assigned revision number of this time tracking activity 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        serviceItem: {\n          type: 'object',\n          description: 'The type of service performed during this time tracking activity, referring to billable or purchasable services such as specialized labor, consulting hours, and professional fees.\\n\\n**NOTE**: This field is not required if no `customer` is specified. However, if `billingStatus` is set to \"billable\", both this field and `customer` are required.',\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        transactionDate: {\n          type: 'string',\n          description: 'The date of this time tracking activity, in ISO 8601 format (YYYY-MM-DD).',\n          format: 'date'\n        },\n        updatedAt: {\n          type: 'string',\n          description: 'The date and time when this time tracking activity 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        'billingStatus',\n        'class',\n        'createdAt',\n        'customer',\n        'duration',\n        'entity',\n        'externalId',\n        'isBilled',\n        'note',\n        'objectType',\n        'payrollWageItem',\n        'revisionNumber',\n        'serviceItem',\n        'transactionDate',\n        'updatedAt'\n      ]\n    }\n  }\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {
@@ -29,13 +31,21 @@ export const tool: Tool = {
         description:
           'The ID of the EndUser to receive this request (e.g., `"Conductor-End-User-Id: {{END_USER_ID}}"`).',
       },
+      jq_filter: {
+        type: 'string',
+        title: 'jq Filter',
+        description:
+          'A jq filter to apply to the response to include certain fields. Consult the output schema in the tool description to see the fields that are available.\n\nFor example: to include only the `name` field in every object of a results array, you can provide ".results[].name".\n\nFor more information, see the [jq documentation](https://jqlang.org/manual/).',
+      },
     },
   },
 };
 
 export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {
   const { id, ...body } = args as any;
-  return asTextContentResult(await conductor.qbd.timeTrackingActivities.retrieve(id, body));
+  return asTextContentResult(
+    await maybeFilter(args, await conductor.qbd.timeTrackingActivities.retrieve(id, body)),
+  );
 };
 
 export default { metadata, tool, handler };

package/src/tools/qbd/time-tracking-activities/update-qbd-time-tracking-activities.ts

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

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

@@ -17,7 +17,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'list_qbd_transactions',
   description:
-    'Searches across all transaction types. Unlike transaction-specific queries, this endpoint only returns fields common to all transaction types, such as ID, type, dates, account, and reference numbers. For more details specific to that transaction type, make a subsequent call to the relevant transaction-specific endpoint (such as invoices, bills, etc.). NOTE: This endpoint does not support time tracking activities.',
+    "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\nSearches across all transaction types. Unlike transaction-specific queries, this endpoint only returns fields common to all transaction types, such as ID, type, dates, account, and reference numbers. For more details specific to that transaction type, make a subsequent call to the relevant transaction-specific endpoint (such as invoices, bills, etc.). NOTE: This endpoint does not support time tracking activities.",
   inputSchema: {
     type: 'object',
     properties: {
@@ -200,7 +200,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.transactions.list(body));
+  const response = await conductor.qbd.transactions.list(body).asResponse();
+  return asTextContentResult(await response.json());
 };
 
 export default { metadata, tool, handler };

package/src/tools/qbd/transactions/retrieve-qbd-transactions.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_transactions',
-  description: 'Retrieves a transaction 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 transaction by ID.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/transaction',\n  $defs: {\n    transaction: {\n      type: 'object',\n      title: 'The Transaction object',\n      properties: {\n        account: {\n          type: 'object',\n          description: 'The account associated with this transaction.',\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        amount: {\n          type: 'string',\n          description: 'The monetary amount of this transaction, represented as a decimal string.'\n        },\n        amountInHomeCurrency: {\n          type: 'string',\n          description: 'The monetary amount of this transaction converted to the home currency of the QuickBooks company file. Represented as a decimal string.'\n        },\n        createdAt: {\n          type: 'string',\n          description: 'The date and time when this transaction was created, in ISO 8601 format (YYYY-MM-DDThh:mm:ss±hh:mm). The time zone is the same as the user\\'s time zone in QuickBooks.'\n        },\n        currency: {\n          type: 'object',\n          description: 'The transaction\\'s currency. For built-in currencies, the name and code are standard international values. For user-defined currencies, all values are editable.',\n          properties: {\n            id: {\n              type: 'string',\n              description: 'The unique identifier assigned by QuickBooks to this object. This ID is unique across all objects of the same type, but not across different QuickBooks object types.'\n            },\n            fullName: {\n              type: 'string',\n              description: 'The fully-qualified unique name for this object, formed by combining the names of its parent objects with its own `name`, separated by colons. Not case-sensitive.'\n            }\n          },\n          required: [            'id',\n            'fullName'\n          ]\n        },\n        entity: {\n          type: 'object',\n          description: 'The customer, vendor, employee, or person on QuickBooks\\'s \"Other Names\" list associated with this transaction.',\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        exchangeRate: {\n          type: 'number',\n          description: 'The market exchange rate between this transaction\\'s currency and the home currency in QuickBooks at the time of this transaction. Represented as a decimal value (e.g., 1.2345 for 1 EUR = 1.2345 USD if USD is the home currency).'\n        },\n        memo: {\n          type: 'string',\n          description: 'A memo or note for this transaction.'\n        },\n        refNumber: {\n          type: 'string',\n          description: 'The case-sensitive user-defined reference number for this transaction, which can be used to identify the transaction in QuickBooks. This value is not required to be unique and can be arbitrarily changed by the QuickBooks user.'\n        },\n        transactionDate: {\n          type: 'string',\n          description: 'The date of this transaction, in ISO 8601 format (YYYY-MM-DD).',\n          format: 'date'\n        },\n        transactionId: {\n          type: 'string',\n          description: 'The QuickBooks-assigned unique identifier of this transaction. If `transactionLineId` is also defined, this is the identifier of the line\\'s parent transaction object.'\n        },\n        transactionLineId: {\n          type: 'string',\n          description: 'The QuickBooks-assigned unique identifier of this transaction line. If `null`, this result is a transaction object.'\n        },\n        transactionType: {\n          type: 'string',\n          description: 'The type of transaction.',\n          enum: [            'ar_refund_credit_card',\n            'bill',\n            'bill_payment_check',\n            'bill_payment_credit_card',\n            'build_assembly',\n            'charge',\n            'check',\n            'credit_card_charge',\n            'credit_card_credit',\n            'credit_memo',\n            'deposit',\n            'estimate',\n            'inventory_adjustment',\n            'invoice',\n            'item_receipt',\n            'journal_entry',\n            'liability_adjustment',\n            'paycheck',\n            'payroll_liability_check',\n            'purchase_order',\n            'receive_payment',\n            'sales_order',\n            'sales_receipt',\n            'sales_tax_payment_check',\n            'transfer',\n            'vendor_credit',\n            'ytd_adjustment'\n          ]\n        },\n        updatedAt: {\n          type: 'string',\n          description: 'The date and time when this transaction 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: [        'account',\n        'amount',\n        'amountInHomeCurrency',\n        'createdAt',\n        'currency',\n        'entity',\n        'exchangeRate',\n        'memo',\n        'refNumber',\n        'transactionDate',\n        'transactionId',\n        'transactionLineId',\n        'transactionType',\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.transactions.retrieve(id, body));
+  return asTextContentResult(await maybeFilter(args, await conductor.qbd.transactions.retrieve(id, body)));
 };
 
 export default { metadata, tool, handler };

package/src/tools/qbd/transfers/create-qbd-transfers.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_transfers',
-  description: 'Creates a new transfer.',
+  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 transfer.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/transfer',\n  $defs: {\n    transfer: {\n      type: 'object',\n      title: 'The Transfer object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The unique identifier assigned by QuickBooks to this transfer. This ID is unique across all transaction types.'\n        },\n        amount: {\n          type: 'string',\n          description: 'The monetary amount of this transfer, represented as a decimal string.'\n        },\n        class: {\n          type: 'object',\n          description: 'The transfer\\'s class. Classes can be used to categorize objects into meaningful segments, such as department, location, or type of work. In QuickBooks, class tracking is off by default.',\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        createdAt: {\n          type: 'string',\n          description: 'The date and time when this transfer 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        memo: {\n          type: 'string',\n          description: 'A memo or note for this transfer.'\n        },\n        objectType: {\n          type: 'string',\n          description: 'The type of object. This value is always `\"qbd_transfer\"`.',\n          enum: [            'qbd_transfer'\n          ]\n        },\n        revisionNumber: {\n          type: 'string',\n          description: 'The current QuickBooks-assigned revision number of this transfer 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        sourceAccount: {\n          type: 'object',\n          description: 'The account from which money will be transferred.',\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        sourceAccountBalance: {\n          type: 'string',\n          description: 'The balance of the account from which money will be transferred.'\n        },\n        targetAccount: {\n          type: 'object',\n          description: 'The account to which money will be transferred.',\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        targetAccountBalance: {\n          type: 'string',\n          description: 'The balance of the account to which money will be transferred.'\n        },\n        transactionDate: {\n          type: 'string',\n          description: 'The date of this transfer, in ISO 8601 format (YYYY-MM-DD).',\n          format: 'date'\n        },\n        updatedAt: {\n          type: 'string',\n          description: 'The date and time when this transfer 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        'amount',\n        'class',\n        'createdAt',\n        'memo',\n        'objectType',\n        'revisionNumber',\n        'sourceAccount',\n        'sourceAccountBalance',\n        'targetAccount',\n        'targetAccountBalance',\n        'transactionDate',\n        'updatedAt'\n      ]\n    }\n  }\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {
@@ -51,13 +53,19 @@ export const tool: Tool = {
         type: 'string',
         description: 'A memo or note for this transfer.',
       },
+      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.transfers.create(body));
+  return asTextContentResult(await maybeFilter(args, await conductor.qbd.transfers.create(body)));
 };
 
 export default { metadata, tool, handler };

package/src/tools/qbd/transfers/list-qbd-transfers.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: 'list_qbd_transfers',
-  description: 'Returns a list of transfers. 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 transfers. Use the `cursor` parameter to paginate through the results.\n\n# Response Schema\n```json\n{\n  type: 'object',\n  properties: {\n    data: {\n      type: 'array',\n      description: 'The array of transfers.',\n      items: {\n        $ref: '#/$defs/transfer'\n      }\n    },\n    hasMore: {\n      type: 'boolean',\n      description: 'Indicates whether there are more objects to be fetched.'\n    },\n    nextCursor: {\n      type: 'string',\n      description: 'The `nextCursor` is a pagination token returned in the response when you use the `limit` parameter in your request. To retrieve subsequent pages of results, include this token as the value of the `cursor` request parameter in your following API calls.\\n\\n**NOTE**: The `nextCursor` value remains constant throughout the pagination process for a specific list instance; continue to use the same `nextCursor` token in each request to fetch additional pages.'\n    },\n    objectType: {\n      type: 'string',\n      description: 'The type of object. This value is always `\"list\"`.',\n      enum: [        'list'\n      ]\n    },\n    remainingCount: {\n      type: 'number',\n      description: 'The number of objects remaining to be fetched.'\n    },\n    url: {\n      type: 'string',\n      description: 'The endpoint URL where this list can be accessed.'\n    }\n  },\n  required: [    'data',\n    'hasMore',\n    'nextCursor',\n    'objectType',\n    'remainingCount',\n    'url'\n  ],\n  $defs: {\n    transfer: {\n      type: 'object',\n      title: 'The Transfer object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The unique identifier assigned by QuickBooks to this transfer. This ID is unique across all transaction types.'\n        },\n        amount: {\n          type: 'string',\n          description: 'The monetary amount of this transfer, represented as a decimal string.'\n        },\n        class: {\n          type: 'object',\n          description: 'The transfer\\'s class. Classes can be used to categorize objects into meaningful segments, such as department, location, or type of work. In QuickBooks, class tracking is off by default.',\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        createdAt: {\n          type: 'string',\n          description: 'The date and time when this transfer 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        memo: {\n          type: 'string',\n          description: 'A memo or note for this transfer.'\n        },\n        objectType: {\n          type: 'string',\n          description: 'The type of object. This value is always `\"qbd_transfer\"`.',\n          enum: [            'qbd_transfer'\n          ]\n        },\n        revisionNumber: {\n          type: 'string',\n          description: 'The current QuickBooks-assigned revision number of this transfer 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        sourceAccount: {\n          type: 'object',\n          description: 'The account from which money will be transferred.',\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        sourceAccountBalance: {\n          type: 'string',\n          description: 'The balance of the account from which money will be transferred.'\n        },\n        targetAccount: {\n          type: 'object',\n          description: 'The account to which money will be transferred.',\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        targetAccountBalance: {\n          type: 'string',\n          description: 'The balance of the account to which money will be transferred.'\n        },\n        transactionDate: {\n          type: 'string',\n          description: 'The date of this transfer, in ISO 8601 format (YYYY-MM-DD).',\n          format: 'date'\n        },\n        updatedAt: {\n          type: 'string',\n          description: 'The date and time when this transfer 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        'amount',\n        'class',\n        'createdAt',\n        'memo',\n        'objectType',\n        'revisionNumber',\n        'sourceAccount',\n        'sourceAccountBalance',\n        'targetAccount',\n        'targetAccountBalance',\n        'transactionDate',\n        'updatedAt'\n      ]\n    }\n  }\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {
@@ -65,13 +67,20 @@ export const tool: Tool = {
         description:
           'Filter for transfers 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.transfers.list(body));
+  const response = await conductor.qbd.transfers.list(body).asResponse();
+  return asTextContentResult(await maybeFilter(args, await response.json()));
 };
 
 export default { metadata, tool, handler };

package/src/tools/qbd/transfers/retrieve-qbd-transfers.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_transfers',
-  description: 'Retrieves a transfer 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 transfer by ID.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/transfer',\n  $defs: {\n    transfer: {\n      type: 'object',\n      title: 'The Transfer object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The unique identifier assigned by QuickBooks to this transfer. This ID is unique across all transaction types.'\n        },\n        amount: {\n          type: 'string',\n          description: 'The monetary amount of this transfer, represented as a decimal string.'\n        },\n        class: {\n          type: 'object',\n          description: 'The transfer\\'s class. Classes can be used to categorize objects into meaningful segments, such as department, location, or type of work. In QuickBooks, class tracking is off by default.',\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        createdAt: {\n          type: 'string',\n          description: 'The date and time when this transfer 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        memo: {\n          type: 'string',\n          description: 'A memo or note for this transfer.'\n        },\n        objectType: {\n          type: 'string',\n          description: 'The type of object. This value is always `\"qbd_transfer\"`.',\n          enum: [            'qbd_transfer'\n          ]\n        },\n        revisionNumber: {\n          type: 'string',\n          description: 'The current QuickBooks-assigned revision number of this transfer 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        sourceAccount: {\n          type: 'object',\n          description: 'The account from which money will be transferred.',\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        sourceAccountBalance: {\n          type: 'string',\n          description: 'The balance of the account from which money will be transferred.'\n        },\n        targetAccount: {\n          type: 'object',\n          description: 'The account to which money will be transferred.',\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        targetAccountBalance: {\n          type: 'string',\n          description: 'The balance of the account to which money will be transferred.'\n        },\n        transactionDate: {\n          type: 'string',\n          description: 'The date of this transfer, in ISO 8601 format (YYYY-MM-DD).',\n          format: 'date'\n        },\n        updatedAt: {\n          type: 'string',\n          description: 'The date and time when this transfer 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        'amount',\n        'class',\n        'createdAt',\n        'memo',\n        'objectType',\n        'revisionNumber',\n        'sourceAccount',\n        'sourceAccountBalance',\n        'targetAccount',\n        'targetAccountBalance',\n        'transactionDate',\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.transfers.retrieve(id, body));
+  return asTextContentResult(await maybeFilter(args, await conductor.qbd.transfers.retrieve(id, body)));
 };
 
 export default { metadata, tool, handler };

package/src/tools/qbd/transfers/update-qbd-transfers.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_transfers',
-  description: 'Updates an existing transfer.',
+  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 transfer.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/transfer',\n  $defs: {\n    transfer: {\n      type: 'object',\n      title: 'The Transfer object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The unique identifier assigned by QuickBooks to this transfer. This ID is unique across all transaction types.'\n        },\n        amount: {\n          type: 'string',\n          description: 'The monetary amount of this transfer, represented as a decimal string.'\n        },\n        class: {\n          type: 'object',\n          description: 'The transfer\\'s class. Classes can be used to categorize objects into meaningful segments, such as department, location, or type of work. In QuickBooks, class tracking is off by default.',\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        createdAt: {\n          type: 'string',\n          description: 'The date and time when this transfer 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        memo: {\n          type: 'string',\n          description: 'A memo or note for this transfer.'\n        },\n        objectType: {\n          type: 'string',\n          description: 'The type of object. This value is always `\"qbd_transfer\"`.',\n          enum: [            'qbd_transfer'\n          ]\n        },\n        revisionNumber: {\n          type: 'string',\n          description: 'The current QuickBooks-assigned revision number of this transfer 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        sourceAccount: {\n          type: 'object',\n          description: 'The account from which money will be transferred.',\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        sourceAccountBalance: {\n          type: 'string',\n          description: 'The balance of the account from which money will be transferred.'\n        },\n        targetAccount: {\n          type: 'object',\n          description: 'The account to which money will be transferred.',\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        targetAccountBalance: {\n          type: 'string',\n          description: 'The balance of the account to which money will be transferred.'\n        },\n        transactionDate: {\n          type: 'string',\n          description: 'The date of this transfer, in ISO 8601 format (YYYY-MM-DD).',\n          format: 'date'\n        },\n        updatedAt: {\n          type: 'string',\n          description: 'The date and time when this transfer 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        'amount',\n        'class',\n        'createdAt',\n        'memo',\n        'objectType',\n        'revisionNumber',\n        'sourceAccount',\n        'sourceAccountBalance',\n        'targetAccount',\n        'targetAccountBalance',\n        'transactionDate',\n        'updatedAt'\n      ]\n    }\n  }\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {
@@ -60,13 +62,19 @@ export const tool: Tool = {
         description: 'The date of this transfer, in ISO 8601 format (YYYY-MM-DD).',
         format: 'date',
       },
+      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.transfers.update(id, body));
+  return asTextContentResult(await maybeFilter(args, await conductor.qbd.transfers.update(id, body)));
 };
 
 export default { metadata, tool, handler };

package/src/tools/qbd/vendor-credits/create-qbd-vendor-credits.ts

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

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

package/src/tools/qbd/vendor-credits/list-qbd-vendor-credits.ts

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

package/src/tools/qbd/vendor-credits/retrieve-qbd-vendor-credits.ts

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

package/src/tools/qbd/vendor-credits/update-qbd-vendor-credits.ts

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

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

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

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

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

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

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

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

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

package/src/tools/types.ts

@@ -47,7 +47,7 @@ export type HandlerFunction = (
   args: Record<string, unknown> | undefined,
 ) => Promise<ToolCallResult>;
 
-export function asTextContentResult(result: Object): ToolCallResult {
+export function asTextContentResult(result: unknown): ToolCallResult {
   return {
     content: [
       {

package/tools/auth-sessions/create-auth-sessions.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"create-auth-sessions.d.mts","sourceRoot":"","sources":["../../src/tools/auth-sessions/create-auth-sessions.ts"],"names":[],"mappings":"OAIO,EAAE,IAAI,EAAE,MAAM,oCAAoC;OAClD,KAAK,EAAE,QAAQ,EAAE;OACjB,SAAS,MAAM,gBAAgB;AAEtC,eAAO,MAAM,QAAQ,EAAE,QAMtB,CAAC;AAEF,eAAO,MAAM,IAAI,EAAE,IA4BlB,CAAC;AAEF,eAAO,MAAM,OAAO,GAAU,WAAW,SAAS,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,qEAG5F,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAHuC,SAAS,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;;AAK7F,wBAA2C"}
+{"version":3,"file":"create-auth-sessions.d.mts","sourceRoot":"","sources":["../../src/tools/auth-sessions/create-auth-sessions.ts"],"names":[],"mappings":"OAKO,EAAE,IAAI,EAAE,MAAM,oCAAoC;OAClD,KAAK,EAAE,QAAQ,EAAE;OACjB,SAAS,MAAM,gBAAgB;AAEtC,eAAO,MAAM,QAAQ,EAAE,QAMtB,CAAC;AAEF,eAAO,MAAM,IAAI,EAAE,IAkClB,CAAC;AAEF,eAAO,MAAM,OAAO,GAAU,WAAW,SAAS,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,qEAG5F,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAHuC,SAAS,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;;AAK7F,wBAA2C"}

package/tools/auth-sessions/create-auth-sessions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-auth-sessions.d.ts","sourceRoot":"","sources":["../../src/tools/auth-sessions/create-auth-sessions.ts"],"names":[],"mappings":"OAIO,EAAE,IAAI,EAAE,MAAM,oCAAoC;OAClD,KAAK,EAAE,QAAQ,EAAE;OACjB,SAAS,MAAM,gBAAgB;AAEtC,eAAO,MAAM,QAAQ,EAAE,QAMtB,CAAC;AAEF,eAAO,MAAM,IAAI,EAAE,IA4BlB,CAAC;AAEF,eAAO,MAAM,OAAO,GAAU,WAAW,SAAS,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,qEAG5F,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAHuC,SAAS,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;;AAK7F,wBAA2C"}
+{"version":3,"file":"create-auth-sessions.d.ts","sourceRoot":"","sources":["../../src/tools/auth-sessions/create-auth-sessions.ts"],"names":[],"mappings":"OAKO,EAAE,IAAI,EAAE,MAAM,oCAAoC;OAClD,KAAK,EAAE,QAAQ,EAAE;OACjB,SAAS,MAAM,gBAAgB;AAEtC,eAAO,MAAM,QAAQ,EAAE,QAMtB,CAAC;AAEF,eAAO,MAAM,IAAI,EAAE,IAkClB,CAAC;AAEF,eAAO,MAAM,OAAO,GAAU,WAAW,SAAS,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,qEAG5F,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAHuC,SAAS,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;;AAK7F,wBAA2C"}

package/tools/auth-sessions/create-auth-sessions.js

@@ -2,6 +2,7 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.handler = exports.tool = exports.metadata = void 0;
+const filtering_1 = require("conductor-node-mcp/filtering");
 const types_1 = require("conductor-node-mcp/tools/types");
 exports.metadata = {
     resource: 'auth_sessions',
@@ -12,7 +13,7 @@ exports.metadata = {
 };
 exports.tool = {
     name: 'create_auth_sessions',
-    description: "To launch the authentication flow, create an auth session and pass the returned session's `authFlowUrl` to the client for your end-user to visit in their browser. Demo: https://connect.conductor.is/qbd/demo",
+    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\nTo launch the authentication flow, create an auth session and pass the returned session's `authFlowUrl` to the client for your end-user to visit in their browser. Demo: https://connect.conductor.is/qbd/demo\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/auth_session',\n  $defs: {\n    auth_session: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The unique identifier for this auth session.'\n        },\n        authFlowUrl: {\n          type: 'string',\n          description: 'The URL of the authentication flow that you will pass to your client for your user to set up their integration connection.'\n        },\n        clientSecret: {\n          type: 'string',\n          description: 'The secret used in `authFlowUrl` to securely access the authentication flow.'\n        },\n        createdAt: {\n          type: 'string',\n          description: 'The date and time when this auth session record was created.'\n        },\n        endUserId: {\n          type: 'string',\n          description: 'The ID of the end-user for whom to create an integration connection.'\n        },\n        expiresAt: {\n          type: 'string',\n          description: 'The date and time when this auth session expires. By default, this value is 30 minutes from creation. You can extend this time by setting `linkExpiryMins` when creating the auth session.'\n        },\n        objectType: {\n          type: 'string',\n          description: 'The type of object. This value is always `\"auth_session\"`.',\n          enum: [            'auth_session'\n          ]\n        },\n        redirectUrl: {\n          type: 'string',\n          description: 'The URL to which Conductor will redirect your user to return to your app after they complete the authentication flow. If `null`, their browser tab will close instead.'\n        }\n      },\n      required: [        'id',\n        'authFlowUrl',\n        'clientSecret',\n        'createdAt',\n        'endUserId',\n        'expiresAt',\n        'objectType',\n        'redirectUrl'\n      ]\n    }\n  }\n}\n```",
     inputSchema: {
         type: 'object',
         properties: {
@@ -32,12 +33,17 @@ exports.tool = {
                 type: 'string',
                 description: 'The URL to which Conductor will redirect the end-user to return to your app after they complete the authentication flow. If not provided, their browser tab will close instead.',
             },
+            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/).',
+            },
         },
     },
 };
 const handler = async (conductor, args) => {
     const body = args;
-    return (0, types_1.asTextContentResult)(await conductor.authSessions.create(body));
+    return (0, types_1.asTextContentResult)(await (0, filtering_1.maybeFilter)(args, await conductor.authSessions.create(body)));
 };
 exports.handler = handler;
 exports.default = { metadata: exports.metadata, tool: exports.tool, handler: exports.handler };