@tryfinch/finch-api-mcp 7.0.0 → 8.1.0

package/src/tools/hris/benefits/create-hris-benefits.ts

@@ -1,129 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-import { isJqError, maybeFilter } from '@tryfinch/finch-api-mcp/filtering';
-import { Metadata, asErrorResult, asTextContentResult } from '@tryfinch/finch-api-mcp/tools/types';
-
-import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import Finch from '@tryfinch/finch-api';
-
-export const metadata: Metadata = {
-  resource: 'hris.benefits',
-  operation: 'write',
-  tags: [],
-  httpMethod: 'post',
-  httpPath: '/employer/benefits',
-  operationId: 'create-company-benefits',
-};
-
-export const tool: Tool = {
-  name: 'create_hris_benefits',
-  description:
-    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nCreates a new company-wide deduction or contribution. Please use the `/providers` endpoint to view available types for each provider.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/create_company_benefits_response',\n  $defs: {\n    create_company_benefits_response: {\n      type: 'object',\n      properties: {\n        benefit_id: {\n          type: 'string',\n          description: 'The id of the benefit.'\n        },\n        job_id: {\n          type: 'string'\n        }\n      },\n      required: [        'benefit_id',\n        'job_id'\n      ]\n    }\n  }\n}\n```",
-  inputSchema: {
-    type: 'object',
-    properties: {
-      entity_ids: {
-        type: 'array',
-        description: "The entity IDs to specify which entities' data to access.",
-        items: {
-          type: 'string',
-        },
-      },
-      company_contribution: {
-        type: 'object',
-        title: 'BenefitCompanyMatchContribution',
-        description: 'The company match for this benefit.',
-        properties: {
-          tiers: {
-            type: 'array',
-            items: {
-              type: 'object',
-              properties: {
-                match: {
-                  type: 'integer',
-                },
-                threshold: {
-                  type: 'integer',
-                },
-              },
-              required: ['match', 'threshold'],
-            },
-          },
-          type: {
-            type: 'string',
-            enum: ['match'],
-          },
-        },
-        required: ['tiers', 'type'],
-      },
-      description: {
-        type: 'string',
-        title: 'BenefitDescription',
-        description:
-          'Name of the benefit as it appears in the provider and pay statements. Recommend limiting this to <30 characters due to limitations in specific providers (e.g. Justworks).',
-      },
-      frequency: {
-        $ref: '#/$defs/benefit_frequency',
-      },
-      type: {
-        $ref: '#/$defs/benefit_type',
-      },
-      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: [],
-    $defs: {
-      benefit_frequency: {
-        type: 'string',
-        title: 'BenefitFrequency',
-        description: 'The frequency of the benefit deduction/contribution.',
-        enum: ['every_paycheck', 'monthly', 'one_time'],
-      },
-      benefit_type: {
-        type: 'string',
-        title: 'BenefitType',
-        description: 'Type of benefit.',
-        enum: [
-          '457',
-          '401k',
-          '401k_roth',
-          '401k_loan',
-          '403b',
-          '403b_roth',
-          '457_roth',
-          'commuter',
-          'custom_post_tax',
-          'custom_pre_tax',
-          'fsa_dependent_care',
-          'fsa_medical',
-          'hsa_post',
-          'hsa_pre',
-          's125_dental',
-          's125_medical',
-          's125_vision',
-          'simple',
-          'simple_ira',
-        ],
-      },
-    },
-  },
-  annotations: {},
-};
-
-export const handler = async (client: Finch, args: Record<string, unknown> | undefined) => {
-  const { jq_filter, ...body } = args as any;
-  try {
-    return asTextContentResult(await maybeFilter(jq_filter, await client.hris.benefits.create(body)));
-  } catch (error) {
-    if (error instanceof Finch.APIError || isJqError(error)) {
-      return asErrorResult(error.message);
-    }
-    throw error;
-  }
-};
-
-export default { metadata, tool, handler };

package/src/tools/hris/benefits/individuals/enroll-many-benefits-hris-individuals.ts

@@ -1,146 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-import { isJqError, maybeFilter } from '@tryfinch/finch-api-mcp/filtering';
-import { Metadata, asErrorResult, asTextContentResult } from '@tryfinch/finch-api-mcp/tools/types';
-
-import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import Finch from '@tryfinch/finch-api';
-
-export const metadata: Metadata = {
-  resource: 'hris.benefits.individuals',
-  operation: 'write',
-  tags: [],
-  httpMethod: 'post',
-  httpPath: '/employer/benefits/{benefit_id}/individuals',
-  operationId: 'post-employer-individual-benefits-benefit_id',
-};
-
-export const tool: Tool = {
-  name: 'enroll_many_benefits_hris_individuals',
-  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\nEnroll an individual into a deduction or contribution. This is an overwrite operation. If the employee is already enrolled, the enrollment amounts will be adjusted. Making the same request multiple times will not create new enrollments, but will continue to set the state of the existing enrollment.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/enrolled_individual_benefit_response',\n  $defs: {\n    enrolled_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',
-        },
-      },
-      individuals: {
-        type: 'array',
-        description: 'Array of the individual_id to enroll and a configuration object.',
-        items: {
-          type: 'object',
-          properties: {
-            configuration: {
-              type: 'object',
-              properties: {
-                annual_contribution_limit: {
-                  type: 'string',
-                  description:
-                    'For HSA benefits only - whether the contribution limit is for an individual or family',
-                  enum: ['individual', 'family'],
-                },
-                annual_maximum: {
-                  type: 'integer',
-                  description: 'Maximum annual amount in cents',
-                },
-                catch_up: {
-                  type: 'boolean',
-                  description: 'For retirement benefits only - whether catch up contributions are enabled',
-                },
-                company_contribution: {
-                  type: 'object',
-                  properties: {
-                    amount: {
-                      type: 'integer',
-                      description:
-                        'Amount in cents for fixed type or basis points (1/100th of a percent) for percent type',
-                    },
-                    tiers: {
-                      type: 'array',
-                      description:
-                        'Array of tier objects for tiered contribution matching (required when type is tiered)',
-                      items: {
-                        type: 'object',
-                        properties: {
-                          match: {
-                            type: 'integer',
-                            description: 'The employer match percentage in basis points (0-10000 = 0-100%)',
-                          },
-                          threshold: {
-                            type: 'integer',
-                            description:
-                              'The employee contribution threshold in basis points (0-10000 = 0-100%)',
-                          },
-                        },
-                        required: ['match', 'threshold'],
-                      },
-                    },
-                    type: {
-                      type: 'string',
-                      enum: ['fixed', 'percent', 'tiered'],
-                    },
-                  },
-                },
-                effective_date: {
-                  type: 'string',
-                  description: 'The date the enrollment will take effect',
-                  format: 'date',
-                },
-                employee_deduction: {
-                  type: 'object',
-                  properties: {
-                    amount: {
-                      type: 'integer',
-                      description:
-                        'Amount in cents for fixed type or basis points (1/100th of a percent) for percent type',
-                    },
-                    type: {
-                      type: 'string',
-                      enum: ['fixed', 'percent'],
-                    },
-                  },
-                },
-              },
-            },
-            individual_id: {
-              type: 'string',
-              description: 'Finch id (uuidv4) for the individual to enroll',
-            },
-          },
-        },
-      },
-      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: {},
-};
-
-export const handler = async (client: Finch, args: Record<string, unknown> | undefined) => {
-  const { benefit_id, jq_filter, ...body } = args as any;
-  try {
-    return asTextContentResult(
-      await maybeFilter(jq_filter, await client.hris.benefits.individuals.enrollMany(benefit_id, body)),
-    );
-  } catch (error) {
-    if (error instanceof Finch.APIError || isJqError(error)) {
-      return asErrorResult(error.message);
-    }
-    throw error;
-  }
-};
-
-export default { metadata, tool, handler };

