conductor-node-mcp 12.13.0 → 12.15.0

package/README.md

@@ -213,6 +213,14 @@ The following tools are available in this MCP server.
 - `list_qbd_bills` (`read`): Returns a list of bills. Use the `cursor` parameter to paginate through the results.
 - `delete_qbd_bills` (`write`): Permanently deletes a a bill. The deletion will fail if the bill is currently in use or has any linked transactions that are in use.
 
+### Resource `qbd.build_assemblies`:
+
+- `create_qbd_build_assemblies` (`write`): Creates a new build assembly.
+- `retrieve_qbd_build_assemblies` (`read`): Retrieves a build assembly by ID.
+- `update_qbd_build_assemblies` (`write`): Updates an existing build assembly.
+- `list_qbd_build_assemblies` (`read`): Returns a list of build assemblies. Use the `cursor` parameter to paginate through the results.
+- `delete_qbd_build_assemblies` (`write`): Permanently deletes a a build assembly. The deletion will fail if the build assembly is currently in use or has any linked transactions that are in use.
+
 ### Resource `qbd.checks`:
 
 - `create_qbd_checks` (`write`): Creates a new check.

package/filtering.d.mts

@@ -0,0 +1,2 @@
+export declare function maybeFilter(args: Record<string, unknown> | undefined, response: any): Promise<any>;
+//# sourceMappingURL=filtering.d.mts.map

package/filtering.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filtering.d.mts","sourceRoot":"","sources":["src/filtering.ts"],"names":[],"mappings":"AAAA,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAAE,QAAQ,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAOxG"}

package/filtering.d.ts

@@ -0,0 +1,2 @@
+export declare function maybeFilter(args: Record<string, unknown> | undefined, response: any): Promise<any>;
+//# sourceMappingURL=filtering.d.ts.map

package/filtering.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filtering.d.ts","sourceRoot":"","sources":["src/filtering.ts"],"names":[],"mappings":"AAAA,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAAE,QAAQ,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAOxG"}

package/filtering.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.maybeFilter = maybeFilter;
+async function maybeFilter(args, response) {
+    const jqFilter = args?.['jq_filter'];
+    if (jqFilter && typeof jqFilter === 'string') {
+        return await jq(response, jqFilter);
+    }
+    else {
+        return response;
+    }
+}
+var jqWeb = require('jq-web');
+async function jq(json, jqFilter) {
+    return (await jqWeb).json(json, jqFilter);
+}
+//# sourceMappingURL=filtering.js.map

package/filtering.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filtering.js","sourceRoot":"","sources":["src/filtering.ts"],"names":[],"mappings":";;AAAA,kCAOC;AAPM,KAAK,UAAU,WAAW,CAAC,IAAyC,EAAE,QAAa;IACxF,MAAM,QAAQ,GAAG,IAAI,EAAE,CAAC,WAAW,CAAC,CAAC;IACrC,IAAI,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC7C,OAAO,MAAM,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACtC,CAAC;SAAM,CAAC;QACN,OAAO,QAAQ,CAAC;IAClB,CAAC;AACH,CAAC;AAED,IAAI,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;AAC9B,KAAK,UAAU,EAAE,CAAC,IAAS,EAAE,QAAgB;IAC3C,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAC5C,CAAC"}

package/filtering.mjs

@@ -0,0 +1,14 @@
+export async function maybeFilter(args, response) {
+    const jqFilter = args?.['jq_filter'];
+    if (jqFilter && typeof jqFilter === 'string') {
+        return await jq(response, jqFilter);
+    }
+    else {
+        return response;
+    }
+}
+var jqWeb = require('jq-web');
+async function jq(json, jqFilter) {
+    return (await jqWeb).json(json, jqFilter);
+}
+//# sourceMappingURL=filtering.mjs.map

