@henrylabs/mcp 0.10.0 → 0.12.0

package/README.md

@@ -241,7 +241,7 @@ The following tools are available in this MCP server.
 
 ### Resource `products`:
 
-- `retrieve_product_details` (`read`) tags: [headless, hosted]: Retrieve comprehensive product details using a product ID from search results.
+- `retrieve_product_details` (`read`): Retrieve comprehensive product details using a product ID from search results.
 
   MUST BE CALLED BEFORE adding items to cart - this is the only way to get the productLink required for cart operations.
 
@@ -252,7 +252,7 @@ The following tools are available in this MCP server.
   - Available variants (sizes, colors, etc.) with availability status
   - Thumbnail images (multiple angles)
 
-- `search_products` (`write`) tags: [headless, hosted]: Search for products using keywords and filters (price range, color, size, gender, manufacturer, region).
+- `search_products` (`write`): Search for products using keywords and filters (price range, color, size, gender, manufacturer, region).
 
   Returns basic product information:
 
@@ -277,7 +277,7 @@ The following tools are available in this MCP server.
 
 ### Resource `cart`:
 
-- `create_cart_checkout` (`write`) tags: [hosted]: Generates a fully-hosted checkout URL for the user's cart. This is the SIMPLEST checkout method.
+- `create_cart_checkout` (`write`): Generates a fully-hosted checkout URL for the user's cart. This is the SIMPLEST checkout method.
 
   The hosted page handles:
 
@@ -304,7 +304,7 @@ The following tools are available in this MCP server.
 
 ### Resource `cart.items`:
 
-- `list_cart_items` (`read`) tags: [headless, hosted]: Retrieve all products currently in the user's cart.
+- `list_cart_items` (`read`) tags: [hosted]: Retrieve all products currently in the user's cart.
 
   Returns products array with:
 
@@ -320,7 +320,7 @@ The following tools are available in this MCP server.
   - Calculate totals
   - Verify items before creating checkout
 
-- `add_cart_items` (`write`) tags: [headless, hosted]: Add products to cart or update quantities if already in cart.
+- `add_cart_items` (`write`) tags: [hosted]: Add products to cart or update quantities if already in cart.
 
   Required fields per product:
 
@@ -353,7 +353,7 @@ The following tools are available in this MCP server.
   - cart_summary: total_items and total_unique_products
   - variant_checks: Availability verification results (if requested)
 
-- `clear_cart_items` (`write`) tags: [headless, hosted]: Remove ALL products from the cart. Cannot be undone.
+- `clear_cart_items` (`write`) tags: [hosted]: Remove ALL products from the cart. Cannot be undone.
 
   Use when:
 
@@ -363,7 +363,7 @@ The following tools are available in this MCP server.
 
   Returns success confirmation message.
 
-- `remove_cart_items` (`write`) tags: [headless, hosted]: Remove a specific product from the cart by its productId.
+- `remove_cart_items` (`write`) tags: [hosted]: Remove a specific product from the cart by its productId.
 
   Required: productId (must match the ID used when adding item)
 
@@ -371,7 +371,7 @@ The following tools are available in this MCP server.
 
 ### Resource `checkout.session`:
 
-- `confirm_checkout_session` (`write`) tags: [headless]: Finalize the checkout and create an order. Returns order details with order ID.
+- `confirm_checkout_session` (`write`): Finalize the checkout and create an order. Returns order details with order ID.
 
   Required:
 
@@ -392,7 +392,7 @@ The following tools are available in this MCP server.
 
   After confirmation, provide order ID to user for tracking.
 
-- `create_checkout_session` (`write`) tags: [headless]: Create/update a checkout session for headless checkout flow. Returns pricing breakdown and session token.
+- `create_checkout_session` (`write`): Create/update a checkout session for headless checkout flow. Returns pricing breakdown and session token.
 
   Required: shippingDetails object with:
 
@@ -417,7 +417,7 @@ The following tools are available in this MCP server.
 
 ### Resource `orders`:
 
