conductor-node-mcp 13.1.0 → 14.0.0

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

@@ -1,98 +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.currencies',
-  operation: 'write',
-  tags: [],
-  httpMethod: 'post',
-  httpPath: '/quickbooks-desktop/currencies',
-};
-
-export const tool: Tool = {
-  name: 'create_qbd_currencies',
-  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 user-defined currency with the specified name and currency code. Exchange rates for user-defined currencies are not updated automatically by QuickBooks Desktop; update them manually as needed.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/currency',\n  $defs: {\n    currency: {\n      type: 'object',\n      title: 'The Currency object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The unique identifier assigned by QuickBooks to this currency. This ID is unique across all currencies but not across different QuickBooks object types.'\n        },\n        asOfDate: {\n          type: 'string',\n          description: 'The date when the exchange rate for this currency was last updated, in ISO 8601 format (YYYY-MM-DD).',\n          format: 'date'\n        },\n        createdAt: {\n          type: 'string',\n          description: 'The date and time when this currency 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        currencyCode: {\n          type: 'string',\n          description: 'The internationally accepted currency code used by this currency, typically based on the ISO 4217 standard (for example, USD for US Dollars). Built-in QuickBooks currencies follow ISO 4217. For user-defined currencies, following ISO 4217 is recommended but not required. In many cases, the three-letter code is formed from the country\\'s two-letter internet code plus a currency letter (e.g., BZ + D → BZD for Belize Dollar).'\n        },\n        currencyFormat: {\n          type: 'object',\n          title: 'The Currency Format object',\n          description: 'Controls how this currency displays thousands separators, grouping, and decimal places.',\n          properties: {\n            decimalPlaces: {\n              type: 'string',\n              description: 'Controls the number of decimal places displayed for currency values. Use `0` to hide decimals or `2` to display cents.',\n              enum: [                '0',\n                '2'\n              ]\n            },\n            decimalSeparator: {\n              type: 'string',\n              description: 'Controls the decimal separator when displaying currency values (for example, \"1.00\" vs \"1,00\"). Defaults to period.',\n              enum: [                'comma',\n                'period'\n              ]\n            },\n            thousandSeparator: {\n              type: 'string',\n              description: 'Controls the thousands separator when displaying currency values (for example, \"1,000,000\"). Defaults to comma.',\n              enum: [                'apostrophe',\n                'comma',\n                'period',\n                'space'\n              ]\n            },\n            thousandSeparatorGrouping: {\n              type: 'string',\n              description: 'Controls how digits are grouped for thousands when displaying currency values (for example, \"10,000,000\").',\n              enum: [                'x_xx_xx_xxx',\n                'xx_xxx_xxx'\n              ]\n            }\n          },\n          required: [            'decimalPlaces',\n            'decimalSeparator',\n            'thousandSeparator',\n            'thousandSeparatorGrouping'\n          ]\n        },\n        exchangeRate: {\n          type: 'number',\n          description: 'The market exchange rate between this currency\\'s currency and the home currency in QuickBooks at the time of this transaction. Represented as a decimal value (e.g., 1.2345 for 1 EUR = 1.2345 USD if USD is the home currency).'\n        },\n        isActive: {\n          type: 'boolean',\n          description: 'Indicates whether this currency is active. Inactive objects are typically hidden from views and reports in QuickBooks. Defaults to `true`.'\n        },\n        isUserDefinedCurrency: {\n          type: 'boolean',\n          description: 'Indicates whether this currency was created by a QuickBooks user (`true`) or is a built-in currency (`false`).'\n        },\n        name: {\n          type: 'string',\n          description: 'The case-insensitive unique name of this currency, unique across all currencies. For built-in currencies, the name is the internationally accepted currency name and is not editable.\\n\\n**NOTE**: Currencies 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_currency\"`.',\n          enum: [            'qbd_currency'\n          ]\n        },\n        revisionNumber: {\n          type: 'string',\n          description: 'The current QuickBooks-assigned revision number of this currency 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 currency 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        'asOfDate',\n        'createdAt',\n        'currencyCode',\n        'currencyFormat',\n        'exchangeRate',\n        'isActive',\n        'isUserDefinedCurrency',\n        'name',\n        'objectType',\n        'revisionNumber',\n        'updatedAt'\n      ]\n    }\n  }\n}\n```",
-  inputSchema: {
-    type: 'object',
-    properties: {
-      currencyCode: {
-        type: 'string',
-        description:
-          "The internationally accepted currency code used by this currency, typically based on the ISO 4217 standard (for example, USD for US Dollars). Built-in QuickBooks currencies follow ISO 4217. For user-defined currencies, following ISO 4217 is recommended but not required. In many cases, the three-letter code is formed from the country's two-letter internet code plus a currency letter (e.g., BZ + D → BZD for Belize Dollar).\n\nMaximum length: 3 characters.",
-      },
-      name: {
-        type: 'string',
-        description:
-          'The case-insensitive unique name of this currency, unique across all currencies. For built-in currencies, the name is the internationally accepted currency name and is not editable.\n\n**NOTE**: Currencies 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: 64 characters.',
-      },
-      conductorEndUserId: {
-        type: 'string',
-        description: 'The ID of the End-User to receive this request.',
-      },
-      currencyFormat: {
-        type: 'object',
-        description:
-          'Controls how this currency displays thousands separators, grouping, and decimal places.',
-        properties: {
-          decimalPlaces: {
-            type: 'string',
-            description:
-              'Controls the number of decimal places displayed for currency values. Use `0` to hide decimals or `2` to display cents.',
-            enum: ['0', '2'],
-          },
-          decimalSeparator: {
-            type: 'string',
-            description:
-              'Controls the decimal separator when displaying currency values (for example, "1.00" vs "1,00"). Defaults to period.',
-            enum: ['comma', 'period'],
-          },
-          thousandSeparator: {
-            type: 'string',
-            description:
-              'Controls the thousands separator when displaying currency values (for example, "1,000,000"). Defaults to comma.',
-            enum: ['apostrophe', 'comma', 'period', 'space'],
-          },
-          thousandSeparatorGrouping: {
-            type: 'string',
-            description:
-              'Controls how digits are grouped for thousands when displaying currency values (for example, "10,000,000").',
-            enum: ['x_xx_xx_xxx', 'xx_xxx_xxx'],
-          },
-        },
-      },
-      isActive: {
-        type: 'boolean',
-        description:
-          'Indicates whether this currency 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: ['currencyCode', '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.currencies.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/currencies/list-qbd-currencies.ts

@@ -1,107 +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.currencies',
-  operation: 'read',
-  tags: [],
-  httpMethod: 'get',
-  httpPath: '/quickbooks-desktop/currencies',
-};
-
-export const tool: Tool = {
-  name: 'list_qbd_currencies',
-  description:
-    'Returns a list of currencies. NOTE: QuickBooks Desktop does not support pagination for currencies; hence, there is no `cursor` parameter. Users typically have few currencies.',
-  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 currencies 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 currencies. 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 currencies without limit, unlike paginated endpoints which default to 150 records. This is acceptable because currencies typically have low record counts.',
-      },
-      nameContains: {
-        type: 'string',
-        description:
-          'Filter for currencies 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 currencies 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 currencies whose `name` is alphabetically greater than or equal to this value.',
-      },
-      names: {
-        type: 'array',
-        description:
-          'Filter for specific currencies by their name(s), case-insensitive. Like `id`, `name` is a unique identifier for a currency.\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 currencies 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 currencies whose `name` is alphabetically less than or equal to this value.',
-      },
-      status: {
-        type: 'string',
-        description: 'Filter for currencies that are active, inactive, or both.',
-        enum: ['active', 'all', 'inactive'],
-      },
-      updatedAfter: {
-        type: 'string',
-        description:
-          "Filter for currencies 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 currencies 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;
-  try {
-    return asTextContentResult(await conductor.qbd.currencies.list(body));
-  } catch (error) {
-    if (error instanceof Conductor.APIError) {
-      return asErrorResult(error.message);
-    }
-    throw error;
-  }
-};
-
-export default { metadata, tool, handler };

package/src/tools/qbd/currencies/retrieve-qbd-currencies.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.currencies',
-  operation: 'read',
-  tags: [],
-  httpMethod: 'get',
-  httpPath: '/quickbooks-desktop/currencies/{id}',
-};
-
-export const tool: Tool = {
-  name: 'retrieve_qbd_currencies',
-  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 currency by ID.\n\n**IMPORTANT:** If you need to fetch multiple specific currencies 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/currency',\n  $defs: {\n    currency: {\n      type: 'object',\n      title: 'The Currency object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The unique identifier assigned by QuickBooks to this currency. This ID is unique across all currencies but not across different QuickBooks object types.'\n        },\n        asOfDate: {\n          type: 'string',\n          description: 'The date when the exchange rate for this currency was last updated, in ISO 8601 format (YYYY-MM-DD).',\n          format: 'date'\n        },\n        createdAt: {\n          type: 'string',\n          description: 'The date and time when this currency 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        currencyCode: {\n          type: 'string',\n          description: 'The internationally accepted currency code used by this currency, typically based on the ISO 4217 standard (for example, USD for US Dollars). Built-in QuickBooks currencies follow ISO 4217. For user-defined currencies, following ISO 4217 is recommended but not required. In many cases, the three-letter code is formed from the country\\'s two-letter internet code plus a currency letter (e.g., BZ + D → BZD for Belize Dollar).'\n        },\n        currencyFormat: {\n          type: 'object',\n          title: 'The Currency Format object',\n          description: 'Controls how this currency displays thousands separators, grouping, and decimal places.',\n          properties: {\n            decimalPlaces: {\n              type: 'string',\n              description: 'Controls the number of decimal places displayed for currency values. Use `0` to hide decimals or `2` to display cents.',\n              enum: [                '0',\n                '2'\n              ]\n            },\n            decimalSeparator: {\n              type: 'string',\n              description: 'Controls the decimal separator when displaying currency values (for example, \"1.00\" vs \"1,00\"). Defaults to period.',\n              enum: [                'comma',\n                'period'\n              ]\n            },\n            thousandSeparator: {\n              type: 'string',\n              description: 'Controls the thousands separator when displaying currency values (for example, \"1,000,000\"). Defaults to comma.',\n              enum: [                'apostrophe',\n                'comma',\n                'period',\n                'space'\n              ]\n            },\n            thousandSeparatorGrouping: {\n              type: 'string',\n              description: 'Controls how digits are grouped for thousands when displaying currency values (for example, \"10,000,000\").',\n              enum: [                'x_xx_xx_xxx',\n                'xx_xxx_xxx'\n              ]\n            }\n          },\n          required: [            'decimalPlaces',\n            'decimalSeparator',\n            'thousandSeparator',\n            'thousandSeparatorGrouping'\n          ]\n        },\n        exchangeRate: {\n          type: 'number',\n          description: 'The market exchange rate between this currency\\'s currency and the home currency in QuickBooks at the time of this transaction. Represented as a decimal value (e.g., 1.2345 for 1 EUR = 1.2345 USD if USD is the home currency).'\n        },\n        isActive: {\n          type: 'boolean',\n          description: 'Indicates whether this currency is active. Inactive objects are typically hidden from views and reports in QuickBooks. Defaults to `true`.'\n        },\n        isUserDefinedCurrency: {\n          type: 'boolean',\n          description: 'Indicates whether this currency was created by a QuickBooks user (`true`) or is a built-in currency (`false`).'\n        },\n        name: {\n          type: 'string',\n          description: 'The case-insensitive unique name of this currency, unique across all currencies. For built-in currencies, the name is the internationally accepted currency name and is not editable.\\n\\n**NOTE**: Currencies 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_currency\"`.',\n          enum: [            'qbd_currency'\n          ]\n        },\n        revisionNumber: {\n          type: 'string',\n          description: 'The current QuickBooks-assigned revision number of this currency 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 currency 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        'asOfDate',\n        'createdAt',\n        'currencyCode',\n        'currencyFormat',\n        'exchangeRate',\n        'isActive',\n        'isUserDefinedCurrency',\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 currency 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.currencies.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/currencies/update-qbd-currencies.ts

@@ -1,107 +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.currencies',
-  operation: 'write',
-  tags: [],
-  httpMethod: 'post',
-  httpPath: '/quickbooks-desktop/currencies/{id}',
-};
-
-export const tool: Tool = {
-  name: 'update_qbd_currencies',
-  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 currency. For built-in currencies, only the `isActive` status can be changed; name and currency code are not editable. For user-defined currencies, all fields in this request are editable.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/currency',\n  $defs: {\n    currency: {\n      type: 'object',\n      title: 'The Currency object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The unique identifier assigned by QuickBooks to this currency. This ID is unique across all currencies but not across different QuickBooks object types.'\n        },\n        asOfDate: {\n          type: 'string',\n          description: 'The date when the exchange rate for this currency was last updated, in ISO 8601 format (YYYY-MM-DD).',\n          format: 'date'\n        },\n        createdAt: {\n          type: 'string',\n          description: 'The date and time when this currency 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        currencyCode: {\n          type: 'string',\n          description: 'The internationally accepted currency code used by this currency, typically based on the ISO 4217 standard (for example, USD for US Dollars). Built-in QuickBooks currencies follow ISO 4217. For user-defined currencies, following ISO 4217 is recommended but not required. In many cases, the three-letter code is formed from the country\\'s two-letter internet code plus a currency letter (e.g., BZ + D → BZD for Belize Dollar).'\n        },\n        currencyFormat: {\n          type: 'object',\n          title: 'The Currency Format object',\n          description: 'Controls how this currency displays thousands separators, grouping, and decimal places.',\n          properties: {\n            decimalPlaces: {\n              type: 'string',\n              description: 'Controls the number of decimal places displayed for currency values. Use `0` to hide decimals or `2` to display cents.',\n              enum: [                '0',\n                '2'\n              ]\n            },\n            decimalSeparator: {\n              type: 'string',\n              description: 'Controls the decimal separator when displaying currency values (for example, \"1.00\" vs \"1,00\"). Defaults to period.',\n              enum: [                'comma',\n                'period'\n              ]\n            },\n            thousandSeparator: {\n              type: 'string',\n              description: 'Controls the thousands separator when displaying currency values (for example, \"1,000,000\"). Defaults to comma.',\n              enum: [                'apostrophe',\n                'comma',\n                'period',\n                'space'\n              ]\n            },\n            thousandSeparatorGrouping: {\n              type: 'string',\n              description: 'Controls how digits are grouped for thousands when displaying currency values (for example, \"10,000,000\").',\n              enum: [                'x_xx_xx_xxx',\n                'xx_xxx_xxx'\n              ]\n            }\n          },\n          required: [            'decimalPlaces',\n            'decimalSeparator',\n            'thousandSeparator',\n            'thousandSeparatorGrouping'\n          ]\n        },\n        exchangeRate: {\n          type: 'number',\n          description: 'The market exchange rate between this currency\\'s currency and the home currency in QuickBooks at the time of this transaction. Represented as a decimal value (e.g., 1.2345 for 1 EUR = 1.2345 USD if USD is the home currency).'\n        },\n        isActive: {\n          type: 'boolean',\n          description: 'Indicates whether this currency is active. Inactive objects are typically hidden from views and reports in QuickBooks. Defaults to `true`.'\n        },\n        isUserDefinedCurrency: {\n          type: 'boolean',\n          description: 'Indicates whether this currency was created by a QuickBooks user (`true`) or is a built-in currency (`false`).'\n        },\n        name: {\n          type: 'string',\n          description: 'The case-insensitive unique name of this currency, unique across all currencies. For built-in currencies, the name is the internationally accepted currency name and is not editable.\\n\\n**NOTE**: Currencies 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_currency\"`.',\n          enum: [            'qbd_currency'\n          ]\n        },\n        revisionNumber: {\n          type: 'string',\n          description: 'The current QuickBooks-assigned revision number of this currency 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 currency 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        'asOfDate',\n        'createdAt',\n        'currencyCode',\n        'currencyFormat',\n        'exchangeRate',\n        'isActive',\n        'isUserDefinedCurrency',\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 currency to update.',
-      },
-      revisionNumber: {
-        type: 'string',
-        description:
-          "The current QuickBooks-assigned revision number of the currency 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.',
-      },
-      currencyCode: {
-        type: 'string',
-        description:
-          "The internationally accepted currency code used by this currency, typically based on the ISO 4217 standard (for example, USD for US Dollars). Built-in QuickBooks currencies follow ISO 4217. For user-defined currencies, following ISO 4217 is recommended but not required. In many cases, the three-letter code is formed from the country's two-letter internet code plus a currency letter (e.g., BZ + D → BZD for Belize Dollar).\n\nMaximum length: 3 characters.",
-      },
-      currencyFormat: {
-        type: 'object',
-        description:
-          'Controls how this currency displays thousands separators, grouping, and decimal places.',
-        properties: {
-          decimalPlaces: {
-            type: 'string',
-            description:
-              'Controls the number of decimal places displayed for currency values. Use `0` to hide decimals or `2` to display cents.',
-            enum: ['0', '2'],
-          },
-          decimalSeparator: {
-            type: 'string',
-            description:
-              'Controls the decimal separator when displaying currency values (for example, "1.00" vs "1,00"). Defaults to period.',
-            enum: ['comma', 'period'],
-          },
-          thousandSeparator: {
-            type: 'string',
-            description:
-              'Controls the thousands separator when displaying currency values (for example, "1,000,000"). Defaults to comma.',
-            enum: ['apostrophe', 'comma', 'period', 'space'],
-          },
-          thousandSeparatorGrouping: {
-            type: 'string',
-            description:
-              'Controls how digits are grouped for thousands when displaying currency values (for example, "10,000,000").',
-            enum: ['x_xx_xx_xxx', 'xx_xxx_xxx'],
-          },
-        },
-      },
-      isActive: {
-        type: 'boolean',
-        description:
-          'Indicates whether this currency 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 currency, unique across all currencies. For built-in currencies, the name is the internationally accepted currency name and is not editable.\n\n**NOTE**: Currencies 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: 64 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.currencies.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/customer-types/create-qbd-customer-types.ts

@@ -1,67 +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.customer_types',
-  operation: 'write',
-  tags: [],
-  httpMethod: 'post',
-  httpPath: '/quickbooks-desktop/customer-types',
-};
-
-export const tool: Tool = {
-  name: 'create_qbd_customer_types',
-  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 type.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/customer_type',\n  $defs: {\n    customer_type: {\n      type: 'object',\n      title: 'The Customer Type object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The unique identifier assigned by QuickBooks to this customer type. This ID is unique across all customer types but not across different QuickBooks object types.'\n        },\n        createdAt: {\n          type: 'string',\n          description: 'The date and time when this customer type 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        fullName: {\n          type: 'string',\n          description: 'The case-insensitive fully-qualified unique name of this customer type, formed by combining the names of its hierarchical parent objects with its own `name`, separated by colons. For example, if a customer type is under \"Industry\" and has the `name` \"Healthcare\", its `fullName` would be \"Industry:Healthcare\".\\n\\n**NOTE**: Unlike `name`, `fullName` is guaranteed to be unique across all customer type objects. However, `fullName` can still be arbitrarily changed by the QuickBooks user when they modify the underlying `name` field.'\n        },\n        isActive: {\n          type: 'boolean',\n          description: 'Indicates whether this customer type 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 name of this customer type. Not guaranteed to be unique because it does not include the names of its hierarchical parent objects like `fullName` does. For example, two customer types could both have the `name` \"Healthcare\", but they could have unique `fullName` values, such as \"Industry:Healthcare\" and \"Region:Healthcare\".'\n        },\n        objectType: {\n          type: 'string',\n          description: 'The type of object. This value is always `\"qbd_customer_type\"`.',\n          enum: [            'qbd_customer_type'\n          ]\n        },\n        parent: {\n          type: 'object',\n          description: 'The parent customer type one level above this one in the hierarchy. For example, if this customer type has a `fullName` of \"Industry:Healthcare\", its parent has a `fullName` of \"Industry\". If this customer type is at the top level, this field will be `null`.',\n          properties: {\n            id: {\n              type: 'string',\n              description: 'The unique identifier assigned by QuickBooks to this object. This ID is unique across all objects of the same type, but not across different QuickBooks object types.'\n            },\n            fullName: {\n              type: 'string',\n              description: 'The fully-qualified unique name for this object, formed by combining the names of its parent objects with its own `name`, separated by colons. Not case-sensitive.'\n            }\n          },\n          required: [            'id',\n            'fullName'\n          ]\n        },\n        revisionNumber: {\n          type: 'string',\n          description: 'The current QuickBooks-assigned revision number of this customer type 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        sublevel: {\n          type: 'number',\n          description: 'The depth level of this customer type in the hierarchy. A top-level customer type has a `sublevel` of 0; each subsequent sublevel increases this number by 1. For example, a customer type with a `fullName` of \"Industry:Healthcare\" would have a `sublevel` of 1.'\n        },\n        updatedAt: {\n          type: 'string',\n          description: 'The date and time when this customer type 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        'fullName',\n        'isActive',\n        'name',\n        'objectType',\n        'parent',\n        'revisionNumber',\n        'sublevel',\n        'updatedAt'\n      ]\n    }\n  }\n}\n```",
-  inputSchema: {
-    type: 'object',
-    properties: {
-      name: {
-        type: 'string',
-        description:
-          'The case-insensitive name of this customer type. Not guaranteed to be unique because it does not include the names of its hierarchical parent objects like `fullName` does. For example, two customer types could both have the `name` "Healthcare", but they could have unique `fullName` values, such as "Industry:Healthcare" and "Region:Healthcare".\n\nMaximum length: 31 characters.',
-      },
-      conductorEndUserId: {
-        type: 'string',
-        description: 'The ID of the End-User to receive this request.',
-      },
-      isActive: {
-        type: 'boolean',
-        description:
-          'Indicates whether this customer type is active. Inactive objects are typically hidden from views and reports in QuickBooks. Defaults to `true`.',
-      },
-      parentId: {
-        type: 'string',
-        description:
-          'The parent customer type one level above this one in the hierarchy. For example, if this customer type has a `fullName` of "Industry:Healthcare", its parent has a `fullName` of "Industry". If this customer type is at the top level, this field will be `null`.',
-      },
-      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.customerTypes.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/customer-types/list-qbd-customer-types.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.customer_types',
-  operation: 'read',
-  tags: [],
-  httpMethod: 'get',
-  httpPath: '/quickbooks-desktop/customer-types',
-};
-
-export const tool: Tool = {
-  name: 'list_qbd_customer_types',
-  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 customer types. NOTE: QuickBooks Desktop does not support pagination for customer types; hence, there is no `cursor` parameter. Users typically have few customer types.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/customer_type_list_response',\n  $defs: {\n    customer_type_list_response: {\n      type: 'object',\n      properties: {\n        data: {\n          type: 'array',\n          description: 'The array of customer types.',\n          items: {\n            $ref: '#/$defs/customer_type'\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    customer_type: {\n      type: 'object',\n      title: 'The Customer Type object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The unique identifier assigned by QuickBooks to this customer type. This ID is unique across all customer types but not across different QuickBooks object types.'\n        },\n        createdAt: {\n          type: 'string',\n          description: 'The date and time when this customer type 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        fullName: {\n          type: 'string',\n          description: 'The case-insensitive fully-qualified unique name of this customer type, formed by combining the names of its hierarchical parent objects with its own `name`, separated by colons. For example, if a customer type is under \"Industry\" and has the `name` \"Healthcare\", its `fullName` would be \"Industry:Healthcare\".\\n\\n**NOTE**: Unlike `name`, `fullName` is guaranteed to be unique across all customer type objects. However, `fullName` can still be arbitrarily changed by the QuickBooks user when they modify the underlying `name` field.'\n        },\n        isActive: {\n          type: 'boolean',\n          description: 'Indicates whether this customer type 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 name of this customer type. Not guaranteed to be unique because it does not include the names of its hierarchical parent objects like `fullName` does. For example, two customer types could both have the `name` \"Healthcare\", but they could have unique `fullName` values, such as \"Industry:Healthcare\" and \"Region:Healthcare\".'\n        },\n        objectType: {\n          type: 'string',\n          description: 'The type of object. This value is always `\"qbd_customer_type\"`.',\n          enum: [            'qbd_customer_type'\n          ]\n        },\n        parent: {\n          type: 'object',\n          description: 'The parent customer type one level above this one in the hierarchy. For example, if this customer type has a `fullName` of \"Industry:Healthcare\", its parent has a `fullName` of \"Industry\". If this customer type is at the top level, this field will be `null`.',\n          properties: {\n            id: {\n              type: 'string',\n              description: 'The unique identifier assigned by QuickBooks to this object. This ID is unique across all objects of the same type, but not across different QuickBooks object types.'\n            },\n            fullName: {\n              type: 'string',\n              description: 'The fully-qualified unique name for this object, formed by combining the names of its parent objects with its own `name`, separated by colons. Not case-sensitive.'\n            }\n          },\n          required: [            'id',\n            'fullName'\n          ]\n        },\n        revisionNumber: {\n          type: 'string',\n          description: 'The current QuickBooks-assigned revision number of this customer type 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        sublevel: {\n          type: 'number',\n          description: 'The depth level of this customer type in the hierarchy. A top-level customer type has a `sublevel` of 0; each subsequent sublevel increases this number by 1. For example, a customer type with a `fullName` of \"Industry:Healthcare\" would have a `sublevel` of 1.'\n        },\n        updatedAt: {\n          type: 'string',\n          description: 'The date and time when this customer type 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        'fullName',\n        'isActive',\n        'name',\n        'objectType',\n        'parent',\n        'revisionNumber',\n        'sublevel',\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.',
-      },
-      fullNames: {
-        type: 'array',
-        description:
-          'Filter for specific customer types by their full-name(s), case-insensitive. Like `id`, `fullName` is a unique identifier for a customer type, formed by by combining the names of its parent objects with its own `name`, separated by colons. For example, if a customer type is under "Industry" and has the `name` "Healthcare", its `fullName` would be "Industry:Healthcare".\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',
-        },
-      },
-      ids: {
-        type: 'array',
-        description:
-          'Filter for specific customer types 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 customer types. 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 customer types without limit, unlike paginated endpoints which default to 150 records. This is acceptable because customer types typically have low record counts.',
-      },
-      nameContains: {
-        type: 'string',
-        description:
-          'Filter for customer types 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 customer types 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 customer types whose `name` is alphabetically greater than or equal to this value.',
-      },
-      nameStartsWith: {
-        type: 'string',
-        description:
-          'Filter for customer types 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 customer types whose `name` is alphabetically less than or equal to this value.',
-      },
-      status: {
-        type: 'string',
-        description: 'Filter for customer types that are active, inactive, or both.',
-        enum: ['active', 'all', 'inactive'],
-      },
-      updatedAfter: {
-        type: 'string',
-        description:
-          "Filter for customer types 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 customer types 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.customerTypes.list(body)));
-  } catch (error) {
-    if (error instanceof Conductor.APIError || isJqError(error)) {
-      return asErrorResult(error.message);
-    }
-    throw error;
-  }
-};
-
-export default { metadata, tool, handler };