conductor-node-mcp 12.18.0 → 12.18.2

package/src/tools/qbd/bill-credit-card-payments/delete-qbd-bill-credit-card-payments.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.billCreditCardPayments.delete(id, body)),
+    await maybeFilter(jq_filter, await conductor.qbd.billCreditCardPayments.delete(id, body)),
   );
 };
 

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

@@ -16,7 +16,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'list_qbd_bill_credit_card_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 bill credit card payments. Use the `cursor` parameter to paginate through the results.",
+    'Returns a list of bill credit card payments. Use the `cursor` parameter to paginate through the results.',
   inputSchema: {
     type: 'object',
     properties: {
@@ -127,6 +127,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/bill-credit-card-payments/retrieve-qbd-bill-credit-card-payments.ts

@@ -15,8 +15,7 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'retrieve_qbd_bill_credit_card_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 bill credit card payment by ID.",
+  description: 'Retrieves a bill credit card 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/bills/create-qbd-bills.ts

@@ -15,8 +15,7 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'create_qbd_bills',
-  description:
-    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nCreates a new bill.",
+  description: 'Creates a new bill.',
   inputSchema: {
     type: 'object',
     properties: {
@@ -405,6 +404,7 @@ export const tool: Tool = {
     },
     required: ['transactionDate', 'vendorId', 'conductorEndUserId'],
   },
+  annotations: {},
 };
 
 export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {

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

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

@@ -15,8 +15,7 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'list_qbd_bills',
-  description:
-    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nReturns a list of bills. Use the `cursor` parameter to paginate through the results.",
+  description: 'Returns a list of bills. Use the `cursor` parameter to paginate through the results.',
   inputSchema: {
     type: 'object',
     properties: {
@@ -136,6 +135,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/bills/retrieve-qbd-bills.ts

@@ -16,7 +16,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'retrieve_qbd_bills',
   description:
-    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nRetrieves a bill by ID.\n\nNOTE: The response automatically includes any linked transactions.",
+    'Retrieves a bill 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/bills/update-qbd-bills.ts

@@ -15,8 +15,7 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'update_qbd_bills',
-  description:
-    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nUpdates an existing bill.",
+  description: 'Updates an existing bill.',
   inputSchema: {
     type: 'object',
     properties: {
@@ -441,6 +440,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/build-assemblies/create-qbd-build-assemblies.ts

@@ -15,8 +15,7 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'create_qbd_build_assemblies',
-  description:
-    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nCreates a new build assembly.",
+  description: 'Creates a new build assembly.',
   inputSchema: {
     type: 'object',
     properties: {
@@ -88,6 +87,7 @@ export const tool: Tool = {
     },
     required: ['inventoryAssemblyItemId', 'quantityToBuild', 'transactionDate', 'conductorEndUserId'],
   },
+  annotations: {},
 };
 
 export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {

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

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

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

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

@@ -15,8 +15,7 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'update_qbd_build_assemblies',
-  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 build assembly.",
+  description: 'Updates an existing build assembly.',
   inputSchema: {
     type: 'object',
     properties: {
@@ -92,6 +91,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/checks/create-qbd-checks.ts

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

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

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

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

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

@@ -15,8 +15,7 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'update_qbd_checks',
-  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 check.",
+  description: 'Updates an existing check.',
   inputSchema: {
     type: 'object',
     properties: {
@@ -456,6 +455,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/classes/create-qbd-classes.ts

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

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

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

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

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

@@ -59,11 +59,12 @@ export const tool: Tool = {
     },
     required: ['id', 'revisionNumber', 'conductorEndUserId'],
   },
+  annotations: {},
 };
 
 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.classes.update(id, body)));
+  const { id, jq_filter, ...body } = args as any;
+  return asTextContentResult(await maybeFilter(jq_filter, await conductor.qbd.classes.update(id, body)));
 };
 
 export default { metadata, tool, handler };

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

@@ -16,7 +16,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'retrieve_qbd_company',
   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 detailed information about the connected QuickBooks company file, including company address, legal name, preferences, and subscribed services. Note that company information cannot be modified through the API, only through the QuickBooks Desktop user interface.",
+    'Returns detailed information about the connected QuickBooks company file, including company address, legal name, preferences, and subscribed services. Note that company information 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/credit-card-charges/create-qbd-credit-card-charges.ts

@@ -15,8 +15,7 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'create_qbd_credit_card_charges',
-  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 credit card charge for the specified account.",
+  description: 'Creates a new credit card charge for the specified account.',
   inputSchema: {
     type: 'object',
     properties: {
@@ -337,6 +336,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/credit-card-charges/delete-qbd-credit-card-charges.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.creditCardCharges.delete(id, body)));
+  const { id, jq_filter, ...body } = args as any;
+  return asTextContentResult(
+    await maybeFilter(jq_filter, await conductor.qbd.creditCardCharges.delete(id, body)),
+  );
 };
 
 export default { metadata, tool, handler };

package/src/tools/qbd/credit-card-charges/list-qbd-credit-card-charges.ts

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

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

@@ -15,8 +15,7 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'update_qbd_credit_card_charges',
-  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 card charge.",
+  description: 'Updates an existing credit card charge.',
   inputSchema: {
     type: 'object',
     properties: {
@@ -380,6 +379,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/credit-card-credits/create-qbd-credit-card-credits.ts

@@ -15,8 +15,7 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'create_qbd_credit_card_credits',
-  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 credit card credit for the specified account.",
+  description: 'Creates a new credit card credit for the specified account.',
   inputSchema: {
     type: 'object',
     properties: {
@@ -337,6 +336,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/credit-card-credits/delete-qbd-credit-card-credits.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.creditCardCredits.delete(id, body)));
+  const { id, jq_filter, ...body } = args as any;
+  return asTextContentResult(
+    await maybeFilter(jq_filter, await conductor.qbd.creditCardCredits.delete(id, body)),
+  );
 };
 
 export default { metadata, tool, handler };

package/src/tools/qbd/credit-card-credits/list-qbd-credit-card-credits.ts

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

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

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

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