conductor-node-mcp 13.1.0 → 14.1.0

package/src/dynamic-tools.ts

@@ -1,159 +0,0 @@
-import Conductor from 'conductor-node';
-import { Endpoint, asTextContentResult, ToolCallResult } from './tools/types';
-import { zodToJsonSchema } from 'zod-to-json-schema';
-import { z } from 'zod';
-import { Cabidela } from '@cloudflare/cabidela';
-
-function zodToInputSchema(schema: z.ZodSchema) {
-  return {
-    type: 'object' as const,
-    ...(zodToJsonSchema(schema) as any),
-  };
-}
-
-/**
- * A list of tools that expose all the endpoints in the API dynamically.
- *
- * Instead of exposing every endpoint as its own tool, which uses up too many tokens for LLMs to use at once,
- * we expose a single tool that can be used to search for endpoints by name, resource, operation, or tag, and then
- * a generic endpoint that can be used to invoke any endpoint with the provided arguments.
- *
- * @param endpoints - The endpoints to include in the list.
- */
-export function dynamicTools(endpoints: Endpoint[]): Endpoint[] {
-  const listEndpointsSchema = z.object({
-    search_query: z
-      .string()
-      .optional()
-      .describe(
-        'An optional search query to filter the endpoints by. Provide a partial name, resource, operation, or tag to filter the endpoints returned.',
-      ),
-  });
-
-  const listEndpointsTool = {
-    metadata: {
-      resource: 'dynamic_tools',
-      operation: 'read' as const,
-      tags: [],
-    },
-    tool: {
-      name: 'list_api_endpoints',
-      description: 'List or search for all endpoints in the QuickBooks Desktop Node.js API',
-      inputSchema: zodToInputSchema(listEndpointsSchema),
-    },
-    handler: async (
-      client: Conductor,
-      args: Record<string, unknown> | undefined,
-    ): Promise<ToolCallResult> => {
-      const query = args && listEndpointsSchema.parse(args).search_query?.trim();
-
-      const filteredEndpoints =
-        query && query.length > 0 ?
-          endpoints.filter((endpoint) => {
-            const fieldsToMatch = [
-              endpoint.tool.name,
-              endpoint.tool.description,
-              endpoint.metadata.resource,
-              endpoint.metadata.operation,
-              ...endpoint.metadata.tags,
-            ];
-            return fieldsToMatch.some((field) => field && field.toLowerCase().includes(query.toLowerCase()));
-          })
-        : endpoints;
-
-      return asTextContentResult({
-        tools: filteredEndpoints.map(({ tool, metadata }) => ({
-          name: tool.name,
-          description: tool.description,
-          resource: metadata.resource,
-          operation: metadata.operation,
-          tags: metadata.tags,
-        })),
-      });
-    },
-  };
-
-  const getEndpointSchema = z.object({
-    endpoint: z.string().describe('The name of the endpoint to get the schema for.'),
-  });
-  const getEndpointTool = {
-    metadata: {
-      resource: 'dynamic_tools',
-      operation: 'read' as const,
-      tags: [],
-    },
-    tool: {
-      name: 'get_api_endpoint_schema',
-      description:
-        'Get the schema for an endpoint in the QuickBooks Desktop Node.js API. You can use the schema returned by this tool to invoke an endpoint with the `invoke_api_endpoint` tool.',
-      inputSchema: zodToInputSchema(getEndpointSchema),
-    },
-    handler: async (client: Conductor, args: Record<string, unknown> | undefined) => {
-      if (!args) {
-        throw new Error('No endpoint provided');
-      }
-      const endpointName = getEndpointSchema.parse(args).endpoint;
-
-      const endpoint = endpoints.find((e) => e.tool.name === endpointName);
-      if (!endpoint) {
-        throw new Error(`Endpoint ${endpointName} not found`);
-      }
-      return asTextContentResult(endpoint.tool);
-    },
-  };
-
-  const invokeEndpointSchema = z.object({
-    endpoint_name: z.string().describe('The name of the endpoint to invoke.'),
-    args: z
-      .record(z.string(), z.any())
-      .describe(
-        'The arguments to pass to the endpoint. This must match the schema returned by the `get_api_endpoint_schema` tool.',
-      ),
-  });
-
-  const invokeEndpointTool = {
-    metadata: {
-      resource: 'dynamic_tools',
-      operation: 'write' as const,
-      tags: [],
-    },
-    tool: {
-      name: 'invoke_api_endpoint',
-      description:
-        'Invoke an endpoint in the QuickBooks Desktop Node.js API. Note: use the `list_api_endpoints` tool to get the list of endpoints and `get_api_endpoint_schema` tool to get the schema for an endpoint.',
-      inputSchema: zodToInputSchema(invokeEndpointSchema),
-    },
-    handler: async (
-      client: Conductor,
-      args: Record<string, unknown> | undefined,
-    ): Promise<ToolCallResult> => {
-      if (!args) {
-        throw new Error('No endpoint provided');
-      }
-      const { success, data, error } = invokeEndpointSchema.safeParse(args);
-      if (!success) {
-        throw new Error(`Invalid arguments for endpoint. ${error?.format()}`);
-      }
-      const { endpoint_name, args: endpointArgs } = data;
-
-      const endpoint = endpoints.find((e) => e.tool.name === endpoint_name);
-      if (!endpoint) {
-        throw new Error(
-          `Endpoint ${endpoint_name} not found. Use the \`list_api_endpoints\` tool to get the list of available endpoints.`,
-        );
-      }
-
-      try {
-        // Try to validate the arguments for a better error message
-        const cabidela = new Cabidela(endpoint.tool.inputSchema, { fullErrors: true });
-        cabidela.validate(endpointArgs);
-      } catch (error) {
-        throw new Error(`Invalid arguments for endpoint ${endpoint_name}:\n${error}`);
-      }
-
-      return await endpoint.handler(client, endpointArgs);
-    },
-  };
-
-  return [getEndpointTool, listEndpointsTool, invokeEndpointTool];
-}

