@tryfinch/finch-api-mcp 6.31.0 → 8.0.0

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

@@ -1,83 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-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: [],
-};
-
-export const tool: Tool = {
-  name: 'new_connect_sessions',
-  description: 'Create a new connect session for an employer',
-  inputSchema: {
-    type: 'object',
-    properties: {
-      customer_id: {
-        type: 'string',
-      },
-      customer_name: {
-        type: 'string',
-      },
-      products: {
-        type: 'array',
-        items: {
-          type: 'string',
-          description: 'The Finch products that can be requested during the Connect flow.',
-          enum: [
-            'company',
-            'directory',
-            'individual',
-            'employment',
-            'payment',
-            'pay_statement',
-            'benefits',
-            'ssn',
-            'deduction',
-            'documents',
-          ],
-        },
-      },
-      customer_email: {
-        type: 'string',
-      },
-      integration: {
-        type: 'object',
-        properties: {
-          auth_method: {
-            type: 'string',
-            enum: ['assisted', 'credential', 'oauth', 'api_token'],
-          },
-          provider: {
-            type: 'string',
-          },
-        },
-        required: [],
-      },
-      manual: {
-        type: 'boolean',
-      },
-      minutes_to_expire: {
-        type: 'number',
-        description: 'The number of minutes until the session expires (defaults to 43,200, which is 30 days)',
-      },
-      redirect_uri: {
-        type: 'string',
-      },
-      sandbox: {
-        type: 'string',
-        enum: ['finch', 'provider'],
-      },
-    },
-  },
-};
-
-export const handler = (client: Finch, args: Record<string, unknown> | undefined) => {
-  const body = args as any;
-  return client.connect.sessions.new(body);
-};
-
-export default { metadata, tool, handler };

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

@@ -1,60 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-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: [],
-};
-
-export const tool: Tool = {
-  name: 'reauthenticate_connect_sessions',
-  description: 'Create a new Connect session for reauthenticating an existing connection',
-  inputSchema: {
-    type: 'object',
-    properties: {
-      connection_id: {
-        type: 'string',
-        description: 'The ID of the existing connection to reauthenticate',
-      },
-      minutes_to_expire: {
-        type: 'integer',
-        description: 'The number of minutes until the session expires (defaults to 43,200, which is 30 days)',
-      },
-      products: {
-        type: 'array',
-        description: 'The products to request access to (optional for reauthentication)',
-        items: {
-          type: 'string',
-          description: 'The Finch products that can be requested during the Connect flow.',
-          enum: [
-            'company',
-            'directory',
-            'individual',
-            'employment',
-            'payment',
-            'pay_statement',
-            'benefits',
-            'ssn',
-            'deduction',
-            'documents',
-          ],
-        },
-      },
-      redirect_uri: {
-        type: 'string',
-        description: 'The URI to redirect to after the Connect flow is completed',
-      },
-    },
-  },
-};
-
-export const handler = (client: Finch, args: Record<string, unknown> | undefined) => {
-  const body = args as any;
-  return client.connect.sessions.reauthenticate(body);
-};
-
-export default { metadata, tool, handler };

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

@@ -1,102 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-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: [],
-};
-
-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.',
-  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',
-        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',
-      },
-    },
-    $defs: {
-      benefit_frequency: {
-        type: 'string',
-        title: 'BenefitFrequency',
-        description: 'The frequency of the benefit deduction/contribution.',
-        enum: ['one_time', 'every_paycheck', 'monthly'],
-      },
-      benefit_type: {
-        type: 'string',
-        title: 'BenefitType',
-        description: 'Type of benefit.',
-        enum: [
-          '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',
-        ],
-      },
-    },
-  },
-};
-
-export const handler = (client: Finch, args: Record<string, unknown> | undefined) => {
-  const body = args as any;
-  return client.hris.benefits.create(body);
-};
-
-export default { metadata, tool, handler };

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

@@ -1,101 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-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: [],
-};
-
-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.',
-  inputSchema: {
-    type: 'object',
-    properties: {
-      benefit_id: {
-        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',
-                    },
-                    type: {
-                      type: 'string',
-                      enum: ['fixed', 'percent'],
-                    },
-                  },
-                  required: [],
-                },
-                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'],
-                    },
-                  },
-                  required: [],
-                },
-              },
-              required: [],
-            },
-            individual_id: {
-              type: 'string',
-              description: 'Finch id (uuidv4) for the individual to enroll',
-            },
-          },
-          required: [],
-        },
-      },
-    },
-  },
-};
-
-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 default { metadata, tool, handler };

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

@@ -1,31 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-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: [],
-};
-
-export const tool: Tool = {
-  name: 'enrolled_ids_benefits_hris_individuals',
-  description: 'Lists individuals currently enrolled in a given deduction.',
-  inputSchema: {
-    type: 'object',
-    properties: {
-      benefit_id: {
-        type: 'string',
-      },
-    },
-  },
-};
-
-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 default { metadata, tool, handler };

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

