@henrylabs/mcp 0.2.0

package/src/server.ts

@@ -0,0 +1,208 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { Endpoint, endpoints, HandlerFunction, query } from './tools';
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema,
+  SetLevelRequestSchema,
+  Implementation,
+  Tool,
+} from '@modelcontextprotocol/sdk/types.js';
+import { ClientOptions } from '@henrylabs/sdk';
+import HenrySDK from '@henrylabs/sdk';
+import {
+  applyCompatibilityTransformations,
+  ClientCapabilities,
+  defaultClientCapabilities,
+  knownClients,
+  parseEmbeddedJSON,
+} from './compat';
+import { dynamicTools } from './dynamic-tools';
+import { codeTool } from './code-tool';
+import docsSearchTool from './docs-search-tool';
+import { McpOptions } from './options';
+
+export { McpOptions } from './options';
+export { ClientType } from './compat';
+export { Filter } from './tools';
+export { ClientOptions } from '@henrylabs/sdk';
+export { endpoints } from './tools';
+
+export const newMcpServer = () =>
+  new McpServer(
+    {
+      name: 'henrylabs_sdk_api',
+      version: '0.2.0',
+    },
+    { capabilities: { tools: {}, logging: {} } },
+  );
+
+// Create server instance
+export const server = newMcpServer();
+
+/**
+ * Initializes the provided MCP Server with the given tools and handlers.
+ * If not provided, the default client, tools and handlers will be used.
+ */
+export function initMcpServer(params: {
+  server: Server | McpServer;
+  clientOptions?: ClientOptions;
+  mcpOptions?: McpOptions;
+}) {
+  const server = params.server instanceof McpServer ? params.server.server : params.server;
+  const mcpOptions = params.mcpOptions ?? {};
+
+  let providedEndpoints: Endpoint[] | null = null;
+  let endpointMap: Record<string, Endpoint> | null = null;
+
+  const initTools = async (implementation?: Implementation) => {
+    if (implementation && (!mcpOptions.client || mcpOptions.client === 'infer')) {
+      mcpOptions.client =
+        implementation.name.toLowerCase().includes('claude') ? 'claude'
+        : implementation.name.toLowerCase().includes('cursor') ? 'cursor'
+        : undefined;
+      mcpOptions.capabilities = {
+        ...(mcpOptions.client && knownClients[mcpOptions.client]),
+        ...mcpOptions.capabilities,
+      };
+    }
+    providedEndpoints ??= await selectTools(endpoints, mcpOptions);
+    endpointMap ??= Object.fromEntries(providedEndpoints.map((endpoint) => [endpoint.tool.name, endpoint]));
+  };
+
+  const logAtLevel =
+    (level: 'debug' | 'info' | 'warning' | 'error') =>
+    (message: string, ...rest: unknown[]) => {
+      void server.sendLoggingMessage({
+        level,
+        data: { message, rest },
+      });
+    };
+  const logger = {
+    debug: logAtLevel('debug'),
+    info: logAtLevel('info'),
+    warn: logAtLevel('warning'),
+    error: logAtLevel('error'),
+  };
+
+  let client = new HenrySDK({
+    ...{ environment: (readEnv('HENRY_SDK_ENVIRONMENT') || undefined) as any },
+    logger,
+    ...params.clientOptions,
+    defaultHeaders: {
+      ...params.clientOptions?.defaultHeaders,
+      'X-Stainless-MCP': 'true',
+    },
+  });
+
+  server.setRequestHandler(ListToolsRequestSchema, async () => {
+    if (providedEndpoints === null) {
+      await initTools(server.getClientVersion());
+    }
+    return {
+      tools: providedEndpoints!.map((endpoint) => endpoint.tool),
+    };
+  });
+
+  server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    if (endpointMap === null) {
+      await initTools(server.getClientVersion());
+    }
+    const { name, arguments: args } = request.params;
+    const endpoint = endpointMap![name];
+    if (!endpoint) {
+      throw new Error(`Unknown tool: ${name}`);
+    }
+
+    return executeHandler(endpoint.tool, endpoint.handler, client, args, mcpOptions.capabilities);
+  });
+
+  server.setRequestHandler(SetLevelRequestSchema, async (request) => {
+    const { level } = request.params;
+    switch (level) {
+      case 'debug':
+        client = client.withOptions({ logLevel: 'debug' });
+        break;
+      case 'info':
+        client = client.withOptions({ logLevel: 'info' });
+        break;
+      case 'notice':
+      case 'warning':
+        client = client.withOptions({ logLevel: 'warn' });
+        break;
+      case 'error':
+        client = client.withOptions({ logLevel: 'error' });
+        break;
+      default:
+        client = client.withOptions({ logLevel: 'off' });
+        break;
+    }
+    return {};
+  });
+}
+
+/**
+ * Selects the tools to include in the MCP Server based on the provided options.
+ */
+export async function selectTools(endpoints: Endpoint[], options?: McpOptions): Promise<Endpoint[]> {
+  const filteredEndpoints = query(options?.filters ?? [], endpoints);
+
+  let includedTools = filteredEndpoints.slice();
+
+  if (includedTools.length > 0) {
+    if (options?.includeDynamicTools) {
+      includedTools = dynamicTools(includedTools);
+    }
+  } else {
+    if (options?.includeAllTools) {
+      includedTools = endpoints.slice();
+    } else if (options?.includeDynamicTools) {
+      includedTools = dynamicTools(endpoints);
+    } else if (options?.includeCodeTools) {
+      includedTools = [await codeTool()];
+    } else {
+      includedTools = endpoints.slice();
+    }
+  }
+  if (options?.includeDocsTools ?? true) {
+    includedTools.push(docsSearchTool);
+  }
+  const capabilities = { ...defaultClientCapabilities, ...options?.capabilities };
+  return applyCompatibilityTransformations(includedTools, capabilities);
+}
+
+/**
+ * Runs the provided handler with the given client and arguments.
+ */
+export async function executeHandler(
+  tool: Tool,
+  handler: HandlerFunction,
+  client: HenrySDK,
+  args: Record<string, unknown> | undefined,
+  compatibilityOptions?: Partial<ClientCapabilities>,
+) {
+  const options = { ...defaultClientCapabilities, ...compatibilityOptions };
+  if (!options.validJson && args) {
+    args = parseEmbeddedJSON(args, tool.inputSchema);
+  }
+  return await handler(client, args || {});
+}
+
+export const readEnv = (env: string): string | undefined => {
+  if (typeof (globalThis as any).process !== 'undefined') {
+    return (globalThis as any).process.env?.[env]?.trim();
+  } else if (typeof (globalThis as any).Deno !== 'undefined') {
+    return (globalThis as any).Deno.env?.get?.(env)?.trim();
+  }
+  return;
+};
+
+export const readEnvOrError = (env: string): string => {
+  let envValue = readEnv(env);
+  if (envValue === undefined) {
+    throw new Error(`Environment variable ${env} is not set`);
+  }
+  return envValue;
+};