package/src/tools/hris/benefits/individuals/enrolled-ids-benefits-hris-individuals.ts

@@ -1,63 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-import { isJqError, maybeFilter } from '@tryfinch/finch-api-mcp/filtering';
-import { Metadata, asErrorResult, asTextContentResult } from '@tryfinch/finch-api-mcp/tools/types';
-
-import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import Finch from '@tryfinch/finch-api';
-
-export const metadata: Metadata = {
-  resource: 'hris.benefits.individuals',
-  operation: 'read',
-  tags: [],
-  httpMethod: 'get',
-  httpPath: '/employer/benefits/{benefit_id}/enrolled',
-  operationId: 'get-company-benefits-enrolled',
-};
-
-export const tool: Tool = {
-  name: 'enrolled_ids_benefits_hris_individuals',
-  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\nLists individuals currently enrolled in a given deduction.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/individual_enrolled_ids_response',\n  $defs: {\n    individual_enrolled_ids_response: {\n      type: 'object',\n      properties: {\n        benefit_id: {\n          type: 'string',\n          description: 'The id of the benefit.'\n        },\n        individual_ids: {\n          type: 'array',\n          items: {\n            type: 'string',\n            description: 'A stable Finch `id` (UUID v4) for an individual in the company.'\n          }\n        }\n      },\n      required: [        'benefit_id',\n        'individual_ids'\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',
-        },
-      },
-      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: {
-    readOnlyHint: true,
-  },
-};
-
-export const handler = async (client: Finch, args: Record<string, unknown> | undefined) => {
-  const { benefit_id, jq_filter, ...body } = args as any;
-  try {
-    return asTextContentResult(
-      await maybeFilter(jq_filter, await client.hris.benefits.individuals.enrolledIDs(benefit_id, body)),
-    );
-  } catch (error) {
-    if (error instanceof Finch.APIError || isJqError(error)) {
-      return asErrorResult(error.message);
-    }
-    throw error;
-  }
-};
-
-export default { metadata, tool, handler };

