@tryfinch/finch-api-mcp 6.30.0 → 7.0.0

package/tools/hris/benefits/individuals/unenroll-many-benefits-hris-individuals.mjs

@@ -1,18 +1,31 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { isJqError, maybeFilter } from '@tryfinch/finch-api-mcp/filtering';
+import { asErrorResult, asTextContentResult } from '@tryfinch/finch-api-mcp/tools/types';
+import Finch from '@tryfinch/finch-api';
 export const metadata = {
     resource: 'hris.benefits.individuals',
     operation: 'write',
     tags: [],
+    httpMethod: 'delete',
+    httpPath: '/employer/benefits/{benefit_id}/individuals',
+    operationId: 'delete-individual-benefits',
 };
 export const tool = {
     name: 'unenroll_many_benefits_hris_individuals',
-    description: 'Unenroll individuals from a deduction or contribution',
+    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\nUnenroll individuals from a deduction or contribution\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/unenrolled_individual_benefit_response',\n  $defs: {\n    unenrolled_individual_benefit_response: {\n      type: 'object',\n      properties: {\n        job_id: {\n          type: 'string'\n        }\n      },\n      required: [        'job_id'\n      ]\n    }\n  }\n}\n```",
     inputSchema: {
         type: 'object',
         properties: {
             benefit_id: {
                 type: 'string',
             },
+            entity_ids: {
+                type: 'array',
+                description: "The entity IDs to specify which entities' data to access.",
+                items: {
+                    type: 'string',
+                },
+            },
             individual_ids: {
                 type: 'array',
                 description: 'Array of individual_ids to unenroll.',
@@ -20,12 +33,29 @@ export const tool = {
                     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: ['benefit_id'],
+    },
+    annotations: {
+        idempotentHint: true,
     },
 };
-export const handler = (client, args) => {
-    const { benefit_id, ...body } = args;
-    return client.hris.benefits.individuals.unenrollMany(benefit_id, body);
+export const handler = async (client, args) => {
+    const { benefit_id, jq_filter, ...body } = args;
+    try {
+        return asTextContentResult(await maybeFilter(jq_filter, await client.hris.benefits.individuals.unenrollMany(benefit_id, body)));
+    }
+    catch (error) {
+        if (error instanceof Finch.APIError || isJqError(error)) {
+            return asErrorResult(error.message);
+        }
+        throw error;
+    }
 };
 export default { metadata, tool, handler };
 //# sourceMappingURL=unenroll-many-benefits-hris-individuals.mjs.map

package/tools/hris/benefits/individuals/unenroll-many-benefits-hris-individuals.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"unenroll-many-benefits-hris-individuals.mjs","sourceRoot":"","sources":["../../../../src/tools/hris/benefits/individuals/unenroll-many-benefits-hris-individuals.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAMtF,MAAM,CAAC,MAAM,QAAQ,GAAa;IAChC,QAAQ,EAAE,2BAA2B;IACrC,SAAS,EAAE,OAAO;IAClB,IAAI,EAAE,EAAE;CACT,CAAC;AAEF,MAAM,CAAC,MAAM,IAAI,GAAS;IACxB,IAAI,EAAE,yCAAyC;IAC/C,WAAW,EAAE,uDAAuD;IACpE,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;aACf;YACD,cAAc,EAAE;gBACd,IAAI,EAAE,OAAO;gBACb,WAAW,EAAE,sCAAsC;gBACnD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;iBACf;aACF;SACF;KACF;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,MAAa,EAAE,IAAyC,EAAE,EAAE;IAClF,MAAM,EAAE,UAAU,EAAE,GAAG,IAAI,EAAE,GAAG,IAAW,CAAC;IAC5C,OAAO,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,YAAY,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;AACzE,CAAC,CAAC;AAEF,eAAe,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC"}
+{"version":3,"file":"unenroll-many-benefits-hris-individuals.mjs","sourceRoot":"","sources":["../../../../src/tools/hris/benefits/individuals/unenroll-many-benefits-hris-individuals.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,mCAAmC;OACnE,EAAY,aAAa,EAAE,mBAAmB,EAAE,MAAM,qCAAqC;OAG3F,KAAK,MAAM,qBAAqB;AAEvC,MAAM,CAAC,MAAM,QAAQ,GAAa;IAChC,QAAQ,EAAE,2BAA2B;IACrC,SAAS,EAAE,OAAO;IAClB,IAAI,EAAE,EAAE;IACR,UAAU,EAAE,QAAQ;IACpB,QAAQ,EAAE,6CAA6C;IACvD,WAAW,EAAE,4BAA4B;CAC1C,CAAC;AAEF,MAAM,CAAC,MAAM,IAAI,GAAS;IACxB,IAAI,EAAE,yCAAyC;IAC/C,WAAW,EACT,oiBAAoiB;IACtiB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;aACf;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,WAAW,EAAE,2DAA2D;gBACxE,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;iBACf;aACF;YACD,cAAc,EAAE;gBACd,IAAI,EAAE,OAAO;gBACb,WAAW,EAAE,sCAAsC;gBACnD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;iBACf;aACF;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,WAAW;gBAClB,WAAW,EACT,kWAAkW;aACrW;SACF;QACD,QAAQ,EAAE,CAAC,YAAY,CAAC;KACzB;IACD,WAAW,EAAE;QACX,cAAc,EAAE,IAAI;KACrB;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAG,KAAK,EAAE,MAAa,EAAE,IAAyC,EAAE,EAAE;IACxF,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,IAAW,CAAC;IACvD,IAAI,CAAC;QACH,OAAO,mBAAmB,CACxB,MAAM,WAAW,CAAC,SAAS,EAAE,MAAM,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,YAAY,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,CACpG,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,KAAK,CAAC,QAAQ,IAAI,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;YACxD,OAAO,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACtC,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC,CAAC;AAEF,eAAe,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC"}

package/tools/hris/benefits/list-hris-benefits.d.mts

@@ -1,32 +1,51 @@
+import { Metadata } from '@tryfinch/finch-api-mcp/tools/types';
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import type { Metadata } from "../..//index.mjs";
 import Finch from '@tryfinch/finch-api';
 export declare const metadata: Metadata;
 export declare const tool: Tool;
-export declare const handler: (client: Finch, args: Record<string, unknown> | undefined) => import("@tryfinch/finch-api/core").PagePromise<Finch.HRIS.Benefits.CompanyBenefitsSinglePage, Finch.HRIS.Benefits.CompanyBenefit>;
+export declare const handler: (client: Finch, args: Record<string, unknown> | undefined) => Promise<import("@tryfinch/finch-api-mcp/tools/types").ToolCallResult>;
 declare const _default: {
     metadata: Metadata;
     tool: {
-        [x: string]: unknown;
-        name: string;
         inputSchema: {
             [x: string]: unknown;
             type: "object";
             properties?: {
-                [x: string]: unknown;
+                [x: string]: object;
             } | undefined;
+            required?: string[] | undefined;
         };
+        name: string;
         description?: string | undefined;
-        annotations?: {
+        outputSchema?: {
             [x: string]: unknown;
+            type: "object";
+            properties?: {
+                [x: string]: object;
+            } | undefined;
+            required?: string[] | undefined;
+        } | undefined;
+        annotations?: {
             title?: string | undefined;
             readOnlyHint?: boolean | undefined;
             destructiveHint?: boolean | undefined;
             idempotentHint?: boolean | undefined;
             openWorldHint?: boolean | undefined;
         } | undefined;
+        execution?: {
+            taskSupport?: "optional" | "required" | "forbidden" | undefined;
+        } | undefined;
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+        icons?: {
+            src: string;
+            mimeType?: string | undefined;
+            sizes?: string[] | undefined;
+        }[] | undefined;
+        title?: string | undefined;
     };
-    handler: (client: Finch, args: Record<string, unknown> | undefined) => import("@tryfinch/finch-api/core").PagePromise<Finch.HRIS.Benefits.CompanyBenefitsSinglePage, Finch.HRIS.Benefits.CompanyBenefit>;
+    handler: (client: Finch, args: Record<string, unknown> | undefined) => Promise<import("@tryfinch/finch-api-mcp/tools/types").ToolCallResult>;
 };
 export default _default;
 //# sourceMappingURL=list-hris-benefits.d.mts.map

package/tools/hris/benefits/list-hris-benefits.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"list-hris-benefits.d.mts","sourceRoot":"","sources":["../../../src/tools/hris/benefits/list-hris-benefits.ts"],"names":[],"mappings":"OAEO,EAAE,IAAI,EAAE,MAAM,oCAAoC;OAClD,KAAK,EAAE,QAAQ,EAAE;OACjB,KAAK,MAAM,qBAAqB;AAEvC,eAAO,MAAM,QAAQ,EAAE,QAItB,CAAC;AAEF,eAAO,MAAM,IAAI,EAAE,IAOlB,CAAC;AAEF,eAAO,MAAM,OAAO,GAAI,QAAQ,KAAK,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,sIAE/E,CAAC;;;;;;;;;;;;;;;;;;;;;;;sBAF8B,KAAK,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;;AAIhF,wBAA2C"}
+{"version":3,"file":"list-hris-benefits.d.mts","sourceRoot":"","sources":["../../../src/tools/hris/benefits/list-hris-benefits.ts"],"names":[],"mappings":"OAGO,EAAE,QAAQ,EAAsC,MAAM,qCAAqC;OAE3F,EAAE,IAAI,EAAE,MAAM,oCAAoC;OAClD,KAAK,MAAM,qBAAqB;AAEvC,eAAO,MAAM,QAAQ,EAAE,QAOtB,CAAC;AAEF,eAAO,MAAM,IAAI,EAAE,IA0BlB,CAAC;AAEF,eAAO,MAAM,OAAO,GAAU,QAAQ,KAAK,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,0EAWrF,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAXoC,KAAK,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;;AAatF,wBAA2C"}

package/tools/hris/benefits/list-hris-benefits.d.ts

@@ -1,32 +1,51 @@
+import { Metadata } from '@tryfinch/finch-api-mcp/tools/types';
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import type { Metadata } from "../..//index.js";
 import Finch from '@tryfinch/finch-api';
 export declare const metadata: Metadata;
 export declare const tool: Tool;
-export declare const handler: (client: Finch, args: Record<string, unknown> | undefined) => import("@tryfinch/finch-api/core").PagePromise<Finch.HRIS.Benefits.CompanyBenefitsSinglePage, Finch.HRIS.Benefits.CompanyBenefit>;
+export declare const handler: (client: Finch, args: Record<string, unknown> | undefined) => Promise<import("@tryfinch/finch-api-mcp/tools/types").ToolCallResult>;
 declare const _default: {
     metadata: Metadata;
     tool: {
-        [x: string]: unknown;
-        name: string;
         inputSchema: {
             [x: string]: unknown;
             type: "object";
             properties?: {
-                [x: string]: unknown;
+                [x: string]: object;
             } | undefined;
+            required?: string[] | undefined;
         };
+        name: string;
         description?: string | undefined;
-        annotations?: {
+        outputSchema?: {
             [x: string]: unknown;
+            type: "object";
+            properties?: {
+                [x: string]: object;
+            } | undefined;
+            required?: string[] | undefined;
+        } | undefined;
+        annotations?: {
             title?: string | undefined;
             readOnlyHint?: boolean | undefined;
             destructiveHint?: boolean | undefined;
             idempotentHint?: boolean | undefined;
             openWorldHint?: boolean | undefined;
         } | undefined;
+        execution?: {
+            taskSupport?: "optional" | "required" | "forbidden" | undefined;
+        } | undefined;
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+        icons?: {
+            src: string;
+            mimeType?: string | undefined;
+            sizes?: string[] | undefined;
+        }[] | undefined;
+        title?: string | undefined;
     };
-    handler: (client: Finch, args: Record<string, unknown> | undefined) => import("@tryfinch/finch-api/core").PagePromise<Finch.HRIS.Benefits.CompanyBenefitsSinglePage, Finch.HRIS.Benefits.CompanyBenefit>;
+    handler: (client: Finch, args: Record<string, unknown> | undefined) => Promise<import("@tryfinch/finch-api-mcp/tools/types").ToolCallResult>;
 };
 export default _default;
 //# sourceMappingURL=list-hris-benefits.d.ts.map

package/tools/hris/benefits/list-hris-benefits.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-hris-benefits.d.ts","sourceRoot":"","sources":["../../../src/tools/hris/benefits/list-hris-benefits.ts"],"names":[],"mappings":"OAEO,EAAE,IAAI,EAAE,MAAM,oCAAoC;OAClD,KAAK,EAAE,QAAQ,EAAE;OACjB,KAAK,MAAM,qBAAqB;AAEvC,eAAO,MAAM,QAAQ,EAAE,QAItB,CAAC;AAEF,eAAO,MAAM,IAAI,EAAE,IAOlB,CAAC;AAEF,eAAO,MAAM,OAAO,GAAI,QAAQ,KAAK,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,sIAE/E,CAAC;;;;;;;;;;;;;;;;;;;;;;;sBAF8B,KAAK,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;;AAIhF,wBAA2C"}
+{"version":3,"file":"list-hris-benefits.d.ts","sourceRoot":"","sources":["../../../src/tools/hris/benefits/list-hris-benefits.ts"],"names":[],"mappings":"OAGO,EAAE,QAAQ,EAAsC,MAAM,qCAAqC;OAE3F,EAAE,IAAI,EAAE,MAAM,oCAAoC;OAClD,KAAK,MAAM,qBAAqB;AAEvC,eAAO,MAAM,QAAQ,EAAE,QAOtB,CAAC;AAEF,eAAO,MAAM,IAAI,EAAE,IA0BlB,CAAC;AAEF,eAAO,MAAM,OAAO,GAAU,QAAQ,KAAK,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,0EAWrF,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAXoC,KAAK,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;;AAatF,wBAA2C"}

package/tools/hris/benefits/list-hris-benefits.js

@@ -1,22 +1,58 @@
 "use strict";
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.handler = exports.tool = exports.metadata = void 0;
+const filtering_1 = require("@tryfinch/finch-api-mcp/filtering");
+const types_1 = require("@tryfinch/finch-api-mcp/tools/types");
+const finch_api_1 = __importDefault(require("@tryfinch/finch-api"));
 exports.metadata = {
     resource: 'hris.benefits',
     operation: 'read',
     tags: [],
+    httpMethod: 'get',
+    httpPath: '/employer/benefits',
+    operationId: 'get-company-benefits',
 };
 exports.tool = {
     name: 'list_hris_benefits',
-    description: 'List all company-wide deductions and contributions.',
+    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\nList all company-wide deductions and contributions.\n\n# Response Schema\n```json\n{\n  type: 'array',\n  description: 'Array of company benefits.',\n  items: {\n    $ref: '#/$defs/company_benefit'\n  },\n  $defs: {\n    company_benefit: {\n      type: 'object',\n      title: 'CompanyBenefit',\n      properties: {\n        benefit_id: {\n          type: 'string',\n          description: 'The id of the benefit.'\n        },\n        description: {\n          type: 'string'\n        },\n        frequency: {\n          $ref: '#/$defs/benefit_frequency'\n        },\n        type: {\n          $ref: '#/$defs/benefit_type'\n        },\n        company_contribution: {\n          type: 'object',\n          title: 'BenefitCompanyMatchContribution',\n          description: 'The company match for this benefit.',\n          properties: {\n            tiers: {\n              type: 'array',\n              items: {\n                type: 'object',\n                properties: {\n                  match: {\n                    type: 'integer'\n                  },\n                  threshold: {\n                    type: 'integer'\n                  }\n                },\n                required: [                  'match',\n                  'threshold'\n                ]\n              }\n            },\n            type: {\n              type: 'string',\n              enum: [                'match'\n              ]\n            }\n          },\n          required: [            'tiers',\n            'type'\n          ]\n        }\n      },\n      required: [        'benefit_id',\n        'description',\n        'frequency',\n        'type'\n      ]\n    },\n    benefit_frequency: {\n      type: 'string',\n      title: 'BenefitFrequency',\n      description: 'The frequency of the benefit deduction/contribution.',\n      enum: [        'every_paycheck',\n        'monthly',\n        'one_time'\n      ]\n    },\n    benefit_type: {\n      type: 'string',\n      title: 'BenefitType',\n      description: 'Type of benefit.',\n      enum: [        '457',\n        '401k',\n        '401k_roth',\n        '401k_loan',\n        '403b',\n        '403b_roth',\n        '457_roth',\n        'commuter',\n        'custom_post_tax',\n        'custom_pre_tax',\n        'fsa_dependent_care',\n        'fsa_medical',\n        'hsa_post',\n        'hsa_pre',\n        's125_dental',\n        's125_medical',\n        's125_vision',\n        'simple',\n        'simple_ira'\n      ]\n    }\n  }\n}\n```",
     inputSchema: {
         type: 'object',
-        properties: {},
+        properties: {
+            entity_ids: {
+                type: 'array',
+                description: "The entity IDs to specify which entities' data to access.",
+                items: {
+                    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: [],
+    },
+    annotations: {
+        readOnlyHint: true,
     },
 };
-const handler = (client, args) => {
-    return client.hris.benefits.list();
+const handler = async (client, args) => {
+    const { jq_filter, ...body } = args;
+    const response = await client.hris.benefits.list(body).asResponse();
+    try {
+        return (0, types_1.asTextContentResult)(await (0, filtering_1.maybeFilter)(jq_filter, await response.json()));
+    }
+    catch (error) {
+        if (error instanceof finch_api_1.default.APIError || (0, filtering_1.isJqError)(error)) {
+            return (0, types_1.asErrorResult)(error.message);
+        }
+        throw error;
+    }
 };
 exports.handler = handler;
 exports.default = { metadata: exports.metadata, tool: exports.tool, handler: exports.handler };

package/tools/hris/benefits/list-hris-benefits.js.map

@@ -1 +1 @@
-{"version":3,"file":"list-hris-benefits.js","sourceRoot":"","sources":["../../../src/tools/hris/benefits/list-hris-benefits.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAMzE,QAAA,QAAQ,GAAa;IAChC,QAAQ,EAAE,eAAe;IACzB,SAAS,EAAE,MAAM;IACjB,IAAI,EAAE,EAAE;CACT,CAAC;AAEW,QAAA,IAAI,GAAS;IACxB,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EAAE,qDAAqD;IAClE,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,EAAE;KACf;CACF,CAAC;AAEK,MAAM,OAAO,GAAG,CAAC,MAAa,EAAE,IAAyC,EAAE,EAAE;IAClF,OAAO,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;AACrC,CAAC,CAAC;AAFW,QAAA,OAAO,WAElB;AAEF,kBAAe,EAAE,QAAQ,EAAR,gBAAQ,EAAE,IAAI,EAAJ,YAAI,EAAE,OAAO,EAAP,eAAO,EAAE,CAAC"}
+{"version":3,"file":"list-hris-benefits.js","sourceRoot":"","sources":["../../../src/tools/hris/benefits/list-hris-benefits.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;;;AAEtF,iEAA2E;AAC3E,+DAAmG;AAGnG,oEAAwC;AAE3B,QAAA,QAAQ,GAAa;IAChC,QAAQ,EAAE,eAAe;IACzB,SAAS,EAAE,MAAM;IACjB,IAAI,EAAE,EAAE;IACR,UAAU,EAAE,KAAK;IACjB,QAAQ,EAAE,oBAAoB;IAC9B,WAAW,EAAE,sBAAsB;CACpC,CAAC;AAEW,QAAA,IAAI,GAAS;IACxB,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EACT,onFAAonF;IACtnF,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,WAAW,EAAE,2DAA2D;gBACxE,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;iBACf;aACF;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,WAAW;gBAClB,WAAW,EACT,kWAAkW;aACrW;SACF;QACD,QAAQ,EAAE,EAAE;KACb;IACD,WAAW,EAAE;QACX,YAAY,EAAE,IAAI;KACnB;CACF,CAAC;AAEK,MAAM,OAAO,GAAG,KAAK,EAAE,MAAa,EAAE,IAAyC,EAAE,EAAE;IACxF,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,IAAW,CAAC;IAC3C,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC;IACpE,IAAI,CAAC;QACH,OAAO,IAAA,2BAAmB,EAAC,MAAM,IAAA,uBAAW,EAAC,SAAS,EAAE,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAClF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,mBAAK,CAAC,QAAQ,IAAI,IAAA,qBAAS,EAAC,KAAK,CAAC,EAAE,CAAC;YACxD,OAAO,IAAA,qBAAa,EAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACtC,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC,CAAC;AAXW,QAAA,OAAO,WAWlB;AAEF,kBAAe,EAAE,QAAQ,EAAR,gBAAQ,EAAE,IAAI,EAAJ,YAAI,EAAE,OAAO,EAAP,eAAO,EAAE,CAAC"}

package/tools/hris/benefits/list-hris-benefits.mjs

@@ -1,19 +1,52 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { isJqError, maybeFilter } from '@tryfinch/finch-api-mcp/filtering';
+import { asErrorResult, asTextContentResult } from '@tryfinch/finch-api-mcp/tools/types';
+import Finch from '@tryfinch/finch-api';
 export const metadata = {
     resource: 'hris.benefits',
     operation: 'read',
     tags: [],
+    httpMethod: 'get',
+    httpPath: '/employer/benefits',
+    operationId: 'get-company-benefits',
 };
 export const tool = {
     name: 'list_hris_benefits',
-    description: 'List all company-wide deductions and contributions.',
+    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\nList all company-wide deductions and contributions.\n\n# Response Schema\n```json\n{\n  type: 'array',\n  description: 'Array of company benefits.',\n  items: {\n    $ref: '#/$defs/company_benefit'\n  },\n  $defs: {\n    company_benefit: {\n      type: 'object',\n      title: 'CompanyBenefit',\n      properties: {\n        benefit_id: {\n          type: 'string',\n          description: 'The id of the benefit.'\n        },\n        description: {\n          type: 'string'\n        },\n        frequency: {\n          $ref: '#/$defs/benefit_frequency'\n        },\n        type: {\n          $ref: '#/$defs/benefit_type'\n        },\n        company_contribution: {\n          type: 'object',\n          title: 'BenefitCompanyMatchContribution',\n          description: 'The company match for this benefit.',\n          properties: {\n            tiers: {\n              type: 'array',\n              items: {\n                type: 'object',\n                properties: {\n                  match: {\n                    type: 'integer'\n                  },\n                  threshold: {\n                    type: 'integer'\n                  }\n                },\n                required: [                  'match',\n                  'threshold'\n                ]\n              }\n            },\n            type: {\n              type: 'string',\n              enum: [                'match'\n              ]\n            }\n          },\n          required: [            'tiers',\n            'type'\n          ]\n        }\n      },\n      required: [        'benefit_id',\n        'description',\n        'frequency',\n        'type'\n      ]\n    },\n    benefit_frequency: {\n      type: 'string',\n      title: 'BenefitFrequency',\n      description: 'The frequency of the benefit deduction/contribution.',\n      enum: [        'every_paycheck',\n        'monthly',\n        'one_time'\n      ]\n    },\n    benefit_type: {\n      type: 'string',\n      title: 'BenefitType',\n      description: 'Type of benefit.',\n      enum: [        '457',\n        '401k',\n        '401k_roth',\n        '401k_loan',\n        '403b',\n        '403b_roth',\n        '457_roth',\n        'commuter',\n        'custom_post_tax',\n        'custom_pre_tax',\n        'fsa_dependent_care',\n        'fsa_medical',\n        'hsa_post',\n        'hsa_pre',\n        's125_dental',\n        's125_medical',\n        's125_vision',\n        'simple',\n        'simple_ira'\n      ]\n    }\n  }\n}\n```",
     inputSchema: {
         type: 'object',
-        properties: {},
+        properties: {
+            entity_ids: {
+                type: 'array',
+                description: "The entity IDs to specify which entities' data to access.",
+                items: {
+                    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: [],
+    },
+    annotations: {
+        readOnlyHint: true,
     },
 };
-export const handler = (client, args) => {
-    return client.hris.benefits.list();
+export const handler = async (client, args) => {
+    const { jq_filter, ...body } = args;
+    const response = await client.hris.benefits.list(body).asResponse();
+    try {
+        return asTextContentResult(await maybeFilter(jq_filter, await response.json()));
+    }
+    catch (error) {
+        if (error instanceof Finch.APIError || isJqError(error)) {
+            return asErrorResult(error.message);
+        }
+        throw error;
+    }
 };
 export default { metadata, tool, handler };
 //# sourceMappingURL=list-hris-benefits.mjs.map

package/tools/hris/benefits/list-hris-benefits.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"list-hris-benefits.mjs","sourceRoot":"","sources":["../../../src/tools/hris/benefits/list-hris-benefits.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAMtF,MAAM,CAAC,MAAM,QAAQ,GAAa;IAChC,QAAQ,EAAE,eAAe;IACzB,SAAS,EAAE,MAAM;IACjB,IAAI,EAAE,EAAE;CACT,CAAC;AAEF,MAAM,CAAC,MAAM,IAAI,GAAS;IACxB,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EAAE,qDAAqD;IAClE,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,EAAE;KACf;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,MAAa,EAAE,IAAyC,EAAE,EAAE;IAClF,OAAO,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;AACrC,CAAC,CAAC;AAEF,eAAe,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC"}
+{"version":3,"file":"list-hris-benefits.mjs","sourceRoot":"","sources":["../../../src/tools/hris/benefits/list-hris-benefits.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,mCAAmC;OACnE,EAAY,aAAa,EAAE,mBAAmB,EAAE,MAAM,qCAAqC;OAG3F,KAAK,MAAM,qBAAqB;AAEvC,MAAM,CAAC,MAAM,QAAQ,GAAa;IAChC,QAAQ,EAAE,eAAe;IACzB,SAAS,EAAE,MAAM;IACjB,IAAI,EAAE,EAAE;IACR,UAAU,EAAE,KAAK;IACjB,QAAQ,EAAE,oBAAoB;IAC9B,WAAW,EAAE,sBAAsB;CACpC,CAAC;AAEF,MAAM,CAAC,MAAM,IAAI,GAAS;IACxB,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EACT,onFAAonF;IACtnF,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,WAAW,EAAE,2DAA2D;gBACxE,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;iBACf;aACF;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,WAAW;gBAClB,WAAW,EACT,kWAAkW;aACrW;SACF;QACD,QAAQ,EAAE,EAAE;KACb;IACD,WAAW,EAAE;QACX,YAAY,EAAE,IAAI;KACnB;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAG,KAAK,EAAE,MAAa,EAAE,IAAyC,EAAE,EAAE;IACxF,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,IAAW,CAAC;IAC3C,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC;IACpE,IAAI,CAAC;QACH,OAAO,mBAAmB,CAAC,MAAM,WAAW,CAAC,SAAS,EAAE,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAClF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,KAAK,CAAC,QAAQ,IAAI,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;YACxD,OAAO,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACtC,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC,CAAC;AAEF,eAAe,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC"}

package/tools/hris/benefits/list-supported-benefits-hris-benefits.d.mts

@@ -1,32 +1,51 @@
+import { Metadata } from '@tryfinch/finch-api-mcp/tools/types';
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import type { Metadata } from "../..//index.mjs";
 import Finch from '@tryfinch/finch-api';
 export declare const metadata: Metadata;
 export declare const tool: Tool;
-export declare const handler: (client: Finch, args: Record<string, unknown> | undefined) => import("@tryfinch/finch-api/core").PagePromise<Finch.HRIS.Benefits.BenefitListSupportedBenefitsResponsesSinglePage, Finch.HRIS.Benefits.BenefitListSupportedBenefitsResponse>;
+export declare const handler: (client: Finch, args: Record<string, unknown> | undefined) => Promise<import("@tryfinch/finch-api-mcp/tools/types").ToolCallResult>;
 declare const _default: {
     metadata: Metadata;
     tool: {
-        [x: string]: unknown;
-        name: string;
         inputSchema: {
             [x: string]: unknown;
             type: "object";
             properties?: {
-                [x: string]: unknown;
+                [x: string]: object;
             } | undefined;
+            required?: string[] | undefined;
         };
+        name: string;
         description?: string | undefined;
-        annotations?: {
+        outputSchema?: {
             [x: string]: unknown;
+            type: "object";
+            properties?: {
+                [x: string]: object;
+            } | undefined;
+            required?: string[] | undefined;
+        } | undefined;
+        annotations?: {
             title?: string | undefined;
             readOnlyHint?: boolean | undefined;
             destructiveHint?: boolean | undefined;
             idempotentHint?: boolean | undefined;
             openWorldHint?: boolean | undefined;
         } | undefined;
+        execution?: {
+            taskSupport?: "optional" | "required" | "forbidden" | undefined;
+        } | undefined;
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+        icons?: {
+            src: string;
+            mimeType?: string | undefined;
+            sizes?: string[] | undefined;
+        }[] | undefined;
+        title?: string | undefined;
     };
-    handler: (client: Finch, args: Record<string, unknown> | undefined) => import("@tryfinch/finch-api/core").PagePromise<Finch.HRIS.Benefits.BenefitListSupportedBenefitsResponsesSinglePage, Finch.HRIS.Benefits.BenefitListSupportedBenefitsResponse>;
+    handler: (client: Finch, args: Record<string, unknown> | undefined) => Promise<import("@tryfinch/finch-api-mcp/tools/types").ToolCallResult>;
 };
 export default _default;
 //# sourceMappingURL=list-supported-benefits-hris-benefits.d.mts.map

package/tools/hris/benefits/list-supported-benefits-hris-benefits.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"list-supported-benefits-hris-benefits.d.mts","sourceRoot":"","sources":["../../../src/tools/hris/benefits/list-supported-benefits-hris-benefits.ts"],"names":[],"mappings":"OAEO,EAAE,IAAI,EAAE,MAAM,oCAAoC;OAClD,KAAK,EAAE,QAAQ,EAAE;OACjB,KAAK,MAAM,qBAAqB;AAEvC,eAAO,MAAM,QAAQ,EAAE,QAItB,CAAC;AAEF,eAAO,MAAM,IAAI,EAAE,IAOlB,CAAC;AAEF,eAAO,MAAM,OAAO,GAAI,QAAQ,KAAK,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,kLAE/E,CAAC;;;;;;;;;;;;;;;;;;;;;;;sBAF8B,KAAK,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;;AAIhF,wBAA2C"}
+{"version":3,"file":"list-supported-benefits-hris-benefits.d.mts","sourceRoot":"","sources":["../../../src/tools/hris/benefits/list-supported-benefits-hris-benefits.ts"],"names":[],"mappings":"OAGO,EAAE,QAAQ,EAAsC,MAAM,qCAAqC;OAE3F,EAAE,IAAI,EAAE,MAAM,oCAAoC;OAClD,KAAK,MAAM,qBAAqB;AAEvC,eAAO,MAAM,QAAQ,EAAE,QAOtB,CAAC;AAEF,eAAO,MAAM,IAAI,EAAE,IA0BlB,CAAC;AAEF,eAAO,MAAM,OAAO,GAAU,QAAQ,KAAK,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,0EAWrF,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAXoC,KAAK,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;;AAatF,wBAA2C"}

package/tools/hris/benefits/list-supported-benefits-hris-benefits.d.ts

@@ -1,32 +1,51 @@
+import { Metadata } from '@tryfinch/finch-api-mcp/tools/types';
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import type { Metadata } from "../..//index.js";
 import Finch from '@tryfinch/finch-api';
 export declare const metadata: Metadata;
 export declare const tool: Tool;
-export declare const handler: (client: Finch, args: Record<string, unknown> | undefined) => import("@tryfinch/finch-api/core").PagePromise<Finch.HRIS.Benefits.BenefitListSupportedBenefitsResponsesSinglePage, Finch.HRIS.Benefits.BenefitListSupportedBenefitsResponse>;
+export declare const handler: (client: Finch, args: Record<string, unknown> | undefined) => Promise<import("@tryfinch/finch-api-mcp/tools/types").ToolCallResult>;
 declare const _default: {
     metadata: Metadata;
     tool: {
-        [x: string]: unknown;
-        name: string;
         inputSchema: {
             [x: string]: unknown;
             type: "object";
             properties?: {
-                [x: string]: unknown;
+                [x: string]: object;
             } | undefined;
+            required?: string[] | undefined;
         };
+        name: string;
         description?: string | undefined;
-        annotations?: {
+        outputSchema?: {
             [x: string]: unknown;
+            type: "object";
+            properties?: {
+                [x: string]: object;
+            } | undefined;
+            required?: string[] | undefined;
+        } | undefined;
+        annotations?: {
             title?: string | undefined;
             readOnlyHint?: boolean | undefined;
             destructiveHint?: boolean | undefined;
             idempotentHint?: boolean | undefined;
             openWorldHint?: boolean | undefined;
         } | undefined;
+        execution?: {
+            taskSupport?: "optional" | "required" | "forbidden" | undefined;
+        } | undefined;
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+        icons?: {
+            src: string;
+            mimeType?: string | undefined;
+            sizes?: string[] | undefined;
+        }[] | undefined;
+        title?: string | undefined;
     };
-    handler: (client: Finch, args: Record<string, unknown> | undefined) => import("@tryfinch/finch-api/core").PagePromise<Finch.HRIS.Benefits.BenefitListSupportedBenefitsResponsesSinglePage, Finch.HRIS.Benefits.BenefitListSupportedBenefitsResponse>;
+    handler: (client: Finch, args: Record<string, unknown> | undefined) => Promise<import("@tryfinch/finch-api-mcp/tools/types").ToolCallResult>;
 };
 export default _default;
 //# sourceMappingURL=list-supported-benefits-hris-benefits.d.ts.map

package/tools/hris/benefits/list-supported-benefits-hris-benefits.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-supported-benefits-hris-benefits.d.ts","sourceRoot":"","sources":["../../../src/tools/hris/benefits/list-supported-benefits-hris-benefits.ts"],"names":[],"mappings":"OAEO,EAAE,IAAI,EAAE,MAAM,oCAAoC;OAClD,KAAK,EAAE,QAAQ,EAAE;OACjB,KAAK,MAAM,qBAAqB;AAEvC,eAAO,MAAM,QAAQ,EAAE,QAItB,CAAC;AAEF,eAAO,MAAM,IAAI,EAAE,IAOlB,CAAC;AAEF,eAAO,MAAM,OAAO,GAAI,QAAQ,KAAK,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,kLAE/E,CAAC;;;;;;;;;;;;;;;;;;;;;;;sBAF8B,KAAK,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;;AAIhF,wBAA2C"}
+{"version":3,"file":"list-supported-benefits-hris-benefits.d.ts","sourceRoot":"","sources":["../../../src/tools/hris/benefits/list-supported-benefits-hris-benefits.ts"],"names":[],"mappings":"OAGO,EAAE,QAAQ,EAAsC,MAAM,qCAAqC;OAE3F,EAAE,IAAI,EAAE,MAAM,oCAAoC;OAClD,KAAK,MAAM,qBAAqB;AAEvC,eAAO,MAAM,QAAQ,EAAE,QAOtB,CAAC;AAEF,eAAO,MAAM,IAAI,EAAE,IA0BlB,CAAC;AAEF,eAAO,MAAM,OAAO,GAAU,QAAQ,KAAK,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,0EAWrF,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAXoC,KAAK,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;;AAatF,wBAA2C"}

package/tools/hris/benefits/list-supported-benefits-hris-benefits.js

@@ -1,22 +1,58 @@
 "use strict";
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.handler = exports.tool = exports.metadata = void 0;
+const filtering_1 = require("@tryfinch/finch-api-mcp/filtering");
+const types_1 = require("@tryfinch/finch-api-mcp/tools/types");
+const finch_api_1 = __importDefault(require("@tryfinch/finch-api"));
 exports.metadata = {
     resource: 'hris.benefits',
     operation: 'read',
     tags: [],
+    httpMethod: 'get',
+    httpPath: '/employer/benefits/meta',
+    operationId: 'get-company-benefits-meta',
 };
 exports.tool = {
     name: 'list_supported_benefits_hris_benefits',
-    description: 'Get deductions metadata',
+    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 deductions metadata\n\n# Response Schema\n```json\n{\n  type: 'array',\n  items: {\n    $ref: '#/$defs/supported_benefit'\n  },\n  $defs: {\n    supported_benefit: {\n      type: 'object',\n      title: 'BenefitFeature',\n      properties: {\n        annual_maximum: {\n          type: 'boolean',\n          description: 'Whether the provider supports an annual maximum for this benefit.'\n        },\n        company_contribution: {\n          type: 'array',\n          description: 'Supported contribution types. An empty array indicates contributions are not supported.',\n          items: {\n            type: 'string',\n            enum: [              'fixed',\n              'percent',\n              'tiered'\n            ]\n          }\n        },\n        description: {\n          type: 'string'\n        },\n        employee_deduction: {\n          type: 'array',\n          description: 'Supported deduction types. An empty array indicates deductions are not supported.',\n          items: {\n            type: 'string',\n            enum: [              'fixed',\n              'percent'\n            ]\n          }\n        },\n        frequencies: {\n          type: 'array',\n          description: 'The list of frequencies supported by the provider for this benefit',\n          items: {\n            $ref: '#/$defs/benefit_frequency'\n          }\n        },\n        catch_up: {\n          type: 'boolean',\n          description: 'Whether the provider supports catch up for this benefit. This field will only be true for retirement benefits.'\n        },\n        hsa_contribution_limit: {\n          type: 'array',\n          description: 'Whether the provider supports HSA contribution limits. Empty if this feature is not supported for the benefit. This array only has values for HSA benefits.',\n          items: {\n            type: 'string',\n            enum: [              'family',\n              'individual'\n            ]\n          }\n        }\n      },\n      required: [        'annual_maximum',\n        'company_contribution',\n        'description',\n        'employee_deduction',\n        'frequencies'\n      ]\n    },\n    benefit_frequency: {\n      type: 'string',\n      title: 'BenefitFrequency',\n      description: 'The frequency of the benefit deduction/contribution.',\n      enum: [        'every_paycheck',\n        'monthly',\n        'one_time'\n      ]\n    }\n  }\n}\n```",
     inputSchema: {
         type: 'object',
-        properties: {},
+        properties: {
+            entity_ids: {
+                type: 'array',
+                description: "The entity IDs to specify which entities' data to access.",
+                items: {
+                    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: [],
+    },
+    annotations: {
+        readOnlyHint: true,
     },
 };
-const handler = (client, args) => {
-    return client.hris.benefits.listSupportedBenefits();
+const handler = async (client, args) => {
+    const { jq_filter, ...body } = args;
+    const response = await client.hris.benefits.listSupportedBenefits(body).asResponse();
+    try {
+        return (0, types_1.asTextContentResult)(await (0, filtering_1.maybeFilter)(jq_filter, await response.json()));
+    }
+    catch (error) {
+        if (error instanceof finch_api_1.default.APIError || (0, filtering_1.isJqError)(error)) {
+            return (0, types_1.asErrorResult)(error.message);
+        }
+        throw error;
+    }
 };
 exports.handler = handler;
 exports.default = { metadata: exports.metadata, tool: exports.tool, handler: exports.handler };

package/tools/hris/benefits/list-supported-benefits-hris-benefits.js.map

@@ -1 +1 @@
-{"version":3,"file":"list-supported-benefits-hris-benefits.js","sourceRoot":"","sources":["../../../src/tools/hris/benefits/list-supported-benefits-hris-benefits.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAMzE,QAAA,QAAQ,GAAa;IAChC,QAAQ,EAAE,eAAe;IACzB,SAAS,EAAE,MAAM;IACjB,IAAI,EAAE,EAAE;CACT,CAAC;AAEW,QAAA,IAAI,GAAS;IACxB,IAAI,EAAE,uCAAuC;IAC7C,WAAW,EAAE,yBAAyB;IACtC,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,EAAE;KACf;CACF,CAAC;AAEK,MAAM,OAAO,GAAG,CAAC,MAAa,EAAE,IAAyC,EAAE,EAAE;IAClF,OAAO,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,qBAAqB,EAAE,CAAC;AACtD,CAAC,CAAC;AAFW,QAAA,OAAO,WAElB;AAEF,kBAAe,EAAE,QAAQ,EAAR,gBAAQ,EAAE,IAAI,EAAJ,YAAI,EAAE,OAAO,EAAP,eAAO,EAAE,CAAC"}
+{"version":3,"file":"list-supported-benefits-hris-benefits.js","sourceRoot":"","sources":["../../../src/tools/hris/benefits/list-supported-benefits-hris-benefits.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;;;AAEtF,iEAA2E;AAC3E,+DAAmG;AAGnG,oEAAwC;AAE3B,QAAA,QAAQ,GAAa;IAChC,QAAQ,EAAE,eAAe;IACzB,SAAS,EAAE,MAAM;IACjB,IAAI,EAAE,EAAE;IACR,UAAU,EAAE,KAAK;IACjB,QAAQ,EAAE,yBAAyB;IACnC,WAAW,EAAE,2BAA2B;CACzC,CAAC;AAEW,QAAA,IAAI,GAAS;IACxB,IAAI,EAAE,uCAAuC;IAC7C,WAAW,EACT,2iFAA2iF;IAC7iF,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,WAAW,EAAE,2DAA2D;gBACxE,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;iBACf;aACF;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,WAAW;gBAClB,WAAW,EACT,kWAAkW;aACrW;SACF;QACD,QAAQ,EAAE,EAAE;KACb;IACD,WAAW,EAAE;QACX,YAAY,EAAE,IAAI;KACnB;CACF,CAAC;AAEK,MAAM,OAAO,GAAG,KAAK,EAAE,MAAa,EAAE,IAAyC,EAAE,EAAE;IACxF,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,IAAW,CAAC;IAC3C,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC;IACrF,IAAI,CAAC;QACH,OAAO,IAAA,2BAAmB,EAAC,MAAM,IAAA,uBAAW,EAAC,SAAS,EAAE,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAClF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,mBAAK,CAAC,QAAQ,IAAI,IAAA,qBAAS,EAAC,KAAK,CAAC,EAAE,CAAC;YACxD,OAAO,IAAA,qBAAa,EAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACtC,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC,CAAC;AAXW,QAAA,OAAO,WAWlB;AAEF,kBAAe,EAAE,QAAQ,EAAR,gBAAQ,EAAE,IAAI,EAAJ,YAAI,EAAE,OAAO,EAAP,eAAO,EAAE,CAAC"}

package/tools/hris/benefits/list-supported-benefits-hris-benefits.mjs

@@ -1,19 +1,52 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { isJqError, maybeFilter } from '@tryfinch/finch-api-mcp/filtering';
+import { asErrorResult, asTextContentResult } from '@tryfinch/finch-api-mcp/tools/types';
+import Finch from '@tryfinch/finch-api';
 export const metadata = {
     resource: 'hris.benefits',
     operation: 'read',
     tags: [],
+    httpMethod: 'get',
+    httpPath: '/employer/benefits/meta',
+    operationId: 'get-company-benefits-meta',
 };
 export const tool = {
     name: 'list_supported_benefits_hris_benefits',
-    description: 'Get deductions metadata',
+    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 deductions metadata\n\n# Response Schema\n```json\n{\n  type: 'array',\n  items: {\n    $ref: '#/$defs/supported_benefit'\n  },\n  $defs: {\n    supported_benefit: {\n      type: 'object',\n      title: 'BenefitFeature',\n      properties: {\n        annual_maximum: {\n          type: 'boolean',\n          description: 'Whether the provider supports an annual maximum for this benefit.'\n        },\n        company_contribution: {\n          type: 'array',\n          description: 'Supported contribution types. An empty array indicates contributions are not supported.',\n          items: {\n            type: 'string',\n            enum: [              'fixed',\n              'percent',\n              'tiered'\n            ]\n          }\n        },\n        description: {\n          type: 'string'\n        },\n        employee_deduction: {\n          type: 'array',\n          description: 'Supported deduction types. An empty array indicates deductions are not supported.',\n          items: {\n            type: 'string',\n            enum: [              'fixed',\n              'percent'\n            ]\n          }\n        },\n        frequencies: {\n          type: 'array',\n          description: 'The list of frequencies supported by the provider for this benefit',\n          items: {\n            $ref: '#/$defs/benefit_frequency'\n          }\n        },\n        catch_up: {\n          type: 'boolean',\n          description: 'Whether the provider supports catch up for this benefit. This field will only be true for retirement benefits.'\n        },\n        hsa_contribution_limit: {\n          type: 'array',\n          description: 'Whether the provider supports HSA contribution limits. Empty if this feature is not supported for the benefit. This array only has values for HSA benefits.',\n          items: {\n            type: 'string',\n            enum: [              'family',\n              'individual'\n            ]\n          }\n        }\n      },\n      required: [        'annual_maximum',\n        'company_contribution',\n        'description',\n        'employee_deduction',\n        'frequencies'\n      ]\n    },\n    benefit_frequency: {\n      type: 'string',\n      title: 'BenefitFrequency',\n      description: 'The frequency of the benefit deduction/contribution.',\n      enum: [        'every_paycheck',\n        'monthly',\n        'one_time'\n      ]\n    }\n  }\n}\n```",
     inputSchema: {
         type: 'object',
-        properties: {},
+        properties: {
+            entity_ids: {
+                type: 'array',
+                description: "The entity IDs to specify which entities' data to access.",
+                items: {
+                    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: [],
+    },
+    annotations: {
+        readOnlyHint: true,
     },
 };
-export const handler = (client, args) => {
-    return client.hris.benefits.listSupportedBenefits();
+export const handler = async (client, args) => {
+    const { jq_filter, ...body } = args;
+    const response = await client.hris.benefits.listSupportedBenefits(body).asResponse();
+    try {
+        return asTextContentResult(await maybeFilter(jq_filter, await response.json()));
+    }
+    catch (error) {
+        if (error instanceof Finch.APIError || isJqError(error)) {
+            return asErrorResult(error.message);
+        }
+        throw error;
+    }
 };
 export default { metadata, tool, handler };
 //# sourceMappingURL=list-supported-benefits-hris-benefits.mjs.map