@tryfinch/finch-api-mcp 6.31.0 → 7.0.0

package/src/tools/account/disconnect-account.ts

@@ -1,26 +1,49 @@
 // 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 type { Metadata } from '../';
 import Finch from '@tryfinch/finch-api';
 
 export const metadata: Metadata = {
   resource: 'account',
   operation: 'write',
   tags: [],
+  httpMethod: 'post',
+  httpPath: '/disconnect',
+  operationId: 'post-disconnect',
 };
 
 export const tool: Tool = {
   name: 'disconnect_account',
-  description: 'Disconnect one or more `access_token`s from your application.',
+  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\nDisconnect one or more `access_token`s from your application.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/disconnect_response',\n  $defs: {\n    disconnect_response: {\n      type: 'object',\n      properties: {\n        status: {\n          type: 'string',\n          description: 'If the request is successful, Finch will return \"success\" (HTTP 200 status).'\n        }\n      },\n      required: [        'status'\n      ]\n    }\n  }\n}\n```",
   inputSchema: {
     type: 'object',
-    properties: {},
+    properties: {
+      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: {},
 };
 
-export const handler = (client: Finch, args: Record<string, unknown> | undefined) => {
-  return client.account.disconnect();
+export const handler = async (client: Finch, args: Record<string, unknown> | undefined) => {
+  const { jq_filter } = args as any;
+  try {
+    return asTextContentResult(await maybeFilter(jq_filter, await client.account.disconnect()));
+  } catch (error) {
+    if (error instanceof Finch.APIError || isJqError(error)) {
+      return asErrorResult(error.message);
+    }
+    throw error;
+  }
 };
 
 export default { metadata, tool, handler };

package/src/tools/account/introspect-account.ts

@@ -1,26 +1,51 @@
 // 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 type { Metadata } from '../';
 import Finch from '@tryfinch/finch-api';
 
 export const metadata: Metadata = {
   resource: 'account',
   operation: 'read',
   tags: [],
+  httpMethod: 'get',
+  httpPath: '/introspect',
+  operationId: 'get-introspect',
 };
 
 export const tool: Tool = {
   name: 'introspect_account',
-  description: 'Read account information associated with an `access_token`',
+  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\nRead account information associated with an `access_token`\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/introspection',\n  $defs: {\n    introspection: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The Finch UUID of the token being introspected'\n        },\n        client_id: {\n          type: 'string',\n          description: 'The client ID of the application associated with the `access_token`'\n        },\n        client_type: {\n          type: 'string',\n          title: 'ClientType',\n          description: 'The type of application associated with a token.',\n          enum: [            'development',\n            'production',\n            'sandbox'\n          ]\n        },\n        connection_id: {\n          type: 'string',\n          description: 'The Finch UUID of the connection associated with the `access_token`'\n        },\n        connection_status: {\n          type: 'object',\n          properties: {\n            status: {\n              $ref: '#/$defs/connection_status_type'\n            },\n            last_successful_sync: {\n              anyOf: [                {\n                  type: 'string',\n                  format: 'date-time'\n                },\n                {\n                  type: 'string'\n                }\n              ],\n              description: 'The datetime when the connection was last successfully synced'\n            },\n            message: {\n              type: 'string'\n            }\n          },\n          required: [            'status'\n          ]\n        },\n        connection_type: {\n          type: 'string',\n          title: 'ConnectionType',\n          description: 'The type of the connection associated with the token.\\n- `provider` - connection to an external provider\\n- `finch` - finch-generated data.',\n          enum: [            'finch',\n            'provider'\n          ]\n        },\n        products: {\n          type: 'array',\n          description: 'An array of the authorized products associated with the `access_token`.',\n          items: {\n            type: 'string'\n          }\n        },\n        provider_id: {\n          type: 'string',\n          description: 'The ID of the provider associated with the `access_token`.'\n        },\n        account_id: {\n          type: 'string',\n          description: '[DEPRECATED] Use `connection_id` to associate tokens with a Finch connection instead of this account ID'\n        },\n        authentication_methods: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              type: {\n                type: 'string',\n                description: 'The type of authentication method',\n                enum: [                  'assisted',\n                  'credential',\n                  'api_token',\n                  'api_credential',\n                  'oauth'\n                ]\n              },\n              connection_status: {\n                type: 'object',\n                properties: {\n                  status: {\n                    $ref: '#/$defs/connection_status_type'\n                  },\n                  last_successful_sync: {\n                    anyOf: [                      {\n                        type: 'string',\n                        format: 'date-time'\n                      },\n                      {\n                        type: 'string'\n                      }\n                    ],\n                    description: 'The datetime when the connection was last successfully synced'\n                  },\n                  message: {\n                    type: 'string'\n                  }\n                },\n                required: [                  'status'\n                ]\n              },\n              products: {\n                type: 'array',\n                description: 'An array of the authorized products associated with the `access_token`',\n                items: {\n                  type: 'string'\n                }\n              }\n            },\n            required: [              'type'\n            ]\n          }\n        },\n        company_id: {\n          type: 'string',\n          description: '[DEPRECATED] Use `connection_id` to associate tokens with a Finch connection instead of this company ID'\n        },\n        customer_email: {\n          type: 'string',\n          description: 'The email of your customer you provided to Finch when a connect session was created for this connection'\n        },\n        customer_id: {\n          type: 'string',\n          description: 'The ID of your customer you provided to Finch when a connect session was created for this connection'\n        },\n        customer_name: {\n          type: 'string',\n          description: 'The name of your customer you provided to Finch when a connect session was created for this connection'\n        },\n        entities: {\n          type: 'array',\n          description: 'Array of detailed entity information for each connected account in multi-account mode',\n          items: {\n            type: 'object',\n            properties: {\n              id: {\n                type: 'string',\n                description: 'The connection account ID for this entity'\n              },\n              name: {\n                type: 'string',\n                description: 'The name of the entity (payroll provider company name)'\n              },\n              source_id: {\n                type: 'string',\n                description: 'The source ID of the entity'\n              }\n            },\n            required: [              'id',\n              'name',\n              'source_id'\n            ]\n          }\n        },\n        manual: {\n          type: 'boolean',\n          description: 'Whether the connection associated with the `access_token` uses the Assisted Connect Flow. (`true` if using Assisted Connect, `false` if connection is automated)'\n        },\n        payroll_provider_id: {\n          type: 'string',\n          description: '[DEPRECATED] Use `provider_id` to identify the provider instead of this payroll provider ID.'\n        },\n        username: {\n          type: 'string',\n          description: 'The account username used for login associated with the `access_token`.'\n        }\n      },\n      required: [        'id',\n        'client_id',\n        'client_type',\n        'connection_id',\n        'connection_status',\n        'connection_type',\n        'products',\n        'provider_id'\n      ]\n    },\n    connection_status_type: {\n      type: 'string',\n      enum: [        'pending',\n        'processing',\n        'connected',\n        'error_no_account_setup',\n        'error_permissions',\n        'reauth'\n      ]\n    }\n  }\n}\n```",
   inputSchema: {
     type: 'object',
-    properties: {},
+    properties: {
+      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: Finch, args: Record<string, unknown> | undefined) => {
-  return client.account.introspect();
+export const handler = async (client: Finch, args: Record<string, unknown> | undefined) => {
+  const { jq_filter } = args as any;
+  try {
+    return asTextContentResult(await maybeFilter(jq_filter, await client.account.introspect()));
+  } catch (error) {
+    if (error instanceof Finch.APIError || isJqError(error)) {
+      return asErrorResult(error.message);
+    }
+    throw error;
+  }
 };
 
 export default { metadata, tool, handler };

package/src/tools/connect/sessions/new-connect-sessions.ts

@@ -1,83 +1,115 @@
 // 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 type { Metadata } from '../../';
 import Finch from '@tryfinch/finch-api';
 
 export const metadata: Metadata = {
   resource: 'connect.sessions',
   operation: 'write',
   tags: [],
+  httpMethod: 'post',
+  httpPath: '/connect/sessions',
+  operationId: 'post-connect-sessions',
 };
 
 export const tool: Tool = {
   name: 'new_connect_sessions',
-  description: 'Create a new connect session for an employer',
+  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\nCreate a new connect session for an employer\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/session_new_response',\n  $defs: {\n    session_new_response: {\n      type: 'object',\n      properties: {\n        connect_url: {\n          type: 'string',\n          description: 'The Connect URL to redirect the user to for authentication'\n        },\n        session_id: {\n          type: 'string',\n          description: 'The unique identifier for the created connect session'\n        }\n      },\n      required: [        'connect_url',\n        'session_id'\n      ]\n    }\n  }\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {
       customer_id: {
         type: 'string',
+        description: 'Unique identifier for the customer',
       },
       customer_name: {
         type: 'string',
+        description: 'Name of the customer',
       },
       products: {
         type: 'array',
+        description: 'The Finch products to request access to',
         items: {
           type: 'string',
           description: 'The Finch products that can be requested during the Connect flow.',
           enum: [
+            'benefits',
             'company',
+            'deduction',
             'directory',
-            'individual',
+            'documents',
             'employment',
+            'individual',
             'payment',
             'pay_statement',
-            'benefits',
             'ssn',
-            'deduction',
-            'documents',
           ],
         },
       },
       customer_email: {
         type: 'string',
+        description: 'Email address of the customer',
       },
       integration: {
         type: 'object',
+        description: 'Integration configuration for the connect session',
         properties: {
-          auth_method: {
+          provider: {
             type: 'string',
-            enum: ['assisted', 'credential', 'oauth', 'api_token'],
+            description: 'The provider to integrate with',
           },
-          provider: {
+          auth_method: {
             type: 'string',
+            description: 'The authentication method to use',
+            enum: ['assisted', 'credential', 'oauth', 'api_token'],
           },
         },
-        required: [],
+        required: ['provider'],
       },
       manual: {
         type: 'boolean',
+        description: 'Enable manual authentication mode',
       },
       minutes_to_expire: {
         type: 'number',
-        description: 'The number of minutes until the session expires (defaults to 43,200, which is 30 days)',
+        description:
+          'The number of minutes until the session expires (defaults to 129,600, which is 90 days)',
       },
       redirect_uri: {
         type: 'string',
+        description: 'The URI to redirect to after the Connect flow is completed',
       },
       sandbox: {
         type: 'string',
+        description: 'Sandbox mode for testing',
         enum: ['finch', 'provider'],
       },
+      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: ['customer_id', 'customer_name', 'products'],
   },
+  annotations: {},
 };
 
-export const handler = (client: Finch, args: Record<string, unknown> | undefined) => {
-  const body = args as any;
-  return client.connect.sessions.new(body);
+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.connect.sessions.new(body)));
+  } catch (error) {
+    if (error instanceof Finch.APIError || isJqError(error)) {
+      return asErrorResult(error.message);
+    }
+    throw error;
+  }
 };
 
 export default { metadata, tool, handler };

package/src/tools/connect/sessions/reauthenticate-connect-sessions.ts

@@ -1,18 +1,24 @@
 // 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 type { Metadata } from '../../';
 import Finch from '@tryfinch/finch-api';
 
 export const metadata: Metadata = {
   resource: 'connect.sessions',
   operation: 'write',
   tags: [],
+  httpMethod: 'post',
+  httpPath: '/connect/sessions/reauthenticate',
+  operationId: 'post-connect-sessions-reauthenticate',
 };
 
 export const tool: Tool = {
   name: 'reauthenticate_connect_sessions',
-  description: 'Create a new Connect session for reauthenticating an existing connection',
+  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\nCreate a new Connect session for reauthenticating an existing connection\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/session_reauthenticate_response',\n  $defs: {\n    session_reauthenticate_response: {\n      type: 'object',\n      properties: {\n        connect_url: {\n          type: 'string',\n          description: 'The Connect URL to redirect the user to for reauthentication'\n        },\n        session_id: {\n          type: 'string',\n          description: 'The unique identifier for the created connect session'\n        }\n      },\n      required: [        'connect_url',\n        'session_id'\n      ]\n    }\n  }\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {
@@ -31,16 +37,16 @@ export const tool: Tool = {
           type: 'string',
           description: 'The Finch products that can be requested during the Connect flow.',
           enum: [
+            'benefits',
             'company',
+            'deduction',
             'directory',
-            'individual',
+            'documents',
             'employment',
+            'individual',
             'payment',
             'pay_statement',
-            'benefits',
             'ssn',
-            'deduction',
-            'documents',
           ],
         },
       },
@@ -48,13 +54,30 @@ export const tool: Tool = {
         type: 'string',
         description: 'The URI to redirect to after the Connect flow is completed',
       },
+      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: ['connection_id'],
   },
+  annotations: {},
 };
 
-export const handler = (client: Finch, args: Record<string, unknown> | undefined) => {
-  const body = args as any;
-  return client.connect.sessions.reauthenticate(body);
+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.connect.sessions.reauthenticate(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/create-hris-benefits.ts

@@ -1,22 +1,34 @@
 // 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 type { Metadata } from '../../';
 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:
-    'Creates a new company-wide deduction or contribution. Please use the `/providers` endpoint to view available types for each provider.',
+    "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',
@@ -34,7 +46,7 @@ export const tool: Tool = {
                   type: 'integer',
                 },
               },
-              required: [],
+              required: ['match', 'threshold'],
             },
           },
           type: {
@@ -42,7 +54,7 @@ export const tool: Tool = {
             enum: ['match'],
           },
         },
-        required: [],
+        required: ['tiers', 'type'],
       },
       description: {
         type: 'string',
@@ -56,47 +68,62 @@ export const tool: Tool = {
       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: ['one_time', 'every_paycheck', 'monthly'],
+        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',
           '457_roth',
-          's125_medical',
-          's125_dental',
-          's125_vision',
-          'hsa_pre',
-          'hsa_post',
-          'fsa_medical',
-          'fsa_dependent_care',
-          'simple_ira',
-          'simple',
           '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 = (client: Finch, args: Record<string, unknown> | undefined) => {
-  const body = args as any;
-  return client.hris.benefits.create(body);
+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,25 +1,37 @@
 // 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 type { Metadata } from '../../../';
 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:
-    'Enroll 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.',
+    "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.',
@@ -51,12 +63,31 @@ export const tool: Tool = {
                       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'],
+                      enum: ['fixed', 'percent', 'tiered'],
                     },
                   },
-                  required: [],
                 },
                 effective_date: {
                   type: 'string',
@@ -76,26 +107,40 @@ export const tool: Tool = {
                       enum: ['fixed', 'percent'],
                     },
                   },
-                  required: [],
                 },
               },
-              required: [],
             },
             individual_id: {
               type: 'string',
               description: 'Finch id (uuidv4) for the individual to enroll',
             },
           },
-          required: [],
         },
       },
+      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 = (client: Finch, args: Record<string, unknown> | undefined) => {
-  const { benefit_id, ...body } = args as any;
-  return client.hris.benefits.individuals.enrollMany(benefit_id, body['individuals']);
+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,31 +1,63 @@
 // 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 type { Metadata } from '../../../';
 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: 'Lists individuals currently enrolled in a given deduction.',
+  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 = (client: Finch, args: Record<string, unknown> | undefined) => {
-  const { benefit_id, ...body } = args as any;
-  return client.hris.benefits.individuals.enrolledIds(benefit_id);
+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 };