@henrylabs/mcp 0.15.0 → 0.18.0

package/src/dynamic-tools.ts

@@ -1,153 +0,0 @@
-import HenrySDK from '@henrylabs/sdk';
-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 Henry SDK TypeScript API',
-      inputSchema: zodToInputSchema(listEndpointsSchema),
-    },
-    handler: async (client: HenrySDK, 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 Henry SDK TypeScript 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: HenrySDK, 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 Henry SDK TypeScript 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: HenrySDK, 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/cart/create-cart-checkout.ts

@@ -1,60 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-import { isJqError, maybeFilter } from '@henrylabs/mcp/filtering';
-import { Metadata, asErrorResult, asTextContentResult } from '@henrylabs/mcp/tools/types';
-
-import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import HenrySDK from '@henrylabs/sdk';
-
-export const metadata: Metadata = {
-  resource: 'cart',
-  operation: 'write',
-  tags: [],
-  httpMethod: 'post',
-  httpPath: '/cart/checkout',
-  operationId: 'createHostedCheckoutPage',
-};
-
-export const tool: Tool = {
-  name: 'create_cart_checkout',
-  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\nGenerates a fully-hosted checkout URL for the user's cart. This is the SIMPLEST checkout method.\n\nThe hosted page handles:\n- Order review\n- Shipping address collection\n- Payment information (via Stripe)\n- Order confirmation\n- All UI and validation\n\nReturns: checkout_url (direct link for user to complete purchase)\n\nParameters:\n- auth: true (default) - requires user authentication, false for guest checkout\n\nUse this when:\n- You want a quick, complete checkout solution\n- Don't need custom checkout UI\n- Want Stripe to handle payment collection\n\nFor custom checkout UI, use the headless flow instead:\ncreate_checkout_session → collect_payment_details → confirm_checkout_session\n\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/cart_create_checkout_response',\n  $defs: {\n    cart_create_checkout_response: {\n      type: 'object',\n      properties: {\n        message: {\n          type: 'string'\n        },\n        status: {\n          type: 'string'\n        },\n        success: {\n          type: 'boolean'\n        },\n        data: {\n          type: 'object',\n          properties: {\n            checkout_url: {\n              type: 'string'\n            }\n          },\n          required: [            'checkout_url'\n          ]\n        }\n      },\n      required: [        'message',\n        'status',\n        'success'\n      ]\n    }\n  }\n}\n```",
-  inputSchema: {
-    type: 'object',
-    properties: {
-      'x-user-id': {
-        type: 'string',
-      },
-      auth: {
-        type: 'boolean',
-        description: 'Whether authentication is required for checkout (default: true)',
-      },
-      region: {
-        type: 'string',
-        description: 'ISO 3166-1 alpha-2 country code (2-character lowercase string)',
-      },
-      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: ['x-user-id'],
-  },
-  annotations: {},
-};
-
-export const handler = async (client: HenrySDK, args: Record<string, unknown> | undefined) => {
-  const { jq_filter, ...body } = args as any;
-  try {
-    return asTextContentResult(await maybeFilter(jq_filter, await client.cart.createCheckout(body)));
-  } catch (error) {
-    if (error instanceof HenrySDK.APIError || isJqError(error)) {
-      return asErrorResult(error.message);
-    }
-    throw error;
-  }
-};
-
-export default { metadata, tool, handler };

package/src/tools/cart/items/add-cart-items.ts

@@ -1,100 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-import { isJqError, maybeFilter } from '@henrylabs/mcp/filtering';
-import { Metadata, asErrorResult, asTextContentResult } from '@henrylabs/mcp/tools/types';
-
-import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import HenrySDK from '@henrylabs/sdk';
-
-export const metadata: Metadata = {
-  resource: 'cart.items',
-  operation: 'write',
-  tags: [],
-  httpMethod: 'post',
-  httpPath: '/cart/items',
-  operationId: 'addCartItems',
-};
-
-export const tool: Tool = {
-  name: 'add_cart_items',
-  description:
-    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nAdd products to cart or update quantities if already in cart.\n\nRequired fields per product:\n- name: Product name (from retrieve_product_details)\n- price: Price as string, e.g. \"29.99\" (from stores[0].price)\n- productLink: Store URL (from stores[0].link - MUST call retrieve_product_details first)\n- quantity: Number of items\n\nOptional but IMPORTANT:\n- metadata: Object containing variant selections (size, color, etc.)\n  Example: {\"size\": \"Large\", \"color\": \"Blue\"}\n- productImageLink: Thumbnail URL (from thumbnails[0])\n- affiliateProductLink: Use instead of productLink for affiliate tracking\n- productId: Include for easier tracking\n\nVARIANT HANDLING:\nIf retrieve_product_details shows variants array, you MUST:\n1. Show variants to user: \"Available sizes: S, M, L, XL\"\n2. Get user's selection\n3. Include in metadata: {\"size\": \"L\"}\n\nOptional: Set checkVariantAvailability: true to verify variants exist at stores\n\nReturns:\n- added_products: New items in cart\n- updated_products: Items with quantity increases\n- cart_summary: total_items and total_unique_products\n- variant_checks: Availability verification results (if requested)\n\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/item_add_response',\n  $defs: {\n    item_add_response: {\n      type: 'object',\n      properties: {\n        message: {\n          type: 'string'\n        },\n        status: {\n          type: 'string'\n        },\n        success: {\n          type: 'boolean'\n        },\n        data: {\n          type: 'object',\n          properties: {\n            added_products: {\n              type: 'array',\n              items: {\n                type: 'object',\n                properties: {\n                  name: {\n                    type: 'string'\n                  },\n                  price: {\n                    type: 'string'\n                  },\n                  productId: {\n                    type: 'string'\n                  },\n                  quantity: {\n                    type: 'number'\n                  }\n                },\n                required: [                  'name',\n                  'price',\n                  'productId',\n                  'quantity'\n                ]\n              }\n            },\n            cart_summary: {\n              type: 'object',\n              properties: {\n                total_items: {\n                  type: 'number'\n                },\n                total_unique_products: {\n                  type: 'number'\n                }\n              },\n              required: [                'total_items',\n                'total_unique_products'\n              ]\n            },\n            updated_products: {\n              type: 'array',\n              items: {\n                type: 'object',\n                properties: {\n                  addedQuantity: {\n                    type: 'number'\n                  },\n                  name: {\n                    type: 'string'\n                  },\n                  previousQuantity: {\n                    type: 'number'\n                  },\n                  price: {\n                    type: 'string'\n                  },\n                  productId: {\n                    type: 'string'\n                  },\n                  quantity: {\n                    type: 'number'\n                  }\n                },\n                required: [                  'addedQuantity',\n                  'name',\n                  'previousQuantity',\n                  'price',\n                  'productId',\n                  'quantity'\n                ]\n              }\n            },\n            variant_checks: {\n              type: 'array',\n              items: {\n                type: 'object',\n                properties: {\n                  productId: {\n                    type: 'string'\n                  },\n                  status: {\n                    type: 'string'\n                  },\n                  variantCheckRequestId: {\n                    type: 'string'\n                  }\n                },\n                required: [                  'productId',\n                  'status',\n                  'variantCheckRequestId'\n                ]\n              }\n            }\n          },\n          required: [            'added_products',\n            'cart_summary',\n            'updated_products'\n          ]\n        }\n      },\n      required: [        'message',\n        'status',\n        'success'\n      ]\n    }\n  }\n}\n```",
-  inputSchema: {
-    type: 'object',
-    properties: {
-      productsDetails: {
-        type: 'array',
-        items: {
-          type: 'object',
-          properties: {
-            name: {
-              type: 'string',
-              description: 'Product name',
-            },
-            price: {
-              type: 'string',
-              description: 'Product price',
-            },
-            productLink: {
-              type: 'string',
-              description: 'Product link',
-            },
-            quantity: {
-              type: 'number',
-              description: 'Quantity',
-            },
-            affiliateProductLink: {
-              type: 'string',
-              description:
-                'Affiliate product link (if provided, will be used instead of productLink for order fulfillment)',
-            },
-            metadata: {
-              type: 'object',
-              description: 'Product metadata',
-              additionalProperties: true,
-            },
-            productId: {
-              type: 'string',
-              description: 'Product Id',
-            },
-            productImageLink: {
-              type: 'string',
-              description: 'Product image link (thumbnail)',
-            },
-          },
-          required: ['name', 'price', 'productLink', 'quantity'],
-        },
-      },
-      'x-user-id': {
-        type: 'string',
-      },
-      checkVariantAvailability: {
-        type: 'boolean',
-        description:
-          'Whether to check variant availability after adding to cart. If true, variant check requests will be created for products with metadata and requestIds returned.',
-      },
-      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: ['productsDetails', 'x-user-id'],
-  },
-  annotations: {},
-};
-
-export const handler = async (client: HenrySDK, args: Record<string, unknown> | undefined) => {
-  const { jq_filter, ...body } = args as any;
-  try {
-    return asTextContentResult(await maybeFilter(jq_filter, await client.cart.items.add(body)));
-  } catch (error) {
-    if (error instanceof HenrySDK.APIError || isJqError(error)) {
-      return asErrorResult(error.message);
-    }
-    throw error;
-  }
-};
-
-export default { metadata, tool, handler };

package/src/tools/cart/items/clear-cart-items.ts

@@ -1,54 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-import { isJqError, maybeFilter } from '@henrylabs/mcp/filtering';
-import { Metadata, asErrorResult, asTextContentResult } from '@henrylabs/mcp/tools/types';
-
-import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import HenrySDK from '@henrylabs/sdk';
-
-export const metadata: Metadata = {
-  resource: 'cart.items',
-  operation: 'write',
-  tags: [],
-  httpMethod: 'delete',
-  httpPath: '/cart/items',
-  operationId: 'deleteAllCartItems',
-};
-
-export const tool: Tool = {
-  name: 'clear_cart_items',
-  description:
-    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nRemove ALL products from the cart. Cannot be undone.\n\nUse when:\n- User wants to start over\n- Clearing abandoned cart\n- After successful order completion\n\nReturns success confirmation message.\n\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/item_clear_response',\n  $defs: {\n    item_clear_response: {\n      type: 'object',\n      properties: {\n        message: {\n          type: 'string'\n        },\n        status: {\n          type: 'string'\n        },\n        success: {\n          type: 'boolean'\n        }\n      },\n      required: [        'message',\n        'status',\n        'success'\n      ]\n    }\n  }\n}\n```",
-  inputSchema: {
-    type: 'object',
-    properties: {
-      'x-user-id': {
-        type: 'string',
-      },
-      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: ['x-user-id'],
-  },
-  annotations: {
-    idempotentHint: true,
-  },
-};
-
-export const handler = async (client: HenrySDK, args: Record<string, unknown> | undefined) => {
-  const { jq_filter, ...body } = args as any;
-  try {
-    return asTextContentResult(await maybeFilter(jq_filter, await client.cart.items.clear(body)));
-  } catch (error) {
-    if (error instanceof HenrySDK.APIError || isJqError(error)) {
-      return asErrorResult(error.message);
-    }
-    throw error;
-  }
-};
-
-export default { metadata, tool, handler };

package/src/tools/cart/items/list-cart-items.ts

@@ -1,54 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-import { isJqError, maybeFilter } from '@henrylabs/mcp/filtering';
-import { Metadata, asErrorResult, asTextContentResult } from '@henrylabs/mcp/tools/types';
-
-import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import HenrySDK from '@henrylabs/sdk';
-
-export const metadata: Metadata = {
-  resource: 'cart.items',
-  operation: 'read',
-  tags: [],
-  httpMethod: 'get',
-  httpPath: '/cart/items',
-  operationId: 'getCartItems',
-};
-
-export const tool: Tool = {
-  name: 'list_cart_items',
-  description:
-    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nRetrieve all products currently in the user's cart.\n\nReturns products array with:\n- name, price, productLink, quantity\n- productId (if provided when added)\n- metadata (variant selections)\n- productImageLink (thumbnail)\n- affiliateProductLink (if used)\n\nUse this to:\n- Show cart contents before checkout\n- Calculate totals\n- Verify items before creating checkout\n\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/item_list_response',\n  $defs: {\n    item_list_response: {\n      type: 'object',\n      properties: {\n        message: {\n          type: 'string'\n        },\n        status: {\n          type: 'string'\n        },\n        success: {\n          type: 'boolean'\n        },\n        data: {\n          type: 'object',\n          properties: {\n            products: {\n              type: 'array',\n              items: {\n                type: 'object',\n                properties: {\n                  name: {\n                    type: 'string',\n                    description: 'Product name'\n                  },\n                  price: {\n                    type: 'string',\n                    description: 'Product price'\n                  },\n                  productLink: {\n                    type: 'string',\n                    description: 'Product link'\n                  },\n                  quantity: {\n                    type: 'number',\n                    description: 'Quantity'\n                  },\n                  affiliateProductLink: {\n                    type: 'string',\n                    description: 'Affiliate product link (if provided, will be used instead of productLink for order fulfillment)'\n                  },\n                  metadata: {\n                    type: 'object',\n                    description: 'Product metadata',\n                    additionalProperties: true\n                  },\n                  productId: {\n                    type: 'string',\n                    description: 'Product Id'\n                  },\n                  productImageLink: {\n                    type: 'string',\n                    description: 'Product image link (thumbnail)'\n                  }\n                },\n                required: [                  'name',\n                  'price',\n                  'productLink',\n                  'quantity'\n                ]\n              }\n            }\n          },\n          required: [            'products'\n          ]\n        }\n      },\n      required: [        'message',\n        'status',\n        'success'\n      ]\n    }\n  }\n}\n```",
-  inputSchema: {
-    type: 'object',
-    properties: {
-      'x-user-id': {
-        type: 'string',
-      },
-      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: ['x-user-id'],
-  },
-  annotations: {
-    readOnlyHint: true,
-  },
-};
-
-export const handler = async (client: HenrySDK, args: Record<string, unknown> | undefined) => {
-  const { jq_filter, ...body } = args as any;
-  try {
-    return asTextContentResult(await maybeFilter(jq_filter, await client.cart.items.list(body)));
-  } catch (error) {
-    if (error instanceof HenrySDK.APIError || isJqError(error)) {
-      return asErrorResult(error.message);
-    }
-    throw error;
-  }
-};
-
-export default { metadata, tool, handler };

package/src/tools/cart/items/remove-cart-items.ts

@@ -1,57 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-import { isJqError, maybeFilter } from '@henrylabs/mcp/filtering';
-import { Metadata, asErrorResult, asTextContentResult } from '@henrylabs/mcp/tools/types';
-
-import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import HenrySDK from '@henrylabs/sdk';
-
-export const metadata: Metadata = {
-  resource: 'cart.items',
-  operation: 'write',
-  tags: [],
-  httpMethod: 'delete',
-  httpPath: '/cart/items/{productId}',
-  operationId: 'deleteCartItem',
-};
-
-export const tool: Tool = {
-  name: 'remove_cart_items',
-  description:
-    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nRemove a specific product from the cart by its productId.\n\nRequired: productId (must match the ID used when adding item)\n\nReturns success confirmation message.\n\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/item_remove_response',\n  $defs: {\n    item_remove_response: {\n      type: 'object',\n      properties: {\n        message: {\n          type: 'string'\n        },\n        status: {\n          type: 'string'\n        },\n        success: {\n          type: 'boolean'\n        }\n      },\n      required: [        'message',\n        'status',\n        'success'\n      ]\n    }\n  }\n}\n```",
-  inputSchema: {
-    type: 'object',
-    properties: {
-      productId: {
-        type: 'string',
-      },
-      'x-user-id': {
-        type: 'string',
-      },
-      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: ['productId', 'x-user-id'],
-  },
-  annotations: {
-    idempotentHint: true,
-  },
-};
-
-export const handler = async (client: HenrySDK, args: Record<string, unknown> | undefined) => {
-  const { productId, jq_filter, ...body } = args as any;
-  try {
-    return asTextContentResult(await maybeFilter(jq_filter, await client.cart.items.remove(productId, body)));
-  } catch (error) {
-    if (error instanceof HenrySDK.APIError || isJqError(error)) {
-      return asErrorResult(error.message);
-    }
-    throw error;
-  }
-};
-
-export default { metadata, tool, handler };

package/src/tools/index.ts

@@ -1,87 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-import { Metadata, Endpoint, HandlerFunction } from './types';
-
-export { Metadata, Endpoint, HandlerFunction };
-
-import retrieve_product_details from './products/retrieve-product-details';
-import search_products from './products/search-products';
-import create_cart_checkout from './cart/create-cart-checkout';
-import list_cart_items from './cart/items/list-cart-items';
-import add_cart_items from './cart/items/add-cart-items';
-import clear_cart_items from './cart/items/clear-cart-items';
-import remove_cart_items from './cart/items/remove-cart-items';
-import retrieve_status_orders from './orders/retrieve-status-orders';
-import collect_payment_details from './wallet/collect-payment-details';
-
-export const endpoints: Endpoint[] = [];
-
-function addEndpoint(endpoint: Endpoint) {
-  endpoints.push(endpoint);
-}
-
-addEndpoint(retrieve_product_details);
-addEndpoint(search_products);
-addEndpoint(create_cart_checkout);
-addEndpoint(list_cart_items);
-addEndpoint(add_cart_items);
-addEndpoint(clear_cart_items);
-addEndpoint(remove_cart_items);
-addEndpoint(retrieve_status_orders);
-addEndpoint(collect_payment_details);
-
-export type Filter = {
-  type: 'resource' | 'operation' | 'tag' | 'tool';
-  op: 'include' | 'exclude';
-  value: string;
-};
-
-export function query(filters: Filter[], endpoints: Endpoint[]): Endpoint[] {
-  const allExcludes = filters.length > 0 && filters.every((filter) => filter.op === 'exclude');
-  const unmatchedFilters = new Set(filters);
-
-  const filtered = endpoints.filter((endpoint: Endpoint) => {
-    let included = false || allExcludes;
-
-    for (const filter of filters) {
-      if (match(filter, endpoint)) {
-        unmatchedFilters.delete(filter);
-        included = filter.op === 'include';
-      }
-    }
-
-    return included;
-  });
-
-  // Check if any filters didn't match
-  const unmatched = Array.from(unmatchedFilters).filter((f) => f.type === 'tool' || f.type === 'resource');
-  if (unmatched.length > 0) {
-    throw new Error(
-      `The following filters did not match any endpoints: ${unmatched
-        .map((f) => `${f.type}=${f.value}`)
-        .join(', ')}`,
-    );
-  }
-
-  return filtered;
-}
-
-function match({ type, value }: Filter, endpoint: Endpoint): boolean {
-  switch (type) {
-    case 'resource': {
-      const regexStr = '^' + normalizeResource(value).replace(/\*/g, '.*') + '$';
-      const regex = new RegExp(regexStr);
-      return regex.test(normalizeResource(endpoint.metadata.resource));
-    }
-    case 'operation':
-      return endpoint.metadata.operation === value;
-    case 'tag':
-      return endpoint.metadata.tags.includes(value);
-    case 'tool':
-      return endpoint.tool.name === value;
-  }
-}
-
-function normalizeResource(resource: string): string {
-  return resource.toLowerCase().replace(/[^a-z.*\-_]*/g, '');
-}

package/src/tools/orders/retrieve-status-orders.ts

@@ -1,54 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-import { isJqError, maybeFilter } from '@henrylabs/mcp/filtering';
-import { Metadata, asErrorResult, asTextContentResult } from '@henrylabs/mcp/tools/types';
-
-import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import HenrySDK from '@henrylabs/sdk';
-
-export const metadata: Metadata = {
-  resource: 'orders',
-  operation: 'read',
-  tags: [],
-  httpMethod: 'get',
-  httpPath: '/orders/{orderId}',
-  operationId: 'getOrderStatus',
-};
-
-export const tool: Tool = {
-  name: 'retrieve_status_orders',
-  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\nCheck the status and details of an order using its order ID.\n\nReturns:\n- id: Order ID\n- status: Current order status (e.g., \"processing\", \"shipped\", \"delivered\")\n- statusMessage: Detailed status description\n- products: Array with productName, quantity, productMetadata (variants)\n- currency, subtotal, shipping, tax, grandTotal\n- shippingDetails: Full delivery address\n- userId: User who placed order\n- cardLast4: Payment card used (last 4 digits)\n\nUse for:\n- Order tracking\n- Status updates\n- Order history\n- Customer support\n\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/order_retrieve_status_response',\n  $defs: {\n    order_retrieve_status_response: {\n      type: 'object',\n      properties: {\n        message: {\n          type: 'string'\n        },\n        status: {\n          type: 'string'\n        },\n        success: {\n          type: 'boolean'\n        },\n        data: {\n          type: 'object',\n          properties: {\n            id: {\n              type: 'string'\n            },\n            currency: {\n              type: 'string'\n            },\n            grandTotal: {\n              type: 'string'\n            },\n            products: {\n              type: 'array',\n              items: {\n                type: 'object',\n                properties: {\n                  productName: {\n                    type: 'string'\n                  },\n                  quantity: {\n                    type: 'number'\n                  },\n                  productMetadata: {\n                    type: 'object',\n                    additionalProperties: true\n                  }\n                },\n                required: [                  'productName',\n                  'quantity'\n                ]\n              }\n            },\n            shipping: {\n              type: 'string'\n            },\n            status: {\n              type: 'string'\n            },\n            statusMessage: {\n              type: 'string'\n            },\n            subtotal: {\n              type: 'string'\n            },\n            tax: {\n              type: 'string'\n            },\n            userId: {\n              type: 'string'\n            },\n            shippingDetails: {\n              type: 'object',\n              properties: {\n                addressLine1: {\n                  type: 'string'\n                },\n                city: {\n                  type: 'string'\n                },\n                countryCode: {\n                  type: 'string'\n                },\n                email: {\n                  type: 'string'\n                },\n                fullName: {\n                  type: 'string'\n                },\n                phoneNumber: {\n                  type: 'string'\n                },\n                postalCode: {\n                  type: 'string'\n                },\n                stateOrProvince: {\n                  type: 'string'\n                },\n                addressLine2: {\n                  type: 'string'\n                }\n              },\n              required: [                'addressLine1',\n                'city',\n                'countryCode',\n                'email',\n                'fullName',\n                'phoneNumber',\n                'postalCode',\n                'stateOrProvince'\n              ]\n            }\n          },\n          required: [            'id',\n            'currency',\n            'grandTotal',\n            'products',\n            'shipping',\n            'status',\n            'statusMessage',\n            'subtotal',\n            'tax',\n            'userId'\n          ]\n        }\n      },\n      required: [        'message',\n        'status',\n        'success'\n      ]\n    }\n  }\n}\n```",
-  inputSchema: {
-    type: 'object',
-    properties: {
-      orderId: {
-        type: 'string',
-      },
-      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: ['orderId'],
-  },
-  annotations: {
-    readOnlyHint: true,
-  },
-};
-
-export const handler = async (client: HenrySDK, args: Record<string, unknown> | undefined) => {
-  const { orderId, jq_filter, ...body } = args as any;
-  try {
-    return asTextContentResult(await maybeFilter(jq_filter, await client.orders.retrieveStatus(orderId)));
-  } catch (error) {
-    if (error instanceof HenrySDK.APIError || isJqError(error)) {
-      return asErrorResult(error.message);
-    }
-    throw error;
-  }
-};
-
-export default { metadata, tool, handler };