package/filtering.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"filtering.mjs","sourceRoot":"","sources":["src/filtering.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAyC,EAAE,QAAa;IACxF,MAAM,QAAQ,GAAG,IAAI,EAAE,CAAC,WAAW,CAAC,CAAC;IACrC,IAAI,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC7C,OAAO,MAAM,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACtC,CAAC;SAAM,CAAC;QACN,OAAO,QAAQ,CAAC;IAClB,CAAC;AACH,CAAC;AAED,IAAI,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;AAC9B,KAAK,UAAU,EAAE,CAAC,IAAS,EAAE,QAAgB;IAC3C,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAC5C,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "conductor-node-mcp",
-  "version": "12.13.0",
+  "version": "12.15.0",
   "description": "The official MCP Server for the Conductor API",
   "author": "Conductor <support@conductor.is>",
   "types": "./index.d.ts",
@@ -24,8 +24,9 @@
     "fix": "eslint --fix --ext ts,js ."
   },
   "dependencies": {
-    "conductor-node": "^12.13.0",
+    "conductor-node": "^12.15.0",
     "@modelcontextprotocol/sdk": "^1.11.5",
+    "jq-web": "^0.6.2",
     "yargs": "^17.7.2",
     "@cloudflare/cabidela": "^0.2.4",
     "zod": "^3.25.20",

package/server.js

@@ -20,7 +20,7 @@ Object.defineProperty(exports, "endpoints", { enumerable: true, get: function ()
 // Create server instance
 exports.server = new mcp_js_1.McpServer({
     name: 'conductor_node_api',
-    version: '12.13.0',
+    version: '12.15.0',
 }, {
     capabilities: {
         tools: {},

package/server.mjs

@@ -9,7 +9,7 @@ export { endpoints } from "./tools.mjs";
 // Create server instance
 export const server = new McpServer({
     name: 'conductor_node_api',
-    version: '12.13.0',
+    version: '12.15.0',
 }, {
     capabilities: {
         tools: {},

package/src/filtering.ts

@@ -0,0 +1,13 @@
+export async function maybeFilter(args: Record<string, unknown> | undefined, response: any): Promise<any> {
+  const jqFilter = args?.['jq_filter'];
+  if (jqFilter && typeof jqFilter === 'string') {
+    return await jq(response, jqFilter);
+  } else {
+    return response;
+  }
+}
+
+var jqWeb = require('jq-web');
+async function jq(json: any, jqFilter: string) {
+  return (await jqWeb).json(json, jqFilter);
+}

package/src/server.ts

@@ -26,7 +26,7 @@ export { endpoints } from './tools';
 export const server = new McpServer(
   {
     name: 'conductor_node_api',
-    version: '12.13.0',
+    version: '12.15.0',
   },
   {
     capabilities: {

package/src/tools/auth-sessions/create-auth-sessions.ts

@@ -1,5 +1,6 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+import { maybeFilter } from 'conductor-node-mcp/filtering';
 import { asTextContentResult } from 'conductor-node-mcp/tools/types';
 
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
@@ -17,7 +18,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'create_auth_sessions',
   description:
-    "To launch the authentication flow, create an auth session and pass the returned session's `authFlowUrl` to the client for your end-user to visit in their browser. Demo: https://connect.conductor.is/qbd/demo",
+    "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\nTo launch the authentication flow, create an auth session and pass the returned session's `authFlowUrl` to the client for your end-user to visit in their browser. Demo: https://connect.conductor.is/qbd/demo\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/auth_session',\n  $defs: {\n    auth_session: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The unique identifier for this auth session.'\n        },\n        authFlowUrl: {\n          type: 'string',\n          description: 'The URL of the authentication flow that you will pass to your client for your user to set up their integration connection.'\n        },\n        clientSecret: {\n          type: 'string',\n          description: 'The secret used in `authFlowUrl` to securely access the authentication flow.'\n        },\n        createdAt: {\n          type: 'string',\n          description: 'The date and time when this auth session record was created.'\n        },\n        endUserId: {\n          type: 'string',\n          description: 'The ID of the end-user for whom to create an integration connection.'\n        },\n        expiresAt: {\n          type: 'string',\n          description: 'The date and time when this auth session expires. By default, this value is 30 minutes from creation. You can extend this time by setting `linkExpiryMins` when creating the auth session.'\n        },\n        objectType: {\n          type: 'string',\n          description: 'The type of object. This value is always `\"auth_session\"`.',\n          enum: [            'auth_session'\n          ]\n        },\n        redirectUrl: {\n          type: 'string',\n          description: 'The URL to which Conductor will redirect your user to return to your app after they complete the authentication flow. If `null`, their browser tab will close instead.'\n        }\n      },\n      required: [        'id',\n        'authFlowUrl',\n        'clientSecret',\n        'createdAt',\n        'endUserId',\n        'expiresAt',\n        'objectType',\n        'redirectUrl'\n      ]\n    }\n  }\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {
@@ -40,13 +41,19 @@ export const tool: Tool = {
         description:
           'The URL to which Conductor will redirect the end-user to return to your app after they complete the authentication flow. If not provided, their browser tab will close instead.',
       },
+      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/).',
+      },
     },
   },
 };
 
 export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {
   const body = args as any;
-  return asTextContentResult(await conductor.authSessions.create(body));
+  return asTextContentResult(await maybeFilter(args, await conductor.authSessions.create(body)));
 };
 
 export default { metadata, tool, handler };

package/src/tools/end-users/create-end-users.ts

@@ -1,5 +1,6 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+import { maybeFilter } from 'conductor-node-mcp/filtering';
 import { asTextContentResult } from 'conductor-node-mcp/tools/types';
 
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
@@ -16,7 +17,8 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'create_end_users',
-  description: 'Creates an end-user.',
+  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 an end-user.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/end_user',\n  $defs: {\n    end_user: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The unique identifier for this end-user. You must save this value to your database because it is how you identify which of your users to receive your API requests.'\n        },\n        companyName: {\n          type: 'string',\n          description: 'The end-user\\'s company name that will be shown elsewhere in Conductor.'\n        },\n        createdAt: {\n          type: 'string',\n          description: 'The date and time when this end-user record was created.'\n        },\n        email: {\n          type: 'string',\n          description: 'The end-user\\'s email address for identification purposes.'\n        },\n        integrationConnections: {\n          type: 'array',\n          description: 'The end-user\\'s integration connections.',\n          items: {\n            type: 'object',\n            properties: {\n              id: {\n                type: 'string',\n                description: 'The unique identifier for this integration connection.'\n              },\n              createdAt: {\n                type: 'string',\n                description: 'The date and time when this integration connection record was created.'\n              },\n              integrationSlug: {\n                type: 'string',\n                description: 'The identifier of the third-party platform to integrate.',\n                enum: [                  'quickbooks_desktop'\n                ]\n              },\n              lastRequestAt: {\n                type: 'string',\n                description: 'The date and time of your last API request to this integration connection.'\n              },\n              lastSuccessfulRequestAt: {\n                type: 'string',\n                description: 'The date and time of your last *successful* API request to this integration connection. A successful request means the integration fully processed and returned a response without any errors end-to-end.'\n              },\n              objectType: {\n                type: 'string',\n                description: 'The type of object. This value is always `\"integration_connection\"`.',\n                enum: [                  'integration_connection'\n                ]\n              }\n            },\n            required: [              'id',\n              'createdAt',\n              'integrationSlug',\n              'lastRequestAt',\n              'lastSuccessfulRequestAt',\n              'objectType'\n            ]\n          }\n        },\n        objectType: {\n          type: 'string',\n          description: 'The type of object. This value is always `\"end_user\"`.',\n          enum: [            'end_user'\n          ]\n        },\n        sourceId: {\n          type: 'string',\n          description: 'The end-user\\'s unique identifier from your system. Maps users between your database and Conductor.'\n        }\n      },\n      required: [        'id',\n        'companyName',\n        'createdAt',\n        'email',\n        'integrationConnections',\n        'objectType',\n        'sourceId'\n      ]\n    }\n  }\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {
@@ -34,13 +36,19 @@ export const tool: Tool = {
         description:
           "The end-user's unique identifier from your system. Maps users between your database and Conductor. Must be unique for each user. If you have only one user, you may use any string value.",
       },
+      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/).',
+      },
     },
   },
 };
 
 export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {
   const body = args as any;
-  return asTextContentResult(await conductor.endUsers.create(body));
+  return asTextContentResult(await maybeFilter(args, await conductor.endUsers.create(body)));
 };
 
 export default { metadata, tool, handler };