package/src/filtering.ts

@@ -1,18 +0,0 @@
-// @ts-nocheck
-import initJq from 'jq-web';
-
-export async function maybeFilter(jqFilter: unknown | undefined, response: any): Promise<any> {
-  if (jqFilter && typeof jqFilter === 'string') {
-    return await jq(response, jqFilter);
-  } else {
-    return response;
-  }
-}
-
-async function jq(json: any, jqFilter: string) {
-  return (await initJq).json(json, jqFilter);
-}
-
-export function isJqError(error: any): error is Error {
-  return error instanceof Error && 'stderr' in error;
-}

package/src/tools/auth-sessions/create-auth-sessions.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: 'auth_sessions',
-  operation: 'write',
-  tags: [],
-  httpMethod: 'post',
-  httpPath: '/auth-sessions',
-};
-
-export const tool: Tool = {
-  name: 'create_auth_sessions',
-  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\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: {
-      endUserId: {
-        type: 'string',
-        description: 'The ID of the end-user for whom to create the integration connection.',
-      },
-      publishableKey: {
-        type: 'string',
-        description:
-          "Your Conductor publishable key, which we use to create the auth session's `authFlowUrl`.",
-      },
-      linkExpiryMins: {
-        type: 'number',
-        description:
-          'The number of minutes after which the auth session will expire. Must be at least 15 minutes and no more than 7 days. If not provided, defaults to 30 minutes.',
-      },
-      redirectUrl: {
-        type: 'string',
-        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/).',
-      },
-    },
-    required: ['endUserId', 'publishableKey'],
-  },
-  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.authSessions.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/end-users/create-end-users.ts

@@ -1,62 +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: 'end_users',
-  operation: 'write',
-  tags: [],
-  httpMethod: 'post',
-  httpPath: '/end-users',
-};
-
-export const tool: Tool = {
-  name: 'create_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\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: {
-      companyName: {
-        type: 'string',
-        description: "The end-user's company name that will be shown elsewhere in Conductor.",
-      },
-      email: {
-        type: 'string',
-        description:
-          "The end-user's email address for identification purposes. Setting this field will not cause any emails to be sent.",
-      },
-      sourceId: {
-        type: 'string',
-        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/).',
-      },
-    },
-    required: ['companyName', 'email', 'sourceId'],
-  },
-  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.endUsers.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/end-users/delete-end-users.ts

