conductor-node-mcp 12.18.0 → 12.18.2

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

@@ -16,7 +16,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'list_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\nReturns a list of other-names. NOTE: QuickBooks Desktop does not support pagination for other-names; hence, there is no `cursor` parameter. Users typically have few other-names.",
+    'Returns a list of other-names. NOTE: QuickBooks Desktop does not support pagination for other-names; hence, there is no `cursor` parameter. Users typically have few other-names.',
   inputSchema: {
     type: 'object',
     properties: {
@@ -89,6 +89,9 @@ export const tool: Tool = {
     },
     required: ['conductorEndUserId'],
   },
+  annotations: {
+    readOnlyHint: true,
+  },
 };
 
 export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {

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

@@ -39,11 +39,14 @@ export const tool: Tool = {
     },
     required: ['id', 'conductorEndUserId'],
   },
+  annotations: {
+    readOnlyHint: true,
+  },
 };
 
 export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {
-  const { id, ...body } = args as any;
-  return asTextContentResult(await maybeFilter(args, await conductor.qbd.otherNames.retrieve(id, body)));
+  const { id, jq_filter, ...body } = args as any;
+  return asTextContentResult(await maybeFilter(jq_filter, await conductor.qbd.otherNames.retrieve(id, body)));
 };
 
 export default { metadata, tool, handler };

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

@@ -15,8 +15,7 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'update_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\nUpdates an existing other-name.",
+  description: 'Updates an existing other-name.',
   inputSchema: {
     type: 'object',
     properties: {
@@ -156,6 +155,7 @@ export const tool: Tool = {
     },
     required: ['id', 'revisionNumber', 'conductorEndUserId'],
   },
+  annotations: {},
 };
 
 export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {

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

@@ -62,11 +62,12 @@ export const tool: Tool = {
     },
     required: ['name', 'paymentMethodType', 'conductorEndUserId'],
   },
+  annotations: {},
 };
 
 export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {
-  const body = args as any;
-  return asTextContentResult(await maybeFilter(args, await conductor.qbd.paymentMethods.create(body)));
+  const { jq_filter, ...body } = args as any;
+  return asTextContentResult(await maybeFilter(jq_filter, await conductor.qbd.paymentMethods.create(body)));
 };
 
 export default { metadata, tool, handler };

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

@@ -113,11 +113,14 @@ export const tool: Tool = {
     },
     required: ['conductorEndUserId'],
   },
+  annotations: {
+    readOnlyHint: true,
+  },
 };
 
 export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {
-  const body = args as any;
-  return asTextContentResult(await maybeFilter(args, await conductor.qbd.paymentMethods.list(body)));
+  const { jq_filter, ...body } = args as any;
+  return asTextContentResult(await maybeFilter(jq_filter, await conductor.qbd.paymentMethods.list(body)));
 };
 
 export default { metadata, tool, handler };

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

@@ -39,11 +39,16 @@ export const tool: Tool = {
     },
     required: ['id', 'conductorEndUserId'],
   },
+  annotations: {
+    readOnlyHint: true,
+  },
 };
 
 export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {
-  const { id, ...body } = args as any;
-  return asTextContentResult(await maybeFilter(args, await conductor.qbd.paymentMethods.retrieve(id, body)));
+  const { id, jq_filter, ...body } = args as any;
+  return asTextContentResult(
+    await maybeFilter(jq_filter, await conductor.qbd.paymentMethods.retrieve(id, body)),
+  );
 };
 
 export default { metadata, tool, handler };

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

@@ -65,11 +65,12 @@ export const tool: Tool = {
     },
     required: ['expenseAccountId', 'name', 'wageType', 'conductorEndUserId'],
   },
+  annotations: {},
 };
 
 export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {
-  const body = args as any;
-  return asTextContentResult(await maybeFilter(args, await conductor.qbd.payrollWageItems.create(body)));
+  const { jq_filter, ...body } = args as any;
+  return asTextContentResult(await maybeFilter(jq_filter, await conductor.qbd.payrollWageItems.create(body)));
 };
 
 export default { metadata, tool, handler };

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

@@ -101,12 +101,15 @@ export const tool: Tool = {
     },
     required: ['conductorEndUserId'],
   },