package/src/tools/end-users/delete-end-users.ts

@@ -1,5 +1,6 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+import { maybeFilter } from 'conductor-node-mcp/filtering';
 import { asTextContentResult } from 'conductor-node-mcp/tools/types';
 
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
@@ -16,7 +17,8 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'delete_end_users',
-  description: 'Permanently deletes an end-user object and all of its connections.',
+  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\nPermanently deletes an end-user object and all of its connections.\n\n# Response Schema\n```json\n{\n  type: 'object',\n  properties: {\n    id: {\n      type: 'string',\n      description: 'The ID of the deleted end-user.'\n    },\n    deleted: {\n      type: 'boolean',\n      description: 'Indicates whether the end-user was deleted.'\n    },\n    objectType: {\n      type: 'string',\n      description: 'The type of object. This value is always `\"end_user\"`.',\n      enum: [        'end_user'\n      ]\n    }\n  },\n  required: [    'id',\n    'deleted',\n    'objectType'\n  ]\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {
@@ -24,13 +26,19 @@ export const tool: Tool = {
         type: 'string',
         description: 'The ID of the end-user to delete.',
       },
+      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/).',
+      },
     },
   },
 };
 
 export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {
   const { id, ...body } = args as any;
-  return asTextContentResult(await conductor.endUsers.delete(id));
+  return asTextContentResult(await maybeFilter(args, await conductor.endUsers.delete(id)));
 };
 
 export default { metadata, tool, handler };