-- `retrieve_status_orders` (`read`) tags: [headless, hosted]: Check the status and details of an order using its order ID.
+- `retrieve_status_orders` (`read`): Check the status and details of an order using its order ID.
 
   Returns:
 
@@ -439,7 +439,7 @@ The following tools are available in this MCP server.
 
 ### Resource `wallet`:
 
-- `collect_payment_details` (`write`) tags: [headless]: Generate a modal URL for securely collecting payment card information via Stripe.
+- `collect_payment_details` (`write`): Generate a modal URL for securely collecting payment card information via Stripe.
 
   MUST be called in headless checkout flow BEFORE confirm_checkout_session.
 

package/filtering.d.mts

@@ -1,2 +1,3 @@
 export declare function maybeFilter(jqFilter: unknown | undefined, response: any): Promise<any>;
+export declare function isJqError(error: any): error is Error;
 //# sourceMappingURL=filtering.d.mts.map

package/filtering.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"filtering.d.mts","sourceRoot":"","sources":["src/filtering.ts"],"names":[],"mappings":"AAGA,wBAAsB,WAAW,CAAC,QAAQ,EAAE,OAAO,GAAG,SAAS,EAAE,QAAQ,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAM5F"}
+{"version":3,"file":"filtering.d.mts","sourceRoot":"","sources":["src/filtering.ts"],"names":[],"mappings":"AAGA,wBAAsB,WAAW,CAAC,QAAQ,EAAE,OAAO,GAAG,SAAS,EAAE,QAAQ,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAM5F;AAMD,wBAAgB,SAAS,CAAC,KAAK,EAAE,GAAG,GAAG,KAAK,IAAI,KAAK,CAEpD"}

package/filtering.d.ts

@@ -1,2 +1,3 @@
 export declare function maybeFilter(jqFilter: unknown | undefined, response: any): Promise<any>;
+export declare function isJqError(error: any): error is Error;
 //# sourceMappingURL=filtering.d.ts.map

package/filtering.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"filtering.d.ts","sourceRoot":"","sources":["src/filtering.ts"],"names":[],"mappings":"AAGA,wBAAsB,WAAW,CAAC,QAAQ,EAAE,OAAO,GAAG,SAAS,EAAE,QAAQ,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAM5F"}
+{"version":3,"file":"filtering.d.ts","sourceRoot":"","sources":["src/filtering.ts"],"names":[],"mappings":"AAGA,wBAAsB,WAAW,CAAC,QAAQ,EAAE,OAAO,GAAG,SAAS,EAAE,QAAQ,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAM5F;AAMD,wBAAgB,SAAS,CAAC,KAAK,EAAE,GAAG,GAAG,KAAK,IAAI,KAAK,CAEpD"}

package/filtering.js

