release: 0.21.0

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.20.2"
+  ".": "0.21.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 5
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/isaacus%2Fisaacus-8cedb48141daf72e4c1a8b29dad13fb1025dd5edad384296be4bd28277b8d7cc.yml
-openapi_spec_hash: 306db110474ab42cf13c1ce7cf178cb3
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/isaacus%2Fisaacus-baf5ebdd05d1b5192759a356c2701131c47cfb5b7239a49fcb94e68d4210648c.yml
+openapi_spec_hash: 6ea786d56726e18156adf57915fcbe5f
 config_hash: 9040e7359f066240ad536041fb2c5185

CHANGELOG.md

@@ -1,5 +1,35 @@
 # Changelog
 
+## 0.21.0 (2026-03-03)
+
+Full Changelog: [v0.20.2...v0.21.0](https://github.com/isaacus-dev/isaacus-typescript/compare/v0.20.2...v0.21.0)
+
+### Features
+
+* **mcp:** add an option to disable code tool ([b4ec89b](https://github.com/isaacus-dev/isaacus-typescript/commit/b4ec89ba60bf0baa492f407b6a7a2eab50237f67))
+
+
+### Bug Fixes
+
+* **docs/contributing:** correct pnpm link command ([73bfd2a](https://github.com/isaacus-dev/isaacus-typescript/commit/73bfd2abf18103cca4a37898ee2f23c1444ce5bf))
+* **mcp:** initialize SDK lazily to avoid failing the connection on init errors ([875e4fc](https://github.com/isaacus-dev/isaacus-typescript/commit/875e4fc2ac4211278b81cfbf94dee10154d7c56d))
+* **mcp:** update prompt ([5537be5](https://github.com/isaacus-dev/isaacus-typescript/commit/5537be5ec545efbe38de1454b3f855bebe6fa387))
+
+
+### Chores
+
+* **internal/client:** fix form-urlencoded requests ([a1d0fec](https://github.com/isaacus-dev/isaacus-typescript/commit/a1d0fecc8af11202a614786e2dceb2b0928a38ee))
+* **internal:** allow setting x-stainless-api-key header on mcp server requests ([edc6fb5](https://github.com/isaacus-dev/isaacus-typescript/commit/edc6fb5bd091f0183e868c40ce5613db65daa028))
+* **internal:** cache fetch instruction calls in MCP server ([0278e79](https://github.com/isaacus-dev/isaacus-typescript/commit/0278e790e2d7384a9318436103389a578d0cf79f))
+* **internal:** fix MCP Dockerfiles so they can be built without buildkit ([9c22d30](https://github.com/isaacus-dev/isaacus-typescript/commit/9c22d30b32e6e8a303257de8809942606a021717))
+* **internal:** fix MCP Dockerfiles so they can be built without buildkit ([2994023](https://github.com/isaacus-dev/isaacus-typescript/commit/2994023b8e36ac061cea8139025b8421e6c659fd))
+* **internal:** make MCP code execution location configurable via a flag ([0f48e15](https://github.com/isaacus-dev/isaacus-typescript/commit/0f48e15c7296096e24eeecfad6100aa6ca00c2de))
+* **internal:** move stringifyQuery implementation to internal function ([8a830b9](https://github.com/isaacus-dev/isaacus-typescript/commit/8a830b9f2be17ccc102d697da32dd8308d04a3fe))
+* **internal:** remove mock server code ([73f331b](https://github.com/isaacus-dev/isaacus-typescript/commit/73f331b4dbedeaa77b9fed681f263a9a1505c9a0))
+* **internal:** upgrade @modelcontextprotocol/sdk and hono ([56f145c](https://github.com/isaacus-dev/isaacus-typescript/commit/56f145cf805d5c34c0f84c86a200f0b692c62533))
+* **mcp:** correctly update version in sync with sdk ([b8844d4](https://github.com/isaacus-dev/isaacus-typescript/commit/b8844d441f8c7449e0df84da92665af836b833b4))
+* update mock server docs ([8bac25f](https://github.com/isaacus-dev/isaacus-typescript/commit/8bac25f74d58949f1f0c1a5c3e1cdf6dd7a1ca4a))
+
 ## 0.20.2 (2026-02-18)
 
 Full Changelog: [v0.20.1...v0.20.2](https://github.com/isaacus-dev/isaacus-typescript/compare/v0.20.1...v0.20.2)

CONTRIBUTING.md

@@ -60,17 +60,11 @@ $ yarn link isaacus
 # With pnpm
 $ pnpm link --global
 $ cd ../my-package
-$ pnpm link -—global isaacus
+$ pnpm link --global isaacus
 ```
 
 ## Running tests
 
-Most tests require you to [set up a mock server](https://github.com/stoplightio/prism) against the OpenAPI spec to run the tests.
-
-```sh
-$ npx prism mock path/to/your/openapi.yml
-```
-
 ```sh
 $ yarn run test
 ```

package.json

@@ -1,6 +1,6 @@
 {
   "name": "isaacus",
-  "version": "0.20.2",
+  "version": "0.21.0",
   "description": "The official TypeScript library for the Isaacus API",
   "author": "Isaacus <support@isaacus.com>",
   "types": "dist/index.d.ts",

packages/mcp-server/Dockerfile

@@ -37,8 +37,12 @@ COPY . .
 RUN yarn install --frozen-lockfile && \
     yarn build
 
-# Production stage
-FROM node:24-alpine
+FROM denoland/deno:alpine-2.7.1
+
+# Install node and npm
+RUN apk add --no-cache nodejs npm
+
+ENV LD_LIBRARY_PATH=/usr/lib:/usr/local/lib
 
 # Add non-root user
 RUN addgroup -g 1001 -S nodejs && adduser -S nodejs -u 1001
@@ -57,6 +61,7 @@ COPY --from=builder /build/dist ./node_modules/isaacus
 
 # Change ownership to nodejs user
 RUN chown -R nodejs:nodejs /app
+RUN chown -R nodejs:nodejs /deno-dir
 
 # Switch to non-root user
 USER nodejs

packages/mcp-server/manifest.json

@@ -1,7 +1,7 @@
 {
   "dxt_version": "0.2",
   "name": "isaacus-mcp",
-  "version": "0.11.0",
+  "version": "0.21.0",
   "description": "The official MCP Server for the Isaacus API",
   "author": {
     "name": "Isaacus",
@@ -18,7 +18,9 @@
     "entry_point": "index.js",
     "mcp_config": {
       "command": "node",
-      "args": ["${__dirname}/index.js"],
+      "args": [
+        "${__dirname}/index.js"
+      ],
       "env": {
         "ISAACUS_API_KEY": "${user_config.ISAACUS_API_KEY}"
       }
@@ -39,5 +41,7 @@
       "node": ">=18.0.0"
     }
   },
-  "keywords": ["api"]
+  "keywords": [
+    "api"
+  ]
 }

packages/mcp-server/package.json

@@ -1,6 +1,6 @@
 {
   "name": "isaacus-mcp",
-  "version": "0.20.2",
+  "version": "0.21.0",
   "description": "The official MCP Server for the Isaacus API",
   "author": "Isaacus <support@isaacus.com>",
   "types": "dist/index.d.ts",
@@ -32,7 +32,7 @@
   "dependencies": {
     "isaacus": "file:../../dist/",
     "@cloudflare/cabidela": "^0.2.4",
-    "@modelcontextprotocol/sdk": "^1.25.2",
+    "@modelcontextprotocol/sdk": "^1.26.0",
     "@valtown/deno-http-worker": "^0.0.21",
     "cookie-parser": "^1.4.6",
     "cors": "^2.8.5",

packages/mcp-server/src/auth.ts

@@ -2,8 +2,9 @@
 
 import { IncomingMessage } from 'node:http';
 import { ClientOptions } from 'isaacus';
+import { McpOptions } from './options';
 
-export const parseAuthHeaders = (req: IncomingMessage, required?: boolean): Partial<ClientOptions> => {
+export const parseClientAuthHeaders = (req: IncomingMessage, required?: boolean): Partial<ClientOptions> => {
   if (req.headers.authorization) {
     const scheme = req.headers.authorization.split(' ')[0]!;
     const value = req.headers.authorization.slice(scheme.length + 1);
@@ -25,3 +26,17 @@ export const parseAuthHeaders = (req: IncomingMessage, required?: boolean): Part
     : req.headers['x-isaacus-api-key'];
   return { apiKey };
 };
+
+export const getStainlessApiKey = (req: IncomingMessage, mcpOptions: McpOptions): string | undefined => {
+  // Try to get the key from the x-stainless-api-key header
+  const headerKey =
+    Array.isArray(req.headers['x-stainless-api-key']) ?
+      req.headers['x-stainless-api-key'][0]
+    : req.headers['x-stainless-api-key'];
+  if (headerKey && typeof headerKey === 'string') {
+    return headerKey;
+  }
+
+  // Fall back to value set in the mcpOptions (e.g. from environment variable), if provided
+  return mcpOptions.stainlessApiKey;
+};

packages/mcp-server/src/code-tool-paths.cts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export const workerPath = require.resolve('./code-tool-worker.mjs');

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

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