@@ -1,36 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-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: [],
-};
-
-export const tool: Tool = {
-  name: 'retrieve_many_benefits_benefits_hris_individuals',
-  description: 'Get enrollment information for the given individuals.',
-  inputSchema: {
-    type: 'object',
-    properties: {
-      benefit_id: {
-        type: 'string',
-      },
-      individual_ids: {
-        type: 'string',
-        description:
-          'comma-delimited list of stable Finch uuids for each individual. If empty, defaults to all individuals',
-      },
-    },
-  },
-};
-
-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);
-};
-
-export default { metadata, tool, handler };

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

@@ -1,38 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-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: [],
-};
-
-export const tool: Tool = {
-  name: 'unenroll_many_benefits_hris_individuals',
-  description: 'Unenroll individuals from a deduction or contribution',
-  inputSchema: {
-    type: 'object',
-    properties: {
-      benefit_id: {
-        type: 'string',
-      },
-      individual_ids: {
-        type: 'array',
-        description: 'Array of individual_ids to unenroll.',
-        items: {
-          type: 'string',
-        },
-      },
-    },
-  },
-};
-
-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);
-};
-
-export default { metadata, tool, handler };

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

@@ -1,26 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-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: 'read',
-  tags: [],
-};
-
-export const tool: Tool = {
-  name: 'list_hris_benefits',
-  description: 'List all company-wide deductions and contributions.',
-  inputSchema: {
-    type: 'object',
-    properties: {},
-  },
-};
-
-export const handler = (client: Finch, args: Record<string, unknown> | undefined) => {
-  return client.hris.benefits.list();
-};
-
-export default { metadata, tool, handler };

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

@@ -1,26 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-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: 'read',
-  tags: [],
-};
-
-export const tool: Tool = {
-  name: 'list_supported_benefits_hris_benefits',
-  description: 'Get deductions metadata',
-  inputSchema: {
-    type: 'object',
-    properties: {},
-  },
-};
-
-export const handler = (client: Finch, args: Record<string, unknown> | undefined) => {
-  return client.hris.benefits.listSupportedBenefits();
-};
-
-export default { metadata, tool, handler };

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

@@ -1,31 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-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: 'read',
-  tags: [],
-};
-
-export const tool: Tool = {
-  name: 'retrieve_hris_benefits',
-  description: 'Lists deductions and contributions information for a given item',
-  inputSchema: {
-    type: 'object',
-    properties: {
-      benefit_id: {
-        type: 'string',
-      },
-    },
-  },
-};
-
-export const handler = (client: Finch, args: Record<string, unknown> | undefined) => {
-  const { benefit_id, ...body } = args as any;
-  return client.hris.benefits.retrieve(benefit_id);
-};
-
-export default { metadata, tool, handler };

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

@@ -1,35 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-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: [],
-};
-
-export const tool: Tool = {
-  name: 'update_hris_benefits',
-  description: 'Updates an existing company-wide deduction or contribution',
-  inputSchema: {
-    type: 'object',
-    properties: {
-      benefit_id: {
-        type: 'string',
-      },
-      description: {
-        type: 'string',
-        description: 'Updated name or description.',
-      },
-    },
-  },
-};
-
-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);
-};
-
-export default { metadata, tool, handler };

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

@@ -1,58 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import type { Metadata } from '../../../';
-import Finch from '@tryfinch/finch-api';
-
-export const metadata: Metadata = {
-  resource: 'hris.company.pay_statement_item',
-  operation: 'read',
-  tags: [],
-};
-
-export const tool: Tool = {
-  name: 'list_company_hris_pay_statement_item',
-  description:
-    "**Beta:** this endpoint currently serves employers onboarded after March 4th and historical support will be added soon\n Retrieve a list of detailed pay statement items for the access token's connection account.\n",
-  inputSchema: {
-    type: 'object',
-    properties: {
-      categories: {
-        type: 'array',
-        description:
-          'Comma-delimited list of pay statement item categories to filter on. If empty, defaults to all categories.',
-        items: {
-          type: 'string',
-          enum: ['earnings', 'taxes', 'employee_deductions', 'employer_contributions'],
-        },
-      },
-      end_date: {
-        type: 'string',
-        description:
-          'The end date to retrieve pay statement items by via their last seen pay date in `YYYY-MM-DD` format.',
-        format: 'date',
-      },
-      name: {
-        type: 'string',
-        description: 'Case-insensitive partial match search by pay statement item name.',
-      },
-      start_date: {
-        type: 'string',
-        description:
-          'The start date to retrieve pay statement items by via their last seen pay date (inclusive) in `YYYY-MM-DD` format.',
-        format: 'date',
-      },
-      type: {
-        type: 'string',
-        description: 'String search by pay statement item type.',
-      },
-    },
-  },
-};
-
-export const handler = (client: Finch, args: Record<string, unknown> | undefined) => {
-  const body = args as any;
-  return client.hris.company.payStatementItem.list(body);
-};
-
-export default { metadata, tool, handler };