@@ -4,6 +4,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.maybeFilter = maybeFilter;
+exports.isJqError = isJqError;
 // @ts-nocheck
 const jq_web_1 = __importDefault(require("jq-web"));
 async function maybeFilter(jqFilter, response) {
@@ -17,4 +18,7 @@ async function maybeFilter(jqFilter, response) {
 async function jq(json, jqFilter) {
     return (await jq_web_1.default).json(json, jqFilter);
 }
+function isJqError(error) {
+    return error instanceof Error && 'stderr' in error;
+}
 //# sourceMappingURL=filtering.js.map

package/filtering.js.map

@@ -1 +1 @@
-{"version":3,"file":"filtering.js","sourceRoot":"","sources":["src/filtering.ts"],"names":[],"mappings":";;;;;AAGA,kCAMC;AATD,cAAc;AACd,oDAA4B;AAErB,KAAK,UAAU,WAAW,CAAC,QAA6B,EAAE,QAAa;IAC5E,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,KAAK,UAAU,EAAE,CAAC,IAAS,EAAE,QAAgB;IAC3C,OAAO,CAAC,MAAM,gBAAM,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAC7C,CAAC"}
+{"version":3,"file":"filtering.js","sourceRoot":"","sources":["src/filtering.ts"],"names":[],"mappings":";;;;;AAGA,kCAMC;AAMD,8BAEC;AAjBD,cAAc;AACd,oDAA4B;AAErB,KAAK,UAAU,WAAW,CAAC,QAA6B,EAAE,QAAa;IAC5E,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,KAAK,UAAU,EAAE,CAAC,IAAS,EAAE,QAAgB;IAC3C,OAAO,CAAC,MAAM,gBAAM,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAC7C,CAAC;AAED,SAAgB,SAAS,CAAC,KAAU;IAClC,OAAO,KAAK,YAAY,KAAK,IAAI,QAAQ,IAAI,KAAK,CAAC;AACrD,CAAC"}

package/filtering.mjs

@@ -10,4 +10,7 @@ export async function maybeFilter(jqFilter, response) {
 async function jq(json, jqFilter) {
     return (await initJq).json(json, jqFilter);
 }
+export function isJqError(error) {
+    return error instanceof Error && 'stderr' in error;
+}
 //# sourceMappingURL=filtering.mjs.map

package/filtering.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"filtering.mjs","sourceRoot":"","sources":["src/filtering.ts"],"names":[],"mappings":"OACO,MAAM,MAAM,QAAQ;AAE3B,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,QAA6B,EAAE,QAAa;IAC5E,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,KAAK,UAAU,EAAE,CAAC,IAAS,EAAE,QAAgB;IAC3C,OAAO,CAAC,MAAM,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAC7C,CAAC"}
+{"version":3,"file":"filtering.mjs","sourceRoot":"","sources":["src/filtering.ts"],"names":[],"mappings":"OACO,MAAM,MAAM,QAAQ;AAE3B,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,QAA6B,EAAE,QAAa;IAC5E,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,KAAK,UAAU,EAAE,CAAC,IAAS,EAAE,QAAgB;IAC3C,OAAO,CAAC,MAAM,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAU;IAClC,OAAO,KAAK,YAAY,KAAK,IAAI,QAAQ,IAAI,KAAK,CAAC;AACrD,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@henrylabs/mcp",
-  "version": "0.10.0",
+  "version": "0.12.0",
   "description": "The official MCP Server for the Henry SDK API",
   "author": "Henry SDK <lawrence@henry.social>",
   "types": "./index.d.ts",
@@ -27,14 +27,14 @@
     "fix": "eslint --fix --ext ts,js ."
   },
   "dependencies": {
-    "@henrylabs/sdk": "^0.10.0",
+    "@henrylabs/sdk": "^0.12.0",
     "@cloudflare/cabidela": "^0.2.4",
     "@modelcontextprotocol/sdk": "^1.11.5",
     "@valtown/deno-http-worker": "^0.0.21",
     "cors": "^2.8.5",
     "express": "^5.1.0",
     "fuse.js": "^7.1.0",
-    "jq-web": "https://github.com/stainless-api/jq-web/releases/download/v0.8.6/jq-web.tar.gz",
+    "jq-web": "https://github.com/stainless-api/jq-web/releases/download/v0.8.8/jq-web.tar.gz",
     "qs": "^6.14.0",
     "typescript": "5.8.3",
     "yargs": "^17.7.2",

package/server.js

@@ -22,7 +22,7 @@ var tools_2 = require("./tools.js");
 Object.defineProperty(exports, "endpoints", { enumerable: true, get: function () { return tools_2.endpoints; } });
 const newMcpServer = () => new mcp_js_1.McpServer({
     name: 'henrylabs_sdk_api',
-    version: '0.10.0',
+    version: '0.12.0',
 }, { capabilities: { tools: {}, logging: {} } });
 exports.newMcpServer = newMcpServer;
 // Create server instance

package/server.mjs

@@ -11,7 +11,7 @@ export { ClientType } from "./compat.mjs";
 export { endpoints } from "./tools.mjs";
 export const newMcpServer = () => new McpServer({
     name: 'henrylabs_sdk_api',
-    version: '0.10.0',
+    version: '0.12.0',
 }, { capabilities: { tools: {}, logging: {} } });
 // Create server instance
 export const server = newMcpServer();

package/src/filtering.ts

@@ -12,3 +12,7 @@ export async function maybeFilter(jqFilter: unknown | undefined, response: any):
 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/server.ts

@@ -34,7 +34,7 @@ export const newMcpServer = () =>
   new McpServer(
     {
       name: 'henrylabs_sdk_api',
-      version: '0.10.0',
+      version: '0.12.0',
     },
     { capabilities: { tools: {}, logging: {} } },
   );

package/src/tools/cart/create-cart-checkout.ts

@@ -1,7 +1,7 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { maybeFilter } from '@henrylabs/mcp/filtering';
-import { Metadata, asTextContentResult } from '@henrylabs/mcp/tools/types';
+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';
@@ -9,7 +9,7 @@ import HenrySDK from '@henrylabs/sdk';
 export const metadata: Metadata = {
   resource: 'cart',
   operation: 'write',
-  tags: ['hosted'],
+  tags: [],
   httpMethod: 'post',
   httpPath: '/cart/checkout',
   operationId: 'createHostedCheckoutPage',
@@ -43,7 +43,14 @@ export const tool: Tool = {
 
 export const handler = async (client: HenrySDK, args: Record<string, unknown> | undefined) => {
   const { jq_filter, ...body } = args as any;
-  return asTextContentResult(await maybeFilter(jq_filter, await client.cart.createCheckout(body)));
+  try {
+    return asTextContentResult(await maybeFilter(jq_filter, await client.cart.createCheckout(body)));
+  } catch (error) {
+    if (isJqError(error)) {
+      return asErrorResult(error.message);
+    }
+    throw error;
+  }
 };
 
 export default { metadata, tool, handler };

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

@@ -1,7 +1,7 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { maybeFilter } from '@henrylabs/mcp/filtering';
-import { Metadata, asTextContentResult } from '@henrylabs/mcp/tools/types';
+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';
@@ -9,7 +9,7 @@ import HenrySDK from '@henrylabs/sdk';
 export const metadata: Metadata = {
   resource: 'cart.items',
   operation: 'write',
-  tags: ['headless', 'hosted'],
+  tags: ['hosted'],
   httpMethod: 'post',
   httpPath: '/cart/items',
   operationId: 'addCartItems',
@@ -87,7 +87,14 @@ export const tool: Tool = {
 
 export const handler = async (client: HenrySDK, args: Record<string, unknown> | undefined) => {
   const { jq_filter, ...body } = args as any;
-  return asTextContentResult(await maybeFilter(jq_filter, await client.cart.items.add(body)));
+  try {
+    return asTextContentResult(await maybeFilter(jq_filter, await client.cart.items.add(body)));
+  } catch (error) {
+    if (isJqError(error)) {
+      return asErrorResult(error.message);
+    }
+    throw error;
+  }
 };
 
 export default { metadata, tool, handler };

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

@@ -1,7 +1,7 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { maybeFilter } from '@henrylabs/mcp/filtering';
-import { Metadata, asTextContentResult } from '@henrylabs/mcp/tools/types';
+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';
@@ -9,7 +9,7 @@ import HenrySDK from '@henrylabs/sdk';
 export const metadata: Metadata = {
   resource: 'cart.items',
   operation: 'write',
-  tags: ['headless', 'hosted'],
+  tags: ['hosted'],
   httpMethod: 'delete',
   httpPath: '/cart/items',
   operationId: 'deleteAllCartItems',
@@ -41,7 +41,14 @@ export const tool: Tool = {
 
 export const handler = async (client: HenrySDK, args: Record<string, unknown> | undefined) => {
   const { jq_filter, ...body } = args as any;
-  return asTextContentResult(await maybeFilter(jq_filter, await client.cart.items.clear(body)));
+  try {
+    return asTextContentResult(await maybeFilter(jq_filter, await client.cart.items.clear(body)));
+  } catch (error) {
+    if (isJqError(error)) {
+      return asErrorResult(error.message);
+    }
+    throw error;
+  }
 };
 
 export default { metadata, tool, handler };

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

@@ -1,7 +1,7 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { maybeFilter } from '@henrylabs/mcp/filtering';
-import { Metadata, asTextContentResult } from '@henrylabs/mcp/tools/types';
+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';
@@ -9,7 +9,7 @@ import HenrySDK from '@henrylabs/sdk';
 export const metadata: Metadata = {
   resource: 'cart.items',
   operation: 'read',
-  tags: ['headless', 'hosted'],
+  tags: ['hosted'],
   httpMethod: 'get',
   httpPath: '/cart/items',
   operationId: 'getCartItems',
@@ -41,7 +41,14 @@ export const tool: Tool = {
 
 export const handler = async (client: HenrySDK, args: Record<string, unknown> | undefined) => {
   const { jq_filter, ...body } = args as any;
-  return asTextContentResult(await maybeFilter(jq_filter, await client.cart.items.list(body)));
+  try {
+    return asTextContentResult(await maybeFilter(jq_filter, await client.cart.items.list(body)));
+  } catch (error) {
+    if (isJqError(error)) {
+      return asErrorResult(error.message);
+    }
+    throw error;
+  }
 };
 
 export default { metadata, tool, handler };

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

@@ -1,7 +1,7 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { maybeFilter } from '@henrylabs/mcp/filtering';
-import { Metadata, asTextContentResult } from '@henrylabs/mcp/tools/types';
+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';
@@ -9,7 +9,7 @@ import HenrySDK from '@henrylabs/sdk';
 export const metadata: Metadata = {
   resource: 'cart.items',
   operation: 'write',
-  tags: ['headless', 'hosted'],
+  tags: ['hosted'],
   httpMethod: 'delete',
   httpPath: '/cart/items/{productId}',
   operationId: 'deleteCartItem',
@@ -44,7 +44,14 @@ export const tool: Tool = {
 
 export const handler = async (client: HenrySDK, args: Record<string, unknown> | undefined) => {
   const { productId, jq_filter, ...body } = args as any;
-  return asTextContentResult(await maybeFilter(jq_filter, await client.cart.items.remove(productId, body)));
+  try {
+    return asTextContentResult(await maybeFilter(jq_filter, await client.cart.items.remove(productId, body)));
+  } catch (error) {
+    if (isJqError(error)) {
+      return asErrorResult(error.message);
+    }
+    throw error;
+  }
 };
 
 export default { metadata, tool, handler };

package/src/tools/checkout/session/confirm-checkout-session.ts

@@ -1,7 +1,7 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { maybeFilter } from '@henrylabs/mcp/filtering';
-import { Metadata, asTextContentResult } from '@henrylabs/mcp/tools/types';
+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';
@@ -9,7 +9,7 @@ import HenrySDK from '@henrylabs/sdk';
 export const metadata: Metadata = {
   resource: 'checkout.session',
   operation: 'write',
-  tags: ['headless'],
+  tags: [],
   httpMethod: 'post',
   httpPath: '/checkout/session/confirm',
   operationId: 'confirmCheckoutSession',
@@ -93,9 +93,16 @@ export const tool: Tool = {
 
 export const handler = async (client: HenrySDK, args: Record<string, unknown> | undefined) => {
   const { jq_filter, ...body } = args as any;
-  return asTextContentResult(
-    await maybeFilter(jq_filter, await client.checkout.session.confirmCheckout(body)),
-  );
+  try {
+    return asTextContentResult(
+      await maybeFilter(jq_filter, await client.checkout.session.confirmCheckout(body)),
+    );
+  } catch (error) {
+    if (isJqError(error)) {
+      return asErrorResult(error.message);
+    }
+    throw error;
+  }
 };
 
 export default { metadata, tool, handler };

package/src/tools/checkout/session/create-checkout-session.ts

@@ -1,7 +1,7 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { maybeFilter } from '@henrylabs/mcp/filtering';
-import { Metadata, asTextContentResult } from '@henrylabs/mcp/tools/types';
+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';
@@ -9,7 +9,7 @@ import HenrySDK from '@henrylabs/sdk';
 export const metadata: Metadata = {
   resource: 'checkout.session',
   operation: 'write',
-  tags: ['headless'],
+  tags: [],
   httpMethod: 'post',
   httpPath: '/checkout/session/quote',
   operationId: 'createCheckoutSessionQuote',
@@ -90,7 +90,14 @@ export const tool: Tool = {
 
 export const handler = async (client: HenrySDK, args: Record<string, unknown> | undefined) => {
   const { jq_filter, ...body } = args as any;
-  return asTextContentResult(await maybeFilter(jq_filter, await client.checkout.session.createQuote(body)));
+  try {
+    return asTextContentResult(await maybeFilter(jq_filter, await client.checkout.session.createQuote(body)));
+  } catch (error) {
+    if (isJqError(error)) {
+      return asErrorResult(error.message);
+    }
+    throw error;
+  }
 };
 
 export default { metadata, tool, handler };

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

@@ -1,7 +1,7 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { maybeFilter } from '@henrylabs/mcp/filtering';
-import { Metadata, asTextContentResult } from '@henrylabs/mcp/tools/types';
+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';
@@ -9,7 +9,7 @@ import HenrySDK from '@henrylabs/sdk';
 export const metadata: Metadata = {
   resource: 'orders',
   operation: 'read',
-  tags: ['headless', 'hosted'],
+  tags: [],
   httpMethod: 'get',
   httpPath: '/orders/{orderId}',
   operationId: 'getOrderStatus',
@@ -41,7 +41,14 @@ export const tool: Tool = {
 
 export const handler = async (client: HenrySDK, args: Record<string, unknown> | undefined) => {
   const { orderId, jq_filter, ...body } = args as any;
-  return asTextContentResult(await maybeFilter(jq_filter, await client.orders.retrieveStatus(orderId)));
+  try {
+    return asTextContentResult(await maybeFilter(jq_filter, await client.orders.retrieveStatus(orderId)));
+  } catch (error) {
+    if (isJqError(error)) {
+      return asErrorResult(error.message);
+    }
+    throw error;
+  }
 };
 
 export default { metadata, tool, handler };

package/src/tools/products/retrieve-product-details.ts

@@ -1,6 +1,5 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { maybeFilter } from '@henrylabs/mcp/filtering';
 import { Metadata, asTextContentResult } from '@henrylabs/mcp/tools/types';
 
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
@@ -9,7 +8,7 @@ import HenrySDK from '@henrylabs/sdk';
 export const metadata: Metadata = {
   resource: 'products',
   operation: 'read',
-  tags: ['headless', 'hosted'],
+  tags: [],
   httpMethod: 'get',
   httpPath: '/products/details',
   operationId: 'getProductDetails',
@@ -18,7 +17,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'retrieve_product_details',
   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 comprehensive product details using a product ID from search results.\n\nMUST BE CALLED BEFORE adding items to cart - this is the only way to get the productLink required for cart operations.\n\nReturns:\n- Product title, brand, rating, review count\n- Stores array with name, price, shipping, total, and LINK for each retailer\n- Available variants (sizes, colors, etc.) with availability status\n- Thumbnail images (multiple angles)\n\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/product_retrieve_details_response',\n  $defs: {\n    product_retrieve_details_response: {\n      type: 'object',\n      properties: {\n        data: {\n          type: 'object',\n          properties: {\n            productResults: {\n              type: 'object',\n              properties: {\n                brand: {\n                  type: 'string'\n                },\n                rating: {\n                  type: 'number'\n                },\n                reviews: {\n                  type: 'number'\n                },\n                stores: {\n                  type: 'array',\n                  items: {\n                    type: 'object',\n                    properties: {\n                      link: {\n                        type: 'string'\n                      },\n                      name: {\n                        type: 'string'\n                      },\n                      price: {\n                        type: 'string'\n                      },\n                      shipping: {\n                        type: 'string'\n                      },\n                      total: {\n                        type: 'string'\n                      }\n                    },\n                    required: [                      'link',\n                      'name',\n                      'price',\n                      'shipping',\n                      'total'\n                    ]\n                  }\n                },\n                thumbnails: {\n                  type: 'array',\n                  items: {\n                    type: 'string'\n                  }\n                },\n                title: {\n                  type: 'string'\n                },\n                userReviews: {\n                  type: 'array',\n                  items: {\n                    type: 'object',\n                    properties: {\n                      rating: {\n                        type: 'number'\n                      },\n                      source: {\n                        type: 'string'\n                      },\n                      text: {\n                        type: 'string'\n                      },\n                      title: {\n                        type: 'string'\n                      },\n                      userName: {\n                        type: 'string'\n                      }\n                    },\n                    required: [                      'rating',\n                      'source',\n                      'text',\n                      'title',\n                      'userName'\n                    ]\n                  }\n                },\n                variants: {\n                  type: 'array',\n                  items: {\n                    type: 'object',\n                    properties: {\n                      items: {\n                        type: 'array',\n                        items: {\n                          type: 'object',\n                          properties: {\n                            name: {\n                              type: 'string'\n                            },\n                            available: {\n                              type: 'boolean'\n                            },\n                            selected: {\n                              type: 'boolean'\n                            }\n                          },\n                          required: [                            'name'\n                          ]\n                        }\n                      },\n                      title: {\n                        type: 'string'\n                      }\n                    },\n                    required: [                      'items',\n                      'title'\n                    ]\n                  }\n                }\n              },\n              required: [                'brand',\n                'rating',\n                'reviews',\n                'stores',\n                'thumbnails',\n                'title',\n                'userReviews',\n                'variants'\n              ]\n            },\n            relatedSearches: {\n              type: 'array',\n              items: {\n                type: 'object',\n                properties: {\n                  link: {\n                    type: 'string'\n                  },\n                  query: {\n                    type: 'string'\n                  },\n                  image: {\n                    type: 'string'\n                  }\n                },\n                required: [                  'link',\n                  'query'\n                ]\n              }\n            }\n          },\n          required: [            'productResults',\n            'relatedSearches'\n          ]\n        },\n        message: {\n          type: 'string'\n        },\n        status: {\n          type: 'string'\n        },\n        success: {\n          type: 'boolean'\n        }\n      },\n      required: [        'data',\n        'message',\n        'status',\n        'success'\n      ]\n    }\n  }\n}\n```",
+    'Retrieve comprehensive product details using a product ID from search results.\n\nMUST BE CALLED BEFORE adding items to cart - this is the only way to get the productLink required for cart operations.\n\nReturns:\n- Product title, brand, rating, review count\n- Stores array with name, price, shipping, total, and LINK for each retailer\n- Available variants (sizes, colors, etc.) with availability status\n- Thumbnail images (multiple angles)\n',
   inputSchema: {
     type: 'object',
     properties: {
@@ -26,12 +25,6 @@ export const tool: Tool = {
         type: 'string',
         description: 'Product 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/).',
-      },
     },
     required: ['productId'],
   },
@@ -41,8 +34,8 @@ export const tool: Tool = {
 };
 
 export const handler = async (client: HenrySDK, args: Record<string, unknown> | undefined) => {
-  const { jq_filter, ...body } = args as any;
-  return asTextContentResult(await maybeFilter(jq_filter, await client.products.retrieveDetails(body)));
+  const body = args as any;
+  return asTextContentResult(await client.products.retrieveDetails(body));
 };
 
 export default { metadata, tool, handler };