package/src/stdio.ts

@@ -0,0 +1,13 @@
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { initMcpServer, newMcpServer } from './server';
+import { McpOptions } from './options';
+
+export const launchStdioServer = async (options: McpOptions) => {
+  const server = newMcpServer();
+
+  initMcpServer({ server, mcpOptions: options });
+
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error('MCP Server running on stdio');
+};

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

@@ -0,0 +1,49 @@
+// 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';
+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_checkout_cart',
+  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 hosted checkout URL for the user's cart that can be embedded in an iframe or modal. The page walks the buyer through reviewing the order, entering shipping and payment information, and confirming the purchase.\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)',
+      },
+      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;
+  return asTextContentResult(await maybeFilter(jq_filter, await client.cart.createCheckout(body)));
+};
+
+export default { metadata, tool, handler };

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

@@ -0,0 +1,93 @@
+// 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';
+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\nAdds product data to existing cart or create a new one.\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;
+  return asTextContentResult(await maybeFilter(jq_filter, await client.cart.items.add(body)));
+};
+
+export default { metadata, tool, handler };

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

@@ -0,0 +1,47 @@
+// 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';
+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\nDelete all products from the cart\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;
+  return asTextContentResult(await maybeFilter(jq_filter, await client.cart.items.clear(body)));
+};
+
+export default { metadata, tool, handler };

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