package/src/tools/hris/benefits/individuals/retrieve-many-benefits-benefits-hris-individuals.ts

@@ -1,67 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-import { isJqError, maybeFilter } from '@tryfinch/finch-api-mcp/filtering';
-import { Metadata, asErrorResult, asTextContentResult } from '@tryfinch/finch-api-mcp/tools/types';
-
-import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import Finch from '@tryfinch/finch-api';
-
-export const metadata: Metadata = {
-  resource: 'hris.benefits.individuals',
-  operation: 'read',
-  tags: [],
-  httpMethod: 'get',
-  httpPath: '/employer/benefits/{benefit_id}/individuals',
-  operationId: 'get-individual-benefits',
-};
-
-export const tool: Tool = {
-  name: 'retrieve_many_benefits_benefits_hris_individuals',
-  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 enrollment information for the given individuals.\n\n# Response Schema\n```json\n{\n  type: 'array',\n  title: 'IndividualBenefits',\n  items: {\n    $ref: '#/$defs/individual_benefit'\n  },\n  $defs: {\n    individual_benefit: {\n      type: 'object',\n      properties: {\n        body: {\n          anyOf: [            {\n              type: 'object',\n              properties: {\n                annual_maximum: {\n                  type: 'integer',\n                  description: 'If the benefit supports annual maximum, the amount in cents for this individual.'\n                },\n                catch_up: {\n                  type: 'boolean',\n                  description: 'If the benefit supports catch up (401k, 403b, etc.), whether catch up is enabled for this individual.'\n                },\n                company_contribution: {\n                  anyOf: [                    {\n                      type: 'object',\n                      properties: {\n                        amount: {\n                          type: 'integer',\n                          description: 'Contribution amount in cents (for type=fixed) or basis points (for type=percent, where 100 = 1%). Not used for type=tiered.'\n                        },\n                        type: {\n                          type: 'string',\n                          description: 'Contribution type. Supported values: \"fixed\" (amount in cents), \"percent\" (amount in basis points), or \"tiered\" (multi-tier matching).',\n                          enum: [                            'fixed'\n                          ]\n                        }\n                      },\n                      required: [                        'amount',\n                        'type'\n                      ]\n                    },\n                    {\n                      type: 'object',\n                      properties: {\n                        amount: {\n                          type: 'integer',\n                          description: 'Contribution amount in cents (for type=fixed) or basis points (for type=percent, where 100 = 1%). Not used for type=tiered.'\n                        },\n                        type: {\n                          type: 'string',\n                          description: 'Contribution type. Supported values: \"fixed\" (amount in cents), \"percent\" (amount in basis points), or \"tiered\" (multi-tier matching).',\n                          enum: [                            'percent'\n                          ]\n                        }\n                      },\n                      required: [                        'amount',\n                        'type'\n                      ]\n                    },\n                    {\n                      type: 'object',\n                      properties: {\n                        tiers: {\n                          type: 'array',\n                          description: 'Array of tier objects defining employer match tiers based on employee contribution thresholds. Required when type=tiered.',\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                          description: 'Contribution type. Supported values: \"fixed\" (amount in cents), \"percent\" (amount in basis points), or \"tiered\" (multi-tier matching).',\n                          enum: [                            'tiered'\n                          ]\n                        }\n                      },\n                      required: [                        'tiers',\n                        'type'\n                      ]\n                    }\n                  ],\n                  title: 'CompanyContribution',\n                  description: 'Company contribution configuration. Supports fixed amounts (in cents), percentage-based contributions (in basis points where 100 = 1%), or tiered matching structures.'\n                },\n                employee_deduction: {\n                  anyOf: [                    {\n                      type: 'object',\n                      properties: {\n                        amount: {\n                          type: 'integer',\n                          description: 'Contribution amount in cents (for type=fixed) or basis points (for type=percent, where 100 = 1%).'\n                        },\n                        type: {\n                          type: 'string',\n                          description: 'Contribution type. Supported values: \"fixed\" (amount in cents) or \"percent\" (amount in basis points).',\n                          enum: [                            'fixed'\n                          ]\n                        }\n                      },\n                      required: [                        'amount',\n                        'type'\n                      ]\n                    },\n                    {\n                      type: 'object',\n                      properties: {\n                        amount: {\n                          type: 'integer',\n                          description: 'Contribution amount in cents (for type=fixed) or basis points (for type=percent, where 100 = 1%).'\n                        },\n                        type: {\n                          type: 'string',\n                          description: 'Contribution type. Supported values: \"fixed\" (amount in cents) or \"percent\" (amount in basis points).',\n                          enum: [                            'percent'\n                          ]\n                        }\n                      },\n                      required: [                        'amount',\n                        'type'\n                      ]\n                    }\n                  ],\n                  title: 'EmployeeDeductionContribution',\n                  description: 'Employee deduction configuration. Supports both fixed amounts (in cents) and percentage-based contributions (in basis points where 100 = 1%).'\n                },\n                hsa_contribution_limit: {\n                  type: 'string',\n                  description: 'Type for HSA contribution limit if the benefit is a HSA.',\n                  enum: [                    'individual',\n                    'family'\n                  ]\n                }\n              },\n              required: [                'annual_maximum',\n                'catch_up',\n                'company_contribution',\n                'employee_deduction'\n              ]\n            },\n            {\n              type: 'object',\n              properties: {\n                code: {\n                  type: 'number'\n                },\n                message: {\n                  type: 'string'\n                },\n                name: {\n                  type: 'string'\n                },\n                finch_code: {\n                  type: 'string'\n                }\n              },\n              required: [                'code',\n                'message',\n                'name'\n              ]\n            }\n          ]\n        },\n        code: {\n          type: 'integer'\n        },\n        individual_id: {\n          type: 'string'\n        }\n      },\n      required: [        'body',\n        'code',\n        'individual_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: 'string',
-        description:
-          'comma-delimited list of stable Finch uuids for each individual. If empty, defaults to all individuals',
-      },
-      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: {
-    readOnlyHint: true,
-  },
-};
-
-export const handler = async (client: Finch, args: Record<string, unknown> | undefined) => {
-  const { benefit_id, jq_filter, ...body } = args as any;
-  const response = await client.hris.benefits.individuals.retrieveManyBenefits(benefit_id, 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 };

package/src/tools/hris/benefits/individuals/unenroll-many-benefits-hris-individuals.ts

@@ -1,70 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-import { isJqError, maybeFilter } from '@tryfinch/finch-api-mcp/filtering';
-import { Metadata, asErrorResult, asTextContentResult } from '@tryfinch/finch-api-mcp/tools/types';
-
-import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import Finch from '@tryfinch/finch-api';
-
-export const metadata: Metadata = {
-  resource: 'hris.benefits.individuals',
-  operation: 'write',
-  tags: [],
-  httpMethod: 'delete',
-  httpPath: '/employer/benefits/{benefit_id}/individuals',
-  operationId: 'delete-individual-benefits',
-};
-
-export const tool: Tool = {
-  name: 'unenroll_many_benefits_hris_individuals',
-  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.',
-        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: ['benefit_id'],
-  },
-  annotations: {
-    idempotentHint: true,
-  },
-};
-
-export const handler = async (client: Finch, args: Record<string, unknown> | undefined) => {
-  const { benefit_id, jq_filter, ...body } = args as any;
-  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 };

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

