release: 6.33.0 (#623)

* fix(mcp): support jq filtering on cloudflare workers

* chore(mcp): rework imports in tools

* chore(mcp): formatting

* feat(api): api update

* codegen metadata

* fix(mcp): include required section for top-level properties and support naming transformations

* codegen metadata

* codegen metadata

* feat(api): api update

* chore(internal): codegen related update

* release: 6.33.0

---------

Co-authored-by: stainless-app[bot] <142633134+stainless-app[bot]@users.noreply.github.com>

Author: stainless-app[bot]

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "6.32.3"
+  ".": "6.33.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 46
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/finch%2Ffinch-f7e741bc6e0175fd96a9db5348092b90a77b0985154c0814bb681ad5dccdf19a.yml
-openapi_spec_hash: b348a9ef407a8e91dd770fcb219d4ac5
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/finch%2Ffinch-73c284d36c1ed2d9963fc733e421005fad76e559de8efe9baa6511a43dd72668.yml
+openapi_spec_hash: 1e58c4445919b71c77e5c7f16bd6fa7d
 config_hash: 5146b12344dae76238940989dac1e8a0

CHANGELOG.md

@@ -1,5 +1,27 @@
 # Changelog
 
+## 6.33.0 (2025-07-23)
+
+Full Changelog: [v6.32.3...v6.33.0](https://github.com/Finch-API/finch-api-node/compare/v6.32.3...v6.33.0)
+
+### Features
+
+* **api:** api update ([44a2607](https://github.com/Finch-API/finch-api-node/commit/44a26078e84c965bee4fe6dfa0691031ccc65a42))
+* **api:** api update ([c52f01b](https://github.com/Finch-API/finch-api-node/commit/c52f01b0de3340c07294bac7934959da5d399e98))
+
+
+### Bug Fixes
+
+* **mcp:** include required section for top-level properties and support naming transformations ([81932c7](https://github.com/Finch-API/finch-api-node/commit/81932c754864cea1defc5939355a8d7ed8efca54))
+* **mcp:** support jq filtering on cloudflare workers ([f678d75](https://github.com/Finch-API/finch-api-node/commit/f678d75f966bc152fdcc7d19dab40c20f0e4446c))
+
+
+### Chores
+
+* **internal:** codegen related update ([3687e69](https://github.com/Finch-API/finch-api-node/commit/3687e69a3c9f381d958545c25f4e38de33c87ea6))
+* **mcp:** formatting ([040c60f](https://github.com/Finch-API/finch-api-node/commit/040c60fb2766d9a65b7ed56da90a3fc6a06c9de3))
+* **mcp:** rework imports in tools ([58349e8](https://github.com/Finch-API/finch-api-node/commit/58349e876bcf5c8d3b35f306455238fa17c31fe7))
+
 ## 6.32.3 (2025-07-10)
 
 Full Changelog: [v6.32.2...v6.32.3](https://github.com/Finch-API/finch-api-node/compare/v6.32.2...v6.32.3)

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tryfinch/finch-api",
-  "version": "6.32.3",
+  "version": "6.33.0",
   "description": "The official TypeScript library for the Finch API",
   "author": "Finch <[email protected]>",
   "types": "dist/index.d.ts",

packages/mcp-server/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tryfinch/finch-api-mcp",
-  "version": "6.32.3",
+  "version": "6.33.0",
   "description": "The official MCP Server for the Finch API",
   "author": "Finch <[email protected]>",
   "types": "dist/index.d.ts",
@@ -29,7 +29,7 @@
   "dependencies": {
     "@tryfinch/finch-api": "file:../../dist/",
     "@modelcontextprotocol/sdk": "^1.11.5",
-    "jq-web": "^0.6.2",
+    "jq-web": "https://github.com/stainless-api/jq-web/releases/download/v0.8.2/jq-web.tar.gz",
     "yargs": "^17.7.2",
     "@cloudflare/cabidela": "^0.2.4",
     "zod": "^3.25.20",

packages/mcp-server/src/filtering.ts

@@ -1,3 +1,6 @@
+// @ts-nocheck
+import initJq from 'jq-web';
+
 export async function maybeFilter(args: Record<string, unknown> | undefined, response: any): Promise<any> {
   const jqFilter = args?.['jq_filter'];
   if (jqFilter && typeof jqFilter === 'string') {
@@ -7,7 +10,6 @@ export async function maybeFilter(args: Record<string, unknown> | undefined, res
   }
 }
 
-var jqWeb = require('jq-web');
 async function jq(json: any, jqFilter: string) {
-  return (await jqWeb).json(json, jqFilter);
+  return (await initJq).json(json, jqFilter);
 }

packages/mcp-server/src/server.ts

@@ -26,13 +26,9 @@ export { endpoints } from './tools';
 export const server = new McpServer(
   {
     name: 'tryfinch_finch_api_api',
-    version: '6.32.3',
-  },
-  {
-    capabilities: {
-      tools: {},
-    },
+    version: '6.33.0',
   },
+  { capabilities: { tools: {} } },
 );
 
 /**

packages/mcp-server/src/tools/access-tokens/create-access-tokens.ts

@@ -1,10 +1,9 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { maybeFilter } from '@tryfinch/finch-api-mcp/filtering';
-import { asTextContentResult } from '@tryfinch/finch-api-mcp/tools/types';
+import { Metadata, asTextContentResult } from '@tryfinch/finch-api-mcp/tools/types';
 
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import type { Metadata } from '../';
 import Finch from '@tryfinch/finch-api';
 
 export const metadata: Metadata = {
@@ -42,7 +41,9 @@ export const tool: Tool = {
           '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: ['code'],
   },
+  annotations: {},
 };
 
 export const handler = async (client: Finch, args: Record<string, unknown> | undefined) => {

packages/mcp-server/src/tools/account/disconnect-account.ts

@@ -1,10 +1,9 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { maybeFilter } from '@tryfinch/finch-api-mcp/filtering';
-import { asTextContentResult } from '@tryfinch/finch-api-mcp/tools/types';
+import { Metadata, asTextContentResult } from '@tryfinch/finch-api-mcp/tools/types';
 
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import type { Metadata } from '../';
 import Finch from '@tryfinch/finch-api';
 
 export const metadata: Metadata = {
@@ -30,7 +29,9 @@ export const tool: Tool = {
           'A jq filter to apply to the response to include certain fields. Consult the output schema in the tool description to see the fields that are available.\n\nFor example: to include only the `name` field in every object of a results array, you can provide ".results[].name".\n\nFor more information, see the [jq documentation](https://jqlang.org/manual/).',
       },
     },
+    required: [],
   },
+  annotations: {},
 };
 
 export const handler = async (client: Finch, args: Record<string, unknown> | undefined) => {

packages/mcp-server/src/tools/account/introspect-account.ts

@@ -1,10 +1,9 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { maybeFilter } from '@tryfinch/finch-api-mcp/filtering';
-import { asTextContentResult } from '@tryfinch/finch-api-mcp/tools/types';
+import { Metadata, asTextContentResult } from '@tryfinch/finch-api-mcp/tools/types';
 
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import type { Metadata } from '../';
 import Finch from '@tryfinch/finch-api';
 
 export const metadata: Metadata = {
@@ -19,7 +18,7 @@ export const metadata: Metadata = {
 export const tool: Tool = {
   name: 'introspect_account',
   description:
-    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nRead account information associated with an `access_token`\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/introspection',\n  $defs: {\n    introspection: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The Finch UUID of the token being introspected.'\n        },\n        account_id: {\n          type: 'string',\n          description: '[DEPRECATED] Use `connection_id` to associate tokens with a Finch connection instead of this account ID.'\n        },\n        authentication_methods: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              connection_status: {\n                type: 'object',\n                properties: {\n                  message: {\n                    type: 'string'\n                  },\n                  status: {\n                    $ref: '#/$defs/connection_status_type'\n                  }\n                },\n                required: []\n              },\n              products: {\n                type: 'array',\n                description: 'An array of the authorized products associated with the `access_token`.',\n                items: {\n                  type: 'string'\n                }\n              },\n              type: {\n                type: 'string',\n                description: 'The type of authentication method.',\n                enum: [                  'assisted',\n                  'credential',\n                  'api_token',\n                  'api_credential',\n                  'oauth'\n                ]\n              }\n            },\n            required: []\n          }\n        },\n        client_id: {\n          type: 'string',\n          description: 'The client ID of the application associated with the `access_token`.'\n        },\n        client_type: {\n          type: 'string',\n          title: 'ClientType',\n          description: 'The type of application associated with a token.',\n          enum: [            'production',\n            'development',\n            'sandbox'\n          ]\n        },\n        company_id: {\n          type: 'string',\n          description: '[DEPRECATED] Use `connection_id` to associate tokens with a Finch connection instead of this company ID.'\n        },\n        connection_id: {\n          type: 'string',\n          description: 'The Finch UUID of the connection associated with the `access_token`.'\n        },\n        connection_status: {\n          type: 'object',\n          properties: {\n            last_successful_sync: {\n              type: 'string',\n              description: 'The datetime when the connection was last successfully synced.',\n              format: 'date-time'\n            },\n            message: {\n              type: 'string'\n            },\n            status: {\n              $ref: '#/$defs/connection_status_type'\n            }\n          },\n          required: []\n        },\n        connection_type: {\n          type: 'string',\n          title: 'ConnectionType',\n          description: 'The type of the connection associated with the token.\\n- `provider` - connection to an external provider\\n- `finch` - finch-generated data.',\n          enum: [            'provider',\n            'finch'\n          ]\n        },\n        customer_email: {\n          type: 'string',\n          description: 'The email of your customer you provided to Finch when a connect session was created for this connection.'\n        },\n        customer_id: {\n          type: 'string',\n          description: 'The ID of your customer you provided to Finch when a connect session was created for this connection.'\n        },\n        customer_name: {\n          type: 'string',\n          description: 'The name of your customer you provided to Finch when a connect session was created for this connection.'\n        },\n        manual: {\n          type: 'boolean',\n          description: 'Whether the connection associated with the `access_token` uses the Assisted Connect Flow. (`true` if using Assisted Connect, `false` if connection is automated)'\n        },\n        payroll_provider_id: {\n          type: 'string',\n          description: '[DEPRECATED] Use `provider_id` to identify the provider instead of this payroll provider ID.'\n        },\n        products: {\n          type: 'array',\n          description: 'An array of the authorized products associated with the `access_token`.',\n          items: {\n            type: 'string'\n          }\n        },\n        provider_id: {\n          type: 'string',\n          description: 'The ID of the provider associated with the `access_token`.'\n        },\n        username: {\n          type: 'string',\n          description: 'The account username used for login associated with the `access_token`.'\n        }\n      },\n      required: [        'id',\n        'account_id',\n        'authentication_methods',\n        'client_id',\n        'client_type',\n        'company_id',\n        'connection_id',\n        'connection_status',\n        'connection_type',\n        'customer_email',\n        'customer_id',\n        'customer_name',\n        'manual',\n        'payroll_provider_id',\n        'products',\n        'provider_id',\n        'username'\n      ]\n    },\n    connection_status_type: {\n      type: 'string',\n      title: 'ConnectionStatus',\n      enum: [        'pending',\n        'processing',\n        'connected',\n        'error_no_account_setup',\n        'error_permissions',\n        'reauth'\n      ]\n    }\n  }\n}\n```",
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nRead account information associated with an `access_token`\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/introspection',\n  $defs: {\n    introspection: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The Finch UUID of the token being introspected.'\n        },\n        account_id: {\n          type: 'string',\n          description: '[DEPRECATED] Use `connection_id` to associate tokens with a Finch connection instead of this account ID.'\n        },\n        authentication_methods: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              connection_status: {\n                type: 'object',\n                properties: {\n                  message: {\n                    type: 'string'\n                  },\n                  status: {\n                    $ref: '#/$defs/connection_status_type'\n                  }\n                }\n              },\n              products: {\n                type: 'array',\n                description: 'An array of the authorized products associated with the `access_token`.',\n                items: {\n                  type: 'string'\n                }\n              },\n              type: {\n                type: 'string',\n                description: 'The type of authentication method.',\n                enum: [                  'assisted',\n                  'credential',\n                  'api_token',\n                  'api_credential',\n                  'oauth'\n                ]\n              }\n            }\n          }\n        },\n        client_id: {\n          type: 'string',\n          description: 'The client ID of the application associated with the `access_token`.'\n        },\n        client_type: {\n          type: 'string',\n          title: 'ClientType',\n          description: 'The type of application associated with a token.',\n          enum: [            'production',\n            'development',\n            'sandbox'\n          ]\n        },\n        company_id: {\n          type: 'string',\n          description: '[DEPRECATED] Use `connection_id` to associate tokens with a Finch connection instead of this company ID.'\n        },\n        connection_id: {\n          type: 'string',\n          description: 'The Finch UUID of the connection associated with the `access_token`.'\n        },\n        connection_status: {\n          type: 'object',\n          properties: {\n            last_successful_sync: {\n              type: 'string',\n              description: 'The datetime when the connection was last successfully synced.',\n              format: 'date-time'\n            },\n            message: {\n              type: 'string'\n            },\n            status: {\n              $ref: '#/$defs/connection_status_type'\n            }\n          }\n        },\n        connection_type: {\n          type: 'string',\n          title: 'ConnectionType',\n          description: 'The type of the connection associated with the token.\\n- `provider` - connection to an external provider\\n- `finch` - finch-generated data.',\n          enum: [            'provider',\n            'finch'\n          ]\n        },\n        customer_email: {\n          type: 'string',\n          description: 'The email of your customer you provided to Finch when a connect session was created for this connection.'\n        },\n        customer_id: {\n          type: 'string',\n          description: 'The ID of your customer you provided to Finch when a connect session was created for this connection.'\n        },\n        customer_name: {\n          type: 'string',\n          description: 'The name of your customer you provided to Finch when a connect session was created for this connection.'\n        },\n        manual: {\n          type: 'boolean',\n          description: 'Whether the connection associated with the `access_token` uses the Assisted Connect Flow. (`true` if using Assisted Connect, `false` if connection is automated)'\n        },\n        payroll_provider_id: {\n          type: 'string',\n          description: '[DEPRECATED] Use `provider_id` to identify the provider instead of this payroll provider ID.'\n        },\n        products: {\n          type: 'array',\n          description: 'An array of the authorized products associated with the `access_token`.',\n          items: {\n            type: 'string'\n          }\n        },\n        provider_id: {\n          type: 'string',\n          description: 'The ID of the provider associated with the `access_token`.'\n        },\n        username: {\n          type: 'string',\n          description: 'The account username used for login associated with the `access_token`.'\n        }\n      },\n      required: [        'id',\n        'account_id',\n        'authentication_methods',\n        'client_id',\n        'client_type',\n        'company_id',\n        'connection_id',\n        'connection_status',\n        'connection_type',\n        'customer_email',\n        'customer_id',\n        'customer_name',\n        'manual',\n        'payroll_provider_id',\n        'products',\n        'provider_id',\n        'username'\n      ]\n    },\n    connection_status_type: {\n      type: 'string',\n      title: 'ConnectionStatus',\n      enum: [        'pending',\n        'processing',\n        'connected',\n        'error_no_account_setup',\n        'error_permissions',\n        'reauth'\n      ]\n    }\n  }\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {
@@ -30,6 +29,10 @@ export const tool: Tool = {
           '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,
   },
 };