conductor-node-mcp 12.18.0 → 12.18.2

package/src/tools/qbd/credit-memos/delete-qbd-credit-memos.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.creditMemos.delete(id, body)));
+  const { id, jq_filter, ...body } = args as any;
+  return asTextContentResult(await maybeFilter(jq_filter, await conductor.qbd.creditMemos.delete(id, body)));
 };
 
 export default { metadata, tool, handler };

package/src/tools/qbd/credit-memos/list-qbd-credit-memos.ts

@@ -15,8 +15,7 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'list_qbd_credit_memos',
-  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 credit memos. Use the `cursor` parameter to paginate through the results.",
+  description: 'Returns a list of credit memos. Use the `cursor` parameter to paginate through the results.',
   inputSchema: {
     type: 'object',
     properties: {
@@ -132,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/credit-memos/retrieve-qbd-credit-memos.ts

@@ -16,7 +16,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'retrieve_qbd_credit_memos',
   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 credit memo by ID.\n\nNOTE: The response automatically includes any linked transactions.",
+    'Retrieves a credit memo 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/credit-memos/update-qbd-credit-memos.ts

@@ -15,8 +15,7 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'update_qbd_credit_memos',
-  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 credit memo.",
+  description: 'Updates an existing credit memo.',
   inputSchema: {
     type: 'object',
     properties: {
@@ -505,6 +504,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/customers/create-qbd-customers.ts

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

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

@@ -15,8 +15,7 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'list_qbd_customers',
-  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 customers. Use the `cursor` parameter to paginate through the results.",
+  description: 'Returns a list of customers. Use the `cursor` parameter to paginate through the results.',
   inputSchema: {
     type: 'object',
     properties: {
@@ -133,6 +132,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/customers/retrieve-qbd-customers.ts

@@ -15,8 +15,7 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'retrieve_qbd_customers',
-  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 customer by ID.",
+  description: 'Retrieves a customer 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/customers/update-qbd-customers.ts

@@ -15,8 +15,7 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'update_qbd_customers',
-  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 customer.",
+  description: 'Updates an existing customer.',
   inputSchema: {
     type: 'object',
     properties: {
@@ -517,6 +516,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/date-driven-terms/create-qbd-date-driven-terms.ts

@@ -64,11 +64,12 @@ export const tool: Tool = {
     },
     required: ['dueDayOfMonth', 'name', '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.dateDrivenTerms.create(body)));
+  const { jq_filter, ...body } = args as any;
+  return asTextContentResult(await maybeFilter(jq_filter, await conductor.qbd.dateDrivenTerms.create(body)));
 };
 
 export default { metadata, tool, handler };

package/src/tools/qbd/date-driven-terms/list-qbd-date-driven-terms.ts

@@ -96,11 +96,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.dateDrivenTerms.list(body)));
+  const { jq_filter, ...body } = args as any;
+  return asTextContentResult(await maybeFilter(jq_filter, await conductor.qbd.dateDrivenTerms.list(body)));
 };
 
 export default { metadata, tool, handler };

package/src/tools/qbd/date-driven-terms/retrieve-qbd-date-driven-terms.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.dateDrivenTerms.retrieve(id, body)));
+  const { id, jq_filter, ...body } = args as any;
+  return asTextContentResult(
+    await maybeFilter(jq_filter, await conductor.qbd.dateDrivenTerms.retrieve(id, body)),
+  );
 };
 
 export default { metadata, tool, handler };

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

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

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

@@ -16,7 +16,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'list_qbd_discount_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\nReturns a list of discount items. Use the `cursor` parameter to paginate through the results.",
+    'Returns a list of discount items. Use the `cursor` parameter to paginate through the results.',
   inputSchema: {
     type: 'object',
     properties: {
@@ -102,6 +102,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/discount-items/retrieve-qbd-discount-items.ts

@@ -15,8 +15,7 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'retrieve_qbd_discount_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 discount item by ID.",
+  description: 'Retrieves a discount item 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/discount-items/update-qbd-discount-items.ts

@@ -15,8 +15,7 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'update_qbd_discount_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\nUpdates an existing discount item.",
+  description: 'Updates an existing discount item.',
   inputSchema: {
     type: 'object',
     properties: {
@@ -105,6 +104,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/employees/create-qbd-employees.ts

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

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

@@ -16,7 +16,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'list_qbd_employees',
   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 employees. NOTE: QuickBooks Desktop does not support pagination for employees; hence, there is no `cursor` parameter. Users typically have few employees.",
+    'Returns a list of employees. NOTE: QuickBooks Desktop does not support pagination for employees; hence, there is no `cursor` parameter. Users typically have few employees.',
   inputSchema: {
     type: 'object',
     properties: {
@@ -88,6 +88,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/employees/retrieve-qbd-employees.ts

@@ -15,8 +15,7 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'retrieve_qbd_employees',
-  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 employee by ID.",
+  description: 'Retrieves an employee 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/employees/update-qbd-employees.ts

@@ -15,8 +15,7 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'update_qbd_employees',
-  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 employee.",
+  description: 'Updates an existing employee.',
   inputSchema: {
     type: 'object',
     properties: {
@@ -564,6 +563,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/estimates/create-qbd-estimates.ts

@@ -15,8 +15,7 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'create_qbd_estimates',
-  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 estimate.",
+  description: 'Creates a new estimate.',
   inputSchema: {
     type: 'object',
     properties: {
@@ -411,6 +410,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/estimates/delete-qbd-estimates.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.estimates.delete(id, body)));
+  const { id, jq_filter, ...body } = args as any;
+  return asTextContentResult(await maybeFilter(jq_filter, await conductor.qbd.estimates.delete(id, body)));
 };
 
 export default { metadata, tool, handler };

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

@@ -15,8 +15,7 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'list_qbd_estimates',
-  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 estimates. Use the `cursor` parameter to paginate through the results.",
+  description: 'Returns a list of estimates. Use the `cursor` parameter to paginate through the results.',
   inputSchema: {
     type: 'object',
     properties: {
@@ -131,6 +130,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/estimates/retrieve-qbd-estimates.ts

@@ -16,7 +16,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'retrieve_qbd_estimates',
   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 estimate by ID.\n\nNOTE: The response automatically includes any linked transactions.",
+    'Retrieves an estimate 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/estimates/update-qbd-estimates.ts

@@ -15,8 +15,7 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'update_qbd_estimates',
-  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 estimate.",
+  description: 'Updates an existing estimate.',
   inputSchema: {
     type: 'object',
     properties: {
@@ -480,6 +479,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/health-check-qbd.ts

@@ -35,11 +35,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.healthCheck(body)));
+  const { jq_filter, ...body } = args as any;
+  return asTextContentResult(await maybeFilter(jq_filter, await conductor.qbd.healthCheck(body)));
 };
 
 export default { metadata, tool, handler };

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

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

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

@@ -39,12 +39,15 @@ 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;
+  const { id, jq_filter, ...body } = args as any;
   return asTextContentResult(
-    await maybeFilter(args, await conductor.qbd.inventoryAdjustments.delete(id, body)),
+    await maybeFilter(jq_filter, await conductor.qbd.inventoryAdjustments.delete(id, body)),
   );
 };
 

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

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

@@ -15,8 +15,7 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'retrieve_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\nRetrieves an inventory adjustment by ID.",
+  description: 'Retrieves an inventory adjustment 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/inventory-adjustments/update-qbd-inventory-adjustments.ts

@@ -15,8 +15,7 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'update_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\nUpdates an existing inventory adjustment.",
+  description: 'Updates an existing inventory adjustment.',
   inputSchema: {
     type: 'object',
     properties: {
@@ -126,6 +125,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/inventory-assembly-items/create-qbd-inventory-assembly-items.ts

@@ -15,8 +15,7 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'create_qbd_inventory_assembly_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\nCreates a new inventory assembly item.",
+  description: 'Creates a new inventory assembly item.',
   inputSchema: {
     type: 'object',
     properties: {
@@ -167,6 +166,7 @@ export const tool: Tool = {
     },
     required: ['assetAccountId', 'cogsAccountId', 'incomeAccountId', 'name', 'conductorEndUserId'],
   },
+  annotations: {},
 };
 
 export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {

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

@@ -16,7 +16,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'list_qbd_inventory_assembly_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\nReturns a list of inventory assembly items. Use the `cursor` parameter to paginate through the results.",
+    'Returns a list of inventory assembly items. Use the `cursor` parameter to paginate through the results.',
   inputSchema: {
     type: 'object',
     properties: {
@@ -102,6 +102,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/inventory-assembly-items/retrieve-qbd-inventory-assembly-items.ts

@@ -15,8 +15,7 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'retrieve_qbd_inventory_assembly_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 an inventory assembly item by ID.",
+  description: 'Retrieves an inventory assembly item 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/inventory-assembly-items/update-qbd-inventory-assembly-items.ts

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