@@ -1,59 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-import { isJqError, maybeFilter } from '@tryfinch/finch-api-mcp/filtering';
-import { Metadata, asErrorResult, asTextContentResult } from '@tryfinch/finch-api-mcp/tools/types';
-
-import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import Finch from '@tryfinch/finch-api';
-
-export const metadata: Metadata = {
-  resource: 'hris.benefits',
-  operation: 'read',
-  tags: [],
-  httpMethod: 'get',
-  httpPath: '/employer/benefits',
-  operationId: 'get-company-benefits',
-};
-
-export const tool: Tool = {
-  name: 'list_hris_benefits',
-  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: {
-      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 = async (client: Finch, args: Record<string, unknown> | undefined) => {
-  const { jq_filter, ...body } = args as any;
-  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 };

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

@@ -1,59 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-import { isJqError, maybeFilter } from '@tryfinch/finch-api-mcp/filtering';
-import { Metadata, asErrorResult, asTextContentResult } from '@tryfinch/finch-api-mcp/tools/types';
-
-import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import Finch from '@tryfinch/finch-api';
-
-export const metadata: Metadata = {
-  resource: 'hris.benefits',
-  operation: 'read',
-  tags: [],
-  httpMethod: 'get',
-  httpPath: '/employer/benefits/meta',
-  operationId: 'get-company-benefits-meta',
-};
-
-export const tool: Tool = {
-  name: 'list_supported_benefits_hris_benefits',
-  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: {
-      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 = async (client: Finch, args: Record<string, unknown> | undefined) => {
-  const { jq_filter, ...body } = args as any;
-  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 };