package/src/tools/end-users/list-end-users.ts

@@ -1,5 +1,6 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+import { maybeFilter } from 'conductor-node-mcp/filtering';
 import { asTextContentResult } from 'conductor-node-mcp/tools/types';
 
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
@@ -16,15 +17,23 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'list_end_users',
-  description: 'Returns a list of your end-users.',
+  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 your end-users.\n\n# Response Schema\n```json\n{\n  type: 'object',\n  properties: {\n    data: {\n      type: 'array',\n      description: 'The array of end-users.',\n      items: {\n        $ref: '#/$defs/end_user'\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  $defs: {\n    end_user: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The unique identifier for this end-user. You must save this value to your database because it is how you identify which of your users to receive your API requests.'\n        },\n        companyName: {\n          type: 'string',\n          description: 'The end-user\\'s company name that will be shown elsewhere in Conductor.'\n        },\n        createdAt: {\n          type: 'string',\n          description: 'The date and time when this end-user record was created.'\n        },\n        email: {\n          type: 'string',\n          description: 'The end-user\\'s email address for identification purposes.'\n        },\n        integrationConnections: {\n          type: 'array',\n          description: 'The end-user\\'s integration connections.',\n          items: {\n            type: 'object',\n            properties: {\n              id: {\n                type: 'string',\n                description: 'The unique identifier for this integration connection.'\n              },\n              createdAt: {\n                type: 'string',\n                description: 'The date and time when this integration connection record was created.'\n              },\n              integrationSlug: {\n                type: 'string',\n                description: 'The identifier of the third-party platform to integrate.',\n                enum: [                  'quickbooks_desktop'\n                ]\n              },\n              lastRequestAt: {\n                type: 'string',\n                description: 'The date and time of your last API request to this integration connection.'\n              },\n              lastSuccessfulRequestAt: {\n                type: 'string',\n                description: 'The date and time of your last *successful* API request to this integration connection. A successful request means the integration fully processed and returned a response without any errors end-to-end.'\n              },\n              objectType: {\n                type: 'string',\n                description: 'The type of object. This value is always `\"integration_connection\"`.',\n                enum: [                  'integration_connection'\n                ]\n              }\n            },\n            required: [              'id',\n              'createdAt',\n              'integrationSlug',\n              'lastRequestAt',\n              'lastSuccessfulRequestAt',\n              'objectType'\n            ]\n          }\n        },\n        objectType: {\n          type: 'string',\n          description: 'The type of object. This value is always `\"end_user\"`.',\n          enum: [            'end_user'\n          ]\n        },\n        sourceId: {\n          type: 'string',\n          description: 'The end-user\\'s unique identifier from your system. Maps users between your database and Conductor.'\n        }\n      },\n      required: [        'id',\n        'companyName',\n        'createdAt',\n        'email',\n        'integrationConnections',\n        'objectType',\n        'sourceId'\n      ]\n    }\n  }\n}\n```",
   inputSchema: {
     type: 'object',
-    properties: {},
+    properties: {
+      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/).',
+      },
+    },
   },
 };
 
 export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {
-  return asTextContentResult(await conductor.endUsers.list());
+  return asTextContentResult(await maybeFilter(args, await conductor.endUsers.list()));
 };
 
 export default { metadata, tool, handler };

package/src/tools/end-users/passthrough-end-users.ts

