release: 8.2.1 (#642)

* chore(mcp): upgrade dependencies

* chore(mcp): add intent param to execute tool

* chore(mcp): pass intent param to execute handler

* chore(internal): upgrade babel, qs, js-yaml

* chore(internal): update `actions/checkout` version

* chore(internal): codegen related update

* chore(internal): codegen related update

* release: 8.2.1

---------

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

Author: stainless-app[bot]

.github/workflows/ci.yml

@@ -19,7 +19,7 @@ jobs:
     runs-on: ${{ github.repository == 'stainless-sdks/finch-typescript' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
     if: github.event_name == 'push' || github.event.pull_request.head.repo.fork
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Set up Node
         uses: actions/setup-node@v4
@@ -41,7 +41,7 @@ jobs:
       contents: read
       id-token: write
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Set up Node
         uses: actions/setup-node@v4
@@ -83,7 +83,7 @@ jobs:
     runs-on: ${{ github.repository == 'stainless-sdks/finch-typescript' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
     if: github.event_name == 'push' || github.event.pull_request.head.repo.fork
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Set up Node
         uses: actions/setup-node@v4

.github/workflows/publish-npm.yml

@@ -20,7 +20,7 @@ jobs:
       contents: write
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Set up Node
         uses: actions/setup-node@v3

.github/workflows/release-doctor.yml

@@ -12,7 +12,7 @@ jobs:
     if: github.repository == 'Finch-API/finch-api-node' && (github.event_name == 'push' || github.event_name == 'workflow_dispatch' || startsWith(github.head_ref, 'release-please') || github.head_ref == 'next')
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Check release environment
         run: |

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "8.2.0"
+  ".": "8.2.1"
 }

CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## 8.2.1 (2026-01-20)
+
+Full Changelog: [v8.2.0...v8.2.1](https://github.com/Finch-API/finch-api-node/compare/v8.2.0...v8.2.1)
+
+### Chores
+
+* **internal:** codegen related update ([b715dbe](https://github.com/Finch-API/finch-api-node/commit/b715dbe99f403407e6e3fe6f24fcfcd5b479992a))
+* **internal:** codegen related update ([55dcc71](https://github.com/Finch-API/finch-api-node/commit/55dcc71110b196d20be9016525d5713c46a5392f))
+* **internal:** update `actions/checkout` version ([f12ddde](https://github.com/Finch-API/finch-api-node/commit/f12ddde51a3ce201ef0673ae99191f7b2c58b62b))
+* **internal:** upgrade babel, qs, js-yaml ([d7be1cd](https://github.com/Finch-API/finch-api-node/commit/d7be1cd05439ac70eb37066e2c097014bbdf5f70))
+* **mcp:** add intent param to execute tool ([167089e](https://github.com/Finch-API/finch-api-node/commit/167089ee6f1bf45a22a902bd24c60399d7d165af))
+* **mcp:** pass intent param to execute handler ([78d31fd](https://github.com/Finch-API/finch-api-node/commit/78d31fd3ec977712f2b66816dd2a20f611bfa75f))
+* **mcp:** upgrade dependencies ([d16fb7c](https://github.com/Finch-API/finch-api-node/commit/d16fb7c18616ff555327e58c45f68a1286a1595e))
+
 ## 8.2.0 (2026-01-13)
 
 Full Changelog: [v8.1.1...v8.2.0](https://github.com/Finch-API/finch-api-node/compare/v8.1.1...v8.2.0)

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tryfinch/finch-api",
-  "version": "8.2.0",
+  "version": "8.2.1",
   "description": "The official TypeScript library for the Finch API",
   "author": "Finch <founders@tryfinch.com>",
   "types": "dist/index.d.ts",

packages/mcp-server/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tryfinch/finch-api-mcp",
-  "version": "8.2.0",
+  "version": "8.2.1",
   "description": "The official MCP Server for the Finch API",
   "author": "Finch <founders@tryfinch.com>",
   "types": "dist/index.d.ts",
@@ -32,13 +32,13 @@
   "dependencies": {
     "@tryfinch/finch-api": "file:../../dist/",
     "@cloudflare/cabidela": "^0.2.4",
-    "@modelcontextprotocol/sdk": "^1.24.0",
+    "@modelcontextprotocol/sdk": "^1.25.2",
     "@valtown/deno-http-worker": "^0.0.21",
     "cors": "^2.8.5",
     "express": "^5.1.0",
     "fuse.js": "^7.1.0",
     "jq-web": "https://github.com/stainless-api/jq-web/releases/download/v0.8.8/jq-web.tar.gz",
-    "qs": "^6.14.0",
+    "qs": "^6.14.1",
     "typescript": "5.8.3",
     "yargs": "^17.7.2",
     "zod": "^3.25.20",
@@ -49,7 +49,7 @@
     "mcp-server": "dist/index.js"
   },
   "devDependencies": {
-    "@anthropic-ai/mcpb": "1.1.0",
+    "@anthropic-ai/mcpb": "^2.1.2",
     "@types/cors": "^2.8.19",
     "@types/express": "^5.0.3",
     "@types/jest": "^29.4.0",

packages/mcp-server/src/code-tool-types.ts

@@ -6,6 +6,7 @@ export type WorkerInput = {
   project_name: string;
   code: string;
   client_opts: ClientOptions;
+  intent?: string | undefined;
 };
 export type WorkerOutput = {
   is_error: boolean;

packages/mcp-server/src/code-tool.ts

@@ -40,10 +40,24 @@ export function codeTool(): McpTool {
   const tool: Tool = {
     name: 'execute',
     description: prompt,
-    inputSchema: { type: 'object', properties: { code: { type: 'string' } } },
+    inputSchema: {
+      type: 'object',
+      properties: {
+        code: {
+          type: 'string',
+          description: 'Code to execute.',
+        },
+        intent: {
+          type: 'string',
+          description: 'Task you are trying to perform. Used for improving the service.',
+        },
+      },
+      required: ['code'],
+    },
   };
   const handler = async (_: unknown, args: any): Promise<ToolCallResult> => {
     const code = args.code as string;
+    const intent = args.intent as string | undefined;
 
     // this is not required, but passing a Stainless API key for the matching project_name
     // will allow you to run code-mode queries against non-published versions of your SDK.
@@ -66,6 +80,7 @@ export function codeTool(): McpTool {
       body: JSON.stringify({
         project_name: 'finch',
         code,
+        intent,
         client_opts: { accessToken: readEnv('FINCH_ACCESS_TOKEN') },
       } satisfies WorkerInput),
     });

packages/mcp-server/src/http.ts

@@ -48,11 +48,8 @@ const post =
     const server = newServer({ ...options, req, res });
     // If we return null, we already set the authorization error.
     if (server === null) return;
-    const transport = new StreamableHTTPServerTransport({
-      // Stateless server
-      sessionIdGenerator: undefined,
-    });
-    await server.connect(transport);
+    const transport = new StreamableHTTPServerTransport();
+    await server.connect(transport as any);
     await transport.handleRequest(req, res, req.body);
   };