+  annotations: {
+    readOnlyHint: true,
+  },
 };
 
 export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {
-  const body = args as any;
+  const { jq_filter, ...body } = args as any;
   const response = await conductor.qbd.payrollWageItems.list(body).asResponse();
-  return asTextContentResult(await maybeFilter(args, await response.json()));
+  return asTextContentResult(await maybeFilter(jq_filter, await response.json()));
 };
 
 export default { metadata, tool, handler };

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

@@ -39,12 +39,15 @@ export const tool: Tool = {
     },
     required: ['id', 'conductorEndUserId'],
   },
+  annotations: {
+    readOnlyHint: true,
+  },
 };
 
 export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {
-  const { id, ...body } = args as any;
+  const { id, jq_filter, ...body } = args as any;
   return asTextContentResult(
-    await maybeFilter(args, await conductor.qbd.payrollWageItems.retrieve(id, body)),
+    await maybeFilter(jq_filter, await conductor.qbd.payrollWageItems.retrieve(id, body)),
   );
 };
 

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

@@ -16,7 +16,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'retrieve_qbd_preferences',
   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 the preferences that the QuickBooks administrator has set for all users of the connected company file. Note that preferences cannot be modified through the API, only through the QuickBooks Desktop user interface.",
+    'Returns the preferences that the QuickBooks administrator has set for all users of the connected company file. Note that preferences cannot be modified through the API, only through the QuickBooks Desktop user interface.',
   inputSchema: {
     type: 'object',
     properties: {
@@ -28,6 +28,9 @@ export const tool: Tool = {
     },
     required: ['conductorEndUserId'],
   },
+  annotations: {
+    readOnlyHint: true,
+  },
 };
 
 export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {

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

@@ -15,8 +15,7 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'create_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\nCreates a new price level.",
+  description: 'Creates a new price level.',
   inputSchema: {
     type: 'object',
     properties: {
@@ -84,6 +83,7 @@ export const tool: Tool = {
     },
     required: ['name', 'conductorEndUserId'],
   },
+  annotations: {},
 };
 
 export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {

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

@@ -16,7 +16,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'list_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\nReturns a list of price levels. NOTE: QuickBooks Desktop does not support pagination for price levels; hence, there is no `cursor` parameter. Users typically have few price levels.",
+    'Returns a list of price levels. NOTE: QuickBooks Desktop does not support pagination for price levels; hence, there is no `cursor` parameter. Users typically have few price levels.',
   inputSchema: {
     type: 'object',
     properties: {
@@ -103,6 +103,9 @@ export const tool: Tool = {
     },
     required: ['conductorEndUserId'],
   },
+  annotations: {
+    readOnlyHint: true,
+  },
 };
 
 export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {

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

@@ -39,11 +39,16 @@ export const tool: Tool = {
     },
     required: ['id', 'conductorEndUserId'],
   },
+  annotations: {
+    readOnlyHint: true,
+  },
 };
 
 export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {
-  const { id, ...body } = args as any;
-  return asTextContentResult(await maybeFilter(args, await conductor.qbd.priceLevels.retrieve(id, body)));
+  const { id, jq_filter, ...body } = args as any;
+  return asTextContentResult(
+    await maybeFilter(jq_filter, await conductor.qbd.priceLevels.retrieve(id, body)),
+  );
 };
 
 export default { metadata, tool, handler };

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

@@ -15,8 +15,7 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'update_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\nUpdates an existing price level.",
+  description: 'Updates an existing price level.',
   inputSchema: {
     type: 'object',
     properties: {
@@ -93,6 +92,7 @@ export const tool: Tool = {
     },
     required: ['id', 'revisionNumber', 'conductorEndUserId'],
   },
+  annotations: {},
 };
 
 export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {

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

@@ -15,8 +15,7 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'create_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\nCreates a new purchase order.",
+  description: 'Creates a new purchase order.',
   inputSchema: {
     type: 'object',
     properties: {
@@ -402,6 +401,7 @@ export const tool: Tool = {
     },
     required: ['transactionDate', 'conductorEndUserId'],
   },
+  annotations: {},
 };
 
 export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {

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

@@ -39,11 +39,16 @@ export const tool: Tool = {
     },
     required: ['id', 'conductorEndUserId'],
   },
+  annotations: {
+    idempotentHint: true,
+  },
 };
 
 export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {
-  const { id, ...body } = args as any;
-  return asTextContentResult(await maybeFilter(args, await conductor.qbd.purchaseOrders.delete(id, body)));
+  const { id, jq_filter, ...body } = args as any;
+  return asTextContentResult(
+    await maybeFilter(jq_filter, await conductor.qbd.purchaseOrders.delete(id, body)),
+  );
 };
 
 export default { metadata, tool, handler };

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

@@ -16,7 +16,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'list_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\nReturns a list of purchase orders. Use the `cursor` parameter to paginate through the results.",
+    'Returns a list of purchase orders. Use the `cursor` parameter to paginate through the results.',
   inputSchema: {
     type: 'object',
     properties: {
@@ -131,6 +131,9 @@ export const tool: Tool = {
     },
     required: ['conductorEndUserId'],
   },
+  annotations: {
+    readOnlyHint: true,
+  },
 };
 
 export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {

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:
-    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nRetrieves a purchase order by ID.\n\nNOTE: The response automatically includes any linked transactions.",
+    'Retrieves a purchase order by ID.\n\nNOTE: The response automatically includes any linked transactions.',
   inputSchema: {
     type: 'object',
     properties: {
@@ -32,6 +32,9 @@ export const tool: Tool = {
     },
     required: ['id', 'conductorEndUserId'],
   },
+  annotations: {
+    readOnlyHint: true,
+  },
 };
 
 export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {

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

@@ -15,8 +15,7 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'update_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\nUpdates an existing purchase order.",
+  description: 'Updates an existing purchase order.',
   inputSchema: {
     type: 'object',
     properties: {
@@ -481,6 +480,7 @@ export const tool: Tool = {
     },
     required: ['id', 'revisionNumber', 'conductorEndUserId'],
   },
+  annotations: {},
 };
 
 export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {

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

@@ -15,8 +15,7 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'create_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\nCreates a new receive-payment.",
+  description: 'Creates a new receive-payment.',
   inputSchema: {
     type: 'object',
     properties: {
@@ -285,6 +284,7 @@ export const tool: Tool = {
     },
     required: ['customerId', 'totalAmount', 'transactionDate', 'conductorEndUserId'],
   },
+  annotations: {},
 };
 
 export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {

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

@@ -39,11 +39,16 @@ export const tool: Tool = {
     },
     required: ['id', 'conductorEndUserId'],
   },
+  annotations: {
+    idempotentHint: true,
+  },
 };
 
 export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {
-  const { id, ...body } = args as any;
-  return asTextContentResult(await maybeFilter(args, await conductor.qbd.receivePayments.delete(id, body)));
+  const { id, jq_filter, ...body } = args as any;
+  return asTextContentResult(
+    await maybeFilter(jq_filter, await conductor.qbd.receivePayments.delete(id, body)),
+  );
 };
 
 export default { metadata, tool, handler };

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

@@ -16,7 +16,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'list_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\nReturns a list of receive-payments. Use the `cursor` parameter to paginate through the results.",
+    'Returns a list of receive-payments. Use the `cursor` parameter to paginate through the results.',
   inputSchema: {
     type: 'object',
     properties: {
@@ -126,6 +126,9 @@ export const tool: Tool = {
     },
     required: ['conductorEndUserId'],
   },
+  annotations: {
+    readOnlyHint: true,
+  },
 };
 
 export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {

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

@@ -15,8 +15,7 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'retrieve_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\nRetrieves a receive-payment by ID.",
+  description: 'Retrieves a receive-payment by ID.',
   inputSchema: {
     type: 'object',
     properties: {
@@ -32,6 +31,9 @@ export const tool: Tool = {
     },
     required: ['id', 'conductorEndUserId'],
   },
+  annotations: {
+    readOnlyHint: true,
+  },
 };
 
 export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {

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

@@ -15,8 +15,7 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'update_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\nUpdates an existing receive-payment.",
+  description: 'Updates an existing receive-payment.',
   inputSchema: {
     type: 'object',
     properties: {
@@ -273,6 +272,7 @@ export const tool: Tool = {
     },
     required: ['id', 'revisionNumber', 'conductorEndUserId'],
   },
+  annotations: {},
 };
 
 export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {

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

@@ -15,8 +15,7 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'create_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\nCreates a new sales order.",
+  description: 'Creates a new sales order.',
   inputSchema: {
     type: 'object',
     properties: {
@@ -439,6 +438,7 @@ export const tool: Tool = {
     },
     required: ['customerId', 'transactionDate', 'conductorEndUserId'],
   },
+  annotations: {},
 };
 
 export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {

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

@@ -39,11 +39,14 @@ export const tool: Tool = {
     },
     required: ['id', 'conductorEndUserId'],
   },
+  annotations: {
+    idempotentHint: true,
+  },
 };
 
 export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {
-  const { id, ...body } = args as any;
-  return asTextContentResult(await maybeFilter(args, await conductor.qbd.salesOrders.delete(id, body)));
+  const { id, jq_filter, ...body } = args as any;
+  return asTextContentResult(await maybeFilter(jq_filter, await conductor.qbd.salesOrders.delete(id, body)));
 };
 
 export default { metadata, tool, handler };

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

@@ -15,8 +15,7 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'list_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\nReturns a list of sales orders. Use the `cursor` parameter to paginate through the results.",
+  description: 'Returns a list of sales orders. Use the `cursor` parameter to paginate through the results.',
   inputSchema: {
     type: 'object',
     properties: {
@@ -124,6 +123,9 @@ export const tool: Tool = {
     },
     required: ['conductorEndUserId'],
   },
+  annotations: {
+    readOnlyHint: true,
+  },
 };
 
 export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {

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

@@ -16,7 +16,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'retrieve_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\nRetrieves a sales order by ID.\n\nNOTE: The response automatically includes any linked transactions.",
+    'Retrieves a sales order by ID.\n\nNOTE: The response automatically includes any linked transactions.',
   inputSchema: {
     type: 'object',
     properties: {
@@ -32,6 +32,9 @@ export const tool: Tool = {
     },
     required: ['id', 'conductorEndUserId'],
   },
+  annotations: {
+    readOnlyHint: true,
+  },
 };
 
 export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {

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

@@ -15,8 +15,7 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'update_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\nUpdates an existing sales order.",
+  description: 'Updates an existing sales order.',
   inputSchema: {
     type: 'object',
     properties: {
@@ -513,6 +512,7 @@ export const tool: Tool = {
     },
     required: ['id', 'revisionNumber', 'conductorEndUserId'],
   },
+  annotations: {},
 };
 
 export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {

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

@@ -15,8 +15,7 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'create_qbd_sales_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\nCreates a new sales receipt.",
+  description: 'Creates a new sales receipt.',
   inputSchema: {
     type: 'object',
     properties: {
@@ -726,6 +725,7 @@ export const tool: Tool = {
     },
     required: ['customerId', 'transactionDate', 'conductorEndUserId'],
   },
+  annotations: {},
 };
 
 export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {

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

@@ -39,11 +39,16 @@ export const tool: Tool = {
     },
     required: ['id', 'conductorEndUserId'],
   },
+  annotations: {
+    idempotentHint: true,
+  },
 };
 
 export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {
-  const { id, ...body } = args as any;
-  return asTextContentResult(await maybeFilter(args, await conductor.qbd.salesReceipts.delete(id, body)));
+  const { id, jq_filter, ...body } = args as any;
+  return asTextContentResult(
+    await maybeFilter(jq_filter, await conductor.qbd.salesReceipts.delete(id, body)),
+  );
 };
 
 export default { metadata, tool, handler };

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

@@ -16,7 +16,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'list_qbd_sales_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\nReturns a list of sales receipts. Use the `cursor` parameter to paginate through the results.",
+    'Returns a list of sales receipts. Use the `cursor` parameter to paginate through the results.',
   inputSchema: {
     type: 'object',
     properties: {
@@ -126,6 +126,9 @@ export const tool: Tool = {
     },
     required: ['conductorEndUserId'],
   },
+  annotations: {
+    readOnlyHint: true,
+  },
 };
 
 export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {

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

@@ -15,8 +15,7 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'retrieve_qbd_sales_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\nRetrieves a sales receipt by ID.",
+  description: 'Retrieves a sales receipt by ID.',
   inputSchema: {
     type: 'object',
     properties: {
@@ -32,6 +31,9 @@ export const tool: Tool = {
     },
     required: ['id', 'conductorEndUserId'],
   },
+  annotations: {
+    readOnlyHint: true,
+  },
 };
 
 export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {

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

@@ -15,8 +15,7 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'update_qbd_sales_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\nUpdates an existing sales receipt.",
+  description: 'Updates an existing sales receipt.',
   inputSchema: {
     type: 'object',
     properties: {
@@ -515,6 +514,7 @@ export const tool: Tool = {
     },
     required: ['id', 'revisionNumber', 'conductorEndUserId'],
   },
+  annotations: {},
 };
 
 export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {