@tryfinch/finch-api-mcp 6.27.0 → 6.29.0

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

@@ -19,8 +19,7 @@ export const tool: Tool = {
   },
 };
 
-export const handler = (client: Finch, args: any) => {
-  const {} = args;
+export const handler = (client: Finch, args: Record<string, unknown> | undefined) => {
   return client.account.introspect();
 };
 

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

@@ -75,8 +75,8 @@ export const tool: Tool = {
   },
 };
 
-export const handler = (client: Finch, args: any) => {
-  const { ...body } = args;
+export const handler = (client: Finch, args: Record<string, unknown> | undefined) => {
+  const body = args as any;
   return client.connect.sessions.new(body);
 };
 

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

@@ -52,8 +52,8 @@ export const tool: Tool = {
   },
 };
 
-export const handler = (client: Finch, args: any) => {
-  const { ...body } = args;
+export const handler = (client: Finch, args: Record<string, unknown> | undefined) => {
+  const body = args as any;
   return client.connect.sessions.reauthenticate(body);
 };
 

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

@@ -17,6 +17,33 @@ export const tool: Tool = {
   inputSchema: {
     type: 'object',
     properties: {
+      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: [],
+            },
+          },
+          type: {
+            type: 'string',
+            enum: ['match'],
+          },
+        },
+        required: [],
+      },
       description: {
         type: 'string',
         title: 'BenefitDescription',
@@ -24,12 +51,20 @@ export const tool: Tool = {
           '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',
+      },
+    },
+    $defs: {
+      benefit_frequency: {
         type: 'string',
         title: 'BenefitFrequency',
         description: 'The frequency of the benefit deduction/contribution.',
         enum: ['one_time', 'every_paycheck', 'monthly'],
       },
-      type: {
+      benefit_type: {
         type: 'string',
         title: 'BenefitType',
         description: 'Type of benefit.',
@@ -59,8 +94,8 @@ export const tool: Tool = {
   },
 };
 
-export const handler = (client: Finch, args: any) => {
-  const { ...body } = args;
+export const handler = (client: Finch, args: Record<string, unknown> | undefined) => {
+  const body = args as any;
   return client.hris.benefits.create(body);
 };
 

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

@@ -93,8 +93,8 @@ export const tool: Tool = {
   },
 };
 
-export const handler = (client: Finch, args: any) => {
-  const { benefit_id, ...body } = args;
+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']);
 };
 

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

@@ -23,8 +23,8 @@ export const tool: Tool = {
   },
 };
 
-export const handler = (client: Finch, args: any) => {
-  const { benefit_id } = args;
+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);
 };
 

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

@@ -28,8 +28,8 @@ export const tool: Tool = {
   },
 };
 
-export const handler = (client: Finch, args: any) => {
-  const { benefit_id, ...body } = args;
+export const handler = (client: Finch, args: Record<string, unknown> | undefined) => {
+  const { benefit_id, ...body } = args as any;
   return client.hris.benefits.individuals.retrieveManyBenefits(benefit_id, body);
 };
 

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

@@ -30,8 +30,8 @@ export const tool: Tool = {
   },
 };
 
-export const handler = (client: Finch, args: any) => {
-  const { benefit_id, ...body } = args;
+export const handler = (client: Finch, args: Record<string, unknown> | undefined) => {
+  const { benefit_id, ...body } = args as any;
   return client.hris.benefits.individuals.unenrollMany(benefit_id, body);
 };
 

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

@@ -19,8 +19,7 @@ export const tool: Tool = {
   },
 };
 
-export const handler = (client: Finch, args: any) => {
-  const {} = args;
+export const handler = (client: Finch, args: Record<string, unknown> | undefined) => {
   return client.hris.benefits.list();
 };
 

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

@@ -19,8 +19,7 @@ export const tool: Tool = {
   },
 };
 
-export const handler = (client: Finch, args: any) => {
-  const {} = args;
+export const handler = (client: Finch, args: Record<string, unknown> | undefined) => {
   return client.hris.benefits.listSupportedBenefits();
 };
 

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

@@ -23,8 +23,8 @@ export const tool: Tool = {
   },
 };
 
-export const handler = (client: Finch, args: any) => {
-  const { benefit_id } = args;
+export const handler = (client: Finch, args: Record<string, unknown> | undefined) => {
+  const { benefit_id, ...body } = args as any;
   return client.hris.benefits.retrieve(benefit_id);
 };
 

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

@@ -27,8 +27,8 @@ export const tool: Tool = {
   },
 };
 
-export const handler = (client: Finch, args: any) => {
-  const { benefit_id, ...body } = args;
+export const handler = (client: Finch, args: Record<string, unknown> | undefined) => {
+  const { benefit_id, ...body } = args as any;
   return client.hris.benefits.update(benefit_id, body);
 };
 

package/src/tools/hris/company/pay-statement-item/list-company-hris-pay-statement-item.ts

@@ -50,8 +50,8 @@ export const tool: Tool = {
   },
 };
 
-export const handler = (client: Finch, args: any) => {
-  const { ...body } = args;
+export const handler = (client: Finch, args: Record<string, unknown> | undefined) => {
+  const body = args as any;
   return client.hris.company.payStatementItem.list(body);
 };
 

package/src/tools/hris/company/pay-statement-item/rules/create-pay-statement-item-company-hris-rules.ts

@@ -70,8 +70,8 @@ export const tool: Tool = {
   },
 };
 
-export const handler = (client: Finch, args: any) => {
-  const { ...body } = args;
+export const handler = (client: Finch, args: Record<string, unknown> | undefined) => {
+  const body = args as any;
   return client.hris.company.payStatementItem.rules.create(body);
 };
 

package/src/tools/hris/company/pay-statement-item/rules/delete-pay-statement-item-company-hris-rules.ts

@@ -24,8 +24,8 @@ export const tool: Tool = {
   },
 };
 
-export const handler = (client: Finch, args: any) => {
-  const { rule_id } = args;
+export const handler = (client: Finch, args: Record<string, unknown> | undefined) => {
+  const { rule_id, ...body } = args as any;
   return client.hris.company.payStatementItem.rules.delete(rule_id);
 };
 

package/src/tools/hris/company/pay-statement-item/rules/list-pay-statement-item-company-hris-rules.ts

@@ -20,8 +20,7 @@ export const tool: Tool = {
   },
 };
 
-export const handler = (client: Finch, args: any) => {
-  const {} = args;
+export const handler = (client: Finch, args: Record<string, unknown> | undefined) => {
   return client.hris.company.payStatementItem.rules.list();
 };
 

package/src/tools/hris/company/pay-statement-item/rules/update-pay-statement-item-company-hris-rules.ts

@@ -27,8 +27,8 @@ export const tool: Tool = {
   },
 };
 
-export const handler = (client: Finch, args: any) => {
-  const { rule_id, ...body } = args;
+export const handler = (client: Finch, args: Record<string, unknown> | undefined) => {
+  const { rule_id, ...body } = args as any;
   return client.hris.company.payStatementItem.rules.update(rule_id, body);
 };
 

package/src/tools/hris/company/retrieve-hris-company.ts

@@ -19,8 +19,7 @@ export const tool: Tool = {
   },
 };
 
-export const handler = (client: Finch, args: any) => {
-  const {} = args;
+export const handler = (client: Finch, args: Record<string, unknown> | undefined) => {
   return client.hris.company.retrieve();
 };
 

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

@@ -28,8 +28,8 @@ export const tool: Tool = {
   },
 };
 
-export const handler = (client: Finch, args: any) => {
-  const { ...body } = args;
+export const handler = (client: Finch, args: Record<string, unknown> | undefined) => {
+  const body = args as any;
   return client.hris.directory.list(body);
 };
 

package/src/tools/hris/directory/list-individuals-hris-directory.ts

@@ -28,8 +28,8 @@ export const tool: Tool = {
   },
 };
 
-export const handler = (client: Finch, args: any) => {
-  const { ...body } = args;
+export const handler = (client: Finch, args: Record<string, unknown> | undefined) => {
+  const body = args as any;
   return client.hris.directory.listIndividuals(body);
 };
 

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

@@ -45,8 +45,8 @@ export const tool: Tool = {
   },
 };
 
-export const handler = (client: Finch, args: any) => {
-  const { ...body } = args;
+export const handler = (client: Finch, args: Record<string, unknown> | undefined) => {
+  const body = args as any;
   return client.hris.documents.list(body);
 };
 

package/src/tools/hris/documents/retreive-hris-documents.ts

@@ -24,8 +24,8 @@ export const tool: Tool = {
   },
 };
 
-export const handler = (client: Finch, args: any) => {
-  const { document_id } = args;
+export const handler = (client: Finch, args: Record<string, unknown> | undefined) => {
+  const { document_id, ...body } = args as any;
   return client.hris.documents.retreive(document_id);
 };
 

package/src/tools/hris/employments/retrieve-many-hris-employments.ts

@@ -35,8 +35,8 @@ export const tool: Tool = {
   },
 };
 
-export const handler = (client: Finch, args: any) => {
-  const { ...body } = args;
+export const handler = (client: Finch, args: Record<string, unknown> | undefined) => {
+  const body = args as any;
   return client.hris.employments.retrieveMany(body);
 };
 

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

@@ -44,8 +44,8 @@ export const tool: Tool = {
   },
 };
 
-export const handler = (client: Finch, args: any) => {
-  const { ...body } = args;
+export const handler = (client: Finch, args: Record<string, unknown> | undefined) => {
+  const body = args as any;
   return client.hris.individuals.retrieveMany(body);
 };
 

package/src/tools/hris/pay-statements/retrieve-many-hris-pay-statements.ts

@@ -43,8 +43,8 @@ export const tool: Tool = {
   },
 };
 
-export const handler = (client: Finch, args: any) => {
-  const { ...body } = args;
+export const handler = (client: Finch, args: Record<string, unknown> | undefined) => {
+  const body = args as any;
   return client.hris.payStatements.retrieveMany(body);
 };
 

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

@@ -30,8 +30,8 @@ export const tool: Tool = {
   },
 };
 
