conductor-node-mcp 13.1.0 → 14.0.0

package/src/tools/qbd/standard-terms/list-qbd-standard-terms.ts

@@ -1,115 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-import { isJqError, maybeFilter } from 'conductor-node-mcp/filtering';
-import { Metadata, asErrorResult, asTextContentResult } from 'conductor-node-mcp/tools/types';
-
-import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import Conductor from 'conductor-node';
-
-export const metadata: Metadata = {
-  resource: 'qbd.standard_terms',
-  operation: 'read',
-  tags: [],
-  httpMethod: 'get',
-  httpPath: '/quickbooks-desktop/standard-terms',
-};
-
-export const tool: Tool = {
-  name: 'list_qbd_standard_terms',
-  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 standard terms. NOTE: QuickBooks Desktop does not support pagination for standard terms; hence, there is no `cursor` parameter. Users typically have few standard terms.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/standard_term_list_response',\n  $defs: {\n    standard_term_list_response: {\n      type: 'object',\n      properties: {\n        data: {\n          type: 'array',\n          description: 'The array of standard terms.',\n          items: {\n            $ref: '#/$defs/standard_term'\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    standard_term: {\n      type: 'object',\n      title: 'The Standard Term object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The unique identifier assigned by QuickBooks to this standard term. This ID is unique across all standard terms but not across different QuickBooks object types.'\n        },\n        createdAt: {\n          type: 'string',\n          description: 'The date and time when this standard term 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        discountDays: {\n          type: 'number',\n          description: 'The number of days within which payment must be received to qualify for the discount specified by `discountPercentage`.'\n        },\n        discountPercentage: {\n          type: 'string',\n          description: 'The discount percentage applied to the payment if received within the number of days specified by `discountDays`. The value is between 0 and 100.'\n        },\n        dueDays: {\n          type: 'number',\n          description: 'The number of days until payment is due.'\n        },\n        isActive: {\n          type: 'boolean',\n          description: 'Indicates whether this standard term 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 standard term, unique across all standard terms.\\n\\n**NOTE**: Standard terms 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_standard_term\"`.',\n          enum: [            'qbd_standard_term'\n          ]\n        },\n        revisionNumber: {\n          type: 'string',\n          description: 'The current QuickBooks-assigned revision number of this standard term 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 standard term 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        'discountDays',\n        'discountPercentage',\n        'dueDays',\n        'isActive',\n        'name',\n        'objectType',\n        'revisionNumber',\n        'updatedAt'\n      ]\n    }\n  }\n}\n```",
-  inputSchema: {
-    type: 'object',
-    properties: {
-      conductorEndUserId: {
-        type: 'string',
-        description: 'The ID of the End-User to receive this request.',
-      },
-      ids: {
-        type: 'array',
-        description:
-          'Filter for specific standard terms by their QuickBooks-assigned unique identifier(s).\n\n**IMPORTANT**: If you include this parameter, QuickBooks will ignore all other query parameters for this request.\n\n**NOTE**: If any of the values you specify in this parameter are not found, the request will return an error.',
-        items: {
-          type: 'string',
-        },
-      },
-      limit: {
-        type: 'integer',
-        description:
-          'The maximum number of objects to return.\n\n**IMPORTANT**: QuickBooks Desktop does not support cursor-based pagination for standard terms. This parameter will limit the response size, but you cannot fetch subsequent results using a cursor. For pagination, use the name-range parameters instead (e.g., `nameFrom=A&nameTo=B`).\n\nWhen this parameter is omitted, the endpoint returns all standard terms without limit, unlike paginated endpoints which default to 150 records. This is acceptable because standard terms typically have low record counts.',
-      },
-      nameContains: {
-        type: 'string',
-        description:
-          'Filter for standard terms whose `name` contains this substring, case-insensitive.\n\n**NOTE**: If you use this parameter, you cannot also use `nameStartsWith` or `nameEndsWith`.',
-      },
-      nameEndsWith: {
-        type: 'string',
-        description:
-          'Filter for standard terms whose `name` ends with this substring, case-insensitive.\n\n**NOTE**: If you use this parameter, you cannot also use `nameContains` or `nameStartsWith`.',
-      },
-      nameFrom: {
-        type: 'string',
-        description:
-          'Filter for standard terms whose `name` is alphabetically greater than or equal to this value.',
-      },
-      names: {
-        type: 'array',
-        description:
-          'Filter for specific standard terms by their name(s), case-insensitive. Like `id`, `name` is a unique identifier for a standard term.\n\n**IMPORTANT**: If you include this parameter, QuickBooks will ignore all other query parameters for this request.\n\n**NOTE**: If any of the values you specify in this parameter are not found, the request will return an error.',
-        items: {
-          type: 'string',
-        },
-      },
-      nameStartsWith: {
-        type: 'string',
-        description:
-          'Filter for standard terms whose `name` starts with this substring, case-insensitive.\n\n**NOTE**: If you use this parameter, you cannot also use `nameContains` or `nameEndsWith`.',
-      },
-      nameTo: {
-        type: 'string',
-        description:
-          'Filter for standard terms whose `name` is alphabetically less than or equal to this value.',
-      },
-      status: {
-        type: 'string',
-        description: 'Filter for standard terms that are active, inactive, or both.',
-        enum: ['active', 'all', 'inactive'],
-      },
-      updatedAfter: {
-        type: 'string',
-        description:
-          "Filter for standard terms updated on or after this date/time. Accepts the following ISO 8601 formats:\n- **date-only** (YYYY-MM-DD) - QuickBooks Desktop interprets the date as the **start of the specified day** in the local timezone of the end-user's computer (e.g., `2025-01-01` → `2025-01-01T00:00:00`).\n- **datetime without timezone** (YYYY-MM-DDTHH:mm:ss) - QuickBooks Desktop interprets the timestamp in the local timezone of the end-user's computer.\n- **datetime with timezone** (YYYY-MM-DDTHH:mm:ss±HH:mm) - QuickBooks Desktop interprets the timestamp using the specified timezone.",
-      },
-      updatedBefore: {
-        type: 'string',
-        description:
-          "Filter for standard terms updated on or before this date/time. Accepts the following ISO 8601 formats:\n- **date-only** (YYYY-MM-DD) - QuickBooks Desktop interprets the date as the **end of the specified day** in the local timezone of the end-user's computer (e.g., `2025-01-01` → `2025-01-01T23:59:59`).\n- **datetime without timezone** (YYYY-MM-DDTHH:mm:ss) - QuickBooks Desktop interprets the timestamp in the local timezone of the end-user's computer.\n- **datetime with timezone** (YYYY-MM-DDTHH:mm:ss±HH:mm) - QuickBooks Desktop interprets the timestamp using the specified timezone.",
-      },
-      jq_filter: {
-        type: 'string',
-        title: 'jq Filter',
-        description:
-          'A jq filter to apply to the response to include certain fields. Consult the output schema in the tool description to see the fields that are available.\n\nFor example: to include only the `name` field in every object of a results array, you can provide ".results[].name".\n\nFor more information, see the [jq documentation](https://jqlang.org/manual/).',
-      },
-    },
-    required: ['conductorEndUserId'],
-  },
-  annotations: {
-    readOnlyHint: true,
-  },
-};
-
-export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {
-  const { jq_filter, ...body } = args as any;
-  try {
-    return asTextContentResult(await maybeFilter(jq_filter, await conductor.qbd.standardTerms.list(body)));
-  } catch (error) {
-    if (error instanceof Conductor.APIError || isJqError(error)) {
-      return asErrorResult(error.message);
-    }
-    throw error;
-  }
-};
-
-export default { metadata, tool, handler };