@@ -0,0 +1,47 @@
+// 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';
+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\nGet all products from the cart\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;
+  return asTextContentResult(await maybeFilter(jq_filter, await client.cart.items.list(body)));
+};
+
+export default { metadata, tool, handler };

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

@@ -0,0 +1,50 @@
+// 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';
+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\nDelete a product from the cart\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;
+  return asTextContentResult(await maybeFilter(jq_filter, await client.cart.items.remove(productId, body)));
+};
+
+export default { metadata, tool, handler };

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

@@ -0,0 +1,101 @@
+// 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';
+import HenrySDK from '@henrylabs/sdk';
+
+export const metadata: Metadata = {
+  resource: 'checkout.session',
+  operation: 'write',
+  tags: [],
+  httpMethod: 'post',
+  httpPath: '/checkout/session/confirm',
+  operationId: 'confirmCheckoutSession',
+};
+
+export const tool: Tool = {
+  name: 'confirm_checkout_checkout_session',
+  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\nConfirms the checkout session and creates an order\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/session_confirm_checkout_response',\n  $defs: {\n    session_confirm_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            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            shippingDetails: {\n              type: 'object',\n              properties: {\n                addressLine1: {\n                  type: 'string',\n                  description: 'Address line 1'\n                },\n                city: {\n                  type: 'string',\n                  description: 'City'\n                },\n                countryCode: {\n                  type: 'string',\n                  description: 'Country code'\n                },\n                email: {\n                  type: 'string',\n                  description: 'Email'\n                },\n                fullName: {\n                  type: 'string',\n                  description: 'Full name'\n                },\n                phoneNumber: {\n                  type: 'string',\n                  description: 'Phone number'\n                },\n                postalCode: {\n                  type: 'string',\n                  description: 'Postal code'\n                },\n                stateOrProvince: {\n                  type: 'string',\n                  description: 'State or province'\n                },\n                addressLine2: {\n                  type: 'string',\n                  description: 'Address line 2'\n                }\n              },\n              required: [                'addressLine1',\n                'city',\n                'countryCode',\n                'email',\n                'fullName',\n                'phoneNumber',\n                'postalCode',\n                'stateOrProvince'\n              ]\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            cardLast4: {\n              type: 'string'\n            }\n          },\n          required: [            'id',\n            'currency',\n            'grandTotal',\n            'products',\n            'shipping',\n            'shippingDetails',\n            'status',\n            'statusMessage',\n            'subtotal',\n            'tax'\n          ]\n        }\n      },\n      required: [        'message',\n        'status',\n        'success'\n      ]\n    }\n  }\n}\n```",
+  inputSchema: {
+    type: 'object',
+    properties: {
+      'x-session-token': {
+        type: 'string',
+      },
+      shippingDetails: {
+        type: 'object',
+        properties: {
+          addressLine1: {
+            type: 'string',
+            description: 'Address line 1',
+          },
+          city: {
+            type: 'string',
+            description: 'City',
+          },
+          countryCode: {
+            type: 'string',
+            description: 'Country code',
+          },
+          email: {
+            type: 'string',
+            description: 'Email',
+          },
+          fullName: {
+            type: 'string',
+            description: 'Full name',
+          },
+          phoneNumber: {
+            type: 'string',
+            description: 'Phone number',
+          },
+          postalCode: {
+            type: 'string',
+            description: 'Postal code',
+          },
+          stateOrProvince: {
+            type: 'string',
+            description: 'State or province',
+          },
+          addressLine2: {
+            type: 'string',
+            description: 'Address line 2',
+          },
+        },
+        required: [
+          'addressLine1',
+          'city',
+          'countryCode',
+          'email',
+          'fullName',
+          'phoneNumber',
+          'postalCode',
+          'stateOrProvince',
+        ],
+      },
+      '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-session-token'],
+  },
+  annotations: {},
+};
+
+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)),
+  );
+};
+
+export default { metadata, tool, handler };