@@ -1,5 +1,6 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+import { maybeFilter } from 'conductor-node-mcp/filtering';
 import { asTextContentResult } from 'conductor-node-mcp/tools/types';
 
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
@@ -17,7 +18,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'passthrough_end_users',
   description:
-    'Sends a request directly to the specified integration connection (e.g., QuickBooks Desktop) on behalf of the end-user.',
+    "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\nSends a request directly to the specified integration connection (e.g., QuickBooks Desktop) on behalf of the end-user.\n\n# Response Schema\n```json\n{\n  type: 'object',\n  description: 'The response from the integration connection.'\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {
@@ -34,13 +35,21 @@ export const tool: Tool = {
         type: 'object',
         description: 'The request body to send to the integration connection.',
       },
+      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/).',
+      },
     },
   },
 };
 
 export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {
   const { id, integrationSlug, ...body } = args as any;
-  return asTextContentResult(await conductor.endUsers.passthrough(id, integrationSlug, body['qbd_payload']));
+  return asTextContentResult(
+    await maybeFilter(args, await conductor.endUsers.passthrough(id, integrationSlug, body['qbd_payload'])),
+  );
 };
 
 export default { metadata, tool, handler };

package/src/tools/end-users/retrieve-end-users.ts

@@ -1,5 +1,6 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+import { maybeFilter } from 'conductor-node-mcp/filtering';
 import { asTextContentResult } from 'conductor-node-mcp/tools/types';
 
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
@@ -16,7 +17,8 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'retrieve_end_users',
-  description: 'Retrieves an end-user object.',
+  description:
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nRetrieves an end-user object.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/end_user',\n  $defs: {\n    end_user: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The unique identifier for this end-user. You must save this value to your database because it is how you identify which of your users to receive your API requests.'\n        },\n        companyName: {\n          type: 'string',\n          description: 'The end-user\\'s company name that will be shown elsewhere in Conductor.'\n        },\n        createdAt: {\n          type: 'string',\n          description: 'The date and time when this end-user record was created.'\n        },\n        email: {\n          type: 'string',\n          description: 'The end-user\\'s email address for identification purposes.'\n        },\n        integrationConnections: {\n          type: 'array',\n          description: 'The end-user\\'s integration connections.',\n          items: {\n            type: 'object',\n            properties: {\n              id: {\n                type: 'string',\n                description: 'The unique identifier for this integration connection.'\n              },\n              createdAt: {\n                type: 'string',\n                description: 'The date and time when this integration connection record was created.'\n              },\n              integrationSlug: {\n                type: 'string',\n                description: 'The identifier of the third-party platform to integrate.',\n                enum: [                  'quickbooks_desktop'\n                ]\n              },\n              lastRequestAt: {\n                type: 'string',\n                description: 'The date and time of your last API request to this integration connection.'\n              },\n              lastSuccessfulRequestAt: {\n                type: 'string',\n                description: 'The date and time of your last *successful* API request to this integration connection. A successful request means the integration fully processed and returned a response without any errors end-to-end.'\n              },\n              objectType: {\n                type: 'string',\n                description: 'The type of object. This value is always `\"integration_connection\"`.',\n                enum: [                  'integration_connection'\n                ]\n              }\n            },\n            required: [              'id',\n              'createdAt',\n              'integrationSlug',\n              'lastRequestAt',\n              'lastSuccessfulRequestAt',\n              'objectType'\n            ]\n          }\n        },\n        objectType: {\n          type: 'string',\n          description: 'The type of object. This value is always `\"end_user\"`.',\n          enum: [            'end_user'\n          ]\n        },\n        sourceId: {\n          type: 'string',\n          description: 'The end-user\\'s unique identifier from your system. Maps users between your database and Conductor.'\n        }\n      },\n      required: [        'id',\n        'companyName',\n        'createdAt',\n        'email',\n        'integrationConnections',\n        'objectType',\n        'sourceId'\n      ]\n    }\n  }\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {
@@ -24,13 +26,19 @@ export const tool: Tool = {
         type: 'string',
         description: 'The ID of the end-user to retrieve.',
       },
+      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/).',
+      },
     },
   },
 };
 
 export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {
   const { id, ...body } = args as any;
-  return asTextContentResult(await conductor.endUsers.retrieve(id));
+  return asTextContentResult(await maybeFilter(args, await conductor.endUsers.retrieve(id)));
 };
 
 export default { metadata, tool, handler };