package/src/tools/qbd/standard-terms/retrieve-qbd-standard-terms.ts

@@ -1,60 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-import { isJqError, maybeFilter } from 'conductor-node-mcp/filtering';
-import { Metadata, asErrorResult, asTextContentResult } from 'conductor-node-mcp/tools/types';
-
-import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import Conductor from 'conductor-node';
-
-export const metadata: Metadata = {
-  resource: 'qbd.standard_terms',
-  operation: 'read',
-  tags: [],
-  httpMethod: 'get',
-  httpPath: '/quickbooks-desktop/standard-terms/{id}',
-};
-
-export const tool: Tool = {
-  name: 'retrieve_qbd_standard_terms',
-  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 standard term by ID.\n\n**IMPORTANT:** If you need to fetch multiple specific standard terms 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/standard_term',\n  $defs: {\n    standard_term: {\n      type: 'object',\n      title: 'The Standard Term object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The unique identifier assigned by QuickBooks to this standard term. This ID is unique across all standard terms but not across different QuickBooks object types.'\n        },\n        createdAt: {\n          type: 'string',\n          description: 'The date and time when this standard term 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        discountDays: {\n          type: 'number',\n          description: 'The number of days within which payment must be received to qualify for the discount specified by `discountPercentage`.'\n        },\n        discountPercentage: {\n          type: 'string',\n          description: 'The discount percentage applied to the payment if received within the number of days specified by `discountDays`. The value is between 0 and 100.'\n        },\n        dueDays: {\n          type: 'number',\n          description: 'The number of days until payment is due.'\n        },\n        isActive: {\n          type: 'boolean',\n          description: 'Indicates whether this standard term 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 standard term, unique across all standard terms.\\n\\n**NOTE**: Standard terms 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_standard_term\"`.',\n          enum: [            'qbd_standard_term'\n          ]\n        },\n        revisionNumber: {\n          type: 'string',\n          description: 'The current QuickBooks-assigned revision number of this standard term 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 standard term 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        'discountDays',\n        'discountPercentage',\n        'dueDays',\n        'isActive',\n        'name',\n        'objectType',\n        'revisionNumber',\n        'updatedAt'\n      ]\n    }\n  }\n}\n```",
-  inputSchema: {
-    type: 'object',
-    properties: {
-      id: {
-        type: 'string',
-        description: 'The QuickBooks-assigned unique identifier of the standard term to retrieve.',
-      },
-      conductorEndUserId: {
-        type: 'string',
-        description: 'The ID of the End-User to receive this request.',
-      },
-      jq_filter: {
-        type: 'string',
-        title: 'jq Filter',
-        description:
-          'A jq filter to apply to the response to include certain fields. Consult the output schema in the tool description to see the fields that are available.\n\nFor example: to include only the `name` field in every object of a results array, you can provide ".results[].name".\n\nFor more information, see the [jq documentation](https://jqlang.org/manual/).',
-      },
-    },
-    required: ['id', 'conductorEndUserId'],
-  },
-  annotations: {
-    readOnlyHint: true,
-  },
-};
-
-export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {
-  const { id, jq_filter, ...body } = args as any;
-  try {
-    return asTextContentResult(
-      await maybeFilter(jq_filter, await conductor.qbd.standardTerms.retrieve(id, body)),
-    );
-  } catch (error) {
-    if (error instanceof Conductor.APIError || isJqError(error)) {
-      return asErrorResult(error.message);
-    }
-    throw error;
-  }
-};
-
-export default { metadata, tool, handler };

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

@@ -1,90 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-import { isJqError, maybeFilter } from 'conductor-node-mcp/filtering';
-import { Metadata, asErrorResult, asTextContentResult } from 'conductor-node-mcp/tools/types';
-
-import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import Conductor from 'conductor-node';
-
-export const metadata: Metadata = {
-  resource: 'qbd.subtotal_items',
-  operation: 'write',
-  tags: [],
-  httpMethod: 'post',
-  httpPath: '/quickbooks-desktop/subtotal-items',
-};
-
-export const tool: Tool = {
-  name: 'create_qbd_subtotal_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 subtotal item.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/subtotal_item',\n  $defs: {\n    subtotal_item: {\n      type: 'object',\n      title: 'The Subtotal Item object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The unique identifier assigned by QuickBooks to this subtotal item. This ID is unique across all subtotal items but not across different QuickBooks object types.'\n        },\n        barcode: {\n          type: 'string',\n          description: 'The subtotal item\\'s barcode.'\n        },\n        createdAt: {\n          type: 'string',\n          description: 'The date and time when this subtotal 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        customFields: {\n          type: 'array',\n          description: 'The custom fields for the subtotal item 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 subtotal item\\'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 subtotal 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 subtotal item, unique across all subtotal items.\\n\\n**NOTE**: Subtotal 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_subtotal_item\"`.',\n          enum: [            'qbd_subtotal_item'\n          ]\n        },\n        revisionNumber: {\n          type: 'string',\n          description: 'The current QuickBooks-assigned revision number of this subtotal 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        specialItemType: {\n          type: 'string',\n          description: 'The type of special item for this subtotal item.',\n          enum: [            'finance_charge',\n            'reimbursable_expense_group',\n            'reimbursable_expense_subtotal'\n          ]\n        },\n        updatedAt: {\n          type: 'string',\n          description: 'The date and time when this subtotal 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      },\n      required: [        'id',\n        'barcode',\n        'createdAt',\n        'customFields',\n        'description',\n        'externalId',\n        'isActive',\n        'name',\n        'objectType',\n        'revisionNumber',\n        'specialItemType',\n        'updatedAt'\n      ]\n    }\n  }\n}\n```",
-  inputSchema: {
-    type: 'object',
-    properties: {
-      name: {
-        type: 'string',
-        description:
-          'The case-insensitive unique name of this subtotal item, unique across all subtotal items.\n\n**NOTE**: Subtotal 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\nMaximum length: 31 characters.',
-      },
-      conductorEndUserId: {
-        type: 'string',
-        description: 'The ID of the End-User to receive this request.',
-      },
-      barcode: {
-        type: 'object',
-        description: "The subtotal item's barcode.",
-        properties: {
-          allowOverride: {
-            type: 'boolean',
-            description: 'Indicates whether to allow the barcode to be overridden.',
-          },
-          assignEvenIfUsed: {
-            type: 'boolean',
-            description: 'Indicates whether to assign the barcode even if it is already used.',
-          },
-          value: {
-            type: 'string',
-            description: "The item's barcode value.",
-          },
-        },
-      },
-      description: {
-        type: 'string',
-        description:
-          "The subtotal item's description that will appear on sales forms that include this item.",
-      },
-      externalId: {
-        type: 'string',
-        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**IMPORTANT**: This field must be formatted as a valid GUID; otherwise, QuickBooks will return an error.',
-      },
-      isActive: {
-        type: 'boolean',
-        description:
-          'Indicates whether this subtotal item is active. Inactive objects are typically hidden from views and reports in QuickBooks. Defaults to `true`.',
-      },
-      jq_filter: {
-        type: 'string',
-        title: 'jq Filter',
-        description:
-          'A jq filter to apply to the response to include certain fields. Consult the output schema in the tool description to see the fields that are available.\n\nFor example: to include only the `name` field in every object of a results array, you can provide ".results[].name".\n\nFor more information, see the [jq documentation](https://jqlang.org/manual/).',
-      },
-    },
-    required: ['name', 'conductorEndUserId'],
-  },
-  annotations: {},
-};
-
-export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {
-  const { jq_filter, ...body } = args as any;
-  try {
-    return asTextContentResult(await maybeFilter(jq_filter, await conductor.qbd.subtotalItems.create(body)));
-  } catch (error) {
-    if (error instanceof Conductor.APIError || isJqError(error)) {
-      return asErrorResult(error.message);
-    }
-    throw error;
-  }
-};
-
-export default { metadata, tool, handler };

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

@@ -1,114 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-import { Metadata, asErrorResult, asTextContentResult } from 'conductor-node-mcp/tools/types';
-
-import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import Conductor from 'conductor-node';
-
-export const metadata: Metadata = {
-  resource: 'qbd.subtotal_items',
-  operation: 'read',
-  tags: [],
-  httpMethod: 'get',
-  httpPath: '/quickbooks-desktop/subtotal-items',
-};
-
-export const tool: Tool = {
-  name: 'list_qbd_subtotal_items',
-  description:
-    'Returns a list of subtotal items. Use the `cursor` parameter to paginate through the results.',
-  inputSchema: {
-    type: 'object',
-    properties: {
-      conductorEndUserId: {
-        type: 'string',
-        description: 'The ID of the End-User to receive this request.',
-      },
-      cursor: {
-        type: 'string',
-        description:
-          'The pagination token to fetch the next set of results when paginating with the `limit` parameter. Do not include this parameter on the first call. Use the `nextCursor` value returned in the previous response to request subsequent results.',
-      },
-      ids: {
-        type: 'array',
-        description:
-          'Filter for specific subtotal items by their QuickBooks-assigned unique identifier(s).\n\n**IMPORTANT**: If you include this parameter, QuickBooks will ignore all other query parameters for this request.\n\n**NOTE**: If any of the values you specify in this parameter are not found, the request will return an error.',
-        items: {
-          type: 'string',
-        },
-      },
-      limit: {
-        type: 'integer',
-        description:
-          'The maximum number of objects to return. Accepts values ranging from 1 to 150, defaults to 150. When used with cursor-based pagination, this parameter controls how many results are returned per page. To paginate through results, combine this with the `cursor` parameter. Each response will include a `nextCursor` value that can be passed to subsequent requests to retrieve the next page of results.',
-      },
-      nameContains: {
-        type: 'string',
-        description:
-          'Filter for subtotal items whose `name` contains this substring, case-insensitive.\n\n**NOTE**: If you use this parameter, you cannot also use `nameStartsWith` or `nameEndsWith`.',
-      },
-      nameEndsWith: {
-        type: 'string',
-        description:
-          'Filter for subtotal items whose `name` ends with this substring, case-insensitive.\n\n**NOTE**: If you use this parameter, you cannot also use `nameContains` or `nameStartsWith`.',
-      },
-      nameFrom: {
-        type: 'string',
-        description:
-          'Filter for subtotal items whose `name` is alphabetically greater than or equal to this value.',
-      },
-      names: {
-        type: 'array',
-        description:
-          'Filter for specific subtotal items by their name(s), case-insensitive. Like `id`, `name` is a unique identifier for a subtotal item.\n\n**IMPORTANT**: If you include this parameter, QuickBooks will ignore all other query parameters for this request.\n\n**NOTE**: If any of the values you specify in this parameter are not found, the request will return an error.',
-        items: {
-          type: 'string',
-        },
-      },
-      nameStartsWith: {
-        type: 'string',
-        description:
-          'Filter for subtotal items whose `name` starts with this substring, case-insensitive.\n\n**NOTE**: If you use this parameter, you cannot also use `nameContains` or `nameEndsWith`.',
-      },
-      nameTo: {
-        type: 'string',
-        description:
-          'Filter for subtotal items whose `name` is alphabetically less than or equal to this value.',
-      },
-      status: {
-        type: 'string',
-        description: 'Filter for subtotal items that are active, inactive, or both.',
-        enum: ['active', 'all', 'inactive'],
-      },
-      updatedAfter: {
-        type: 'string',
-        description:
-          "Filter for subtotal items updated on or after this date/time. Accepts the following ISO 8601 formats:\n- **date-only** (YYYY-MM-DD) - QuickBooks Desktop interprets the date as the **start of the specified day** in the local timezone of the end-user's computer (e.g., `2025-01-01` → `2025-01-01T00:00:00`).\n- **datetime without timezone** (YYYY-MM-DDTHH:mm:ss) - QuickBooks Desktop interprets the timestamp in the local timezone of the end-user's computer.\n- **datetime with timezone** (YYYY-MM-DDTHH:mm:ss±HH:mm) - QuickBooks Desktop interprets the timestamp using the specified timezone.",
-      },
-      updatedBefore: {
-        type: 'string',
-        description:
-          "Filter for subtotal items updated on or before this date/time. Accepts the following ISO 8601 formats:\n- **date-only** (YYYY-MM-DD) - QuickBooks Desktop interprets the date as the **end of the specified day** in the local timezone of the end-user's computer (e.g., `2025-01-01` → `2025-01-01T23:59:59`).\n- **datetime without timezone** (YYYY-MM-DDTHH:mm:ss) - QuickBooks Desktop interprets the timestamp in the local timezone of the end-user's computer.\n- **datetime with timezone** (YYYY-MM-DDTHH:mm:ss±HH:mm) - QuickBooks Desktop interprets the timestamp using the specified timezone.",
-      },
-    },
-    required: ['conductorEndUserId'],
-  },
-  annotations: {
-    readOnlyHint: true,
-  },
-};
-
-export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {
-  const body = args as any;
-  const response = await conductor.qbd.subtotalItems.list(body).asResponse();
-  try {
-    return asTextContentResult(await response.json());
-  } catch (error) {
-    if (error instanceof Conductor.APIError) {
-      return asErrorResult(error.message);
-    }
-    throw error;
-  }
-};
-
-export default { metadata, tool, handler };

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

@@ -1,60 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-import { isJqError, maybeFilter } from 'conductor-node-mcp/filtering';
-import { Metadata, asErrorResult, asTextContentResult } from 'conductor-node-mcp/tools/types';
-
-import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import Conductor from 'conductor-node';
-
-export const metadata: Metadata = {
-  resource: 'qbd.subtotal_items',
-  operation: 'read',
-  tags: [],
-  httpMethod: 'get',
-  httpPath: '/quickbooks-desktop/subtotal-items/{id}',
-};
-
-export const tool: Tool = {
-  name: 'retrieve_qbd_subtotal_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 subtotal item by ID.\n\n**IMPORTANT:** If you need to fetch multiple specific subtotal 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/subtotal_item',\n  $defs: {\n    subtotal_item: {\n      type: 'object',\n      title: 'The Subtotal Item object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The unique identifier assigned by QuickBooks to this subtotal item. This ID is unique across all subtotal items but not across different QuickBooks object types.'\n        },\n        barcode: {\n          type: 'string',\n          description: 'The subtotal item\\'s barcode.'\n        },\n        createdAt: {\n          type: 'string',\n          description: 'The date and time when this subtotal 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        customFields: {\n          type: 'array',\n          description: 'The custom fields for the subtotal item 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 subtotal item\\'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 subtotal 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 subtotal item, unique across all subtotal items.\\n\\n**NOTE**: Subtotal 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_subtotal_item\"`.',\n          enum: [            'qbd_subtotal_item'\n          ]\n        },\n        revisionNumber: {\n          type: 'string',\n          description: 'The current QuickBooks-assigned revision number of this subtotal 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        specialItemType: {\n          type: 'string',\n          description: 'The type of special item for this subtotal item.',\n          enum: [            'finance_charge',\n            'reimbursable_expense_group',\n            'reimbursable_expense_subtotal'\n          ]\n        },\n        updatedAt: {\n          type: 'string',\n          description: 'The date and time when this subtotal 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      },\n      required: [        'id',\n        'barcode',\n        'createdAt',\n        'customFields',\n        'description',\n        'externalId',\n        'isActive',\n        'name',\n        'objectType',\n        'revisionNumber',\n        'specialItemType',\n        'updatedAt'\n      ]\n    }\n  }\n}\n```",
-  inputSchema: {
-    type: 'object',
-    properties: {
-      id: {
-        type: 'string',
-        description: 'The QuickBooks-assigned unique identifier of the subtotal item to retrieve.',
-      },
-      conductorEndUserId: {
-        type: 'string',
-        description: 'The ID of the End-User to receive this request.',
-      },
-      jq_filter: {
-        type: 'string',
-        title: 'jq Filter',
-        description:
-          'A jq filter to apply to the response to include certain fields. Consult the output schema in the tool description to see the fields that are available.\n\nFor example: to include only the `name` field in every object of a results array, you can provide ".results[].name".\n\nFor more information, see the [jq documentation](https://jqlang.org/manual/).',
-      },
-    },
-    required: ['id', 'conductorEndUserId'],
-  },
-  annotations: {
-    readOnlyHint: true,
-  },
-};
-
-export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {
-  const { id, jq_filter, ...body } = args as any;
-  try {
-    return asTextContentResult(
-      await maybeFilter(jq_filter, await conductor.qbd.subtotalItems.retrieve(id, body)),
-    );
-  } catch (error) {
-    if (error instanceof Conductor.APIError || isJqError(error)) {
-      return asErrorResult(error.message);
-    }
-    throw error;
-  }
-};
-
-export default { metadata, tool, handler };

package/src/tools/qbd/subtotal-items/update-qbd-subtotal-items.ts

@@ -1,96 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-import { isJqError, maybeFilter } from 'conductor-node-mcp/filtering';
-import { Metadata, asErrorResult, asTextContentResult } from 'conductor-node-mcp/tools/types';
-
-import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import Conductor from 'conductor-node';
-
-export const metadata: Metadata = {
-  resource: 'qbd.subtotal_items',
-  operation: 'write',
-  tags: [],
-  httpMethod: 'post',
-  httpPath: '/quickbooks-desktop/subtotal-items/{id}',
-};
-
-export const tool: Tool = {
-  name: 'update_qbd_subtotal_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 subtotal item.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/subtotal_item',\n  $defs: {\n    subtotal_item: {\n      type: 'object',\n      title: 'The Subtotal Item object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The unique identifier assigned by QuickBooks to this subtotal item. This ID is unique across all subtotal items but not across different QuickBooks object types.'\n        },\n        barcode: {\n          type: 'string',\n          description: 'The subtotal item\\'s barcode.'\n        },\n        createdAt: {\n          type: 'string',\n          description: 'The date and time when this subtotal 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        customFields: {\n          type: 'array',\n          description: 'The custom fields for the subtotal item 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 subtotal item\\'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 subtotal 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 subtotal item, unique across all subtotal items.\\n\\n**NOTE**: Subtotal 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_subtotal_item\"`.',\n          enum: [            'qbd_subtotal_item'\n          ]\n        },\n        revisionNumber: {\n          type: 'string',\n          description: 'The current QuickBooks-assigned revision number of this subtotal 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        specialItemType: {\n          type: 'string',\n          description: 'The type of special item for this subtotal item.',\n          enum: [            'finance_charge',\n            'reimbursable_expense_group',\n            'reimbursable_expense_subtotal'\n          ]\n        },\n        updatedAt: {\n          type: 'string',\n          description: 'The date and time when this subtotal 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      },\n      required: [        'id',\n        'barcode',\n        'createdAt',\n        'customFields',\n        'description',\n        'externalId',\n        'isActive',\n        'name',\n        'objectType',\n        'revisionNumber',\n        'specialItemType',\n        'updatedAt'\n      ]\n    }\n  }\n}\n```",
-  inputSchema: {
-    type: 'object',
-    properties: {
-      id: {
-        type: 'string',
-        description: 'The QuickBooks-assigned unique identifier of the subtotal item to update.',
-      },
-      revisionNumber: {
-        type: 'string',
-        description:
-          "The current QuickBooks-assigned revision number of the subtotal item object you are updating, which you can get by fetching the object first. Provide the most recent `revisionNumber` to ensure you're working with the latest data; otherwise, the update will return an error.",
-      },
-      conductorEndUserId: {
-        type: 'string',
-        description: 'The ID of the End-User to receive this request.',
-      },
-      barcode: {
-        type: 'object',
-        description: "The subtotal item's barcode.",
-        properties: {
-          allowOverride: {
-            type: 'boolean',
-            description: 'Indicates whether to allow the barcode to be overridden.',
-          },
-          assignEvenIfUsed: {
-            type: 'boolean',
-            description: 'Indicates whether to assign the barcode even if it is already used.',
-          },
-          value: {
-            type: 'string',
-            description: "The item's barcode value.",
-          },
-        },
-      },
-      description: {
-        type: 'string',
-        description:
-          "The subtotal item's description that will appear on sales forms that include this item.",
-      },
-      isActive: {
-        type: 'boolean',
-        description:
-          'Indicates whether this subtotal item is active. Inactive objects are typically hidden from views and reports in QuickBooks. Defaults to `true`.',
-      },
-      name: {
-        type: 'string',
-        description:
-          'The case-insensitive unique name of this subtotal item, unique across all subtotal items.\n\n**NOTE**: Subtotal 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\nMaximum length: 31 characters.',
-      },
-      jq_filter: {
-        type: 'string',
-        title: 'jq Filter',
-        description:
-          'A jq filter to apply to the response to include certain fields. Consult the output schema in the tool description to see the fields that are available.\n\nFor example: to include only the `name` field in every object of a results array, you can provide ".results[].name".\n\nFor more information, see the [jq documentation](https://jqlang.org/manual/).',
-      },
-    },
-    required: ['id', 'revisionNumber', 'conductorEndUserId'],
-  },
-  annotations: {},
-};
-
-export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {
-  const { id, jq_filter, ...body } = args as any;
-  try {
-    return asTextContentResult(
-      await maybeFilter(jq_filter, await conductor.qbd.subtotalItems.update(id, body)),
-    );
-  } catch (error) {
-    if (error instanceof Conductor.APIError || isJqError(error)) {
-      return asErrorResult(error.message);
-    }
-    throw error;
-  }
-};
-
-export default { metadata, tool, handler };

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

@@ -1,54 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-import { isJqError, maybeFilter } from 'conductor-node-mcp/filtering';
-import { Metadata, asErrorResult, asTextContentResult } from 'conductor-node-mcp/tools/types';
-
-import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import Conductor from 'conductor-node';
-
-export const metadata: Metadata = {
-  resource: 'qbd.templates',
-  operation: 'read',
-  tags: [],
-  httpMethod: 'get',
-  httpPath: '/quickbooks-desktop/templates',
-};
-
-export const tool: Tool = {
-  name: 'list_qbd_templates',
-  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 templates. Use the `cursor` parameter to paginate through the results.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/template_list_response',\n  $defs: {\n    template_list_response: {\n      type: 'object',\n      properties: {\n        data: {\n          type: 'array',\n          description: 'The array of templates.',\n          items: {\n            $ref: '#/$defs/template'\n          }\n        },\n        hasMore: {\n          type: 'boolean',\n          description: 'Indicates whether there are more objects to be fetched.'\n        },\n        nextCursor: {\n          type: 'string',\n          description: 'The `nextCursor` is a pagination token returned in the response when you use the `limit` parameter in your request. To retrieve subsequent pages of results, include this token as the value of the `cursor` request parameter in your following API calls.\\n\\n**NOTE**: The `nextCursor` value remains constant throughout the pagination process for a specific list instance; continue to use the same `nextCursor` token in each request to fetch additional pages.'\n        },\n        objectType: {\n          type: 'string',\n          description: 'The type of object. This value is always `\"list\"`.',\n          enum: [            'list'\n          ]\n        },\n        remainingCount: {\n          type: 'number',\n          description: 'The number of objects remaining to be fetched.'\n        },\n        url: {\n          type: 'string',\n          description: 'The endpoint URL where this list can be accessed.'\n        }\n      },\n      required: [        'data',\n        'hasMore',\n        'nextCursor',\n        'objectType',\n        'remainingCount',\n        'url'\n      ]\n    },\n    template: {\n      type: 'object',\n      title: 'The Template object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The unique identifier assigned by QuickBooks to this template. This ID is unique across all templates but not across different QuickBooks object types.'\n        },\n        createdAt: {\n          type: 'string',\n          description: 'The date and time when this template 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 template 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 template, unique across all templates.\\n\\n**NOTE**: Templates 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_template\"`.',\n          enum: [            'qbd_template'\n          ]\n        },\n        revisionNumber: {\n          type: 'string',\n          description: 'The current QuickBooks-assigned revision number of this template 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        templateType: {\n          type: 'string',\n          description: 'The type of transaction that this template is used for.',\n          enum: [            'bill_payment',\n            'build_assembly',\n            'credit_memo',\n            'estimate',\n            'invoice',\n            'payment_receipt',\n            'purchase_order',\n            'sales_order',\n            'sales_receipt'\n          ]\n        },\n        updatedAt: {\n          type: 'string',\n          description: 'The date and time when this template 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        'revisionNumber',\n        'templateType',\n        'updatedAt'\n      ]\n    }\n  }\n}\n```",
-  inputSchema: {
-    type: 'object',
-    properties: {
-      conductorEndUserId: {
-        type: 'string',
-        description: 'The ID of the End-User to receive this request.',
-      },
-      jq_filter: {
-        type: 'string',
-        title: 'jq Filter',
-        description:
-          'A jq filter to apply to the response to include certain fields. Consult the output schema in the tool description to see the fields that are available.\n\nFor example: to include only the `name` field in every object of a results array, you can provide ".results[].name".\n\nFor more information, see the [jq documentation](https://jqlang.org/manual/).',
-      },
-    },
-    required: ['conductorEndUserId'],
-  },
-  annotations: {
-    readOnlyHint: true,
-  },
-};
-
-export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {
-  const { jq_filter, ...body } = args as any;
-  try {
-    return asTextContentResult(await maybeFilter(jq_filter, await conductor.qbd.templates.list(body)));
-  } catch (error) {
-    if (error instanceof Conductor.APIError || isJqError(error)) {
-      return asErrorResult(error.message);
-    }
-    throw error;
-  }
-};
-
-export default { metadata, tool, handler };