@tryfinch/finch-api-mcp 6.30.0 → 7.0.0

package/tools/hris/company/pay-statement-item/rules/update-pay-statement-item-company-hris-rules.d.mts

@@ -1,32 +1,51 @@
+import { Metadata } from '@tryfinch/finch-api-mcp/tools/types';
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import type { Metadata } from "../../../..//index.mjs";
 import Finch from '@tryfinch/finch-api';
 export declare const metadata: Metadata;
 export declare const tool: Tool;
-export declare const handler: (client: Finch, args: Record<string, unknown> | undefined) => import("@tryfinch/finch-api/core").APIPromise<Finch.HRIS.CompanyResource.PayStatementItem.Rules.RuleUpdateResponse>;
+export declare const handler: (client: Finch, args: Record<string, unknown> | undefined) => Promise<import("@tryfinch/finch-api-mcp/tools/types").ToolCallResult>;
 declare const _default: {
     metadata: Metadata;
     tool: {
-        [x: string]: unknown;
-        name: string;
         inputSchema: {
             [x: string]: unknown;
             type: "object";
             properties?: {
-                [x: string]: unknown;
+                [x: string]: object;
             } | undefined;
+            required?: string[] | undefined;
         };
+        name: string;
         description?: string | undefined;
-        annotations?: {
+        outputSchema?: {
             [x: string]: unknown;
+            type: "object";
+            properties?: {
+                [x: string]: object;
+            } | undefined;
+            required?: string[] | undefined;
+        } | undefined;
+        annotations?: {
             title?: string | undefined;
             readOnlyHint?: boolean | undefined;
             destructiveHint?: boolean | undefined;
             idempotentHint?: boolean | undefined;
             openWorldHint?: boolean | undefined;
         } | undefined;
+        execution?: {
+            taskSupport?: "optional" | "required" | "forbidden" | undefined;
+        } | undefined;
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+        icons?: {
+            src: string;
+            mimeType?: string | undefined;
+            sizes?: string[] | undefined;
+        }[] | undefined;
+        title?: string | undefined;
     };
-    handler: (client: Finch, args: Record<string, unknown> | undefined) => import("@tryfinch/finch-api/core").APIPromise<Finch.HRIS.CompanyResource.PayStatementItem.Rules.RuleUpdateResponse>;
+    handler: (client: Finch, args: Record<string, unknown> | undefined) => Promise<import("@tryfinch/finch-api-mcp/tools/types").ToolCallResult>;
 };
 export default _default;
 //# sourceMappingURL=update-pay-statement-item-company-hris-rules.d.mts.map

package/tools/hris/company/pay-statement-item/rules/update-pay-statement-item-company-hris-rules.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"update-pay-statement-item-company-hris-rules.d.mts","sourceRoot":"","sources":["../../../../../src/tools/hris/company/pay-statement-item/rules/update-pay-statement-item-company-hris-rules.ts"],"names":[],"mappings":"OAEO,EAAE,IAAI,EAAE,MAAM,oCAAoC;OAClD,KAAK,EAAE,QAAQ,EAAE;OACjB,KAAK,MAAM,qBAAqB;AAEvC,eAAO,MAAM,QAAQ,EAAE,QAItB,CAAC;AAEF,eAAO,MAAM,IAAI,EAAE,IAelB,CAAC;AAEF,eAAO,MAAM,OAAO,GAAI,QAAQ,KAAK,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,wHAG/E,CAAC;;;;;;;;;;;;;;;;;;;;;;;sBAH8B,KAAK,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;;AAKhF,wBAA2C"}
+{"version":3,"file":"update-pay-statement-item-company-hris-rules.d.mts","sourceRoot":"","sources":["../../../../../src/tools/hris/company/pay-statement-item/rules/update-pay-statement-item-company-hris-rules.ts"],"names":[],"mappings":"OAGO,EAAE,QAAQ,EAAsC,MAAM,qCAAqC;OAE3F,EAAE,IAAI,EAAE,MAAM,oCAAoC;OAClD,KAAK,MAAM,qBAAqB;AAEvC,eAAO,MAAM,QAAQ,EAAE,QAOtB,CAAC;AAEF,eAAO,MAAM,IAAI,EAAE,IAiClB,CAAC;AAEF,eAAO,MAAM,OAAO,GAAU,QAAQ,KAAK,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,0EAYrF,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAZoC,KAAK,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;;AActF,wBAA2C"}

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

@@ -1,32 +1,51 @@
+import { Metadata } from '@tryfinch/finch-api-mcp/tools/types';
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import type { Metadata } from "../../../..//index.js";
 import Finch from '@tryfinch/finch-api';
 export declare const metadata: Metadata;
 export declare const tool: Tool;