package/src/tools/index.ts

@@ -30,6 +30,11 @@ import retrieve_qbd_bills from './qbd/bills/retrieve-qbd-bills';
 import update_qbd_bills from './qbd/bills/update-qbd-bills';
 import list_qbd_bills from './qbd/bills/list-qbd-bills';
 import delete_qbd_bills from './qbd/bills/delete-qbd-bills';
+import create_qbd_build_assemblies from './qbd/build-assemblies/create-qbd-build-assemblies';
+import retrieve_qbd_build_assemblies from './qbd/build-assemblies/retrieve-qbd-build-assemblies';
+import update_qbd_build_assemblies from './qbd/build-assemblies/update-qbd-build-assemblies';
+import list_qbd_build_assemblies from './qbd/build-assemblies/list-qbd-build-assemblies';
+import delete_qbd_build_assemblies from './qbd/build-assemblies/delete-qbd-build-assemblies';
 import create_qbd_checks from './qbd/checks/create-qbd-checks';
 import retrieve_qbd_checks from './qbd/checks/retrieve-qbd-checks';
 import update_qbd_checks from './qbd/checks/update-qbd-checks';
@@ -228,6 +233,11 @@ addEndpoint(retrieve_qbd_bills);
 addEndpoint(update_qbd_bills);
 addEndpoint(list_qbd_bills);
 addEndpoint(delete_qbd_bills);
+addEndpoint(create_qbd_build_assemblies);
+addEndpoint(retrieve_qbd_build_assemblies);
+addEndpoint(update_qbd_build_assemblies);
+addEndpoint(list_qbd_build_assemblies);
+addEndpoint(delete_qbd_build_assemblies);
 addEndpoint(create_qbd_checks);
 addEndpoint(retrieve_qbd_checks);
 addEndpoint(update_qbd_checks);

package/src/tools/qbd/account-tax-lines/list-qbd-account-tax-lines.ts

@@ -1,5 +1,6 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+import { maybeFilter } from 'conductor-node-mcp/filtering';
 import { asTextContentResult } from 'conductor-node-mcp/tools/types';
 
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
@@ -17,7 +18,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'list_qbd_account_tax_lines',
   description:
-    'Returns a list of account tax lines. NOTE: QuickBooks Desktop does not support pagination for account tax lines; hence, there is no `cursor` parameter. Users typically have few account tax lines.',
+    "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 account tax lines. NOTE: QuickBooks Desktop does not support pagination for account tax lines; hence, there is no `cursor` parameter. Users typically have few account tax lines.\n\n# Response Schema\n```json\n{\n  type: 'object',\n  properties: {\n    data: {\n      type: 'array',\n      description: 'The array of account tax lines.',\n      items: {\n        $ref: '#/$defs/account_tax_line'\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  $defs: {\n    account_tax_line: {\n      type: 'object',\n      title: 'The Account Tax Line object',\n      properties: {\n        taxLineId: {\n          type: 'number',\n          description: 'The identifier of the tax line associated with this account tax line. You can see a list of all available values for this field by calling the endpoint for account tax lines.'\n        },\n        taxLineName: {\n          type: 'string',\n          description: 'The name of the tax line associated with this account tax line, as it appears on the tax form.'\n        }\n      },\n      required: [        'taxLineId',\n        'taxLineName'\n      ]\n    }\n  }\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {
@@ -26,13 +27,19 @@ export const tool: Tool = {
         description:
           'The ID of the EndUser to receive this request (e.g., `"Conductor-End-User-Id: {{END_USER_ID}}"`).',
       },
+      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/).',
+      },
     },
   },
 };
 
 export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {
   const body = args as any;
-  return asTextContentResult(await conductor.qbd.accountTaxLines.list(body));
+  return asTextContentResult(await maybeFilter(args, await conductor.qbd.accountTaxLines.list(body)));
 };
 
 export default { metadata, tool, handler };

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

