@tryfinch/finch-api-mcp 7.0.0 → 8.0.0

package/src/tools/index.ts

@@ -1,161 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-import { Metadata, Endpoint, HandlerFunction } from './types';
-
-export { Metadata, Endpoint, HandlerFunction };
-
-import create_access_tokens from './access-tokens/create-access-tokens';
-import retrieve_hris_company from './hris/company/retrieve-hris-company';
-import list_company_hris_pay_statement_item from './hris/company/pay-statement-item/list-company-hris-pay-statement-item';
-import create_pay_statement_item_company_hris_rules from './hris/company/pay-statement-item/rules/create-pay-statement-item-company-hris-rules';
-import update_pay_statement_item_company_hris_rules from './hris/company/pay-statement-item/rules/update-pay-statement-item-company-hris-rules';
-import list_pay_statement_item_company_hris_rules from './hris/company/pay-statement-item/rules/list-pay-statement-item-company-hris-rules';
-import delete_pay_statement_item_company_hris_rules from './hris/company/pay-statement-item/rules/delete-pay-statement-item-company-hris-rules';
-import list_hris_directory from './hris/directory/list-hris-directory';
-import retrieve_many_hris_individuals from './hris/individuals/retrieve-many-hris-individuals';
-import retrieve_many_hris_employments from './hris/employments/retrieve-many-hris-employments';
-import list_hris_payments from './hris/payments/list-hris-payments';
-import retrieve_many_hris_pay_statements from './hris/pay-statements/retrieve-many-hris-pay-statements';
-import list_hris_documents from './hris/documents/list-hris-documents';
-import retreive_hris_documents from './hris/documents/retreive-hris-documents';
-import create_hris_benefits from './hris/benefits/create-hris-benefits';
-import retrieve_hris_benefits from './hris/benefits/retrieve-hris-benefits';
-import update_hris_benefits from './hris/benefits/update-hris-benefits';
-import list_hris_benefits from './hris/benefits/list-hris-benefits';
-import list_supported_benefits_hris_benefits from './hris/benefits/list-supported-benefits-hris-benefits';
-import enroll_many_benefits_hris_individuals from './hris/benefits/individuals/enroll-many-benefits-hris-individuals';
-import enrolled_ids_benefits_hris_individuals from './hris/benefits/individuals/enrolled-ids-benefits-hris-individuals';
-import retrieve_many_benefits_benefits_hris_individuals from './hris/benefits/individuals/retrieve-many-benefits-benefits-hris-individuals';
-import unenroll_many_benefits_hris_individuals from './hris/benefits/individuals/unenroll-many-benefits-hris-individuals';
-import list_providers from './providers/list-providers';
-import disconnect_account from './account/disconnect-account';
-import introspect_account from './account/introspect-account';
-import forward_request_forwarding from './request-forwarding/forward-request-forwarding';
-import create_jobs_automated from './jobs/automated/create-jobs-automated';
-import retrieve_jobs_automated from './jobs/automated/retrieve-jobs-automated';
-import list_jobs_automated from './jobs/automated/list-jobs-automated';
-import retrieve_jobs_manual from './jobs/manual/retrieve-jobs-manual';
-import create_sandbox_connections from './sandbox/connections/create-sandbox-connections';
-import create_connections_sandbox_accounts from './sandbox/connections/accounts/create-connections-sandbox-accounts';
-import update_connections_sandbox_accounts from './sandbox/connections/accounts/update-connections-sandbox-accounts';
-import update_sandbox_company from './sandbox/company/update-sandbox-company';
-import create_sandbox_directory from './sandbox/directory/create-sandbox-directory';
-import update_sandbox_individual from './sandbox/individual/update-sandbox-individual';
-import update_sandbox_employment from './sandbox/employment/update-sandbox-employment';
-import create_sandbox_payment from './sandbox/payment/create-sandbox-payment';
-import create_sandbox_jobs from './sandbox/jobs/create-sandbox-jobs';
-import retrieve_jobs_sandbox_configuration from './sandbox/jobs/configuration/retrieve-jobs-sandbox-configuration';
-import update_jobs_sandbox_configuration from './sandbox/jobs/configuration/update-jobs-sandbox-configuration';
-import retrieve_payroll_pay_groups from './payroll/pay-groups/retrieve-payroll-pay-groups';
-import list_payroll_pay_groups from './payroll/pay-groups/list-payroll-pay-groups';
-import new_connect_sessions from './connect/sessions/new-connect-sessions';
-import reauthenticate_connect_sessions from './connect/sessions/reauthenticate-connect-sessions';
-
-export const endpoints: Endpoint[] = [];
-
-function addEndpoint(endpoint: Endpoint) {
-  endpoints.push(endpoint);
-}
-
-addEndpoint(create_access_tokens);
-addEndpoint(retrieve_hris_company);
-addEndpoint(list_company_hris_pay_statement_item);
-addEndpoint(create_pay_statement_item_company_hris_rules);
-addEndpoint(update_pay_statement_item_company_hris_rules);
-addEndpoint(list_pay_statement_item_company_hris_rules);
-addEndpoint(delete_pay_statement_item_company_hris_rules);
-addEndpoint(list_hris_directory);
-addEndpoint(retrieve_many_hris_individuals);
-addEndpoint(retrieve_many_hris_employments);
-addEndpoint(list_hris_payments);
-addEndpoint(retrieve_many_hris_pay_statements);
-addEndpoint(list_hris_documents);
-addEndpoint(retreive_hris_documents);
-addEndpoint(create_hris_benefits);
-addEndpoint(retrieve_hris_benefits);
-addEndpoint(update_hris_benefits);
-addEndpoint(list_hris_benefits);
-addEndpoint(list_supported_benefits_hris_benefits);
-addEndpoint(enroll_many_benefits_hris_individuals);
-addEndpoint(enrolled_ids_benefits_hris_individuals);
-addEndpoint(retrieve_many_benefits_benefits_hris_individuals);
-addEndpoint(unenroll_many_benefits_hris_individuals);
-addEndpoint(list_providers);
-addEndpoint(disconnect_account);
-addEndpoint(introspect_account);
-addEndpoint(forward_request_forwarding);
-addEndpoint(create_jobs_automated);
-addEndpoint(retrieve_jobs_automated);
-addEndpoint(list_jobs_automated);
-addEndpoint(retrieve_jobs_manual);
-addEndpoint(create_sandbox_connections);
-addEndpoint(create_connections_sandbox_accounts);
-addEndpoint(update_connections_sandbox_accounts);
-addEndpoint(update_sandbox_company);
-addEndpoint(create_sandbox_directory);
-addEndpoint(update_sandbox_individual);
-addEndpoint(update_sandbox_employment);
-addEndpoint(create_sandbox_payment);
-addEndpoint(create_sandbox_jobs);
-addEndpoint(retrieve_jobs_sandbox_configuration);
-addEndpoint(update_jobs_sandbox_configuration);
-addEndpoint(retrieve_payroll_pay_groups);
-addEndpoint(list_payroll_pay_groups);
-addEndpoint(new_connect_sessions);
-addEndpoint(reauthenticate_connect_sessions);
-
-export type Filter = {
-  type: 'resource' | 'operation' | 'tag' | 'tool';
-  op: 'include' | 'exclude';
-  value: string;
-};
-
-export function query(filters: Filter[], endpoints: Endpoint[]): Endpoint[] {
-  const allExcludes = filters.length > 0 && filters.every((filter) => filter.op === 'exclude');
-  const unmatchedFilters = new Set(filters);
-
-  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
-  const unmatched = Array.from(unmatchedFilters).filter((f) => f.type === 'tool' || f.type === 'resource');
-  if (unmatched.length > 0) {
-    throw new Error(
-      `The following filters did not match any endpoints: ${unmatched
-        .map((f) => `${f.type}=${f.value}`)
-        .join(', ')}`,
-    );
-  }
-
-  return filtered;
-}
-
-function match({ type, value }: Filter, endpoint: Endpoint): boolean {
-  switch (type) {
-    case 'resource': {
-      const regexStr = '^' + normalizeResource(value).replace(/\*/g, '.*') + '$';
-      const regex = new RegExp(regexStr);
-      return regex.test(normalizeResource(endpoint.metadata.resource));
-    }
-    case 'operation':
-      return endpoint.metadata.operation === value;
-    case 'tag':
-      return endpoint.metadata.tags.includes(value);
-    case 'tool':
-      return endpoint.tool.name === value;
-  }
-}
-
-function normalizeResource(resource: string): string {
-  return resource.toLowerCase().replace(/[^a-z.*\-_]*/g, '');
-}

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