-export declare const handler: (client: Finch, args: Record<string, unknown> | undefined) => import("@tryfinch/finch-api/core").APIPromise<Finch.HRIS.CompanyResource.PayStatementItem.Rules.RuleUpdateResponse>;
+export declare const handler: (client: Finch, args: Record<string, unknown> | undefined) => Promise<import("@tryfinch/finch-api-mcp/tools/types").ToolCallResult>;
 declare const _default: {
     metadata: Metadata;
     tool: {
-        [x: string]: unknown;
-        name: string;
         inputSchema: {
             [x: string]: unknown;
             type: "object";
             properties?: {
-                [x: string]: unknown;
+                [x: string]: object;
             } | undefined;
+            required?: string[] | undefined;
         };
+        name: string;
         description?: string | undefined;
-        annotations?: {
+        outputSchema?: {
             [x: string]: unknown;
+            type: "object";
+            properties?: {
+                [x: string]: object;
+            } | undefined;
+            required?: string[] | undefined;
+        } | undefined;
+        annotations?: {
             title?: string | undefined;
             readOnlyHint?: boolean | undefined;
             destructiveHint?: boolean | undefined;
             idempotentHint?: boolean | undefined;
             openWorldHint?: boolean | undefined;
         } | undefined;
+        execution?: {
+            taskSupport?: "optional" | "required" | "forbidden" | undefined;
+        } | undefined;
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+        icons?: {
+            src: string;
+            mimeType?: string | undefined;
+            sizes?: string[] | undefined;
+        }[] | undefined;
+        title?: string | undefined;
     };
-    handler: (client: Finch, args: Record<string, unknown> | undefined) => import("@tryfinch/finch-api/core").APIPromise<Finch.HRIS.CompanyResource.PayStatementItem.Rules.RuleUpdateResponse>;
+    handler: (client: Finch, args: Record<string, unknown> | undefined) => Promise<import("@tryfinch/finch-api-mcp/tools/types").ToolCallResult>;
 };
 export default _default;
 //# sourceMappingURL=update-pay-statement-item-company-hris-rules.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"update-pay-statement-item-company-hris-rules.d.ts","sourceRoot":"","sources":["../../../../../src/tools/hris/company/pay-statement-item/rules/update-pay-statement-item-company-hris-rules.ts"],"names":[],"mappings":"OAEO,EAAE,IAAI,EAAE,MAAM,oCAAoC;OAClD,KAAK,EAAE,QAAQ,EAAE;OACjB,KAAK,MAAM,qBAAqB;AAEvC,eAAO,MAAM,QAAQ,EAAE,QAItB,CAAC;AAEF,eAAO,MAAM,IAAI,EAAE,IAelB,CAAC;AAEF,eAAO,MAAM,OAAO,GAAI,QAAQ,KAAK,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,wHAG/E,CAAC;;;;;;;;;;;;;;;;;;;;;;;sBAH8B,KAAK,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;;AAKhF,wBAA2C"}
+{"version":3,"file":"update-pay-statement-item-company-hris-rules.d.ts","sourceRoot":"","sources":["../../../../../src/tools/hris/company/pay-statement-item/rules/update-pay-statement-item-company-hris-rules.ts"],"names":[],"mappings":"OAGO,EAAE,QAAQ,EAAsC,MAAM,qCAAqC;OAE3F,EAAE,IAAI,EAAE,MAAM,oCAAoC;OAClD,KAAK,MAAM,qBAAqB;AAEvC,eAAO,MAAM,QAAQ,EAAE,QAOtB,CAAC;AAEF,eAAO,MAAM,IAAI,EAAE,IAiClB,CAAC;AAEF,eAAO,MAAM,OAAO,GAAU,QAAQ,KAAK,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,0EAYrF,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAZoC,KAAK,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;;AActF,wBAA2C"}

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

@@ -1,30 +1,64 @@
 "use strict";
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.handler = exports.tool = exports.metadata = void 0;
+const filtering_1 = require("@tryfinch/finch-api-mcp/filtering");
+const types_1 = require("@tryfinch/finch-api-mcp/tools/types");
+const finch_api_1 = __importDefault(require("@tryfinch/finch-api"));
 exports.metadata = {
     resource: 'hris.company.pay_statement_item.rules',
     operation: 'write',
     tags: [],
+    httpMethod: 'put',
+    httpPath: '/employer/pay-statement-item/rule/{rule_id}',
+    operationId: 'update-rule',
 };
 exports.tool = {
     name: 'update_pay_statement_item_company_hris_rules',
-    description: '**Beta:** this endpoint currently serves employers onboarded after March 4th and historical support will be added soon\nUpdate a rule for a pay statement item.\n',
+    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\n**Beta:** this endpoint currently serves employers onboarded after March 4th and historical support will be added soon\nUpdate a rule for a pay statement item.\n\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/rule_update_response',\n  $defs: {\n    rule_update_response: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'Finch id (uuidv4) for the rule.'\n        },\n        attributes: {\n          type: 'object',\n          description: 'Specifies the fields to be applied when the condition is met.',\n          properties: {\n            metadata: {\n              type: 'object',\n              description: 'The metadata to be attached in the entity. It is a key-value pairs where the values can be of any type (string, number, boolean, object, array, etc.).',\n              additionalProperties: true\n            }\n          }\n        },\n        conditions: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              field: {\n                type: 'string',\n                description: 'The field to be checked in the rule.'\n              },\n              operator: {\n                type: 'string',\n                description: 'The operator to be used in the rule.',\n                enum: [                  'equals'\n                ]\n              },\n              value: {\n                type: 'string',\n                description: 'The value of the field to be checked in the rule.'\n              }\n            }\n          }\n        },\n        created_at: {\n          type: 'string',\n          description: 'The datetime when the rule was created.',\n          format: 'date-time'\n        },\n        effective_end_date: {\n          type: 'string',\n          title: 'Date',\n          description: 'Specifies when the rules should stop applying rules based on the date.'\n        },\n        effective_start_date: {\n          type: 'string',\n          title: 'Date',\n          description: 'Specifies when the rule should begin applying based on the date.'\n        },\n        entity_type: {\n          type: 'string',\n          description: 'The entity type to which the rule is applied.',\n          enum: [            'pay_statement_item'\n          ]\n        },\n        priority: {\n          type: 'integer',\n          description: 'The priority of the rule.'\n        },\n        updated_at: {\n          type: 'string',\n          description: 'The datetime when the rule was last updated.',\n          format: 'date-time'\n        }\n      }\n    }\n  }\n}\n```",
     inputSchema: {
         type: 'object',
         properties: {
             rule_id: {
                 type: 'string',
             },
+            entity_ids: {
+                type: 'array',
+                description: 'The entity IDs to update the rule for.',
+                items: {
+                    type: 'string',
+                },
+            },
             optionalProperty: {
                 type: 'object',
+                additionalProperties: true,
+            },
+            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: ['rule_id'],
+    },
+    annotations: {
+        idempotentHint: true,
     },
 };
-const handler = (client, args) => {
-    const { rule_id, ...body } = args;
-    return client.hris.company.payStatementItem.rules.update(rule_id, body);
+const handler = async (client, args) => {
+    const { rule_id, jq_filter, ...body } = args;
+    try {
+        return (0, types_1.asTextContentResult)(await (0, filtering_1.maybeFilter)(jq_filter, await client.hris.company.payStatementItem.rules.update(rule_id, body)));
+    }
+    catch (error) {
+        if (error instanceof finch_api_1.default.APIError || (0, filtering_1.isJqError)(error)) {
+            return (0, types_1.asErrorResult)(error.message);
+        }
+        throw error;
+    }
 };
 exports.handler = handler;
 exports.default = { metadata: exports.metadata, tool: exports.tool, handler: exports.handler };

package/tools/hris/company/pay-statement-item/rules/update-pay-statement-item-company-hris-rules.js.map

@@ -1 +1 @@
-{"version":3,"file":"update-pay-statement-item-company-hris-rules.js","sourceRoot":"","sources":["../../../../../src/tools/hris/company/pay-statement-item/rules/update-pay-statement-item-company-hris-rules.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAMzE,QAAA,QAAQ,GAAa;IAChC,QAAQ,EAAE,uCAAuC;IACjD,SAAS,EAAE,OAAO;IAClB,IAAI,EAAE,EAAE;CACT,CAAC;AAEW,QAAA,IAAI,GAAS;IACxB,IAAI,EAAE,8CAA8C;IACpD,WAAW,EACT,mKAAmK;IACrK,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;aACf;YACD,gBAAgB,EAAE;gBAChB,IAAI,EAAE,QAAQ;aACf;SACF;KACF;CACF,CAAC;AAEK,MAAM,OAAO,GAAG,CAAC,MAAa,EAAE,IAAyC,EAAE,EAAE;IAClF,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,IAAW,CAAC;IACzC,OAAO,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AAC1E,CAAC,CAAC;AAHW,QAAA,OAAO,WAGlB;AAEF,kBAAe,EAAE,QAAQ,EAAR,gBAAQ,EAAE,IAAI,EAAJ,YAAI,EAAE,OAAO,EAAP,eAAO,EAAE,CAAC"}
+{"version":3,"file":"update-pay-statement-item-company-hris-rules.js","sourceRoot":"","sources":["../../../../../src/tools/hris/company/pay-statement-item/rules/update-pay-statement-item-company-hris-rules.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;;;AAEtF,iEAA2E;AAC3E,+DAAmG;AAGnG,oEAAwC;AAE3B,QAAA,QAAQ,GAAa;IAChC,QAAQ,EAAE,uCAAuC;IACjD,SAAS,EAAE,OAAO;IAClB,IAAI,EAAE,EAAE;IACR,UAAU,EAAE,KAAK;IACjB,QAAQ,EAAE,6CAA6C;IACvD,WAAW,EAAE,aAAa;CAC3B,CAAC;AAEW,QAAA,IAAI,GAAS;IACxB,IAAI,EAAE,8CAA8C;IACpD,WAAW,EACT,iwFAAiwF;IACnwF,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;aACf;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,WAAW,EAAE,wCAAwC;gBACrD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;iBACf;aACF;YACD,gBAAgB,EAAE;gBAChB,IAAI,EAAE,QAAQ;gBACd,oBAAoB,EAAE,IAAI;aAC3B;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,WAAW;gBAClB,WAAW,EACT,kWAAkW;aACrW;SACF;QACD,QAAQ,EAAE,CAAC,SAAS,CAAC;KACtB;IACD,WAAW,EAAE;QACX,cAAc,EAAE,IAAI;KACrB;CACF,CAAC;AAEK,MAAM,OAAO,GAAG,KAAK,EAAE,MAAa,EAAE,IAAyC,EAAE,EAAE;IACxF,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,IAAW,CAAC;IACpD,IAAI,CAAC;QACH,OAAO,IAAA,2BAAmB,EACxB,MAAM,IAAA,uBAAW,EAAC,SAAS,EAAE,MAAM,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CACrG,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,mBAAK,CAAC,QAAQ,IAAI,IAAA,qBAAS,EAAC,KAAK,CAAC,EAAE,CAAC;YACxD,OAAO,IAAA,qBAAa,EAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACtC,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC,CAAC;AAZW,QAAA,OAAO,WAYlB;AAEF,kBAAe,EAAE,QAAQ,EAAR,gBAAQ,EAAE,IAAI,EAAJ,YAAI,EAAE,OAAO,EAAP,eAAO,EAAE,CAAC"}

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

@@ -1,27 +1,58 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { isJqError, maybeFilter } from '@tryfinch/finch-api-mcp/filtering';
+import { asErrorResult, asTextContentResult } from '@tryfinch/finch-api-mcp/tools/types';
+import Finch from '@tryfinch/finch-api';
 export const metadata = {
     resource: 'hris.company.pay_statement_item.rules',
     operation: 'write',
     tags: [],
+    httpMethod: 'put',
+    httpPath: '/employer/pay-statement-item/rule/{rule_id}',
+    operationId: 'update-rule',
 };
 export const tool = {
     name: 'update_pay_statement_item_company_hris_rules',
-    description: '**Beta:** this endpoint currently serves employers onboarded after March 4th and historical support will be added soon\nUpdate a rule for a pay statement item.\n',
+    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\n**Beta:** this endpoint currently serves employers onboarded after March 4th and historical support will be added soon\nUpdate a rule for a pay statement item.\n\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/rule_update_response',\n  $defs: {\n    rule_update_response: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'Finch id (uuidv4) for the rule.'\n        },\n        attributes: {\n          type: 'object',\n          description: 'Specifies the fields to be applied when the condition is met.',\n          properties: {\n            metadata: {\n              type: 'object',\n              description: 'The metadata to be attached in the entity. It is a key-value pairs where the values can be of any type (string, number, boolean, object, array, etc.).',\n              additionalProperties: true\n            }\n          }\n        },\n        conditions: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              field: {\n                type: 'string',\n                description: 'The field to be checked in the rule.'\n              },\n              operator: {\n                type: 'string',\n                description: 'The operator to be used in the rule.',\n                enum: [                  'equals'\n                ]\n              },\n              value: {\n                type: 'string',\n                description: 'The value of the field to be checked in the rule.'\n              }\n            }\n          }\n        },\n        created_at: {\n          type: 'string',\n          description: 'The datetime when the rule was created.',\n          format: 'date-time'\n        },\n        effective_end_date: {\n          type: 'string',\n          title: 'Date',\n          description: 'Specifies when the rules should stop applying rules based on the date.'\n        },\n        effective_start_date: {\n          type: 'string',\n          title: 'Date',\n          description: 'Specifies when the rule should begin applying based on the date.'\n        },\n        entity_type: {\n          type: 'string',\n          description: 'The entity type to which the rule is applied.',\n          enum: [            'pay_statement_item'\n          ]\n        },\n        priority: {\n          type: 'integer',\n          description: 'The priority of the rule.'\n        },\n        updated_at: {\n          type: 'string',\n          description: 'The datetime when the rule was last updated.',\n          format: 'date-time'\n        }\n      }\n    }\n  }\n}\n```",
     inputSchema: {
         type: 'object',
         properties: {
             rule_id: {
                 type: 'string',
             },
+            entity_ids: {
+                type: 'array',
+                description: 'The entity IDs to update the rule for.',
+                items: {
+                    type: 'string',
+                },
+            },
             optionalProperty: {
                 type: 'object',
+                additionalProperties: true,
+            },
+            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: ['rule_id'],
+    },
+    annotations: {
+        idempotentHint: true,
     },
 };
-export const handler = (client, args) => {
-    const { rule_id, ...body } = args;
-    return client.hris.company.payStatementItem.rules.update(rule_id, body);
+export const handler = async (client, args) => {
+    const { rule_id, jq_filter, ...body } = args;
+    try {
+        return asTextContentResult(await maybeFilter(jq_filter, await client.hris.company.payStatementItem.rules.update(rule_id, body)));
+    }
+    catch (error) {
+        if (error instanceof Finch.APIError || isJqError(error)) {
+            return asErrorResult(error.message);
+        }
+        throw error;
+    }
 };
 export default { metadata, tool, handler };
 //# sourceMappingURL=update-pay-statement-item-company-hris-rules.mjs.map

package/tools/hris/company/pay-statement-item/rules/update-pay-statement-item-company-hris-rules.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"update-pay-statement-item-company-hris-rules.mjs","sourceRoot":"","sources":["../../../../../src/tools/hris/company/pay-statement-item/rules/update-pay-statement-item-company-hris-rules.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAMtF,MAAM,CAAC,MAAM,QAAQ,GAAa;IAChC,QAAQ,EAAE,uCAAuC;IACjD,SAAS,EAAE,OAAO;IAClB,IAAI,EAAE,EAAE;CACT,CAAC;AAEF,MAAM,CAAC,MAAM,IAAI,GAAS;IACxB,IAAI,EAAE,8CAA8C;IACpD,WAAW,EACT,mKAAmK;IACrK,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;aACf;YACD,gBAAgB,EAAE;gBAChB,IAAI,EAAE,QAAQ;aACf;SACF;KACF;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,MAAa,EAAE,IAAyC,EAAE,EAAE;IAClF,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,IAAW,CAAC;IACzC,OAAO,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AAC1E,CAAC,CAAC;AAEF,eAAe,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC"}
+{"version":3,"file":"update-pay-statement-item-company-hris-rules.mjs","sourceRoot":"","sources":["../../../../../src/tools/hris/company/pay-statement-item/rules/update-pay-statement-item-company-hris-rules.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,mCAAmC;OACnE,EAAY,aAAa,EAAE,mBAAmB,EAAE,MAAM,qCAAqC;OAG3F,KAAK,MAAM,qBAAqB;AAEvC,MAAM,CAAC,MAAM,QAAQ,GAAa;IAChC,QAAQ,EAAE,uCAAuC;IACjD,SAAS,EAAE,OAAO;IAClB,IAAI,EAAE,EAAE;IACR,UAAU,EAAE,KAAK;IACjB,QAAQ,EAAE,6CAA6C;IACvD,WAAW,EAAE,aAAa;CAC3B,CAAC;AAEF,MAAM,CAAC,MAAM,IAAI,GAAS;IACxB,IAAI,EAAE,8CAA8C;IACpD,WAAW,EACT,iwFAAiwF;IACnwF,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;aACf;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,WAAW,EAAE,wCAAwC;gBACrD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;iBACf;aACF;YACD,gBAAgB,EAAE;gBAChB,IAAI,EAAE,QAAQ;gBACd,oBAAoB,EAAE,IAAI;aAC3B;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,WAAW;gBAClB,WAAW,EACT,kWAAkW;aACrW;SACF;QACD,QAAQ,EAAE,CAAC,SAAS,CAAC;KACtB;IACD,WAAW,EAAE;QACX,cAAc,EAAE,IAAI;KACrB;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAG,KAAK,EAAE,MAAa,EAAE,IAAyC,EAAE,EAAE;IACxF,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,IAAW,CAAC;IACpD,IAAI,CAAC;QACH,OAAO,mBAAmB,CACxB,MAAM,WAAW,CAAC,SAAS,EAAE,MAAM,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CACrG,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,KAAK,CAAC,QAAQ,IAAI,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;YACxD,OAAO,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACtC,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC,CAAC;AAEF,eAAe,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC"}

package/tools/hris/company/retrieve-hris-company.d.mts

@@ -1,32 +1,51 @@
+import { Metadata } from '@tryfinch/finch-api-mcp/tools/types';
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import type { Metadata } from "../..//index.mjs";
 import Finch from '@tryfinch/finch-api';
 export declare const metadata: Metadata;
 export declare const tool: Tool;
-export declare const handler: (client: Finch, args: Record<string, unknown> | undefined) => import("@tryfinch/finch-api/core").APIPromise<Finch.HRIS.CompanyResource.Company>;
+export declare const handler: (client: Finch, args: Record<string, unknown> | undefined) => Promise<import("@tryfinch/finch-api-mcp/tools/types").ToolCallResult>;
 declare const _default: {
     metadata: Metadata;
     tool: {
-        [x: string]: unknown;
-        name: string;
         inputSchema: {
             [x: string]: unknown;
             type: "object";
             properties?: {
-                [x: string]: unknown;
+                [x: string]: object;
             } | undefined;
+            required?: string[] | undefined;
         };
+        name: string;
         description?: string | undefined;
-        annotations?: {
+        outputSchema?: {
             [x: string]: unknown;
+            type: "object";
+            properties?: {
+                [x: string]: object;
+            } | undefined;
+            required?: string[] | undefined;
+        } | undefined;
+        annotations?: {
             title?: string | undefined;
             readOnlyHint?: boolean | undefined;
             destructiveHint?: boolean | undefined;
             idempotentHint?: boolean | undefined;
             openWorldHint?: boolean | undefined;
         } | undefined;
+        execution?: {
+            taskSupport?: "optional" | "required" | "forbidden" | undefined;
+        } | undefined;
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+        icons?: {
+            src: string;
+            mimeType?: string | undefined;
+            sizes?: string[] | undefined;
+        }[] | undefined;
+        title?: string | undefined;
     };
-    handler: (client: Finch, args: Record<string, unknown> | undefined) => import("@tryfinch/finch-api/core").APIPromise<Finch.HRIS.CompanyResource.Company>;
+    handler: (client: Finch, args: Record<string, unknown> | undefined) => Promise<import("@tryfinch/finch-api-mcp/tools/types").ToolCallResult>;
 };
 export default _default;
 //# sourceMappingURL=retrieve-hris-company.d.mts.map

package/tools/hris/company/retrieve-hris-company.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"retrieve-hris-company.d.mts","sourceRoot":"","sources":["../../../src/tools/hris/company/retrieve-hris-company.ts"],"names":[],"mappings":"OAEO,EAAE,IAAI,EAAE,MAAM,oCAAoC;OAClD,KAAK,EAAE,QAAQ,EAAE;OACjB,KAAK,MAAM,qBAAqB;AAEvC,eAAO,MAAM,QAAQ,EAAE,QAItB,CAAC;AAEF,eAAO,MAAM,IAAI,EAAE,IAOlB,CAAC;AAEF,eAAO,MAAM,OAAO,GAAI,QAAQ,KAAK,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,sFAE/E,CAAC;;;;;;;;;;;;;;;;;;;;;;;sBAF8B,KAAK,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;;AAIhF,wBAA2C"}
+{"version":3,"file":"retrieve-hris-company.d.mts","sourceRoot":"","sources":["../../../src/tools/hris/company/retrieve-hris-company.ts"],"names":[],"mappings":"OAGO,EAAE,QAAQ,EAAsC,MAAM,qCAAqC;OAE3F,EAAE,IAAI,EAAE,MAAM,oCAAoC;OAClD,KAAK,MAAM,qBAAqB;AAEvC,eAAO,MAAM,QAAQ,EAAE,QAOtB,CAAC;AAEF,eAAO,MAAM,IAAI,EAAE,IA0BlB,CAAC;AAEF,eAAO,MAAM,OAAO,GAAU,QAAQ,KAAK,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,0EAUrF,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAVoC,KAAK,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;;AAYtF,wBAA2C"}

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

@@ -1,32 +1,51 @@
+import { Metadata } from '@tryfinch/finch-api-mcp/tools/types';
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import type { Metadata } from "../..//index.js";
 import Finch from '@tryfinch/finch-api';
 export declare const metadata: Metadata;
 export declare const tool: Tool;
-export declare const handler: (client: Finch, args: Record<string, unknown> | undefined) => import("@tryfinch/finch-api/core").APIPromise<Finch.HRIS.CompanyResource.Company>;
+export declare const handler: (client: Finch, args: Record<string, unknown> | undefined) => Promise<import("@tryfinch/finch-api-mcp/tools/types").ToolCallResult>;
 declare const _default: {
     metadata: Metadata;
     tool: {
-        [x: string]: unknown;
-        name: string;
         inputSchema: {
             [x: string]: unknown;
             type: "object";
             properties?: {
-                [x: string]: unknown;
+                [x: string]: object;
             } | undefined;
+            required?: string[] | undefined;
         };
+        name: string;
         description?: string | undefined;
-        annotations?: {
+        outputSchema?: {
             [x: string]: unknown;
+            type: "object";
+            properties?: {
+                [x: string]: object;
+            } | undefined;
+            required?: string[] | undefined;
+        } | undefined;
+        annotations?: {
             title?: string | undefined;
             readOnlyHint?: boolean | undefined;
             destructiveHint?: boolean | undefined;
             idempotentHint?: boolean | undefined;
             openWorldHint?: boolean | undefined;
         } | undefined;
+        execution?: {
+            taskSupport?: "optional" | "required" | "forbidden" | undefined;
+        } | undefined;
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+        icons?: {
+            src: string;
+            mimeType?: string | undefined;
+            sizes?: string[] | undefined;
+        }[] | undefined;
+        title?: string | undefined;
     };
-    handler: (client: Finch, args: Record<string, unknown> | undefined) => import("@tryfinch/finch-api/core").APIPromise<Finch.HRIS.CompanyResource.Company>;
+    handler: (client: Finch, args: Record<string, unknown> | undefined) => Promise<import("@tryfinch/finch-api-mcp/tools/types").ToolCallResult>;
 };
 export default _default;
 //# sourceMappingURL=retrieve-hris-company.d.ts.map

package/tools/hris/company/retrieve-hris-company.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"retrieve-hris-company.d.ts","sourceRoot":"","sources":["../../../src/tools/hris/company/retrieve-hris-company.ts"],"names":[],"mappings":"OAEO,EAAE,IAAI,EAAE,MAAM,oCAAoC;OAClD,KAAK,EAAE,QAAQ,EAAE;OACjB,KAAK,MAAM,qBAAqB;AAEvC,eAAO,MAAM,QAAQ,EAAE,QAItB,CAAC;AAEF,eAAO,MAAM,IAAI,EAAE,IAOlB,CAAC;AAEF,eAAO,MAAM,OAAO,GAAI,QAAQ,KAAK,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,sFAE/E,CAAC;;;;;;;;;;;;;;;;;;;;;;;sBAF8B,KAAK,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;;AAIhF,wBAA2C"}
+{"version":3,"file":"retrieve-hris-company.d.ts","sourceRoot":"","sources":["../../../src/tools/hris/company/retrieve-hris-company.ts"],"names":[],"mappings":"OAGO,EAAE,QAAQ,EAAsC,MAAM,qCAAqC;OAE3F,EAAE,IAAI,EAAE,MAAM,oCAAoC;OAClD,KAAK,MAAM,qBAAqB;AAEvC,eAAO,MAAM,QAAQ,EAAE,QAOtB,CAAC;AAEF,eAAO,MAAM,IAAI,EAAE,IA0BlB,CAAC;AAEF,eAAO,MAAM,OAAO,GAAU,QAAQ,KAAK,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,0EAUrF,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAVoC,KAAK,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;;AAYtF,wBAA2C"}

package/tools/hris/company/retrieve-hris-company.js

@@ -1,22 +1,57 @@
 "use strict";
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.handler = exports.tool = exports.metadata = void 0;
+const filtering_1 = require("@tryfinch/finch-api-mcp/filtering");
+const types_1 = require("@tryfinch/finch-api-mcp/tools/types");
+const finch_api_1 = __importDefault(require("@tryfinch/finch-api"));
 exports.metadata = {
     resource: 'hris.company',
     operation: 'read',
     tags: [],
+    httpMethod: 'get',
+    httpPath: '/employer/company',
+    operationId: 'get-company',
 };
 exports.tool = {
     name: 'retrieve_hris_company',
-    description: 'Read basic company data',
+    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 basic company data\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/company',\n  $defs: {\n    company: {\n      type: 'object',\n      title: 'GetCompany',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'A stable Finch `id` (UUID v4) for the company.'\n        },\n        accounts: {\n          type: 'array',\n          description: 'An array of bank account objects associated with the payroll/HRIS system.',\n          items: {\n            type: 'object',\n            properties: {\n              account_name: {\n                type: 'string',\n                description: 'The name of the bank associated in the payroll/HRIS system.'\n              },\n              account_number: {\n                type: 'string',\n                description: '10-12 digit number to specify the bank account'\n              },\n              account_type: {\n                type: 'string',\n                description: 'The type of bank account.',\n                enum: [                  'checking',\n                  'savings'\n                ]\n              },\n              institution_name: {\n                type: 'string',\n                description: 'Name of the banking institution.'\n              },\n              routing_number: {\n                type: 'string',\n                description: 'A nine-digit code that\\'s based on the U.S. Bank location where your account was opened.'\n              }\n            },\n            required: [              'account_name',\n              'account_number',\n              'account_type',\n              'institution_name',\n              'routing_number'\n            ]\n          }\n        },\n        departments: {\n          type: 'array',\n          description: 'The array of company departments.',\n          items: {\n            type: 'object',\n            properties: {\n              name: {\n                type: 'string',\n                description: 'The department name.'\n              },\n              parent: {\n                type: 'object',\n                description: 'The parent department, if present.',\n                properties: {\n                  name: {\n                    type: 'string',\n                    description: 'The parent department\\'s name.'\n                  }\n                },\n                required: [                  'name'\n                ]\n              }\n            },\n            required: [              'name',\n              'parent'\n            ]\n          }\n        },\n        ein: {\n          type: 'string',\n          description: 'The employer identification number.'\n        },\n        entity: {\n          type: 'object',\n          description: 'The entity type object.',\n          properties: {\n            subtype: {\n              type: 'string',\n              description: 'The tax payer subtype of the company.',\n              enum: [                's_corporation',\n                'c_corporation',\n                'b_corporation'\n              ]\n            },\n            type: {\n              type: 'string',\n              description: 'The tax payer type of the company.',\n              enum: [                'llc',\n                'lp',\n                'corporation',\n                'sole_proprietor',\n                'non_profit',\n                'partnership',\n                'cooperative'\n              ]\n            }\n          },\n          required: [            'subtype',\n            'type'\n          ]\n        },\n        legal_name: {\n          type: 'string',\n          description: 'The legal name of the company.'\n        },\n        locations: {\n          type: 'array',\n          items: {\n            $ref: '#/$defs/location'\n          }\n        },\n        primary_email: {\n          type: 'string',\n          description: 'The email of the main administrator on the account.'\n        },\n        primary_phone_number: {\n          type: 'string',\n          description: 'The phone number of the main administrator on the account. Format: E.164, with extension where applicable, e.g. `+NNNNNNNNNNN xExtension`'\n        }\n      },\n      required: [        'id',\n        'accounts',\n        'departments',\n        'ein',\n        'entity',\n        'legal_name',\n        'locations',\n        'primary_email',\n        'primary_phone_number'\n      ]\n    },\n    location: {\n      type: 'object',\n      title: 'Location',\n      properties: {\n        city: {\n          type: 'string',\n          description: 'City, district, suburb, town, or village.'\n        },\n        country: {\n          type: 'string',\n          description: 'The 2-letter ISO 3166 country code.'\n        },\n        line1: {\n          type: 'string',\n          description: 'Street address or PO box.'\n        },\n        line2: {\n          type: 'string',\n          description: 'Apartment, suite, unit, or building.'\n        },\n        postal_code: {\n          type: 'string',\n          description: 'The postal code or zip code.'\n        },\n        state: {\n          type: 'string',\n          description: 'The state code.'\n        },\n        name: {\n          type: 'string'\n        },\n        source_id: {\n          type: 'string'\n        }\n      },\n      required: [        'city',\n        'country',\n        'line1',\n        'line2',\n        'postal_code',\n        'state'\n      ]\n    }\n  }\n}\n```",
     inputSchema: {
         type: 'object',
-        properties: {},
+        properties: {
+            entity_ids: {
+                type: 'array',
+                description: "The entity IDs to specify which entities' data to access.",
+                items: {
+                    type: 'string',
+                },
+            },
+            jq_filter: {
+                type: 'string',
+                title: 'jq Filter',
+                description: 'A jq filter to apply to the response to include certain fields. Consult the output schema in the tool description to see the fields that are available.\n\nFor example: to include only the `name` field in every object of a results array, you can provide ".results[].name".\n\nFor more information, see the [jq documentation](https://jqlang.org/manual/).',
+            },
+        },
+        required: [],
+    },
+    annotations: {
+        readOnlyHint: true,
     },
 };
-const handler = (client, args) => {
-    return client.hris.company.retrieve();
+const handler = async (client, args) => {
+    const { jq_filter, ...body } = args;
+    try {
+        return (0, types_1.asTextContentResult)(await (0, filtering_1.maybeFilter)(jq_filter, await client.hris.company.retrieve(body)));
+    }
+    catch (error) {
+        if (error instanceof finch_api_1.default.APIError || (0, filtering_1.isJqError)(error)) {
+            return (0, types_1.asErrorResult)(error.message);
+        }
+        throw error;
+    }
 };
 exports.handler = handler;
 exports.default = { metadata: exports.metadata, tool: exports.tool, handler: exports.handler };

package/tools/hris/company/retrieve-hris-company.js.map

@@ -1 +1 @@
-{"version":3,"file":"retrieve-hris-company.js","sourceRoot":"","sources":["../../../src/tools/hris/company/retrieve-hris-company.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAMzE,QAAA,QAAQ,GAAa;IAChC,QAAQ,EAAE,cAAc;IACxB,SAAS,EAAE,MAAM;IACjB,IAAI,EAAE,EAAE;CACT,CAAC;AAEW,QAAA,IAAI,GAAS;IACxB,IAAI,EAAE,uBAAuB;IAC7B,WAAW,EAAE,yBAAyB;IACtC,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,EAAE;KACf;CACF,CAAC;AAEK,MAAM,OAAO,GAAG,CAAC,MAAa,EAAE,IAAyC,EAAE,EAAE;IAClF,OAAO,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;AACxC,CAAC,CAAC;AAFW,QAAA,OAAO,WAElB;AAEF,kBAAe,EAAE,QAAQ,EAAR,gBAAQ,EAAE,IAAI,EAAJ,YAAI,EAAE,OAAO,EAAP,eAAO,EAAE,CAAC"}
+{"version":3,"file":"retrieve-hris-company.js","sourceRoot":"","sources":["../../../src/tools/hris/company/retrieve-hris-company.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;;;AAEtF,iEAA2E;AAC3E,+DAAmG;AAGnG,oEAAwC;AAE3B,QAAA,QAAQ,GAAa;IAChC,QAAQ,EAAE,cAAc;IACxB,SAAS,EAAE,MAAM;IACjB,IAAI,EAAE,EAAE;IACR,UAAU,EAAE,KAAK;IACjB,QAAQ,EAAE,mBAAmB;IAC7B,WAAW,EAAE,aAAa;CAC3B,CAAC;AAEW,QAAA,IAAI,GAAS;IACxB,IAAI,EAAE,uBAAuB;IAC7B,WAAW,EACT,2iLAA2iL;IAC7iL,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,WAAW,EAAE,2DAA2D;gBACxE,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;iBACf;aACF;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,WAAW;gBAClB,WAAW,EACT,kWAAkW;aACrW;SACF;QACD,QAAQ,EAAE,EAAE;KACb;IACD,WAAW,EAAE;QACX,YAAY,EAAE,IAAI;KACnB;CACF,CAAC;AAEK,MAAM,OAAO,GAAG,KAAK,EAAE,MAAa,EAAE,IAAyC,EAAE,EAAE;IACxF,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,IAAW,CAAC;IAC3C,IAAI,CAAC;QACH,OAAO,IAAA,2BAAmB,EAAC,MAAM,IAAA,uBAAW,EAAC,SAAS,EAAE,MAAM,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACrG,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,mBAAK,CAAC,QAAQ,IAAI,IAAA,qBAAS,EAAC,KAAK,CAAC,EAAE,CAAC;YACxD,OAAO,IAAA,qBAAa,EAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACtC,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC,CAAC;AAVW,QAAA,OAAO,WAUlB;AAEF,kBAAe,EAAE,QAAQ,EAAR,gBAAQ,EAAE,IAAI,EAAJ,YAAI,EAAE,OAAO,EAAP,eAAO,EAAE,CAAC"}

package/tools/hris/company/retrieve-hris-company.mjs

@@ -1,19 +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 { asErrorResult, asTextContentResult } from '@tryfinch/finch-api-mcp/tools/types';
+import Finch from '@tryfinch/finch-api';
 export const metadata = {
     resource: 'hris.company',
     operation: 'read',
     tags: [],
+    httpMethod: 'get',
+    httpPath: '/employer/company',
+    operationId: 'get-company',
 };
 export const tool = {
     name: 'retrieve_hris_company',
-    description: 'Read basic company data',
+    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 basic company data\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/company',\n  $defs: {\n    company: {\n      type: 'object',\n      title: 'GetCompany',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'A stable Finch `id` (UUID v4) for the company.'\n        },\n        accounts: {\n          type: 'array',\n          description: 'An array of bank account objects associated with the payroll/HRIS system.',\n          items: {\n            type: 'object',\n            properties: {\n              account_name: {\n                type: 'string',\n                description: 'The name of the bank associated in the payroll/HRIS system.'\n              },\n              account_number: {\n                type: 'string',\n                description: '10-12 digit number to specify the bank account'\n              },\n              account_type: {\n                type: 'string',\n                description: 'The type of bank account.',\n                enum: [                  'checking',\n                  'savings'\n                ]\n              },\n              institution_name: {\n                type: 'string',\n                description: 'Name of the banking institution.'\n              },\n              routing_number: {\n                type: 'string',\n                description: 'A nine-digit code that\\'s based on the U.S. Bank location where your account was opened.'\n              }\n            },\n            required: [              'account_name',\n              'account_number',\n              'account_type',\n              'institution_name',\n              'routing_number'\n            ]\n          }\n        },\n        departments: {\n          type: 'array',\n          description: 'The array of company departments.',\n          items: {\n            type: 'object',\n            properties: {\n              name: {\n                type: 'string',\n                description: 'The department name.'\n              },\n              parent: {\n                type: 'object',\n                description: 'The parent department, if present.',\n                properties: {\n                  name: {\n                    type: 'string',\n                    description: 'The parent department\\'s name.'\n                  }\n                },\n                required: [                  'name'\n                ]\n              }\n            },\n            required: [              'name',\n              'parent'\n            ]\n          }\n        },\n        ein: {\n          type: 'string',\n          description: 'The employer identification number.'\n        },\n        entity: {\n          type: 'object',\n          description: 'The entity type object.',\n          properties: {\n            subtype: {\n              type: 'string',\n              description: 'The tax payer subtype of the company.',\n              enum: [                's_corporation',\n                'c_corporation',\n                'b_corporation'\n              ]\n            },\n            type: {\n              type: 'string',\n              description: 'The tax payer type of the company.',\n              enum: [                'llc',\n                'lp',\n                'corporation',\n                'sole_proprietor',\n                'non_profit',\n                'partnership',\n                'cooperative'\n              ]\n            }\n          },\n          required: [            'subtype',\n            'type'\n          ]\n        },\n        legal_name: {\n          type: 'string',\n          description: 'The legal name of the company.'\n        },\n        locations: {\n          type: 'array',\n          items: {\n            $ref: '#/$defs/location'\n          }\n        },\n        primary_email: {\n          type: 'string',\n          description: 'The email of the main administrator on the account.'\n        },\n        primary_phone_number: {\n          type: 'string',\n          description: 'The phone number of the main administrator on the account. Format: E.164, with extension where applicable, e.g. `+NNNNNNNNNNN xExtension`'\n        }\n      },\n      required: [        'id',\n        'accounts',\n        'departments',\n        'ein',\n        'entity',\n        'legal_name',\n        'locations',\n        'primary_email',\n        'primary_phone_number'\n      ]\n    },\n    location: {\n      type: 'object',\n      title: 'Location',\n      properties: {\n        city: {\n          type: 'string',\n          description: 'City, district, suburb, town, or village.'\n        },\n        country: {\n          type: 'string',\n          description: 'The 2-letter ISO 3166 country code.'\n        },\n        line1: {\n          type: 'string',\n          description: 'Street address or PO box.'\n        },\n        line2: {\n          type: 'string',\n          description: 'Apartment, suite, unit, or building.'\n        },\n        postal_code: {\n          type: 'string',\n          description: 'The postal code or zip code.'\n        },\n        state: {\n          type: 'string',\n          description: 'The state code.'\n        },\n        name: {\n          type: 'string'\n        },\n        source_id: {\n          type: 'string'\n        }\n      },\n      required: [        'city',\n        'country',\n        'line1',\n        'line2',\n        'postal_code',\n        'state'\n      ]\n    }\n  }\n}\n```",
     inputSchema: {
         type: 'object',
-        properties: {},
+        properties: {
+            entity_ids: {
+                type: 'array',
+                description: "The entity IDs to specify which entities' data to access.",
+                items: {
+                    type: 'string',
+                },
+            },
+            jq_filter: {
+                type: 'string',
+                title: 'jq Filter',
+                description: 'A jq filter to apply to the response to include certain fields. Consult the output schema in the tool description to see the fields that are available.\n\nFor example: to include only the `name` field in every object of a results array, you can provide ".results[].name".\n\nFor more information, see the [jq documentation](https://jqlang.org/manual/).',
+            },
+        },
+        required: [],
+    },
+    annotations: {
+        readOnlyHint: true,
     },
 };
-export const handler = (client, args) => {
-    return client.hris.company.retrieve();
+export const handler = async (client, args) => {
+    const { jq_filter, ...body } = args;
+    try {
+        return asTextContentResult(await maybeFilter(jq_filter, await client.hris.company.retrieve(body)));
+    }
+    catch (error) {
+        if (error instanceof Finch.APIError || isJqError(error)) {
+            return asErrorResult(error.message);
+        }
+        throw error;
+    }
 };
 export default { metadata, tool, handler };
 //# sourceMappingURL=retrieve-hris-company.mjs.map

package/tools/hris/company/retrieve-hris-company.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"retrieve-hris-company.mjs","sourceRoot":"","sources":["../../../src/tools/hris/company/retrieve-hris-company.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAMtF,MAAM,CAAC,MAAM,QAAQ,GAAa;IAChC,QAAQ,EAAE,cAAc;IACxB,SAAS,EAAE,MAAM;IACjB,IAAI,EAAE,EAAE;CACT,CAAC;AAEF,MAAM,CAAC,MAAM,IAAI,GAAS;IACxB,IAAI,EAAE,uBAAuB;IAC7B,WAAW,EAAE,yBAAyB;IACtC,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,EAAE;KACf;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,MAAa,EAAE,IAAyC,EAAE,EAAE;IAClF,OAAO,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;AACxC,CAAC,CAAC;AAEF,eAAe,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC"}
+{"version":3,"file":"retrieve-hris-company.mjs","sourceRoot":"","sources":["../../../src/tools/hris/company/retrieve-hris-company.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,mCAAmC;OACnE,EAAY,aAAa,EAAE,mBAAmB,EAAE,MAAM,qCAAqC;OAG3F,KAAK,MAAM,qBAAqB;AAEvC,MAAM,CAAC,MAAM,QAAQ,GAAa;IAChC,QAAQ,EAAE,cAAc;IACxB,SAAS,EAAE,MAAM;IACjB,IAAI,EAAE,EAAE;IACR,UAAU,EAAE,KAAK;IACjB,QAAQ,EAAE,mBAAmB;IAC7B,WAAW,EAAE,aAAa;CAC3B,CAAC;AAEF,MAAM,CAAC,MAAM,IAAI,GAAS;IACxB,IAAI,EAAE,uBAAuB;IAC7B,WAAW,EACT,2iLAA2iL;IAC7iL,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,WAAW,EAAE,2DAA2D;gBACxE,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;iBACf;aACF;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,WAAW;gBAClB,WAAW,EACT,kWAAkW;aACrW;SACF;QACD,QAAQ,EAAE,EAAE;KACb;IACD,WAAW,EAAE;QACX,YAAY,EAAE,IAAI;KACnB;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAG,KAAK,EAAE,MAAa,EAAE,IAAyC,EAAE,EAAE;IACxF,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,IAAW,CAAC;IAC3C,IAAI,CAAC;QACH,OAAO,mBAAmB,CAAC,MAAM,WAAW,CAAC,SAAS,EAAE,MAAM,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACrG,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,KAAK,CAAC,QAAQ,IAAI,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;YACxD,OAAO,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACtC,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC,CAAC;AAEF,eAAe,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC"}