@@ -16,7 +16,8 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'create_qbd_accounts',
-  description: 'Creates a new financial account.',
+  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 financial account.",
   inputSchema: {
     type: 'object',
     properties: {

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

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

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

@@ -16,7 +16,8 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'retrieve_qbd_accounts',
-  description: 'Retrieves an account by ID.',
+  description:
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nRetrieves an account by ID.",
   inputSchema: {
     type: 'object',
     properties: {

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

@@ -16,7 +16,8 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'update_qbd_accounts',
-  description: 'Updates an existing financial account.',
+  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 financial account.",
   inputSchema: {
     type: 'object',
     properties: {

package/src/tools/qbd/bill-check-payments/create-qbd-bill-check-payments.ts

@@ -16,7 +16,8 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'create_qbd_bill_check_payments',
-  description: 'Creates a new bill check payment.',
+  description:
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nCreates a new bill check payment.",
   inputSchema: {
     type: 'object',
     properties: {

package/src/tools/qbd/bill-check-payments/delete-qbd-bill-check-payments.ts

@@ -1,5 +1,6 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+import { maybeFilter } from 'conductor-node-mcp/filtering';
 import { asTextContentResult } from 'conductor-node-mcp/tools/types';
 
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
@@ -17,7 +18,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'delete_qbd_bill_check_payments',
   description:
-    'Permanently deletes a a bill check payment. The deletion will fail if the bill check payment is currently in use or has any linked transactions that are in use.',
+    "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\nPermanently deletes a a bill check payment. The deletion will fail if the bill check payment is currently in use or has any linked transactions that are in use.\n\n# Response Schema\n```json\n{\n  type: 'object',\n  properties: {\n    id: {\n      type: 'string',\n      description: 'The QuickBooks-assigned unique identifier of the deleted bill check payment.'\n    },\n    deleted: {\n      type: 'boolean',\n      description: 'Indicates whether the bill check payment was deleted.'\n    },\n    objectType: {\n      type: 'string',\n      description: 'The type of object. This value is always `\"qbd_bill_check_payment\"`.',\n      enum: [        'qbd_bill_check_payment'\n      ]\n    },\n    refNumber: {\n      type: 'string',\n      description: 'The case-sensitive user-defined reference number of the deleted bill check payment.'\n    }\n  },\n  required: [    'id',\n    'deleted',\n    'objectType',\n    'refNumber'\n  ]\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {
@@ -30,13 +31,19 @@ export const tool: Tool = {
         description:
           'The ID of the EndUser to receive this request (e.g., `"Conductor-End-User-Id: {{END_USER_ID}}"`).',
       },
+      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/).',
+      },
     },
   },
 };
 
 export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {
   const { id, ...body } = args as any;
-  return asTextContentResult(await conductor.qbd.billCheckPayments.delete(id, body));
+  return asTextContentResult(await maybeFilter(args, await conductor.qbd.billCheckPayments.delete(id, body)));
 };
 
 export default { metadata, tool, handler };

package/src/tools/qbd/bill-check-payments/list-qbd-bill-check-payments.ts

@@ -17,7 +17,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'list_qbd_bill_check_payments',
   description:
-    'Returns a list of bill check payments. Use the `cursor` parameter to paginate through the results.',
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nReturns a list of bill check payments. Use the `cursor` parameter to paginate through the results.",
   inputSchema: {
     type: 'object',
     properties: {
@@ -131,7 +131,8 @@ export const tool: Tool = {
 
 export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {
   const body = args as any;
-  return asTextContentResult(await conductor.qbd.billCheckPayments.list(body));
+  const response = await conductor.qbd.billCheckPayments.list(body).asResponse();
+  return asTextContentResult(await response.json());
 };
 
 export default { metadata, tool, handler };

package/src/tools/qbd/bill-check-payments/retrieve-qbd-bill-check-payments.ts

@@ -16,7 +16,8 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'retrieve_qbd_bill_check_payments',
-  description: 'Retrieves a bill check payment by ID.',
+  description:
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nRetrieves a bill check payment by ID.",
   inputSchema: {
     type: 'object',
     properties: {

package/src/tools/qbd/bill-check-payments/update-qbd-bill-check-payments.ts

@@ -16,7 +16,8 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'update_qbd_bill_check_payments',
-  description: 'Updates an existing bill check payment.',
+  description:
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nUpdates an existing bill check payment.",
   inputSchema: {
     type: 'object',
     properties: {

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

@@ -16,7 +16,8 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'create_qbd_bill_credit_card_payments',
-  description: 'Creates a new bill credit card payment.',
+  description:
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nCreates a new bill credit card payment.",
   inputSchema: {
     type: 'object',
     properties: {