v3.0.0-rc.1

3.0.0-rc.1 (2026-04-13)

Full Changelog: v2.3.3-rc.1...v3.0.0-rc.1

⚠ BREAKING CHANGES

• mcp: remove deprecated tool schemes
• mcp: Migration: To migrate, simply modify the command used to invoke the MCP server. Currently, the only supported tool scheme is code mode. Now, starting the server with just node /path/to/mcp/server or npx package-name will invoke code tools: changing your command to one of these is likely all you will need to do.

Features

• api: Deprecate AI Detection, Medical Comprehend, and Context-Aware Text Splitting (91097e4)
• api: manual updates (0012f4c)
• api: manual updates (d9dd552)
• mcp: add an option to disable code tool (fa96ea5)
• mcp: add initial server instructions (d52d098)
• mcp: add typescript check to code execution tool (7ecde82)
• mcp: handle code mode calls in the Stainless API (a705a1b)
• mcp: return logs on code tool errors (76551d3)

Bug Fixes

• client: avoid memory leak with abort signals (325c9ca)
• client: avoid removing abort listener too early (8a3f29d)
• client: preserve URL params already embedded in path (c650393)
• docs/contributing: correct pnpm link command (edcceda)
• docs: fix mcp installation instructions for remote servers (5248a83)
• fix request delays for retrying to be more respectful of high requested delays (b897aab)
• mcp: add client instantiation options to code tool (761c3b1)
• mcp: allow falling back for required env variables (7e8d2fc)
• mcp: correct code tool API endpoint (6cd6857)
• mcp: correct code tool api output types (9b088bc)
• mcp: fix env parsing (a8328e7)
• mcp: fix options parsing (6690d22)
• mcp: initialize SDK lazily to avoid failing the connection on init errors (49df35f)
• mcp: pass base url to code tool (59063c0)
• mcp: return correct lines on typescript errors (c7e0c9b)
• mcp: return tool execution error on api error (b62c6ba)
• mcp: update code tool prompt (382ffb1)
• mcp: update prompt (dddad93)

Chores