@@ -1,82 +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: 'jobs.automated',
-  operation: 'write',
-  tags: [],
-  httpMethod: 'post',
-  httpPath: '/jobs/automated',
-  operationId: 'post-jobs-automated',
-};
-
-export const tool: Tool = {
-  name: 'create_jobs_automated',
-  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\nEnqueue an automated job.\n\n`data_sync_all`: Enqueue a job to re-sync all data for a connection. `data_sync_all` has a concurrency limit of 1 job at a time per connection. This means that if this endpoint is called while a job is already in progress for this connection, Finch will return the `job_id` of the job that is currently in progress. Finch allows a fixed window rate limit of 1 forced refresh per hour per connection.\n\n`w4_form_employee_sync`: Enqueues a job for sync W-4 data for a particular individual, identified by `individual_id`. This feature is currently in beta.\n\nThis endpoint is available for *Scale* tier customers as an add-on. To request access to this endpoint, please contact your Finch account manager.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/automated_create_response',\n  $defs: {\n    automated_create_response: {\n      type: 'object',\n      properties: {\n        allowed_refreshes: {\n          type: 'integer',\n          description: 'The number of allowed refreshes per hour (per hour, fixed window)'\n        },\n        remaining_refreshes: {\n          type: 'integer',\n          description: 'The number of remaining refreshes available (per hour, fixed window)'\n        },\n        job_id: {\n          type: 'string',\n          description: 'The id of the job that has been created.'\n        },\n        job_url: {\n          type: 'string',\n          description: 'The url that can be used to retrieve the job status'\n        },\n        retry_at: {\n          type: 'string',\n          description: 'ISO 8601 timestamp indicating when to retry the request'\n        }\n      },\n      required: [        'allowed_refreshes',\n        'remaining_refreshes'\n      ]\n    }\n  }\n}\n```",
-  inputSchema: {
-    type: 'object',
-    anyOf: [
-      {
-        type: 'object',
-        properties: {
-          type: {
-            type: 'string',
-            description: 'The type of job to start.',
-            enum: ['data_sync_all'],
-          },
-        },
-        required: ['type'],
-      },
-      {
-        type: 'object',
-        properties: {
-          params: {
-            type: 'object',
-            properties: {
-              individual_id: {
-                type: 'string',
-                description: 'The unique ID of the individual for W-4 data sync.',
-              },
-            },
-            required: ['individual_id'],
-          },
-          type: {
-            type: 'string',
-            description: 'The type of job to start.',
-            enum: ['w4_form_employee_sync'],
-          },
-        },
-        required: ['params', 'type'],
-      },
-    ],
-    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/).',
-      },
-    },
-  },
-  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.jobs.automated.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/jobs/automated/list-jobs-automated.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: 'jobs.automated',
-  operation: 'read',
-  tags: [],
-  httpMethod: 'get',
-  httpPath: '/jobs/automated',
-  operationId: 'get-jobs-automated',
-};
-
-export const tool: Tool = {
-  name: 'list_jobs_automated',
-  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 all automated jobs. Automated jobs are completed by a machine. By default, jobs are sorted in descending order by submission time. For scheduled jobs such as data syncs, only the next scheduled job is shown.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/automated_list_response',\n  $defs: {\n    automated_list_response: {\n      type: 'object',\n      properties: {\n        data: {\n          type: 'array',\n          items: {\n            $ref: '#/$defs/automated_async_job'\n          }\n        },\n        meta: {\n          type: 'object',\n          properties: {\n            quotas: {\n              type: 'object',\n              description: 'Information about remaining quotas for this connection. Only applicable for customers opted in to use Finch\\'s Data Sync Refresh endpoint (`POST /jobs/automated`). Please contact a Finch representative for more details.',\n              properties: {\n                data_sync_all: {\n                  type: 'object',\n                  properties: {\n                    allowed_refreshes: {\n                      type: 'integer'\n                    },\n                    remaining_refreshes: {\n                      type: 'integer'\n                    }\n                  }\n                }\n              }\n            }\n          }\n        }\n      },\n      required: [        'data',\n        'meta'\n      ]\n    },\n    automated_async_job: {\n      type: 'object',\n      title: 'AutomatedAsyncJob',\n      properties: {\n        completed_at: {\n          type: 'string',\n          description: 'The datetime the job completed.',\n          format: 'date-time'\n        },\n        created_at: {\n          type: 'string',\n          description: 'The datetime when the job was created. for scheduled jobs, this will be the initial connection time. For ad-hoc jobs, this will be the time the creation request was received.',\n          format: 'date-time'\n        },\n        job_id: {\n          type: 'string',\n          description: 'The id of the job that has been created.'\n        },\n        job_url: {\n          type: 'string',\n          description: 'The url that can be used to retrieve the job status'\n        },\n        params: {\n          type: 'object',\n          description: 'The input parameters for the job.',\n          properties: {\n            individual_id: {\n              type: 'string',\n              description: 'The ID of the individual that the job was completed for.'\n            }\n          }\n        },\n        scheduled_at: {\n          type: 'string',\n          description: 'The datetime a job is scheduled to be run. For scheduled jobs, this datetime can be in the future if the job has not yet been enqueued. For ad-hoc jobs, this field will be null.',\n          format: 'date-time'\n        },\n        started_at: {\n          type: 'string',\n          description: 'The datetime a job entered into the job queue.',\n          format: 'date-time'\n        },\n        status: {\n          type: 'string',\n          enum: [            'pending',\n            'in_progress',\n            'complete',\n            'error',\n            'reauth_error',\n            'permissions_error'\n          ]\n        },\n        type: {\n          type: 'string',\n          description: 'The type of automated job',\n          enum: [            'data_sync_all',\n            'w4_form_employee_sync'\n          ]\n        }\n      },\n      required: [        'completed_at',\n        'created_at',\n        'job_id',\n        'job_url',\n        'params',\n        'scheduled_at',\n        'started_at',\n        'status',\n        'type'\n      ]\n    }\n  }\n}\n```",
-  inputSchema: {
-    type: 'object',
-    properties: {
-      limit: {
-        type: 'integer',
-        description: 'Number of items to return',
-      },
-      offset: {
-        type: 'integer',
-        description: 'Index to start from (defaults to 0)',
-      },
-      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;
-  try {
-    return asTextContentResult(await maybeFilter(jq_filter, await client.jobs.automated.list(body)));
-  } catch (error) {
-    if (error instanceof Finch.APIError || isJqError(error)) {
-      return asErrorResult(error.message);
-    }
-    throw error;
-  }
-};
-
-export default { metadata, tool, handler };

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

@@ -1,54 +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: 'jobs.automated',
-  operation: 'read',
-  tags: [],
-  httpMethod: 'get',
-  httpPath: '/jobs/automated/{job_id}',
-  operationId: 'get-jobs-job_id',
-};
-
-export const tool: Tool = {
-  name: 'retrieve_jobs_automated',
-  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 an automated job by `job_id`.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/automated_async_job',\n  $defs: {\n    automated_async_job: {\n      type: 'object',\n      title: 'AutomatedAsyncJob',\n      properties: {\n        completed_at: {\n          type: 'string',\n          description: 'The datetime the job completed.',\n          format: 'date-time'\n        },\n        created_at: {\n          type: 'string',\n          description: 'The datetime when the job was created. for scheduled jobs, this will be the initial connection time. For ad-hoc jobs, this will be the time the creation request was received.',\n          format: 'date-time'\n        },\n        job_id: {\n          type: 'string',\n          description: 'The id of the job that has been created.'\n        },\n        job_url: {\n          type: 'string',\n          description: 'The url that can be used to retrieve the job status'\n        },\n        params: {\n          type: 'object',\n          description: 'The input parameters for the job.',\n          properties: {\n            individual_id: {\n              type: 'string',\n              description: 'The ID of the individual that the job was completed for.'\n            }\n          }\n        },\n        scheduled_at: {\n          type: 'string',\n          description: 'The datetime a job is scheduled to be run. For scheduled jobs, this datetime can be in the future if the job has not yet been enqueued. For ad-hoc jobs, this field will be null.',\n          format: 'date-time'\n        },\n        started_at: {\n          type: 'string',\n          description: 'The datetime a job entered into the job queue.',\n          format: 'date-time'\n        },\n        status: {\n          type: 'string',\n          enum: [            'pending',\n            'in_progress',\n            'complete',\n            'error',\n            'reauth_error',\n            'permissions_error'\n          ]\n        },\n        type: {\n          type: 'string',\n          description: 'The type of automated job',\n          enum: [            'data_sync_all',\n            'w4_form_employee_sync'\n          ]\n        }\n      },\n      required: [        'completed_at',\n        'created_at',\n        'job_id',\n        'job_url',\n        'params',\n        'scheduled_at',\n        'started_at',\n        'status',\n        'type'\n      ]\n    }\n  }\n}\n```",
-  inputSchema: {
-    type: 'object',
-    properties: {
-      job_id: {
-        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: ['job_id'],
-  },
-  annotations: {
-    readOnlyHint: true,
-  },
-};
-
-export const handler = async (client: Finch, args: Record<string, unknown> | undefined) => {
-  const { job_id, jq_filter, ...body } = args as any;
-  try {
-    return asTextContentResult(await maybeFilter(jq_filter, await client.jobs.automated.retrieve(job_id)));
-  } catch (error) {
-    if (error instanceof Finch.APIError || isJqError(error)) {
-      return asErrorResult(error.message);
-    }
-    throw error;
-  }
-};
-
-export default { metadata, tool, handler };

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

@@ -1,54 +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: 'jobs.manual',
-  operation: 'read',
-  tags: [],
-  httpMethod: 'get',
-  httpPath: '/jobs/manual/{job_id}',
-  operationId: 'get-jobs-manual-job_id',
-};
-
-export const tool: Tool = {
-  name: 'retrieve_jobs_manual',
-  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 a manual job by `job_id`. Manual jobs are completed by a human and include Assisted Benefits jobs.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/manual_async_job',\n  $defs: {\n    manual_async_job: {\n      type: 'object',\n      title: 'ManualAsyncJob',\n      properties: {\n        body: {\n          type: 'array',\n          description: 'Specific information about the job, such as individual statuses for batch jobs.',\n          items: {\n            type: 'object',\n            additionalProperties: true\n          }\n        },\n        job_id: {\n          type: 'string'\n        },\n        status: {\n          type: 'string',\n          enum: [            'pending',\n            'in_progress',\n            'error',\n            'complete'\n          ]\n        }\n      },\n      required: [        'body',\n        'job_id',\n        'status'\n      ]\n    }\n  }\n}\n```",
-  inputSchema: {
-    type: 'object',
-    properties: {
-      job_id: {
-        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: ['job_id'],
-  },
-  annotations: {
-    readOnlyHint: true,
-  },
-};
-
-export const handler = async (client: Finch, args: Record<string, unknown> | undefined) => {
-  const { job_id, jq_filter, ...body } = args as any;
-  try {
-    return asTextContentResult(await maybeFilter(jq_filter, await client.jobs.manual.retrieve(job_id)));
-  } catch (error) {
-    if (error instanceof Finch.APIError || isJqError(error)) {
-      return asErrorResult(error.message);
-    }
-    throw error;
-  }
-};
-
-export default { metadata, tool, handler };

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

@@ -1,68 +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: 'payroll.pay_groups',
-  operation: 'read',
-  tags: [],
-  httpMethod: 'get',
-  httpPath: '/employer/pay-groups',
-  operationId: 'get-all-pay-groups',
-};
-
-export const tool: Tool = {
-  name: 'list_payroll_pay_groups',
-  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 company pay groups and frequencies\n\n# Response Schema\n```json\n{\n  type: 'array',\n  items: {\n    $ref: '#/$defs/pay_group_list_response'\n  },\n  $defs: {\n    pay_group_list_response: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'Finch id (uuidv4) for the pay group'\n        },\n        name: {\n          type: 'string',\n          description: 'Name of the pay group'\n        },\n        pay_frequencies: {\n          type: 'array',\n          description: 'List of pay frequencies associated with this pay group',\n          items: {\n            type: 'string',\n            enum: [              'annually',\n              'bi_weekly',\n              'daily',\n              'monthly',\n              'other',\n              'quarterly',\n              'semi_annually',\n              'semi_monthly',\n              'weekly'\n            ]\n          }\n        }\n      },\n      required: [        'id',\n        'name',\n        'pay_frequencies'\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',
-        },
-      },
-      individual_id: {
-        type: 'string',
-      },
-      pay_frequencies: {
-        type: 'array',
-        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.payroll.payGroups.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/payroll/pay-groups/retrieve-payroll-pay-groups.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: 'payroll.pay_groups',
-  operation: 'read',
-  tags: [],
-  httpMethod: 'get',
-  httpPath: '/employer/pay-groups/{pay_group_id}',
-  operationId: 'get-pay-group',
-};
-
-export const tool: Tool = {
-  name: 'retrieve_payroll_pay_groups',
-  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 information from a single pay group\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/pay_group_retrieve_response',\n  $defs: {\n    pay_group_retrieve_response: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'Finch id (uuidv4) for the pay group'\n        },\n        individual_ids: {\n          type: 'array',\n          items: {\n            type: 'string',\n            description: 'Finch id (uuidv4) for an individual assigned to this pay group'\n          }\n        },\n        name: {\n          type: 'string',\n          description: 'Name of the pay group'\n        },\n        pay_frequencies: {\n          type: 'array',\n          description: 'List of pay frequencies associated with this pay group',\n          items: {\n            type: 'string',\n            enum: [              'annually',\n              'bi_weekly',\n              'daily',\n              'monthly',\n              'other',\n              'quarterly',\n              'semi_annually',\n              'semi_monthly',\n              'weekly'\n            ]\n          }\n        }\n      },\n      required: [        'id',\n        'individual_ids',\n        'name',\n        'pay_frequencies'\n      ]\n    }\n  }\n}\n```",
-  inputSchema: {
-    type: 'object',
-    properties: {
-      pay_group_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: ['pay_group_id'],
-  },
-  annotations: {
-    readOnlyHint: true,
-  },
-};
-
-export const handler = async (client: Finch, args: Record<string, unknown> | undefined) => {
-  const { pay_group_id, jq_filter, ...body } = args as any;
-  try {
-    return asTextContentResult(
-      await maybeFilter(jq_filter, await client.payroll.payGroups.retrieve(pay_group_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/providers/list-providers.ts

@@ -1,52 +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: 'providers',
-  operation: 'read',
-  tags: [],
-  httpMethod: 'get',
-  httpPath: '/providers',
-  operationId: 'get-providers',
-};
-
-export const tool: Tool = {
-  name: 'list_providers',
-  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\nReturn details on all available payroll and HR systems.\n\n# Response Schema\n```json\n{\n  type: 'array',\n  items: {\n    $ref: '#/$defs/provider_list_response'\n  },\n  $defs: {\n    provider_list_response: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The id of the payroll provider used in Connect.'\n        },\n        display_name: {\n          type: 'string',\n          description: 'The display name of the payroll provider.'\n        },\n        products: {\n          type: 'array',\n          description: 'The list of Finch products supported on this payroll provider.',\n          items: {\n            type: 'string'\n          }\n        },\n        authentication_methods: {\n          type: 'array',\n          description: 'The authentication methods supported by the provider.',\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                  'api'\n                ]\n              },\n              benefits_support: {\n                type: 'object',\n                description: 'The supported benefit types and their configurations',\n                additionalProperties: true\n              },\n              supported_fields: {\n                type: 'object',\n                description: 'The supported fields for each Finch product',\n                additionalProperties: true\n              }\n            },\n            required: [              'type'\n            ]\n          }\n        },\n        beta: {\n          type: 'boolean',\n          description: '`true` if the integration is in a beta state, `false` otherwise'\n        },\n        icon: {\n          type: 'string',\n          description: 'The url to the official icon of the payroll provider.'\n        },\n        logo: {\n          type: 'string',\n          description: 'The url to the official logo of the payroll provider.'\n        },\n        manual: {\n          type: 'boolean',\n          description: '[DEPRECATED] Whether the Finch integration with this provider uses the Assisted Connect Flow by default. This field is now deprecated. Please check for a `type` of `assisted` in the `authentication_methods` field instead.'\n        },\n        mfa_required: {\n          type: 'boolean',\n          description: 'whether MFA is required for the provider.'\n        },\n        primary_color: {\n          type: 'string',\n          description: 'The hex code for the primary color of the payroll provider.'\n        }\n      },\n      required: [        'id',\n        'display_name',\n        'products'\n      ]\n    }\n  }\n}\n```",
-  inputSchema: {
-    type: 'object',
-    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 = async (client: Finch, args: Record<string, unknown> | undefined) => {
-  const { jq_filter } = args as any;
-  const response = await client.providers.list().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 };