@@ -1,54 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-import { isJqError, maybeFilter } from 'conductor-node-mcp/filtering';
-import { Metadata, asErrorResult, asTextContentResult } from 'conductor-node-mcp/tools/types';
-
-import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import Conductor from 'conductor-node';
-
-export const metadata: Metadata = {
-  resource: 'end_users',
-  operation: 'write',
-  tags: [],
-  httpMethod: 'delete',
-  httpPath: '/end-users/{id}',
-};
-
-export const tool: Tool = {
-  name: 'delete_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\nPermanently deletes an end-user object and all of its connections.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/end_user_delete_response',\n  $defs: {\n    end_user_delete_response: {\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  }\n}\n```",
-  inputSchema: {
-    type: 'object',
-    properties: {
-      id: {
-        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/).',
-      },
-    },
-    required: ['id'],
-  },
-  annotations: {
-    idempotentHint: 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.endUsers.delete(id)));
-  } catch (error) {
-    if (error instanceof Conductor.APIError || isJqError(error)) {
-      return asErrorResult(error.message);
-    }
-    throw error;
-  }
-};
-
-export default { metadata, tool, handler };

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

@@ -1,50 +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: 'end_users',
-  operation: 'read',
-  tags: [],
-  httpMethod: 'get',
-  httpPath: '/end-users',
-};
-
-export const tool: Tool = {
-  name: 'list_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  $ref: '#/$defs/end_user_list_response',\n  $defs: {\n    end_user_list_response: {\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    },\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: {
-      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: [],
-  },
-  annotations: {
-    readOnlyHint: true,
-  },
-};
-
-export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {
-  const { jq_filter } = args as any;
-  try {
-    return asTextContentResult(await maybeFilter(jq_filter, await conductor.endUsers.list()));
-  } catch (error) {
-    if (error instanceof Conductor.APIError || isJqError(error)) {
-      return asErrorResult(error.message);
-    }
-    throw error;
-  }
-};
-
-export default { metadata, tool, handler };

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

@@ -1,64 +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: 'end_users',
-  operation: 'write',
-  tags: [],
-  httpMethod: 'post',
-  httpPath: '/end-users/{id}/passthrough/{integrationSlug}',
-};
-
-export const tool: Tool = {
-  name: 'passthrough_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\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  $ref: '#/$defs/end_user_passthrough_response',\n  $defs: {\n    end_user_passthrough_response: {\n      type: 'object',\n      description: 'The response from the integration connection.',\n      additionalProperties: true\n    }\n  }\n}\n```",
-  inputSchema: {
-    type: 'object',
-    properties: {
-      id: {
-        type: 'string',
-        description: 'The ID of the end-user who owns the integration connection.',
-      },
-      integrationSlug: {
-        type: 'string',
-        description: "The integration identifier for the end-user's connection.",
-        enum: ['quickbooks_desktop'],
-      },
-      qbd_payload: {
-        type: 'object',
-        description: 'The request body to send to the integration connection.',
-        additionalProperties: 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: ['id', 'integrationSlug', 'qbd_payload'],
-  },
-  annotations: {},
-};
-
-export const handler = async (conductor: Conductor, args: Record<string, unknown> | undefined) => {
-  const { integrationSlug, jq_filter, ...body } = args as any;
-  try {
-    return asTextContentResult(
-      await maybeFilter(jq_filter, await conductor.endUsers.passthrough(integrationSlug, body)),
-    );
-  } catch (error) {
-    if (error instanceof Conductor.APIError || isJqError(error)) {
-      return asErrorResult(error.message);
-    }
-    throw error;
-  }
-};
-
-export default { metadata, tool, handler };

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

@@ -1,54 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-import { isJqError, maybeFilter } from 'conductor-node-mcp/filtering';
-import { Metadata, asErrorResult, asTextContentResult } from 'conductor-node-mcp/tools/types';
-
-import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import Conductor from 'conductor-node';
-
-export const metadata: Metadata = {
-  resource: 'end_users',
-  operation: 'read',
-  tags: [],
-  httpMethod: 'get',
-  httpPath: '/end-users/{id}',
-};
-
-export const tool: Tool = {
-  name: 'retrieve_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\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: {
-      id: {
-        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/).',
-      },
-    },
-    required: ['id'],
-  },
-  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.endUsers.retrieve(id)));
-  } catch (error) {
-    if (error instanceof Conductor.APIError || isJqError(error)) {
-      return asErrorResult(error.message);
-    }
-    throw error;
-  }
-};
-
-export default { metadata, tool, handler };