• break long lines in snippets into multiline (58a37e3)
• ci: escape input path in publish-npm workflow (5a5bf6b)
• ci: skip lint on metadata-only changes (01c3e15)
• ci: skip uploading artifacts on stainless-internal branches (51bf9fc)
• ci: upgrade actions/github-script (c84c7b9)
• client: do not parse responses with empty content-length (6802838)
• client: restructure abort controller binding (3204f51)
• fix example snippet imports (4e80d76)
• fix typo in descriptions (2f6c30f)
• internal/client: fix form-urlencoded requests (69d4765)
• internal: add health check to MCP server when running in HTTP mode (cbb4461)
• internal: allow basic filtering of methods allowed for MCP code mode (a07d4aa)
• internal: allow setting x-stainless-api-key header on mcp server requests (ec7acc0)
• internal: always generate MCP server dockerfiles and upgrade associated dependencies (dc3398b)
• internal: avoid type checking errors with ts-reset (d32477d)
• internal: bump @modelcontextprotocol/sdk, @hono/node-server, and minimatch (85c4851)
• internal: cache fetch instruction calls in MCP server (6745b11)
• internal: codegen related update (c959300)
• internal: codegen related update (f120aae)
• internal: codegen related update (757eeae)
• internal: codegen related update (56fc7c7)
• internal: codegen related update (e12403b)
• internal: codegen related update (1be7281)
• internal: codegen related update (4807744)
• internal: codegen related update (e56fb21)
• internal: codegen related update (c549df2)
• internal: codegen related update (220705b)
• internal: codegen related update (cf8a0ac)
• internal: codegen related update (5958ab9)
• internal: codegen related update (30d1025)
• internal: fix MCP docker image builds in yarn projects (4a40b93)
• internal: fix MCP Dockerfiles so they can be built without buildkit (2e39b4f)
• internal: fix MCP Dockerfiles so they can be built without buildkit (2aa7960)
• internal: fix MCP server import ordering (1a45a48)
• internal: fix MCP server TS errors that occur with required client options (64520aa)
• internal: fix pagination internals not accepting option promises (302c9ab)
• internal: improve layout of generated MCP server files ([da6f525](https...

v2.3.3-rc.1

2.3.3-rc.1 (2025-12-01)

Full Changelog: v2.3.2...v2.3.3-rc.1

Features

• api: Improve MCP tool descriptions (95aa714)
• mcp: add detail field to docs search tool (0c975f7)
• mcp: enable optional code execution tool on http mcp servers (cad37b7)

Bug Fixes

• client: incorrect offset pagination check (b7847ab)
• Fix linting errors. (#238) (12f49e6)
• mcpb: pin @anthropic-ai/mcpb version (43acbce)
• mcp: return tool execution error on jq failure (f833b8f)
• mcp: use raw responses for binary content (54da4f9)

Chores

• client: fix logger property type (20209b8)
• extract some types in mcp docs (de1e150)
• internal: codegen related update (35b1a8f)
• internal: codegen related update (5e30270)
• internal: grammar fix (it's -> its) (7dfbe17)
• internal: remove .eslintcache (f75e301)
• internal: use npm pack for build uploads (38c37a1)
• jsdoc: fix @link annotations to refer only to parts of the package‘s public interface (d227de6)
• mcp code tool explicit error message when missing a run function (16c1a44)
• mcp: add friendlier MCP code tool errors on incorrect method invocations (e6a4a0c)
• mcp: add line numbers to code tool errors (00af445)
• mcp: clarify http auth error (bd123e0)
• mcp: upgrade jq-web (9a0ac58)
• use structured error when code execution tool errors (e140047)

Documentation

• api: updates to API spec (69b36c9)
• mcp: add a README button for one-click add to Cursor (062b7d7)
• mcp: add a README link to add server to VS Code or Claude Code (bb1991a)

v2.3.2

2.3.2 (2025-10-03)

Full Changelog: v2.3.2-rc.2...v2.3.2

v2.3.2-rc.2

2.3.2-rc.2 (2025-09-30)

Full Changelog: v2.3.2-rc.1...v2.3.2-rc.2

Features

• api: manual updates (be9e40e)
• api: manual updates (05fefe8)

Performance Improvements

• faster formatting (06ae198)

Chores

• configure new SDK language (5776514)
• do not install brew dependencies in ./scripts/bootstrap by default (b35ef28)
• internal: codegen related update (8a14d99)
• internal: fix incremental formatting in some cases (fb5aa47)
• internal: ignore .eslintcache (670ff6e)
• internal: remove deprecated compilerOptions.baseUrl from tsconfig.json (8c0e44e)

Documentation

• api: updates to API spec (de1f80a)

v2.3.2-rc.1

2.3.2-rc.1 (2025-09-11)

Full Changelog: v2.3.1...v2.3.2-rc.1

Features

• api: manual updates (6704d48)

Bug Fixes

• coerce nullable values to undefined (06f7969)
• mcp: fix uploading dxt release assets (342af55)

Chores

• add package to package.json (e13a086)
• ci build action (505befa)
• client: qualify global Blob (a4d8c75)
• configure new SDK language (b42c277)
• internal: update global Error reference (ffe142e)
• update CI script (0e85a1f)

Documentation

• api: updates to API spec (c1c607a)
• api: updates to API spec (1be14df)

v2.3.1

2.3.1 (2025-08-20)

Full Changelog: v2.3.0...v2.3.1

Features

• mcp: add code execution tool (60d2199)

Chores

• deps: update dependency @types/node to v20.17.58 (1ca2721)
• internal: formatting change (9608032)

Documentation

• api: updates to API spec (e03824e)

v2.3.0

2.3.0 (2025-08-14)

Full Changelog: v2.3.0-rc.1...v2.3.0

v2.3.0-rc.1

2.3.0-rc.1 (2025-08-12)

Full Changelog: v2.2.1...v2.3.0-rc.1

Features

• api: add web KG and web search (aec5c23)

Chores

• internal: move publish config (549fdb5)
• internal: remove redundant imports config (629582b)
• internal: update comment in script (0cbef20)
• update @stainless-api/prism-cli to v5.15.0 (4eb486f)

Documentation

• api: updates to API spec (1bcdf1c)
• api: updates to API spec (b7625d0)
• api: updates to API spec (bd08c45)

v2.2.1

2.2.1 (2025-07-16)

Full Changelog: v2.2.0...v2.2.1

Features

• client: add support for endpoint-specific base URLs (bdfd113)
• client: add withOptions helper (73cc2cc)

Bug Fixes

• avoid console usage (0939a4a)
• ci: release-doctor — report correct token name (d0f0be6)
• client: always overwrite when merging headers (0dc9410)
• client: explicitly copy fetch in withOptions (ea81361)
• client: get fetchOptions type more reliably (178185b)
• compat with more runtimes (a43506b)
• package.json format (2208eda)
• publish script — handle NPM errors correctly (39c4b77)

Chores

• add docs to RequestOptions type (3f7237f)
• adjust eslint.config.mjs ignore pattern (01dff7e)
• avoid type error in certain environments (5dd5df5)
• ci: enable for pull requests (1b3eb2c)
• ci: only run for pushes and fork pull requests (df2a7dd)
• client: drop support for EOL node versions (78f8359)
• client: improve path param validation (f457172)
• client: refactor imports (353a5a6)
• deps: bump eslint-plugin-prettier (9a1f18d)
• docs: grammar improvements (52b1f34)
• docs: use top-level-await in example snippets (7f5ac8c)
• improve publish-npm script --latest tag logic (7b778a5)
• internal: add pure annotations, make base APIResource abstract (ee0adb9)
• internal: codegen related update (debc99f)
• internal: fix format script (cab6ad2)
• internal: fix readablestream types in node 20 (c15bde3)
• internal: share typescript helpers (238294b)
• make some internal functions async (0a2239c)
• package: remove engines (85661a0)
• readme: update badges (9c1423c)
• readme: use better example snippet for undocumented params (617d2e6)
• ts: reorder package.json imports (80235f0)

Documentation

• add examples to tsdocs (02ae649)
• api: updates to API spec (295a548)
• api: updates to API spec (bd53b17)

Refactors

• types: replace Record with mapped types (6b89bde)

v2.2.0

2.2.0 (2025-04-30)

Full Changelog: v2.2.0-rc.1...v2.2.0

Chores

• internal: refactor utils (333de4b)

Documentation

• api: updates to API spec (88938c9)
• README updates (ae4fed7)
• Update models in README. (904eda0)