-export const handler = (client: Finch, args: any) => {
-  const { ...body } = args;
+export const handler = (client: Finch, args: Record<string, unknown> | undefined) => {
+  const body = args as any;
   return client.hris.payments.list(body);
 };
 

package/src/tools/index.ts

@@ -51,7 +51,7 @@ import list_payroll_pay_groups from './payroll/pay-groups/list-payroll-pay-group
 import new_connect_sessions from './connect/sessions/new-connect-sessions';
 import reauthenticate_connect_sessions from './connect/sessions/reauthenticate-connect-sessions';
 
-export type HandlerFunction = (client: Finch, args: any) => Promise<any>;
+export type HandlerFunction = (client: Finch, args: Record<string, unknown> | undefined) => Promise<any>;
 
 export type Metadata = {
   resource: string;
@@ -126,22 +126,32 @@ export type Filter = {
 };
 
 export function query(filters: Filter[], endpoints: Endpoint[]): Endpoint[] {
-  if (filters.length === 0) {
-    return endpoints;
-  }
-  const allExcludes = filters.every((filter) => filter.op === 'exclude');
+  const allExcludes = filters.length > 0 && filters.every((filter) => filter.op === 'exclude');
+  const unmatchedFilters = new Set(filters);
 
-  return endpoints.filter((endpoint: Endpoint) => {
+  const filtered = endpoints.filter((endpoint: Endpoint) => {
     let included = false || allExcludes;
 
     for (const filter of filters) {
       if (match(filter, endpoint)) {
+        unmatchedFilters.delete(filter);
         included = filter.op === 'include';
       }
     }
 
     return included;
   });
+
+  // Check if any filters didn't match
+  if (unmatchedFilters.size > 0) {
+    throw new Error(
+      `The following filters did not match any endpoints: ${[...unmatchedFilters]
+        .map((f) => `${f.type}=${f.value}`)
+        .join(', ')}`,
+    );
+  }
+
+  return filtered;
 }
 
 function match({ type, value }: Filter, endpoint: Endpoint): boolean {

package/src/tools/jobs/automated/create-jobs-automated.ts

@@ -51,8 +51,8 @@ export const tool: Tool = {
   },
 };
 
-export const handler = (client: Finch, args: any) => {
-  const { ...body } = args;
+export const handler = (client: Finch, args: Record<string, unknown> | undefined) => {
+  const body = args as any;
   return client.jobs.automated.create(body);
 };
 

package/src/tools/jobs/automated/list-jobs-automated.ts

@@ -29,8 +29,8 @@ export const tool: Tool = {
   },
 };
 
-export const handler = (client: Finch, args: any) => {
-  const { ...body } = args;
+export const handler = (client: Finch, args: Record<string, unknown> | undefined) => {
+  const body = args as any;
   return client.jobs.automated.list(body);
 };
 

package/src/tools/jobs/automated/retrieve-jobs-automated.ts

@@ -23,8 +23,8 @@ export const tool: Tool = {
   },
 };
 
-export const handler = (client: Finch, args: any) => {
-  const { job_id } = args;
+export const handler = (client: Finch, args: Record<string, unknown> | undefined) => {
+  const { job_id, ...body } = args as any;
   return client.jobs.automated.retrieve(job_id);
 };
 

package/src/tools/jobs/manual/retrieve-jobs-manual.ts

@@ -24,8 +24,8 @@ export const tool: Tool = {
   },
 };
 
-export const handler = (client: Finch, args: any) => {
-  const { job_id } = args;
+export const handler = (client: Finch, args: Record<string, unknown> | undefined) => {
+  const { job_id, ...body } = args as any;
   return client.jobs.manual.retrieve(job_id);
 };
 

package/src/tools/payroll/pay-groups/list-payroll-pay-groups.ts

@@ -29,8 +29,8 @@ export const tool: Tool = {
   },
 };
 
-export const handler = (client: Finch, args: any) => {
-  const { ...body } = args;
+export const handler = (client: Finch, args: Record<string, unknown> | undefined) => {
+  const body = args as any;
   return client.payroll.payGroups.list(body);
 };
 

package/src/tools/payroll/pay-groups/retrieve-payroll-pay-groups.ts

@@ -23,8 +23,8 @@ export const tool: Tool = {
   },
 };
 
-export const handler = (client: Finch, args: any) => {
-  const { pay_group_id } = args;
+export const handler = (client: Finch, args: Record<string, unknown> | undefined) => {
+  const { pay_group_id, ...body } = args as any;
   return client.payroll.payGroups.retrieve(pay_group_id);
 };
 

package/src/tools/providers/list-providers.ts

@@ -19,8 +19,7 @@ export const tool: Tool = {
   },
 };
 
-export const handler = (client: Finch, args: any) => {
-  const {} = args;
+export const handler = (client: Finch, args: Record<string, unknown> | undefined) => {
   return client.providers.list();
 };
 

package/src/tools/request-forwarding/forward-request-forwarding.ts

@@ -46,8 +46,8 @@ export const tool: Tool = {
   },
 };
 
-export const handler = (client: Finch, args: any) => {
-  const { ...body } = args;
+export const handler = (client: Finch, args: Record<string, unknown> | undefined) => {
+  const body = args as any;
   return client.requestForwarding.forward(body);
 };
 

package/src/tools/sandbox/company/update-sandbox-company.ts

@@ -101,41 +101,7 @@ export const tool: Tool = {
       locations: {
         type: 'array',
         items: {
-          type: 'object',
-          title: 'Location',
-          properties: {
-            city: {
-              type: 'string',
-              description: 'City, district, suburb, town, or village.',
-            },
-            country: {
-              type: 'string',
-              description: 'The 2-letter ISO 3166 country code.',
-            },
-            line1: {
-              type: 'string',
-              description: 'Street address or PO box.',
-            },
-            line2: {
-              type: 'string',
-              description: 'Apartment, suite, unit, or building.',
-            },
-            name: {
-              type: 'string',
-            },
-            postal_code: {
-              type: 'string',
-              description: 'The postal code or zip code.',
-            },
-            source_id: {
-              type: 'string',
-            },
-            state: {
-              type: 'string',
-              description: 'The state code.',
-            },
-          },
-          required: [],
+          $ref: '#/$defs/location',
         },
       },
       primary_email: {
@@ -148,11 +114,50 @@ export const tool: Tool = {
           'The phone number of the main administrator on the account. Format: E.164, with extension where applicable, e.g. `+NNNNNNNNNNN xExtension`',
       },
     },
+    $defs: {
+      location: {
+        type: 'object',
+        title: 'Location',
+        properties: {
+          city: {
+            type: 'string',
+            description: 'City, district, suburb, town, or village.',
+          },
+          country: {
+            type: 'string',
+            description: 'The 2-letter ISO 3166 country code.',
+          },
+          line1: {
+            type: 'string',
+            description: 'Street address or PO box.',
+          },
+          line2: {
+            type: 'string',
+            description: 'Apartment, suite, unit, or building.',
+          },
+          postal_code: {
+            type: 'string',
+            description: 'The postal code or zip code.',
+          },
+          state: {
+            type: 'string',
+            description: 'The state code.',
+          },
+          name: {
+            type: 'string',
+          },
+          source_id: {
+            type: 'string',
+          },
+        },
+        required: ['city', 'country', 'line1', 'line2', 'postal_code', 'state'],
+      },
+    },
   },
 };
 
-export const handler = (client: Finch, args: any) => {
-  const { ...body } = args;
+export const handler = (client: Finch, args: Record<string, unknown> | undefined) => {
+  const body = args as any;
   return client.sandbox.company.update(body);
 };
 

package/src/tools/sandbox/connections/accounts/create-connections-sandbox-accounts.ts

@@ -40,8 +40,8 @@ export const tool: Tool = {
   },
 };
 
-export const handler = (client: Finch, args: any) => {
-  const { ...body } = args;
+export const handler = (client: Finch, args: Record<string, unknown> | undefined) => {
+  const body = args as any;
   return client.sandbox.connections.accounts.create(body);
 };
 

package/src/tools/sandbox/connections/accounts/update-connections-sandbox-accounts.ts

@@ -18,6 +18,11 @@ export const tool: Tool = {
     type: 'object',
     properties: {
       connection_status: {
+        $ref: '#/$defs/connection_status_type',
+      },
+    },
+    $defs: {
+      connection_status_type: {
         type: 'string',
         title: 'ConnectionStatus',
         enum: ['pending', 'processing', 'connected', 'error_no_account_setup', 'error_permissions', 'reauth'],
@@ -26,8 +31,8 @@ export const tool: Tool = {
   },
 };
 
-export const handler = (client: Finch, args: any) => {
-  const { ...body } = args;
+export const handler = (client: Finch, args: Record<string, unknown> | undefined) => {
+  const body = args as any;
   return client.sandbox.connections.accounts.update(body);
 };
 

package/src/tools/sandbox/connections/create-sandbox-connections.ts

@@ -40,8 +40,8 @@ export const tool: Tool = {
   },
 };
 
-export const handler = (client: Finch, args: any) => {
-  const { ...body } = args;
+export const handler = (client: Finch, args: Record<string, unknown> | undefined) => {
+  const body = args as any;
   return client.sandbox.connections.create(body);
 };