conductor-node-mcp 12.37.0 → 12.38.0

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

@@ -17,7 +17,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'delete_qbd_inventory_adjustments',
   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\nPermanently deletes a an inventory adjustment. The deletion will fail if the inventory adjustment is currently in use or has any linked transactions that are in use.\n\n# Response Schema\n```json\n{\n  type: 'object',\n  properties: {\n    id: {\n      type: 'string',\n      description: 'The QuickBooks-assigned unique identifier of the deleted inventory adjustment.'\n    },\n    deleted: {\n      type: 'boolean',\n      description: 'Indicates whether the inventory adjustment was deleted.'\n    },\n    objectType: {\n      type: 'string',\n      description: 'The type of object. This value is always `\"qbd_inventory_adjustment\"`.',\n      enum: [        'qbd_inventory_adjustment'\n      ]\n    },\n    refNumber: {\n      type: 'string',\n      description: 'The case-sensitive user-defined reference number of the deleted inventory adjustment.'\n    }\n  },\n  required: [    'id',\n    'deleted',\n    'objectType',\n    'refNumber'\n  ]\n}\n```",
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nPermanently deletes a an inventory adjustment. The deletion will fail if the inventory adjustment is currently in use or has any linked transactions that are in use.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/inventory_adjustment_delete_response',\n  $defs: {\n    inventory_adjustment_delete_response: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The QuickBooks-assigned unique identifier of the deleted inventory adjustment.'\n        },\n        deleted: {\n          type: 'boolean',\n          description: 'Indicates whether the inventory adjustment was deleted.'\n        },\n        objectType: {\n          type: 'string',\n          description: 'The type of object. This value is always `\"qbd_inventory_adjustment\"`.',\n          enum: [            'qbd_inventory_adjustment'\n          ]\n        },\n        refNumber: {\n          type: 'string',\n          description: 'The case-sensitive user-defined reference number of the deleted inventory adjustment.'\n        }\n      },\n      required: [        'id',\n        'deleted',\n        'objectType',\n        'refNumber'\n      ]\n    }\n  }\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {

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

@@ -15,7 +15,8 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'retrieve_qbd_inventory_adjustments',
-  description: 'Retrieves an inventory adjustment by ID.',
+  description:
+    'Retrieves an inventory adjustment by ID.\n\n**IMPORTANT:** If you need to fetch multiple specific inventory adjustments by ID, use the list endpoint instead with the `ids` parameter. It accepts an array of IDs so you can batch the request into a single call, which is significantly faster.',
   inputSchema: {
     type: 'object',
     properties: {

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

@@ -15,7 +15,8 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'retrieve_qbd_inventory_assembly_items',
-  description: 'Retrieves an inventory assembly item by ID.',
+  description:
+    'Retrieves an inventory assembly item by ID.\n\n**IMPORTANT:** If you need to fetch multiple specific inventory assembly items by ID, use the list endpoint instead with the `ids` parameter. It accepts an array of IDs so you can batch the request into a single call, which is significantly faster.',
   inputSchema: {
     type: 'object',
     properties: {

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

@@ -15,7 +15,8 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'retrieve_qbd_inventory_items',
-  description: 'Retrieves an inventory item by ID.',
+  description:
+    'Retrieves an inventory item by ID.\n\n**IMPORTANT:** If you need to fetch multiple specific inventory items by ID, use the list endpoint instead with the `ids` parameter. It accepts an array of IDs so you can batch the request into a single call, which is significantly faster.',
   inputSchema: {
     type: 'object',
     properties: {

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

@@ -17,7 +17,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'retrieve_qbd_inventory_sites',
   description:
-    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nRetrieves an inventory site by ID.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/inventory_site',\n  $defs: {\n    inventory_site: {\n      type: 'object',\n      title: 'The Inventory Site object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The unique identifier assigned by QuickBooks to this inventory site. This ID is unique across all inventory sites but not across different QuickBooks object types.'\n        },\n        address: {\n          type: 'object',\n          title: 'The Site Address object',\n          description: 'The inventory site\\'s address.',\n          properties: {\n            city: {\n              type: 'string',\n              description: 'The city, district, suburb, town, or village name of the site address.'\n            },\n            country: {\n              type: 'string',\n              description: 'The country name of the site address.'\n            },\n            line1: {\n              type: 'string',\n              description: 'The first line of the site address (e.g., street, PO Box, or company name).'\n            },\n            line2: {\n              type: 'string',\n              description: 'The second line of the site address, if needed (e.g., apartment, suite, unit, or building).'\n            },\n            line3: {\n              type: 'string',\n              description: 'The third line of the site address, if needed.'\n            },\n            line4: {\n              type: 'string',\n              description: 'The fourth line of the site address, if needed.'\n            },\n            line5: {\n              type: 'string',\n              description: 'The fifth line of the site address, if needed.'\n            },\n            postalCode: {\n              type: 'string',\n              description: 'The postal code or ZIP code of the site address.'\n            },\n            state: {\n              type: 'string',\n              description: 'The state, county, province, or region name of the site address.'\n            }\n          },\n          required: [            'city',\n            'country',\n            'line1',\n            'line2',\n            'line3',\n            'line4',\n            'line5',\n            'postalCode',\n            'state'\n          ]\n        },\n        contact: {\n          type: 'string',\n          description: 'The name of the primary contact person for this inventory site.'\n        },\n        createdAt: {\n          type: 'string',\n          description: 'The date and time when this inventory site was created, in ISO 8601 format (YYYY-MM-DDThh:mm:ss±hh:mm), which QuickBooks Desktop interprets in the local timezone of the end-user\\'s computer.'\n        },\n        description: {\n          type: 'string',\n          description: 'A description of this inventory site.'\n        },\n        email: {\n          type: 'string',\n          description: 'The inventory site\\'s email address.'\n        },\n        fax: {\n          type: 'string',\n          description: 'The inventory site\\'s fax number.'\n        },\n        isActive: {\n          type: 'boolean',\n          description: 'Indicates whether this inventory site is active. Inactive objects are typically hidden from views and reports in QuickBooks. Defaults to `true`.'\n        },\n        isDefault: {\n          type: 'boolean',\n          description: 'Indicates whether this inventory site is the default site used when no specific site is provided during the creation of other objects.'\n        },\n        name: {\n          type: 'string',\n          description: 'The case-insensitive unique name of this inventory site, unique across all inventory sites.\\n\\n**NOTE**: Inventory sites do not have a `fullName` field because they are not hierarchical objects, which is why `name` is unique for them but not for objects that have parents.'\n        },\n        objectType: {\n          type: 'string',\n          description: 'The type of object. This value is always `\"qbd_inventory_site\"`.',\n          enum: [            'qbd_inventory_site'\n          ]\n        },\n        parent: {\n          type: 'object',\n          description: 'The parent inventory site one level above this one in the hierarchy.',\n          properties: {\n            id: {\n              type: 'string',\n              description: 'The unique identifier assigned by QuickBooks to this object. This ID is unique across all objects of the same type, but not across different QuickBooks object types.'\n            },\n            fullName: {\n              type: 'string',\n              description: 'The fully-qualified unique name for this object, formed by combining the names of its parent objects with its own `name`, separated by colons. Not case-sensitive.'\n            }\n          },\n          required: [            'id',\n            'fullName'\n          ]\n        },\n        phone: {\n          type: 'string',\n          description: 'The inventory site\\'s primary telephone number.'\n        },\n        revisionNumber: {\n          type: 'string',\n          description: 'The current QuickBooks-assigned revision number of this inventory site object, which changes each time the object is modified. When updating this object, you must provide the most recent `revisionNumber` to ensure you\\'re working with the latest data; otherwise, the update will return an error.'\n        },\n        updatedAt: {\n          type: 'string',\n          description: 'The date and time when this inventory site was last updated, in ISO 8601 format (YYYY-MM-DDThh:mm:ss±hh:mm), which QuickBooks Desktop interprets in the local timezone of the end-user\\'s computer.'\n        }\n      },\n      required: [        'id',\n        'address',\n        'contact',\n        'createdAt',\n        'description',\n        'email',\n        'fax',\n        'isActive',\n        'isDefault',\n        'name',\n        'objectType',\n        'parent',\n        'phone',\n        'revisionNumber',\n        'updatedAt'\n      ]\n    }\n  }\n}\n```",
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nRetrieves an inventory site by ID.\n\n**IMPORTANT:** If you need to fetch multiple specific inventory sites by ID, use the list endpoint instead with the `ids` parameter. It accepts an array of IDs so you can batch the request into a single call, which is significantly faster.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/inventory_site',\n  $defs: {\n    inventory_site: {\n      type: 'object',\n      title: 'The Inventory Site object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The unique identifier assigned by QuickBooks to this inventory site. This ID is unique across all inventory sites but not across different QuickBooks object types.'\n        },\n        address: {\n          type: 'object',\n          title: 'The Site Address object',\n          description: 'The inventory site\\'s address.',\n          properties: {\n            city: {\n              type: 'string',\n              description: 'The city, district, suburb, town, or village name of the site address.'\n            },\n            country: {\n              type: 'string',\n              description: 'The country name of the site address.'\n            },\n            line1: {\n              type: 'string',\n              description: 'The first line of the site address (e.g., street, PO Box, or company name).'\n            },\n            line2: {\n              type: 'string',\n              description: 'The second line of the site address, if needed (e.g., apartment, suite, unit, or building).'\n            },\n            line3: {\n              type: 'string',\n              description: 'The third line of the site address, if needed.'\n            },\n            line4: {\n              type: 'string',\n              description: 'The fourth line of the site address, if needed.'\n            },\n            line5: {\n              type: 'string',\n              description: 'The fifth line of the site address, if needed.'\n            },\n            postalCode: {\n              type: 'string',\n              description: 'The postal code or ZIP code of the site address.'\n            },\n            state: {\n              type: 'string',\n              description: 'The state, county, province, or region name of the site address.'\n            }\n          },\n          required: [            'city',\n            'country',\n            'line1',\n            'line2',\n            'line3',\n            'line4',\n            'line5',\n            'postalCode',\n            'state'\n          ]\n        },\n        contact: {\n          type: 'string',\n          description: 'The name of the primary contact person for this inventory site.'\n        },\n        createdAt: {\n          type: 'string',\n          description: 'The date and time when this inventory site was created, in ISO 8601 format (YYYY-MM-DDThh:mm:ss±hh:mm), which QuickBooks Desktop interprets in the local timezone of the end-user\\'s computer.'\n        },\n        description: {\n          type: 'string',\n          description: 'A description of this inventory site.'\n        },\n        email: {\n          type: 'string',\n          description: 'The inventory site\\'s email address.'\n        },\n        fax: {\n          type: 'string',\n          description: 'The inventory site\\'s fax number.'\n        },\n        isActive: {\n          type: 'boolean',\n          description: 'Indicates whether this inventory site is active. Inactive objects are typically hidden from views and reports in QuickBooks. Defaults to `true`.'\n        },\n        isDefault: {\n          type: 'boolean',\n          description: 'Indicates whether this inventory site is the default site used when no specific site is provided during the creation of other objects.'\n        },\n        name: {\n          type: 'string',\n          description: 'The case-insensitive unique name of this inventory site, unique across all inventory sites.\\n\\n**NOTE**: Inventory sites do not have a `fullName` field because they are not hierarchical objects, which is why `name` is unique for them but not for objects that have parents.'\n        },\n        objectType: {\n          type: 'string',\n          description: 'The type of object. This value is always `\"qbd_inventory_site\"`.',\n          enum: [            'qbd_inventory_site'\n          ]\n        },\n        parent: {\n          type: 'object',\n          description: 'The parent inventory site one level above this one in the hierarchy.',\n          properties: {\n            id: {\n              type: 'string',\n              description: 'The unique identifier assigned by QuickBooks to this object. This ID is unique across all objects of the same type, but not across different QuickBooks object types.'\n            },\n            fullName: {\n              type: 'string',\n              description: 'The fully-qualified unique name for this object, formed by combining the names of its parent objects with its own `name`, separated by colons. Not case-sensitive.'\n            }\n          },\n          required: [            'id',\n            'fullName'\n          ]\n        },\n        phone: {\n          type: 'string',\n          description: 'The inventory site\\'s primary telephone number.'\n        },\n        revisionNumber: {\n          type: 'string',\n          description: 'The current QuickBooks-assigned revision number of this inventory site object, which changes each time the object is modified. When updating this object, you must provide the most recent `revisionNumber` to ensure you\\'re working with the latest data; otherwise, the update will return an error.'\n        },\n        updatedAt: {\n          type: 'string',\n          description: 'The date and time when this inventory site was last updated, in ISO 8601 format (YYYY-MM-DDThh:mm:ss±hh:mm), which QuickBooks Desktop interprets in the local timezone of the end-user\\'s computer.'\n        }\n      },\n      required: [        'id',\n        'address',\n        'contact',\n        'createdAt',\n        'description',\n        'email',\n        'fax',\n        'isActive',\n        'isDefault',\n        'name',\n        'objectType',\n        'parent',\n        'phone',\n        'revisionNumber',\n        'updatedAt'\n      ]\n    }\n  }\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {

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

@@ -388,7 +388,7 @@ export const tool: Tool = {
       purchaseOrderNumber: {
         type: 'string',
         description:
-          "The customer's Purchase Order (PO) number associated with this invoice. This field is often used to cross-reference the invoice with the customer's purchasing system.",
+          "The customer's Purchase Order (PO) number associated with this invoice. This field is often used to cross-reference the invoice with the customer's purchasing system.\n\nMaximum length: 25 characters.",
       },
       receivablesAccountId: {
         type: 'string',

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

@@ -17,7 +17,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'delete_qbd_invoices',
   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\nPermanently deletes a an invoice. The deletion will fail if the invoice is currently in use or has any linked transactions that are in use.\n\n# Response Schema\n```json\n{\n  type: 'object',\n  properties: {\n    id: {\n      type: 'string',\n      description: 'The QuickBooks-assigned unique identifier of the deleted invoice.'\n    },\n    deleted: {\n      type: 'boolean',\n      description: 'Indicates whether the invoice was deleted.'\n    },\n    objectType: {\n      type: 'string',\n      description: 'The type of object. This value is always `\"qbd_invoice\"`.',\n      enum: [        'qbd_invoice'\n      ]\n    },\n    refNumber: {\n      type: 'string',\n      description: 'The case-sensitive user-defined reference number of the deleted invoice.'\n    }\n  },\n  required: [    'id',\n    'deleted',\n    'objectType',\n    'refNumber'\n  ]\n}\n```",
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nPermanently deletes a an invoice. The deletion will fail if the invoice is currently in use or has any linked transactions that are in use.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/invoice_delete_response',\n  $defs: {\n    invoice_delete_response: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The QuickBooks-assigned unique identifier of the deleted invoice.'\n        },\n        deleted: {\n          type: 'boolean',\n          description: 'Indicates whether the invoice was deleted.'\n        },\n        objectType: {\n          type: 'string',\n          description: 'The type of object. This value is always `\"qbd_invoice\"`.',\n          enum: [            'qbd_invoice'\n          ]\n        },\n        refNumber: {\n          type: 'string',\n          description: 'The case-sensitive user-defined reference number of the deleted invoice.'\n        }\n      },\n      required: [        'id',\n        'deleted',\n        'objectType',\n        'refNumber'\n      ]\n    }\n  }\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {

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

@@ -16,7 +16,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'retrieve_qbd_invoices',
   description:
-    'Retrieves an invoice by ID.\n\nNOTE: The response automatically includes any linked transactions.',
+    'Retrieves an invoice by ID.\n\n**IMPORTANT:** If you need to fetch multiple specific invoices by ID, use the list endpoint instead with the `ids` parameter. It accepts an array of IDs so you can batch the request into a single call, which is significantly faster.\n\nNOTE: The response automatically includes any linked transactions.',
   inputSchema: {
     type: 'object',
     properties: {

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

@@ -434,7 +434,7 @@ export const tool: Tool = {
       purchaseOrderNumber: {
         type: 'string',
         description:
-          "The customer's Purchase Order (PO) number associated with this invoice. This field is often used to cross-reference the invoice with the customer's purchasing system.",
+          "The customer's Purchase Order (PO) number associated with this invoice. This field is often used to cross-reference the invoice with the customer's purchasing system.\n\nMaximum length: 25 characters.",
       },
       receivablesAccountId: {
         type: 'string',

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

@@ -17,7 +17,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'retrieve_qbd_item_groups',
   description:
-    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nRetrieves an item group by ID.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/item_group',\n  $defs: {\n    item_group: {\n      type: 'object',\n      title: 'The Item Group object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The unique identifier assigned by QuickBooks to this item group. This ID is unique across all item groups but not across different QuickBooks object types.'\n        },\n        barcode: {\n          type: 'string',\n          description: 'The item group\\'s barcode.'\n        },\n        createdAt: {\n          type: 'string',\n          description: 'The date and time when this item group was created, in ISO 8601 format (YYYY-MM-DDThh:mm:ss±hh:mm), which QuickBooks Desktop interprets in the local timezone of the end-user\\'s computer.'\n        },\n        customFields: {\n          type: 'array',\n          description: 'The custom fields for the item group object, added as user-defined data extensions, not included in the standard QuickBooks object.',\n          items: {\n            type: 'object',\n            title: 'The Custom Field object',\n            properties: {\n              name: {\n                type: 'string',\n                description: 'The name of the custom field, unique for the specified `ownerId`. For public custom fields, this name is visible as a label in the QuickBooks UI.'\n              },\n              ownerId: {\n                type: 'string',\n                description: 'The identifier of the owner of the custom field, which QuickBooks internally calls a \"data extension\". For public custom fields visible in the UI, such as those added by the QuickBooks user, this is always \"0\". For private custom fields that are only visible to the application that created them, this is a valid GUID identifying the owning application. Internally, Conductor always fetches all public custom fields (those with an `ownerId` of \"0\") for all objects.'\n              },\n              type: {\n                type: 'string',\n                description: 'The data type of this custom field.',\n                enum: [                  'amount_type',\n                  'date_time_type',\n                  'integer_type',\n                  'percent_type',\n                  'price_type',\n                  'quantity_type',\n                  'string_1024_type',\n                  'string_255_type'\n                ]\n              },\n              value: {\n                type: 'string',\n                description: 'The value of this custom field. The maximum length depends on the field\\'s data type.'\n              }\n            },\n            required: [              'name',\n              'ownerId',\n              'type',\n              'value'\n            ]\n          }\n        },\n        description: {\n          type: 'string',\n          description: 'The item group\\'s description that will appear on sales forms that include this item.'\n        },\n        externalId: {\n          type: 'string',\n          description: 'A globally unique identifier (GUID) you, the developer, can provide for tracking this object in your external system. This field is immutable and can only be set during object creation.'\n        },\n        isActive: {\n          type: 'boolean',\n          description: 'Indicates whether this item group is active. Inactive objects are typically hidden from views and reports in QuickBooks. Defaults to `true`.'\n        },\n        lines: {\n          type: 'array',\n          description: 'The item lines in this item group.',\n          items: {\n            type: 'object',\n            title: 'The Item Group Line object',\n            properties: {\n              item: {\n                type: 'object',\n                description: 'The item associated with this item group line. This can refer to any good or service that the business buys or sells, including item types such as a service item, inventory item, or special calculation item like a discount item or sales-tax item.',\n                properties: {\n                  id: {\n                    type: 'string',\n                    description: 'The unique identifier assigned by QuickBooks to this object. This ID is unique across all objects of the same type, but not across different QuickBooks object types.'\n                  },\n                  fullName: {\n                    type: 'string',\n                    description: 'The fully-qualified unique name for this object, formed by combining the names of its parent objects with its own `name`, separated by colons. Not case-sensitive.'\n                  }\n                },\n                required: [                  'id',\n                  'fullName'\n                ]\n              },\n              quantity: {\n                type: 'number',\n                description: 'The quantity of the item group associated with this item group line. This field cannot be cleared.\\n\\n**NOTE**: Do not use this field if the associated item group is a discount item group.'\n              },\n              unitOfMeasure: {\n                type: 'string',\n                description: 'The unit-of-measure used for the `quantity` in this item group line. Must be a valid unit within the item\\'s available units of measure.'\n              }\n            },\n            required: [              'item',\n              'quantity',\n              'unitOfMeasure'\n            ]\n          }\n        },\n        name: {\n          type: 'string',\n          description: 'The case-insensitive unique name of this item group, unique across all item groups.\\n\\n**NOTE**: Item groups do not have a `fullName` field because they are not hierarchical objects, which is why `name` is unique for them but not for objects that have parents.'\n        },\n        objectType: {\n          type: 'string',\n          description: 'The type of object. This value is always `\"qbd_item_group\"`.',\n          enum: [            'qbd_item_group'\n          ]\n        },\n        revisionNumber: {\n          type: 'string',\n          description: 'The current QuickBooks-assigned revision number of this item group object, which changes each time the object is modified. When updating this object, you must provide the most recent `revisionNumber` to ensure you\\'re working with the latest data; otherwise, the update will return an error.'\n        },\n        shouldPrintItemsInGroup: {\n          type: 'boolean',\n          description: 'Indicates whether the individual items in this item group and their separate amounts appear on printed forms.'\n        },\n        specialItemType: {\n          type: 'string',\n          description: 'The type of special item for this item group.',\n          enum: [            'finance_charge',\n            'reimbursable_expense_group',\n            'reimbursable_expense_subtotal'\n          ]\n        },\n        unitOfMeasureSet: {\n          type: 'object',\n          description: 'The unit-of-measure set associated with this item group, which consists of a base unit and related units.',\n          properties: {\n            id: {\n              type: 'string',\n              description: 'The unique identifier assigned by QuickBooks to this object. This ID is unique across all objects of the same type, but not across different QuickBooks object types.'\n            },\n            fullName: {\n              type: 'string',\n              description: 'The fully-qualified unique name for this object, formed by combining the names of its parent objects with its own `name`, separated by colons. Not case-sensitive.'\n            }\n          },\n          required: [            'id',\n            'fullName'\n          ]\n        },\n        updatedAt: {\n          type: 'string',\n          description: 'The date and time when this item group was last updated, in ISO 8601 format (YYYY-MM-DDThh:mm:ss±hh:mm), which QuickBooks Desktop interprets in the local timezone of the end-user\\'s computer.'\n        }\n      },\n      required: [        'id',\n        'barcode',\n        'createdAt',\n        'customFields',\n        'description',\n        'externalId',\n        'isActive',\n        'lines',\n        'name',\n        'objectType',\n        'revisionNumber',\n        'shouldPrintItemsInGroup',\n        'specialItemType',\n        'unitOfMeasureSet',\n        'updatedAt'\n      ]\n    }\n  }\n}\n```",
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nRetrieves an item group by ID.\n\n**IMPORTANT:** If you need to fetch multiple specific item groups by ID, use the list endpoint instead with the `ids` parameter. It accepts an array of IDs so you can batch the request into a single call, which is significantly faster.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/item_group',\n  $defs: {\n    item_group: {\n      type: 'object',\n      title: 'The Item Group object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The unique identifier assigned by QuickBooks to this item group. This ID is unique across all item groups but not across different QuickBooks object types.'\n        },\n        barcode: {\n          type: 'string',\n          description: 'The item group\\'s barcode.'\n        },\n        createdAt: {\n          type: 'string',\n          description: 'The date and time when this item group was created, in ISO 8601 format (YYYY-MM-DDThh:mm:ss±hh:mm), which QuickBooks Desktop interprets in the local timezone of the end-user\\'s computer.'\n        },\n        customFields: {\n          type: 'array',\n          description: 'The custom fields for the item group object, added as user-defined data extensions, not included in the standard QuickBooks object.',\n          items: {\n            type: 'object',\n            title: 'The Custom Field object',\n            properties: {\n              name: {\n                type: 'string',\n                description: 'The name of the custom field, unique for the specified `ownerId`. For public custom fields, this name is visible as a label in the QuickBooks UI.'\n              },\n              ownerId: {\n                type: 'string',\n                description: 'The identifier of the owner of the custom field, which QuickBooks internally calls a \"data extension\". For public custom fields visible in the UI, such as those added by the QuickBooks user, this is always \"0\". For private custom fields that are only visible to the application that created them, this is a valid GUID identifying the owning application. Internally, Conductor always fetches all public custom fields (those with an `ownerId` of \"0\") for all objects.'\n              },\n              type: {\n                type: 'string',\n                description: 'The data type of this custom field.',\n                enum: [                  'amount_type',\n                  'date_time_type',\n                  'integer_type',\n                  'percent_type',\n                  'price_type',\n                  'quantity_type',\n                  'string_1024_type',\n                  'string_255_type'\n                ]\n              },\n              value: {\n                type: 'string',\n                description: 'The value of this custom field. The maximum length depends on the field\\'s data type.'\n              }\n            },\n            required: [              'name',\n              'ownerId',\n              'type',\n              'value'\n            ]\n          }\n        },\n        description: {\n          type: 'string',\n          description: 'The item group\\'s description that will appear on sales forms that include this item.'\n        },\n        externalId: {\n          type: 'string',\n          description: 'A globally unique identifier (GUID) you, the developer, can provide for tracking this object in your external system. This field is immutable and can only be set during object creation.'\n        },\n        isActive: {\n          type: 'boolean',\n          description: 'Indicates whether this item group is active. Inactive objects are typically hidden from views and reports in QuickBooks. Defaults to `true`.'\n        },\n        lines: {\n          type: 'array',\n          description: 'The item lines in this item group.',\n          items: {\n            type: 'object',\n            title: 'The Item Group Line object',\n            properties: {\n              item: {\n                type: 'object',\n                description: 'The item associated with this item group line. This can refer to any good or service that the business buys or sells, including item types such as a service item, inventory item, or special calculation item like a discount item or sales-tax item.',\n                properties: {\n                  id: {\n                    type: 'string',\n                    description: 'The unique identifier assigned by QuickBooks to this object. This ID is unique across all objects of the same type, but not across different QuickBooks object types.'\n                  },\n                  fullName: {\n                    type: 'string',\n                    description: 'The fully-qualified unique name for this object, formed by combining the names of its parent objects with its own `name`, separated by colons. Not case-sensitive.'\n                  }\n                },\n                required: [                  'id',\n                  'fullName'\n                ]\n              },\n              quantity: {\n                type: 'number',\n                description: 'The quantity of the item group associated with this item group line. This field cannot be cleared.\\n\\n**NOTE**: Do not use this field if the associated item group is a discount item group.'\n              },\n              unitOfMeasure: {\n                type: 'string',\n                description: 'The unit-of-measure used for the `quantity` in this item group line. Must be a valid unit within the item\\'s available units of measure.'\n              }\n            },\n            required: [              'item',\n              'quantity',\n              'unitOfMeasure'\n            ]\n          }\n        },\n        name: {\n          type: 'string',\n          description: 'The case-insensitive unique name of this item group, unique across all item groups.\\n\\n**NOTE**: Item groups do not have a `fullName` field because they are not hierarchical objects, which is why `name` is unique for them but not for objects that have parents.'\n        },\n        objectType: {\n          type: 'string',\n          description: 'The type of object. This value is always `\"qbd_item_group\"`.',\n          enum: [            'qbd_item_group'\n          ]\n        },\n        revisionNumber: {\n          type: 'string',\n          description: 'The current QuickBooks-assigned revision number of this item group object, which changes each time the object is modified. When updating this object, you must provide the most recent `revisionNumber` to ensure you\\'re working with the latest data; otherwise, the update will return an error.'\n        },\n        shouldPrintItemsInGroup: {\n          type: 'boolean',\n          description: 'Indicates whether the individual items in this item group and their separate amounts appear on printed forms.'\n        },\n        specialItemType: {\n          type: 'string',\n          description: 'The type of special item for this item group.',\n          enum: [            'finance_charge',\n            'reimbursable_expense_group',\n            'reimbursable_expense_subtotal'\n          ]\n        },\n        unitOfMeasureSet: {\n          type: 'object',\n          description: 'The unit-of-measure set associated with this item group, which consists of a base unit and related units.',\n          properties: {\n            id: {\n              type: 'string',\n              description: 'The unique identifier assigned by QuickBooks to this object. This ID is unique across all objects of the same type, but not across different QuickBooks object types.'\n            },\n            fullName: {\n              type: 'string',\n              description: 'The fully-qualified unique name for this object, formed by combining the names of its parent objects with its own `name`, separated by colons. Not case-sensitive.'\n            }\n          },\n          required: [            'id',\n            'fullName'\n          ]\n        },\n        updatedAt: {\n          type: 'string',\n          description: 'The date and time when this item group was last updated, in ISO 8601 format (YYYY-MM-DDThh:mm:ss±hh:mm), which QuickBooks Desktop interprets in the local timezone of the end-user\\'s computer.'\n        }\n      },\n      required: [        'id',\n        'barcode',\n        'createdAt',\n        'customFields',\n        'description',\n        'externalId',\n        'isActive',\n        'lines',\n        'name',\n        'objectType',\n        'revisionNumber',\n        'shouldPrintItemsInGroup',\n        'specialItemType',\n        'unitOfMeasureSet',\n        'updatedAt'\n      ]\n    }\n  }\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {

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

@@ -17,7 +17,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'delete_qbd_item_receipts',
   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\nPermanently deletes a an item receipt. The deletion will fail if the item receipt is currently in use or has any linked transactions that are in use.\n\n# Response Schema\n```json\n{\n  type: 'object',\n  properties: {\n    id: {\n      type: 'string',\n      description: 'The QuickBooks-assigned unique identifier of the deleted item receipt.'\n    },\n    deleted: {\n      type: 'boolean',\n      description: 'Indicates whether the item receipt was deleted.'\n    },\n    objectType: {\n      type: 'string',\n      description: 'The type of object. This value is always `\"qbd_item_receipt\"`.',\n      enum: [        'qbd_item_receipt'\n      ]\n    },\n    refNumber: {\n      type: 'string',\n      description: 'The case-sensitive user-defined reference number of the deleted item receipt.'\n    }\n  },\n  required: [    'id',\n    'deleted',\n    'objectType',\n    'refNumber'\n  ]\n}\n```",
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nPermanently deletes a an item receipt. The deletion will fail if the item receipt is currently in use or has any linked transactions that are in use.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/item_receipt_delete_response',\n  $defs: {\n    item_receipt_delete_response: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The QuickBooks-assigned unique identifier of the deleted item receipt.'\n        },\n        deleted: {\n          type: 'boolean',\n          description: 'Indicates whether the item receipt was deleted.'\n        },\n        objectType: {\n          type: 'string',\n          description: 'The type of object. This value is always `\"qbd_item_receipt\"`.',\n          enum: [            'qbd_item_receipt'\n          ]\n        },\n        refNumber: {\n          type: 'string',\n          description: 'The case-sensitive user-defined reference number of the deleted item receipt.'\n        }\n      },\n      required: [        'id',\n        'deleted',\n        'objectType',\n        'refNumber'\n      ]\n    }\n  }\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {

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

@@ -16,7 +16,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'retrieve_qbd_item_receipts',
   description:
-    'Retrieves an item receipt by ID.\n\nNOTE: The response automatically includes any linked transactions.',
+    'Retrieves an item receipt by ID.\n\n**IMPORTANT:** If you need to fetch multiple specific item receipts by ID, use the list endpoint instead with the `ids` parameter. It accepts an array of IDs so you can batch the request into a single call, which is significantly faster.\n\nNOTE: The response automatically includes any linked transactions.',
   inputSchema: {
     type: 'object',
     properties: {

package/src/tools/qbd/item-sites/retrieve-qbd-item-sites.ts

@@ -17,7 +17,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'retrieve_qbd_item_sites',
   description:
-    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nRetrieves an item site by ID.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/item_site',\n  $defs: {\n    item_site: {\n      type: 'object',\n      title: 'The Item Site object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The unique identifier assigned by QuickBooks to this item site. This ID is unique across all item sites but not across different QuickBooks object types.'\n        },\n        assemblyBuildPoint: {\n          type: 'number',\n          description: 'The inventory level of this item site at which a new build assembly should begin. When the combined `quantityOnHand` and `quantityOnPurchaseOrders` drops below this point, QuickBooks flags the need to build additional units.'\n        },\n        createdAt: {\n          type: 'string',\n          description: 'The date and time when this item site was created, in ISO 8601 format (YYYY-MM-DDThh:mm:ss±hh:mm), which QuickBooks Desktop interprets in the local timezone of the end-user\\'s computer.'\n        },\n        inventoryAssemblyItem: {\n          type: 'object',\n          description: 'The inventory assembly item associated with this item site. An inventory assembly item is assembled or manufactured from other inventory items, and the items and/or assemblies that make up the assembly are called components.',\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        inventoryItem: {\n          type: 'object',\n          description: 'The inventory item associated with this item site.',\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        inventorySite: {\n          type: 'object',\n          description: 'The site location where inventory for the item associated with this item site is stored.',\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        inventorySiteLocation: {\n          type: 'object',\n          description: 'The specific location (e.g., bin or shelf) within the inventory site where the item associated with this item site is stored.',\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        objectType: {\n          type: 'string',\n          description: 'The type of object. This value is always `\"qbd_item_site\"`.',\n          enum: [            'qbd_item_site'\n          ]\n        },\n        quantityOnHand: {\n          type: 'number',\n          description: 'The number of units of this item site currently in inventory.'\n        },\n        quantityOnPendingTransfers: {\n          type: 'number',\n          description: 'The number of units of this item site that are currently on pending inventory transfer transactions.'\n        },\n        quantityOnPurchaseOrders: {\n          type: 'number',\n          description: 'The number of units of this item site that are currently listed on outstanding purchase orders and have not yet been received.'\n        },\n        quantityOnSalesOrders: {\n          type: 'number',\n          description: 'The number of units of this item site that are currently listed on outstanding sales orders and have not yet been fulfilled or delivered to customers.'\n        },\n        quantityRequiredByPendingBuildTransactions: {\n          type: 'number',\n          description: 'The number of units of this item site required by pending build transactions.'\n        },\n        quantityToBeBuiltByPendingBuildTransactions: {\n          type: 'number',\n          description: 'The number of units of this item site that are scheduled to be built on pending build transactions.'\n        },\n        reorderLevel: {\n          type: 'number',\n          description: 'The inventory level at which QuickBooks prompts you to reorder this item site.'\n        },\n        revisionNumber: {\n          type: 'string',\n          description: 'The current QuickBooks-assigned revision number of this item site object, which changes each time the object is modified. When updating this object, you must provide the most recent `revisionNumber` to ensure you\\'re working with the latest data; otherwise, the update will return an error.'\n        },\n        updatedAt: {\n          type: 'string',\n          description: 'The date and time when this item site was last updated, in ISO 8601 format (YYYY-MM-DDThh:mm:ss±hh:mm), which QuickBooks Desktop interprets in the local timezone of the end-user\\'s computer.'\n        }\n      },\n      required: [        'id',\n        'assemblyBuildPoint',\n        'createdAt',\n        'inventoryAssemblyItem',\n        'inventoryItem',\n        'inventorySite',\n        'inventorySiteLocation',\n        'objectType',\n        'quantityOnHand',\n        'quantityOnPendingTransfers',\n        'quantityOnPurchaseOrders',\n        'quantityOnSalesOrders',\n        'quantityRequiredByPendingBuildTransactions',\n        'quantityToBeBuiltByPendingBuildTransactions',\n        'reorderLevel',\n        'revisionNumber',\n        'updatedAt'\n      ]\n    }\n  }\n}\n```",
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nRetrieves an item site by ID.\n\n**IMPORTANT:** If you need to fetch multiple specific item sites by ID, use the list endpoint instead with the `ids` parameter. It accepts an array of IDs so you can batch the request into a single call, which is significantly faster.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/item_site',\n  $defs: {\n    item_site: {\n      type: 'object',\n      title: 'The Item Site object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The unique identifier assigned by QuickBooks to this item site. This ID is unique across all item sites but not across different QuickBooks object types.'\n        },\n        assemblyBuildPoint: {\n          type: 'number',\n          description: 'The inventory level of this item site at which a new build assembly should begin. When the combined `quantityOnHand` and `quantityOnPurchaseOrders` drops below this point, QuickBooks flags the need to build additional units.'\n        },\n        createdAt: {\n          type: 'string',\n          description: 'The date and time when this item site was created, in ISO 8601 format (YYYY-MM-DDThh:mm:ss±hh:mm), which QuickBooks Desktop interprets in the local timezone of the end-user\\'s computer.'\n        },\n        inventoryAssemblyItem: {\n          type: 'object',\n          description: 'The inventory assembly item associated with this item site. An inventory assembly item is assembled or manufactured from other inventory items, and the items and/or assemblies that make up the assembly are called components.',\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        inventoryItem: {\n          type: 'object',\n          description: 'The inventory item associated with this item site.',\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        inventorySite: {\n          type: 'object',\n          description: 'The site location where inventory for the item associated with this item site is stored.',\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        inventorySiteLocation: {\n          type: 'object',\n          description: 'The specific location (e.g., bin or shelf) within the inventory site where the item associated with this item site is stored.',\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        objectType: {\n          type: 'string',\n          description: 'The type of object. This value is always `\"qbd_item_site\"`.',\n          enum: [            'qbd_item_site'\n          ]\n        },\n        quantityOnHand: {\n          type: 'number',\n          description: 'The number of units of this item site currently in inventory.'\n        },\n        quantityOnPendingTransfers: {\n          type: 'number',\n          description: 'The number of units of this item site that are currently on pending inventory transfer transactions.'\n        },\n        quantityOnPurchaseOrders: {\n          type: 'number',\n          description: 'The number of units of this item site that are currently listed on outstanding purchase orders and have not yet been received.'\n        },\n        quantityOnSalesOrders: {\n          type: 'number',\n          description: 'The number of units of this item site that are currently listed on outstanding sales orders and have not yet been fulfilled or delivered to customers.'\n        },\n        quantityRequiredByPendingBuildTransactions: {\n          type: 'number',\n          description: 'The number of units of this item site required by pending build transactions.'\n        },\n        quantityToBeBuiltByPendingBuildTransactions: {\n          type: 'number',\n          description: 'The number of units of this item site that are scheduled to be built on pending build transactions.'\n        },\n        reorderLevel: {\n          type: 'number',\n          description: 'The inventory level at which QuickBooks prompts you to reorder this item site.'\n        },\n        revisionNumber: {\n          type: 'string',\n          description: 'The current QuickBooks-assigned revision number of this item site object, which changes each time the object is modified. When updating this object, you must provide the most recent `revisionNumber` to ensure you\\'re working with the latest data; otherwise, the update will return an error.'\n        },\n        updatedAt: {\n          type: 'string',\n          description: 'The date and time when this item site was last updated, in ISO 8601 format (YYYY-MM-DDThh:mm:ss±hh:mm), which QuickBooks Desktop interprets in the local timezone of the end-user\\'s computer.'\n        }\n      },\n      required: [        'id',\n        'assemblyBuildPoint',\n        'createdAt',\n        'inventoryAssemblyItem',\n        'inventoryItem',\n        'inventorySite',\n        'inventorySiteLocation',\n        'objectType',\n        'quantityOnHand',\n        'quantityOnPendingTransfers',\n        'quantityOnPurchaseOrders',\n        'quantityOnSalesOrders',\n        'quantityRequiredByPendingBuildTransactions',\n        'quantityToBeBuiltByPendingBuildTransactions',\n        'reorderLevel',\n        'revisionNumber',\n        'updatedAt'\n      ]\n    }\n  }\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {

package/src/tools/qbd/journal-entries/delete-qbd-journal-entries.ts

@@ -17,7 +17,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'delete_qbd_journal_entries',
   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\nPermanently deletes a a journal entry. The deletion will fail if the journal entry 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 journal entry.'\n    },\n    deleted: {\n      type: 'boolean',\n      description: 'Indicates whether the journal entry was deleted.'\n    },\n    objectType: {\n      type: 'string',\n      description: 'The type of object. This value is always `\"qbd_journal_entry\"`.',\n      enum: [        'qbd_journal_entry'\n      ]\n    },\n    refNumber: {\n      type: 'string',\n      description: 'The case-sensitive user-defined reference number of the deleted journal entry.'\n    }\n  },\n  required: [    'id',\n    'deleted',\n    'objectType',\n    'refNumber'\n  ]\n}\n```",
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nPermanently deletes a a journal entry. The deletion will fail if the journal entry is currently in use or has any linked transactions that are in use.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/journal_entry_delete_response',\n  $defs: {\n    journal_entry_delete_response: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The QuickBooks-assigned unique identifier of the deleted journal entry.'\n        },\n        deleted: {\n          type: 'boolean',\n          description: 'Indicates whether the journal entry was deleted.'\n        },\n        objectType: {\n          type: 'string',\n          description: 'The type of object. This value is always `\"qbd_journal_entry\"`.',\n          enum: [            'qbd_journal_entry'\n          ]\n        },\n        refNumber: {\n          type: 'string',\n          description: 'The case-sensitive user-defined reference number of the deleted journal entry.'\n        }\n      },\n      required: [        'id',\n        'deleted',\n        'objectType',\n        'refNumber'\n      ]\n    }\n  }\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {

package/src/tools/qbd/journal-entries/retrieve-qbd-journal-entries.ts

@@ -15,7 +15,8 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'retrieve_qbd_journal_entries',
-  description: 'Retrieves a journal entry by ID.',
+  description:
+    'Retrieves a journal entry by ID.\n\n**IMPORTANT:** If you need to fetch multiple specific journal entries by ID, use the list endpoint instead with the `ids` parameter. It accepts an array of IDs so you can batch the request into a single call, which is significantly faster.',
   inputSchema: {
     type: 'object',
     properties: {

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

@@ -15,7 +15,8 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'retrieve_qbd_non_inventory_items',
-  description: 'Retrieves a non-inventory item by ID.',
+  description:
+    'Retrieves a non-inventory item by ID.\n\n**IMPORTANT:** If you need to fetch multiple specific non-inventory items by ID, use the list endpoint instead with the `ids` parameter. It accepts an array of IDs so you can batch the request into a single call, which is significantly faster.',
   inputSchema: {
     type: 'object',
     properties: {

package/src/tools/qbd/other-charge-items/retrieve-qbd-other-charge-items.ts

@@ -15,7 +15,8 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'retrieve_qbd_other_charge_items',
-  description: 'Retrieves an other charge item by ID.',
+  description:
+    'Retrieves an other charge item by ID.\n\n**IMPORTANT:** If you need to fetch multiple specific other charge items by ID, use the list endpoint instead with the `ids` parameter. It accepts an array of IDs so you can batch the request into a single call, which is significantly faster.',
   inputSchema: {
     type: 'object',
     properties: {

package/src/tools/qbd/other-names/retrieve-qbd-other-names.ts

@@ -17,7 +17,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'retrieve_qbd_other_names',
   description:
-    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nRetrieves an other-name by ID.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/other_name',\n  $defs: {\n    other_name: {\n      type: 'object',\n      title: 'The Other-Name object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The unique identifier assigned by QuickBooks to this other-name. This ID is unique across all other-names but not across different QuickBooks object types.'\n        },\n        accountNumber: {\n          type: 'string',\n          description: 'The other-name\\'s account number, which appears in the QuickBooks chart of accounts, reports, and graphs.\\n\\nNote that if the \"Use Account Numbers\" preference is turned off in QuickBooks, the account number may not be visible in the user interface, but it can still be set and retrieved through the API.'\n        },\n        address: {\n          type: 'object',\n          title: 'The Address object',\n          description: 'The other-name\\'s address.',\n          properties: {\n            city: {\n              type: 'string',\n              description: 'The city, district, suburb, town, or village name of the address.'\n            },\n            country: {\n              type: 'string',\n              description: 'The country name of the address.'\n            },\n            line1: {\n              type: 'string',\n              description: 'The first line of the address (e.g., street, PO Box, or company name).'\n            },\n            line2: {\n              type: 'string',\n              description: 'The second line of the address, if needed (e.g., apartment, suite, unit, or building).'\n            },\n            line3: {\n              type: 'string',\n              description: 'The third line of the address, if needed.'\n            },\n            line4: {\n              type: 'string',\n              description: 'The fourth line of the address, if needed.'\n            },\n            line5: {\n              type: 'string',\n              description: 'The fifth line of the address, if needed.'\n            },\n            note: {\n              type: 'string',\n              description: 'A note written at the bottom of the address in the form in which it appears, such as the invoice form.'\n            },\n            postalCode: {\n              type: 'string',\n              description: 'The postal code or ZIP code of the address.'\n            },\n            state: {\n              type: 'string',\n              description: 'The state, county, province, or region name of the address.'\n            }\n          },\n          required: [            'city',\n            'country',\n            'line1',\n            'line2',\n            'line3',\n            'line4',\n            'line5',\n            'note',\n            'postalCode',\n            'state'\n          ]\n        },\n        alternateContact: {\n          type: 'string',\n          description: 'The name of a alternate contact person for this other-name.'\n        },\n        alternatePhone: {\n          type: 'string',\n          description: 'The other-name\\'s alternate telephone number.'\n        },\n        companyName: {\n          type: 'string',\n          description: 'The name of the company associated with this other-name. This name is used on invoices, checks, and other forms.'\n        },\n        contact: {\n          type: 'string',\n          description: 'The name of the primary contact person for this other-name.'\n        },\n        createdAt: {\n          type: 'string',\n          description: 'The date and time when this other-name was created, in ISO 8601 format (YYYY-MM-DDThh:mm:ss±hh:mm), which QuickBooks Desktop interprets in the local timezone of the end-user\\'s computer.'\n        },\n        customFields: {\n          type: 'array',\n          description: 'The custom fields for the other-name object, added as user-defined data extensions, not included in the standard QuickBooks object.',\n          items: {\n            type: 'object',\n            title: 'The Custom Field object',\n            properties: {\n              name: {\n                type: 'string',\n                description: 'The name of the custom field, unique for the specified `ownerId`. For public custom fields, this name is visible as a label in the QuickBooks UI.'\n              },\n              ownerId: {\n                type: 'string',\n                description: 'The identifier of the owner of the custom field, which QuickBooks internally calls a \"data extension\". For public custom fields visible in the UI, such as those added by the QuickBooks user, this is always \"0\". For private custom fields that are only visible to the application that created them, this is a valid GUID identifying the owning application. Internally, Conductor always fetches all public custom fields (those with an `ownerId` of \"0\") for all objects.'\n              },\n              type: {\n                type: 'string',\n                description: 'The data type of this custom field.',\n                enum: [                  'amount_type',\n                  'date_time_type',\n                  'integer_type',\n                  'percent_type',\n                  'price_type',\n                  'quantity_type',\n                  'string_1024_type',\n                  'string_255_type'\n                ]\n              },\n              value: {\n                type: 'string',\n                description: 'The value of this custom field. The maximum length depends on the field\\'s data type.'\n              }\n            },\n            required: [              'name',\n              'ownerId',\n              'type',\n              'value'\n            ]\n          }\n        },\n        email: {\n          type: 'string',\n          description: 'The other-name\\'s email address.'\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        fax: {\n          type: 'string',\n          description: 'The other-name\\'s fax number.'\n        },\n        firstName: {\n          type: 'string',\n          description: 'The first name of the contact person for this other-name.'\n        },\n        isActive: {\n          type: 'boolean',\n          description: 'Indicates whether this other-name is active. Inactive objects are typically hidden from views and reports in QuickBooks. Defaults to `true`.'\n        },\n        lastName: {\n          type: 'string',\n          description: 'The last name of the contact person for this other-name.'\n        },\n        middleName: {\n          type: 'string',\n          description: 'The middle name of the contact person for this other-name.'\n        },\n        name: {\n          type: 'string',\n          description: 'The case-insensitive unique name of this other-name, unique across all other-names.\\n\\n**NOTE**: Other-names do not have a `fullName` field because they are not hierarchical objects, which is why `name` is unique for them but not for objects that have parents.'\n        },\n        note: {\n          type: 'string',\n          description: 'A note or comment about this other-name.'\n        },\n        objectType: {\n          type: 'string',\n          description: 'The type of object. This value is always `\"qbd_other_name\"`.',\n          enum: [            'qbd_other_name'\n          ]\n        },\n        phone: {\n          type: 'string',\n          description: 'The other-name\\'s primary telephone number.'\n        },\n        revisionNumber: {\n          type: 'string',\n          description: 'The current QuickBooks-assigned revision number of this other-name 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        salutation: {\n          type: 'string',\n          description: 'The formal salutation title that precedes the name of the contact person for this other-name, such as \"Mr.\", \"Ms.\", or \"Dr.\".'\n        },\n        updatedAt: {\n          type: 'string',\n          description: 'The date and time when this other-name was last updated, in ISO 8601 format (YYYY-MM-DDThh:mm:ss±hh:mm), which QuickBooks Desktop interprets in the local timezone of the end-user\\'s computer.'\n        }\n      },\n      required: [        'id',\n        'accountNumber',\n        'address',\n        'alternateContact',\n        'alternatePhone',\n        'companyName',\n        'contact',\n        'createdAt',\n        'customFields',\n        'email',\n        'externalId',\n        'fax',\n        'firstName',\n        'isActive',\n        'lastName',\n        'middleName',\n        'name',\n        'note',\n        'objectType',\n        'phone',\n        'revisionNumber',\n        'salutation',\n        'updatedAt'\n      ]\n    }\n  }\n}\n```",
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nRetrieves an other-name by ID.\n\n**IMPORTANT:** If you need to fetch multiple specific other-names by ID, use the list endpoint instead with the `ids` parameter. It accepts an array of IDs so you can batch the request into a single call, which is significantly faster.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/other_name',\n  $defs: {\n    other_name: {\n      type: 'object',\n      title: 'The Other-Name object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The unique identifier assigned by QuickBooks to this other-name. This ID is unique across all other-names but not across different QuickBooks object types.'\n        },\n        accountNumber: {\n          type: 'string',\n          description: 'The other-name\\'s account number, which appears in the QuickBooks chart of accounts, reports, and graphs.\\n\\nNote that if the \"Use Account Numbers\" preference is turned off in QuickBooks, the account number may not be visible in the user interface, but it can still be set and retrieved through the API.'\n        },\n        address: {\n          type: 'object',\n          title: 'The Address object',\n          description: 'The other-name\\'s address.',\n          properties: {\n            city: {\n              type: 'string',\n              description: 'The city, district, suburb, town, or village name of the address.'\n            },\n            country: {\n              type: 'string',\n              description: 'The country name of the address.'\n            },\n            line1: {\n              type: 'string',\n              description: 'The first line of the address (e.g., street, PO Box, or company name).'\n            },\n            line2: {\n              type: 'string',\n              description: 'The second line of the address, if needed (e.g., apartment, suite, unit, or building).'\n            },\n            line3: {\n              type: 'string',\n              description: 'The third line of the address, if needed.'\n            },\n            line4: {\n              type: 'string',\n              description: 'The fourth line of the address, if needed.'\n            },\n            line5: {\n              type: 'string',\n              description: 'The fifth line of the address, if needed.'\n            },\n            note: {\n              type: 'string',\n              description: 'A note written at the bottom of the address in the form in which it appears, such as the invoice form.'\n            },\n            postalCode: {\n              type: 'string',\n              description: 'The postal code or ZIP code of the address.'\n            },\n            state: {\n              type: 'string',\n              description: 'The state, county, province, or region name of the address.'\n            }\n          },\n          required: [            'city',\n            'country',\n            'line1',\n            'line2',\n            'line3',\n            'line4',\n            'line5',\n            'note',\n            'postalCode',\n            'state'\n          ]\n        },\n        alternateContact: {\n          type: 'string',\n          description: 'The name of a alternate contact person for this other-name.'\n        },\n        alternatePhone: {\n          type: 'string',\n          description: 'The other-name\\'s alternate telephone number.'\n        },\n        companyName: {\n          type: 'string',\n          description: 'The name of the company associated with this other-name. This name is used on invoices, checks, and other forms.'\n        },\n        contact: {\n          type: 'string',\n          description: 'The name of the primary contact person for this other-name.'\n        },\n        createdAt: {\n          type: 'string',\n          description: 'The date and time when this other-name was created, in ISO 8601 format (YYYY-MM-DDThh:mm:ss±hh:mm), which QuickBooks Desktop interprets in the local timezone of the end-user\\'s computer.'\n        },\n        customFields: {\n          type: 'array',\n          description: 'The custom fields for the other-name object, added as user-defined data extensions, not included in the standard QuickBooks object.',\n          items: {\n            type: 'object',\n            title: 'The Custom Field object',\n            properties: {\n              name: {\n                type: 'string',\n                description: 'The name of the custom field, unique for the specified `ownerId`. For public custom fields, this name is visible as a label in the QuickBooks UI.'\n              },\n              ownerId: {\n                type: 'string',\n                description: 'The identifier of the owner of the custom field, which QuickBooks internally calls a \"data extension\". For public custom fields visible in the UI, such as those added by the QuickBooks user, this is always \"0\". For private custom fields that are only visible to the application that created them, this is a valid GUID identifying the owning application. Internally, Conductor always fetches all public custom fields (those with an `ownerId` of \"0\") for all objects.'\n              },\n              type: {\n                type: 'string',\n                description: 'The data type of this custom field.',\n                enum: [                  'amount_type',\n                  'date_time_type',\n                  'integer_type',\n                  'percent_type',\n                  'price_type',\n                  'quantity_type',\n                  'string_1024_type',\n                  'string_255_type'\n                ]\n              },\n              value: {\n                type: 'string',\n                description: 'The value of this custom field. The maximum length depends on the field\\'s data type.'\n              }\n            },\n            required: [              'name',\n              'ownerId',\n              'type',\n              'value'\n            ]\n          }\n        },\n        email: {\n          type: 'string',\n          description: 'The other-name\\'s email address.'\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        fax: {\n          type: 'string',\n          description: 'The other-name\\'s fax number.'\n        },\n        firstName: {\n          type: 'string',\n          description: 'The first name of the contact person for this other-name.'\n        },\n        isActive: {\n          type: 'boolean',\n          description: 'Indicates whether this other-name is active. Inactive objects are typically hidden from views and reports in QuickBooks. Defaults to `true`.'\n        },\n        lastName: {\n          type: 'string',\n          description: 'The last name of the contact person for this other-name.'\n        },\n        middleName: {\n          type: 'string',\n          description: 'The middle name of the contact person for this other-name.'\n        },\n        name: {\n          type: 'string',\n          description: 'The case-insensitive unique name of this other-name, unique across all other-names.\\n\\n**NOTE**: Other-names do not have a `fullName` field because they are not hierarchical objects, which is why `name` is unique for them but not for objects that have parents.'\n        },\n        note: {\n          type: 'string',\n          description: 'A note or comment about this other-name.'\n        },\n        objectType: {\n          type: 'string',\n          description: 'The type of object. This value is always `\"qbd_other_name\"`.',\n          enum: [            'qbd_other_name'\n          ]\n        },\n        phone: {\n          type: 'string',\n          description: 'The other-name\\'s primary telephone number.'\n        },\n        revisionNumber: {\n          type: 'string',\n          description: 'The current QuickBooks-assigned revision number of this other-name 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        salutation: {\n          type: 'string',\n          description: 'The formal salutation title that precedes the name of the contact person for this other-name, such as \"Mr.\", \"Ms.\", or \"Dr.\".'\n        },\n        updatedAt: {\n          type: 'string',\n          description: 'The date and time when this other-name was last updated, in ISO 8601 format (YYYY-MM-DDThh:mm:ss±hh:mm), which QuickBooks Desktop interprets in the local timezone of the end-user\\'s computer.'\n        }\n      },\n      required: [        'id',\n        'accountNumber',\n        'address',\n        'alternateContact',\n        'alternatePhone',\n        'companyName',\n        'contact',\n        'createdAt',\n        'customFields',\n        'email',\n        'externalId',\n        'fax',\n        'firstName',\n        'isActive',\n        'lastName',\n        'middleName',\n        'name',\n        'note',\n        'objectType',\n        'phone',\n        'revisionNumber',\n        'salutation',\n        'updatedAt'\n      ]\n    }\n  }\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {

package/src/tools/qbd/payment-methods/list-qbd-payment-methods.ts

@@ -17,7 +17,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'list_qbd_payment_methods',
   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 payment methods. NOTE: QuickBooks Desktop does not support pagination for payment methods; hence, there is no `cursor` parameter. Users typically have few payment methods.\n\n# Response Schema\n```json\n{\n  type: 'object',\n  properties: {\n    data: {\n      type: 'array',\n      description: 'The array of payment methods.',\n      items: {\n        $ref: '#/$defs/payment_method'\n      }\n    },\n    objectType: {\n      type: 'string',\n      description: 'The type of object. This value is always `\"list\"`.',\n      enum: [        'list'\n      ]\n    },\n    url: {\n      type: 'string',\n      description: 'The endpoint URL where this list can be accessed.'\n    }\n  },\n  required: [    'data',\n    'objectType',\n    'url'\n  ],\n  $defs: {\n    payment_method: {\n      type: 'object',\n      title: 'The Payment Method object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The unique identifier assigned by QuickBooks to this payment method. This ID is unique across all payment methods but not across different QuickBooks object types.'\n        },\n        createdAt: {\n          type: 'string',\n          description: 'The date and time when this payment method was created, in ISO 8601 format (YYYY-MM-DDThh:mm:ss±hh:mm), which QuickBooks Desktop interprets in the local timezone of the end-user\\'s computer.'\n        },\n        isActive: {\n          type: 'boolean',\n          description: 'Indicates whether this payment method is active. Inactive objects are typically hidden from views and reports in QuickBooks. Defaults to `true`.'\n        },\n        name: {\n          type: 'string',\n          description: 'The case-insensitive unique name of this payment method, unique across all payment methods.\\n\\n**NOTE**: Payment methods do not have a `fullName` field because they are not hierarchical objects, which is why `name` is unique for them but not for objects that have parents.'\n        },\n        objectType: {\n          type: 'string',\n          description: 'The type of object. This value is always `\"qbd_payment_method\"`.',\n          enum: [            'qbd_payment_method'\n          ]\n        },\n        paymentMethodType: {\n          type: 'string',\n          description: 'This payment method\\'s type.',\n          enum: [            'american_express',\n            'cash',\n            'check',\n            'debit_card',\n            'discover',\n            'e_check',\n            'gift_card',\n            'master_card',\n            'other',\n            'other_credit_card',\n            'visa'\n          ]\n        },\n        revisionNumber: {\n          type: 'string',\n          description: 'The current QuickBooks-assigned revision number of this payment method object, which changes each time the object is modified. When updating this object, you must provide the most recent `revisionNumber` to ensure you\\'re working with the latest data; otherwise, the update will return an error.'\n        },\n        updatedAt: {\n          type: 'string',\n          description: 'The date and time when this payment method was last updated, in ISO 8601 format (YYYY-MM-DDThh:mm:ss±hh:mm), which QuickBooks Desktop interprets in the local timezone of the end-user\\'s computer.'\n        }\n      },\n      required: [        'id',\n        'createdAt',\n        'isActive',\n        'name',\n        'objectType',\n        'paymentMethodType',\n        'revisionNumber',\n        'updatedAt'\n      ]\n    }\n  }\n}\n```",
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nReturns a list of payment methods. NOTE: QuickBooks Desktop does not support pagination for payment methods; hence, there is no `cursor` parameter. Users typically have few payment methods.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/payment_method_list_response',\n  $defs: {\n    payment_method_list_response: {\n      type: 'object',\n      properties: {\n        data: {\n          type: 'array',\n          description: 'The array of payment methods.',\n          items: {\n            $ref: '#/$defs/payment_method'\n          }\n        },\n        objectType: {\n          type: 'string',\n          description: 'The type of object. This value is always `\"list\"`.',\n          enum: [            'list'\n          ]\n        },\n        url: {\n          type: 'string',\n          description: 'The endpoint URL where this list can be accessed.'\n        }\n      },\n      required: [        'data',\n        'objectType',\n        'url'\n      ]\n    },\n    payment_method: {\n      type: 'object',\n      title: 'The Payment Method object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The unique identifier assigned by QuickBooks to this payment method. This ID is unique across all payment methods but not across different QuickBooks object types.'\n        },\n        createdAt: {\n          type: 'string',\n          description: 'The date and time when this payment method was created, in ISO 8601 format (YYYY-MM-DDThh:mm:ss±hh:mm), which QuickBooks Desktop interprets in the local timezone of the end-user\\'s computer.'\n        },\n        isActive: {\n          type: 'boolean',\n          description: 'Indicates whether this payment method is active. Inactive objects are typically hidden from views and reports in QuickBooks. Defaults to `true`.'\n        },\n        name: {\n          type: 'string',\n          description: 'The case-insensitive unique name of this payment method, unique across all payment methods.\\n\\n**NOTE**: Payment methods do not have a `fullName` field because they are not hierarchical objects, which is why `name` is unique for them but not for objects that have parents.'\n        },\n        objectType: {\n          type: 'string',\n          description: 'The type of object. This value is always `\"qbd_payment_method\"`.',\n          enum: [            'qbd_payment_method'\n          ]\n        },\n        paymentMethodType: {\n          type: 'string',\n          description: 'This payment method\\'s type.',\n          enum: [            'american_express',\n            'cash',\n            'check',\n            'debit_card',\n            'discover',\n            'e_check',\n            'gift_card',\n            'master_card',\n            'other',\n            'other_credit_card',\n            'visa'\n          ]\n        },\n        revisionNumber: {\n          type: 'string',\n          description: 'The current QuickBooks-assigned revision number of this payment method object, which changes each time the object is modified. When updating this object, you must provide the most recent `revisionNumber` to ensure you\\'re working with the latest data; otherwise, the update will return an error.'\n        },\n        updatedAt: {\n          type: 'string',\n          description: 'The date and time when this payment method was last updated, in ISO 8601 format (YYYY-MM-DDThh:mm:ss±hh:mm), which QuickBooks Desktop interprets in the local timezone of the end-user\\'s computer.'\n        }\n      },\n      required: [        'id',\n        'createdAt',\n        'isActive',\n        'name',\n        'objectType',\n        'paymentMethodType',\n        'revisionNumber',\n        'updatedAt'\n      ]\n    }\n  }\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {

package/src/tools/qbd/payment-methods/retrieve-qbd-payment-methods.ts

@@ -17,7 +17,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'retrieve_qbd_payment_methods',
   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 payment method by ID.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/payment_method',\n  $defs: {\n    payment_method: {\n      type: 'object',\n      title: 'The Payment Method object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The unique identifier assigned by QuickBooks to this payment method. This ID is unique across all payment methods but not across different QuickBooks object types.'\n        },\n        createdAt: {\n          type: 'string',\n          description: 'The date and time when this payment method was created, in ISO 8601 format (YYYY-MM-DDThh:mm:ss±hh:mm), which QuickBooks Desktop interprets in the local timezone of the end-user\\'s computer.'\n        },\n        isActive: {\n          type: 'boolean',\n          description: 'Indicates whether this payment method is active. Inactive objects are typically hidden from views and reports in QuickBooks. Defaults to `true`.'\n        },\n        name: {\n          type: 'string',\n          description: 'The case-insensitive unique name of this payment method, unique across all payment methods.\\n\\n**NOTE**: Payment methods do not have a `fullName` field because they are not hierarchical objects, which is why `name` is unique for them but not for objects that have parents.'\n        },\n        objectType: {\n          type: 'string',\n          description: 'The type of object. This value is always `\"qbd_payment_method\"`.',\n          enum: [            'qbd_payment_method'\n          ]\n        },\n        paymentMethodType: {\n          type: 'string',\n          description: 'This payment method\\'s type.',\n          enum: [            'american_express',\n            'cash',\n            'check',\n            'debit_card',\n            'discover',\n            'e_check',\n            'gift_card',\n            'master_card',\n            'other',\n            'other_credit_card',\n            'visa'\n          ]\n        },\n        revisionNumber: {\n          type: 'string',\n          description: 'The current QuickBooks-assigned revision number of this payment method object, which changes each time the object is modified. When updating this object, you must provide the most recent `revisionNumber` to ensure you\\'re working with the latest data; otherwise, the update will return an error.'\n        },\n        updatedAt: {\n          type: 'string',\n          description: 'The date and time when this payment method was last updated, in ISO 8601 format (YYYY-MM-DDThh:mm:ss±hh:mm), which QuickBooks Desktop interprets in the local timezone of the end-user\\'s computer.'\n        }\n      },\n      required: [        'id',\n        'createdAt',\n        'isActive',\n        'name',\n        'objectType',\n        'paymentMethodType',\n        'revisionNumber',\n        'updatedAt'\n      ]\n    }\n  }\n}\n```",
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nRetrieves a payment method by ID.\n\n**IMPORTANT:** If you need to fetch multiple specific payment methods by ID, use the list endpoint instead with the `ids` parameter. It accepts an array of IDs so you can batch the request into a single call, which is significantly faster.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/payment_method',\n  $defs: {\n    payment_method: {\n      type: 'object',\n      title: 'The Payment Method object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The unique identifier assigned by QuickBooks to this payment method. This ID is unique across all payment methods but not across different QuickBooks object types.'\n        },\n        createdAt: {\n          type: 'string',\n          description: 'The date and time when this payment method was created, in ISO 8601 format (YYYY-MM-DDThh:mm:ss±hh:mm), which QuickBooks Desktop interprets in the local timezone of the end-user\\'s computer.'\n        },\n        isActive: {\n          type: 'boolean',\n          description: 'Indicates whether this payment method is active. Inactive objects are typically hidden from views and reports in QuickBooks. Defaults to `true`.'\n        },\n        name: {\n          type: 'string',\n          description: 'The case-insensitive unique name of this payment method, unique across all payment methods.\\n\\n**NOTE**: Payment methods do not have a `fullName` field because they are not hierarchical objects, which is why `name` is unique for them but not for objects that have parents.'\n        },\n        objectType: {\n          type: 'string',\n          description: 'The type of object. This value is always `\"qbd_payment_method\"`.',\n          enum: [            'qbd_payment_method'\n          ]\n        },\n        paymentMethodType: {\n          type: 'string',\n          description: 'This payment method\\'s type.',\n          enum: [            'american_express',\n            'cash',\n            'check',\n            'debit_card',\n            'discover',\n            'e_check',\n            'gift_card',\n            'master_card',\n            'other',\n            'other_credit_card',\n            'visa'\n          ]\n        },\n        revisionNumber: {\n          type: 'string',\n          description: 'The current QuickBooks-assigned revision number of this payment method object, which changes each time the object is modified. When updating this object, you must provide the most recent `revisionNumber` to ensure you\\'re working with the latest data; otherwise, the update will return an error.'\n        },\n        updatedAt: {\n          type: 'string',\n          description: 'The date and time when this payment method was last updated, in ISO 8601 format (YYYY-MM-DDThh:mm:ss±hh:mm), which QuickBooks Desktop interprets in the local timezone of the end-user\\'s computer.'\n        }\n      },\n      required: [        'id',\n        'createdAt',\n        'isActive',\n        'name',\n        'objectType',\n        'paymentMethodType',\n        'revisionNumber',\n        'updatedAt'\n      ]\n    }\n  }\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {

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

@@ -17,7 +17,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'retrieve_qbd_payroll_wage_items',
   description:
-    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nRetrieves a payroll wage item by ID.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/payroll_wage_item',\n  $defs: {\n    payroll_wage_item: {\n      type: 'object',\n      title: 'The Payroll Wage Item object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The unique identifier assigned by QuickBooks to this payroll wage item. This ID is unique across all payroll wage items but not across different QuickBooks object types.'\n        },\n        createdAt: {\n          type: 'string',\n          description: 'The date and time when this payroll wage item was created, in ISO 8601 format (YYYY-MM-DDThh:mm:ss±hh:mm), which QuickBooks Desktop interprets in the local timezone of the end-user\\'s computer.'\n        },\n        expenseAccount: {\n          type: 'object',\n          description: 'The expense account used to track wage expenses paid through this payroll wage item.',\n          properties: {\n            id: {\n              type: 'string',\n              description: 'The unique identifier assigned by QuickBooks to this object. This ID is unique across all objects of the same type, but not across different QuickBooks object types.'\n            },\n            fullName: {\n              type: 'string',\n              description: 'The fully-qualified unique name for this object, formed by combining the names of its parent objects with its own `name`, separated by colons. Not case-sensitive.'\n            }\n          },\n          required: [            'id',\n            'fullName'\n          ]\n        },\n        isActive: {\n          type: 'boolean',\n          description: 'Indicates whether this payroll wage item is active. Inactive objects are typically hidden from views and reports in QuickBooks. Defaults to `true`.'\n        },\n        name: {\n          type: 'string',\n          description: 'The case-insensitive unique name of this payroll wage item, unique across all payroll wage items.\\n\\n**NOTE**: Payroll wage items do not have a `fullName` field because they are not hierarchical objects, which is why `name` is unique for them but not for objects that have parents.'\n        },\n        objectType: {\n          type: 'string',\n          description: 'The type of object. This value is always `\"qbd_payroll_wage_item\"`.',\n          enum: [            'qbd_payroll_wage_item'\n          ]\n        },\n        revisionNumber: {\n          type: 'string',\n          description: 'The current QuickBooks-assigned revision number of this payroll wage item object, which changes each time the object is modified. When updating this object, you must provide the most recent `revisionNumber` to ensure you\\'re working with the latest data; otherwise, the update will return an error.'\n        },\n        updatedAt: {\n          type: 'string',\n          description: 'The date and time when this payroll wage item was last updated, in ISO 8601 format (YYYY-MM-DDThh:mm:ss±hh:mm), which QuickBooks Desktop interprets in the local timezone of the end-user\\'s computer.'\n        },\n        wageType: {\n          type: 'string',\n          description: 'Categorizes how this payroll wage item calculates pay - can be hourly (regular, overtime, sick, or vacation), salary (regular, sick, or vacation), bonus, or commission based.',\n          enum: [            'bonus',\n            'commission',\n            'hourly_overtime',\n            'hourly_regular',\n            'hourly_sick',\n            'hourly_vacation',\n            'salary_regular',\n            'salary_sick',\n            'salary_vacation'\n          ]\n        }\n      },\n      required: [        'id',\n        'createdAt',\n        'expenseAccount',\n        'isActive',\n        'name',\n        'objectType',\n        'revisionNumber',\n        'updatedAt',\n        'wageType'\n      ]\n    }\n  }\n}\n```",
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nRetrieves a payroll wage item by ID.\n\n**IMPORTANT:** If you need to fetch multiple specific payroll wage items by ID, use the list endpoint instead with the `ids` parameter. It accepts an array of IDs so you can batch the request into a single call, which is significantly faster.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/payroll_wage_item',\n  $defs: {\n    payroll_wage_item: {\n      type: 'object',\n      title: 'The Payroll Wage Item object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The unique identifier assigned by QuickBooks to this payroll wage item. This ID is unique across all payroll wage items but not across different QuickBooks object types.'\n        },\n        createdAt: {\n          type: 'string',\n          description: 'The date and time when this payroll wage item was created, in ISO 8601 format (YYYY-MM-DDThh:mm:ss±hh:mm), which QuickBooks Desktop interprets in the local timezone of the end-user\\'s computer.'\n        },\n        expenseAccount: {\n          type: 'object',\n          description: 'The expense account used to track wage expenses paid through this payroll wage item.',\n          properties: {\n            id: {\n              type: 'string',\n              description: 'The unique identifier assigned by QuickBooks to this object. This ID is unique across all objects of the same type, but not across different QuickBooks object types.'\n            },\n            fullName: {\n              type: 'string',\n              description: 'The fully-qualified unique name for this object, formed by combining the names of its parent objects with its own `name`, separated by colons. Not case-sensitive.'\n            }\n          },\n          required: [            'id',\n            'fullName'\n          ]\n        },\n        isActive: {\n          type: 'boolean',\n          description: 'Indicates whether this payroll wage item is active. Inactive objects are typically hidden from views and reports in QuickBooks. Defaults to `true`.'\n        },\n        name: {\n          type: 'string',\n          description: 'The case-insensitive unique name of this payroll wage item, unique across all payroll wage items.\\n\\n**NOTE**: Payroll wage items do not have a `fullName` field because they are not hierarchical objects, which is why `name` is unique for them but not for objects that have parents.'\n        },\n        objectType: {\n          type: 'string',\n          description: 'The type of object. This value is always `\"qbd_payroll_wage_item\"`.',\n          enum: [            'qbd_payroll_wage_item'\n          ]\n        },\n        revisionNumber: {\n          type: 'string',\n          description: 'The current QuickBooks-assigned revision number of this payroll wage item object, which changes each time the object is modified. When updating this object, you must provide the most recent `revisionNumber` to ensure you\\'re working with the latest data; otherwise, the update will return an error.'\n        },\n        updatedAt: {\n          type: 'string',\n          description: 'The date and time when this payroll wage item was last updated, in ISO 8601 format (YYYY-MM-DDThh:mm:ss±hh:mm), which QuickBooks Desktop interprets in the local timezone of the end-user\\'s computer.'\n        },\n        wageType: {\n          type: 'string',\n          description: 'Categorizes how this payroll wage item calculates pay - can be hourly (regular, overtime, sick, or vacation), salary (regular, sick, or vacation), bonus, or commission based.',\n          enum: [            'bonus',\n            'commission',\n            'hourly_overtime',\n            'hourly_regular',\n            'hourly_sick',\n            'hourly_vacation',\n            'salary_regular',\n            'salary_sick',\n            'salary_vacation'\n          ]\n        }\n      },\n      required: [        'id',\n        'createdAt',\n        'expenseAccount',\n        'isActive',\n        'name',\n        'objectType',\n        'revisionNumber',\n        'updatedAt',\n        'wageType'\n      ]\n    }\n  }\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {

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

@@ -17,7 +17,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'retrieve_qbd_price_levels',
   description:
-    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nRetrieves a price level by ID.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/price_level',\n  $defs: {\n    price_level: {\n      type: 'object',\n      title: 'The Price Level object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The unique identifier assigned by QuickBooks to this price level. This ID is unique across all price levels but not across different QuickBooks object types.'\n        },\n        createdAt: {\n          type: 'string',\n          description: 'The date and time when this price level was created, in ISO 8601 format (YYYY-MM-DDThh:mm:ss±hh:mm), which QuickBooks Desktop interprets in the local timezone of the end-user\\'s computer.'\n        },\n        currency: {\n          type: 'object',\n          description: 'The price level\\'s currency. For built-in currencies, the name and code are standard international values. For user-defined currencies, all values are editable.',\n          properties: {\n            id: {\n              type: 'string',\n              description: 'The unique identifier assigned by QuickBooks to this object. This ID is unique across all objects of the same type, but not across different QuickBooks object types.'\n            },\n            fullName: {\n              type: 'string',\n              description: 'The fully-qualified unique name for this object, formed by combining the names of its parent objects with its own `name`, separated by colons. Not case-sensitive.'\n            }\n          },\n          required: [            'id',\n            'fullName'\n          ]\n        },\n        fixedPercentage: {\n          type: 'string',\n          description: 'The fixed percentage adjustment applied to all items for this price level (instead of a per-item price level). Once you create the price level, you cannot change this.\\n\\nWhen this price level is applied to a customer, it automatically adjusts the `rate` and `amount` columns for applicable line items in sales orders and invoices for that customer. This value supports both positive and negative values - a value of \"20\" increases prices by 20%, while \"-10\" decreases prices by 10%.'\n        },\n        isActive: {\n          type: 'boolean',\n          description: 'Indicates whether this price level is active. Inactive objects are typically hidden from views and reports in QuickBooks. Defaults to `true`.'\n        },\n        name: {\n          type: 'string',\n          description: 'The case-insensitive unique name of this price level, unique across all price levels.\\n\\n**NOTE**: Price levels do not have a `fullName` field because they are not hierarchical objects, which is why `name` is unique for them but not for objects that have parents.'\n        },\n        objectType: {\n          type: 'string',\n          description: 'The type of object. This value is always `\"qbd_price_level\"`.',\n          enum: [            'qbd_price_level'\n          ]\n        },\n        perItemPriceLevels: {\n          type: 'array',\n          description: 'The per-item price level configurations for this price level.',\n          items: {\n            type: 'object',\n            title: 'The Per-Item Price Level object',\n            properties: {\n              customPrice: {\n                type: 'string',\n                description: 'The fixed amount custom price for this per-item price level that overrides the standard price for the specified item. Used when setting an absolute price value for the item in this price level.'\n              },\n              customPricePercent: {\n                type: 'string',\n                description: 'The fixed discount percentage for this per-item price level that modifies the specified item\\'s standard price. Used to create a fixed percentage markup or discount specific to this item within this price level.'\n              },\n              item: {\n                type: 'object',\n                description: 'The item associated with this per-item price level. This can refer to any good or service that the business buys or sells, including item types such as a service item, inventory item, or special calculation item like a discount item or sales-tax item.',\n                properties: {\n                  id: {\n                    type: 'string',\n                    description: 'The unique identifier assigned by QuickBooks to this object. This ID is unique across all objects of the same type, but not across different QuickBooks object types.'\n                  },\n                  fullName: {\n                    type: 'string',\n                    description: 'The fully-qualified unique name for this object, formed by combining the names of its parent objects with its own `name`, separated by colons. Not case-sensitive.'\n                  }\n                },\n                required: [                  'id',\n                  'fullName'\n                ]\n              }\n            },\n            required: [              'customPrice',\n              'customPricePercent',\n              'item'\n            ]\n          }\n        },\n        priceLevelType: {\n          type: 'string',\n          description: 'The price level\\'s type.',\n          enum: [            'fixed_percentage',\n            'per_item'\n          ]\n        },\n        revisionNumber: {\n          type: 'string',\n          description: 'The current QuickBooks-assigned revision number of this price level object, which changes each time the object is modified. When updating this object, you must provide the most recent `revisionNumber` to ensure you\\'re working with the latest data; otherwise, the update will return an error.'\n        },\n        updatedAt: {\n          type: 'string',\n          description: 'The date and time when this price level was last updated, in ISO 8601 format (YYYY-MM-DDThh:mm:ss±hh:mm), which QuickBooks Desktop interprets in the local timezone of the end-user\\'s computer.'\n        }\n      },\n      required: [        'id',\n        'createdAt',\n        'currency',\n        'fixedPercentage',\n        'isActive',\n        'name',\n        'objectType',\n        'perItemPriceLevels',\n        'priceLevelType',\n        'revisionNumber',\n        'updatedAt'\n      ]\n    }\n  }\n}\n```",
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nRetrieves a price level by ID.\n\n**IMPORTANT:** If you need to fetch multiple specific price levels by ID, use the list endpoint instead with the `ids` parameter. It accepts an array of IDs so you can batch the request into a single call, which is significantly faster.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/price_level',\n  $defs: {\n    price_level: {\n      type: 'object',\n      title: 'The Price Level object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The unique identifier assigned by QuickBooks to this price level. This ID is unique across all price levels but not across different QuickBooks object types.'\n        },\n        createdAt: {\n          type: 'string',\n          description: 'The date and time when this price level was created, in ISO 8601 format (YYYY-MM-DDThh:mm:ss±hh:mm), which QuickBooks Desktop interprets in the local timezone of the end-user\\'s computer.'\n        },\n        currency: {\n          type: 'object',\n          description: 'The price level\\'s currency. For built-in currencies, the name and code are standard international values. For user-defined currencies, all values are editable.',\n          properties: {\n            id: {\n              type: 'string',\n              description: 'The unique identifier assigned by QuickBooks to this object. This ID is unique across all objects of the same type, but not across different QuickBooks object types.'\n            },\n            fullName: {\n              type: 'string',\n              description: 'The fully-qualified unique name for this object, formed by combining the names of its parent objects with its own `name`, separated by colons. Not case-sensitive.'\n            }\n          },\n          required: [            'id',\n            'fullName'\n          ]\n        },\n        fixedPercentage: {\n          type: 'string',\n          description: 'The fixed percentage adjustment applied to all items for this price level (instead of a per-item price level). Once you create the price level, you cannot change this.\\n\\nWhen this price level is applied to a customer, it automatically adjusts the `rate` and `amount` columns for applicable line items in sales orders and invoices for that customer. This value supports both positive and negative values - a value of \"20\" increases prices by 20%, while \"-10\" decreases prices by 10%.'\n        },\n        isActive: {\n          type: 'boolean',\n          description: 'Indicates whether this price level is active. Inactive objects are typically hidden from views and reports in QuickBooks. Defaults to `true`.'\n        },\n        name: {\n          type: 'string',\n          description: 'The case-insensitive unique name of this price level, unique across all price levels.\\n\\n**NOTE**: Price levels do not have a `fullName` field because they are not hierarchical objects, which is why `name` is unique for them but not for objects that have parents.'\n        },\n        objectType: {\n          type: 'string',\n          description: 'The type of object. This value is always `\"qbd_price_level\"`.',\n          enum: [            'qbd_price_level'\n          ]\n        },\n        perItemPriceLevels: {\n          type: 'array',\n          description: 'The per-item price level configurations for this price level.',\n          items: {\n            type: 'object',\n            title: 'The Per-Item Price Level object',\n            properties: {\n              customPrice: {\n                type: 'string',\n                description: 'The fixed amount custom price for this per-item price level that overrides the standard price for the specified item. Used when setting an absolute price value for the item in this price level.'\n              },\n              customPricePercent: {\n                type: 'string',\n                description: 'The fixed discount percentage for this per-item price level that modifies the specified item\\'s standard price. Used to create a fixed percentage markup or discount specific to this item within this price level.'\n              },\n              item: {\n                type: 'object',\n                description: 'The item associated with this per-item price level. This can refer to any good or service that the business buys or sells, including item types such as a service item, inventory item, or special calculation item like a discount item or sales-tax item.',\n                properties: {\n                  id: {\n                    type: 'string',\n                    description: 'The unique identifier assigned by QuickBooks to this object. This ID is unique across all objects of the same type, but not across different QuickBooks object types.'\n                  },\n                  fullName: {\n                    type: 'string',\n                    description: 'The fully-qualified unique name for this object, formed by combining the names of its parent objects with its own `name`, separated by colons. Not case-sensitive.'\n                  }\n                },\n                required: [                  'id',\n                  'fullName'\n                ]\n              }\n            },\n            required: [              'customPrice',\n              'customPricePercent',\n              'item'\n            ]\n          }\n        },\n        priceLevelType: {\n          type: 'string',\n          description: 'The price level\\'s type.',\n          enum: [            'fixed_percentage',\n            'per_item'\n          ]\n        },\n        revisionNumber: {\n          type: 'string',\n          description: 'The current QuickBooks-assigned revision number of this price level object, which changes each time the object is modified. When updating this object, you must provide the most recent `revisionNumber` to ensure you\\'re working with the latest data; otherwise, the update will return an error.'\n        },\n        updatedAt: {\n          type: 'string',\n          description: 'The date and time when this price level was last updated, in ISO 8601 format (YYYY-MM-DDThh:mm:ss±hh:mm), which QuickBooks Desktop interprets in the local timezone of the end-user\\'s computer.'\n        }\n      },\n      required: [        'id',\n        'createdAt',\n        'currency',\n        'fixedPercentage',\n        'isActive',\n        'name',\n        'objectType',\n        'perItemPriceLevels',\n        'priceLevelType',\n        'revisionNumber',\n        'updatedAt'\n      ]\n    }\n  }\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {

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

@@ -17,7 +17,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'delete_qbd_purchase_orders',
   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\nPermanently deletes a a purchase order. The deletion will fail if the purchase order is currently in use or has any linked transactions that are in use.\n\n# Response Schema\n```json\n{\n  type: 'object',\n  properties: {\n    id: {\n      type: 'string',\n      description: 'The QuickBooks-assigned unique identifier of the deleted purchase order.'\n    },\n    deleted: {\n      type: 'boolean',\n      description: 'Indicates whether the purchase order was deleted.'\n    },\n    objectType: {\n      type: 'string',\n      description: 'The type of object. This value is always `\"qbd_purchase_order\"`.',\n      enum: [        'qbd_purchase_order'\n      ]\n    },\n    refNumber: {\n      type: 'string',\n      description: 'The case-sensitive user-defined reference number of the deleted purchase order.'\n    }\n  },\n  required: [    'id',\n    'deleted',\n    'objectType',\n    'refNumber'\n  ]\n}\n```",
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nPermanently deletes a a purchase order. The deletion will fail if the purchase order is currently in use or has any linked transactions that are in use.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/purchase_order_delete_response',\n  $defs: {\n    purchase_order_delete_response: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The QuickBooks-assigned unique identifier of the deleted purchase order.'\n        },\n        deleted: {\n          type: 'boolean',\n          description: 'Indicates whether the purchase order was deleted.'\n        },\n        objectType: {\n          type: 'string',\n          description: 'The type of object. This value is always `\"qbd_purchase_order\"`.',\n          enum: [            'qbd_purchase_order'\n          ]\n        },\n        refNumber: {\n          type: 'string',\n          description: 'The case-sensitive user-defined reference number of the deleted purchase order.'\n        }\n      },\n      required: [        'id',\n        'deleted',\n        'objectType',\n        'refNumber'\n      ]\n    }\n  }\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {

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

@@ -16,7 +16,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'retrieve_qbd_purchase_orders',
   description:
-    'Retrieves a purchase order by ID.\n\nNOTE: The response automatically includes any linked transactions.',
+    'Retrieves a purchase order by ID.\n\n**IMPORTANT:** If you need to fetch multiple specific purchase orders by ID, use the list endpoint instead with the `ids` parameter. It accepts an array of IDs so you can batch the request into a single call, which is significantly faster.\n\nNOTE: The response automatically includes any linked transactions.',
   inputSchema: {
     type: 'object',
     properties: {

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

@@ -17,7 +17,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'delete_qbd_receive_payments',
   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\nPermanently deletes a a receive-payment. The deletion will fail if the receive-payment is currently in use or has any linked transactions that are in use.\n\n# Response Schema\n```json\n{\n  type: 'object',\n  properties: {\n    id: {\n      type: 'string',\n      description: 'The QuickBooks-assigned unique identifier of the deleted receive-payment.'\n    },\n    deleted: {\n      type: 'boolean',\n      description: 'Indicates whether the receive-payment was deleted.'\n    },\n    objectType: {\n      type: 'string',\n      description: 'The type of object. This value is always `\"qbd_receive_payment\"`.',\n      enum: [        'qbd_receive_payment'\n      ]\n    },\n    refNumber: {\n      type: 'string',\n      description: 'The case-sensitive user-defined reference number of the deleted receive-payment.'\n    }\n  },\n  required: [    'id',\n    'deleted',\n    'objectType',\n    'refNumber'\n  ]\n}\n```",
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nPermanently deletes a a receive-payment. The deletion will fail if the receive-payment is currently in use or has any linked transactions that are in use.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/receive_payment_delete_response',\n  $defs: {\n    receive_payment_delete_response: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The QuickBooks-assigned unique identifier of the deleted receive-payment.'\n        },\n        deleted: {\n          type: 'boolean',\n          description: 'Indicates whether the receive-payment was deleted.'\n        },\n        objectType: {\n          type: 'string',\n          description: 'The type of object. This value is always `\"qbd_receive_payment\"`.',\n          enum: [            'qbd_receive_payment'\n          ]\n        },\n        refNumber: {\n          type: 'string',\n          description: 'The case-sensitive user-defined reference number of the deleted receive-payment.'\n        }\n      },\n      required: [        'id',\n        'deleted',\n        'objectType',\n        'refNumber'\n      ]\n    }\n  }\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {

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

@@ -15,7 +15,8 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'retrieve_qbd_receive_payments',
-  description: 'Retrieves a receive-payment by ID.',
+  description:
+    'Retrieves a receive-payment by ID.\n\n**IMPORTANT:** If you need to fetch multiple specific receive-payments by ID, use the list endpoint instead with the `ids` parameter. It accepts an array of IDs so you can batch the request into a single call, which is significantly faster.',
   inputSchema: {
     type: 'object',
     properties: {

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

@@ -328,7 +328,7 @@ export const tool: Tool = {
       purchaseOrderNumber: {
         type: 'string',
         description:
-          "The customer's Purchase Order (PO) number associated with this sales order. This field is often used to cross-reference the sales order with the customer's purchasing system.",
+          "The customer's Purchase Order (PO) number associated with this sales order. This field is often used to cross-reference the sales order with the customer's purchasing system.\n\nMaximum length: 25 characters.",
       },
       refNumber: {
         type: 'string',

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

@@ -17,7 +17,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'delete_qbd_sales_orders',
   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\nPermanently deletes a a sales order. The deletion will fail if the sales order is currently in use or has any linked transactions that are in use.\n\n# Response Schema\n```json\n{\n  type: 'object',\n  properties: {\n    id: {\n      type: 'string',\n      description: 'The QuickBooks-assigned unique identifier of the deleted sales order.'\n    },\n    deleted: {\n      type: 'boolean',\n      description: 'Indicates whether the sales order was deleted.'\n    },\n    objectType: {\n      type: 'string',\n      description: 'The type of object. This value is always `\"qbd_sales_order\"`.',\n      enum: [        'qbd_sales_order'\n      ]\n    },\n    refNumber: {\n      type: 'string',\n      description: 'The case-sensitive user-defined reference number of the deleted sales order.'\n    }\n  },\n  required: [    'id',\n    'deleted',\n    'objectType',\n    'refNumber'\n  ]\n}\n```",
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nPermanently deletes a a sales order. The deletion will fail if the sales order is currently in use or has any linked transactions that are in use.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/sales_order_delete_response',\n  $defs: {\n    sales_order_delete_response: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The QuickBooks-assigned unique identifier of the deleted sales order.'\n        },\n        deleted: {\n          type: 'boolean',\n          description: 'Indicates whether the sales order was deleted.'\n        },\n        objectType: {\n          type: 'string',\n          description: 'The type of object. This value is always `\"qbd_sales_order\"`.',\n          enum: [            'qbd_sales_order'\n          ]\n        },\n        refNumber: {\n          type: 'string',\n          description: 'The case-sensitive user-defined reference number of the deleted sales order.'\n        }\n      },\n      required: [        'id',\n        'deleted',\n        'objectType',\n        'refNumber'\n      ]\n    }\n  }\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {