CHANGELOG.md

Changelog

4.20.0 (2026-03-26)

Full Changelog: v4.19.0...v4.20.0

Features

• api: api update (5ff6565)

Chores

• ci: skip lint on metadata-only changes (d8462ee)
• internal: fix MCP server TS errors that occur with required client options (91f8e74)
• internal: update gitignore (f600cdb)

4.19.0 (2026-03-18)

Full Changelog: v4.18.1...v4.19.0

Features

• api: api update (ea198e0)

4.18.1 (2026-03-17)

Full Changelog: v4.18.0...v4.18.1

Chores

• internal: support x-stainless-mcp-client-permissions headers in MCP servers (92811c3)
• internal: tweak CI branches (a19cd7d)

4.18.0 (2026-03-15)

Full Changelog: v4.17.1...v4.18.0

Features

• api: api update (86a1ec5)

4.17.1 (2026-03-14)

Full Changelog: v4.17.0...v4.17.1

Chores

• internal: make generated MCP servers compatible with Cloudflare worker environments (604dc1e)
• internal: support x-stainless-mcp-client-envs header in MCP servers (4cd7ba2)

4.17.0 (2026-03-12)

Full Changelog: v4.16.0...v4.17.0

Features

• api: api update (3220815)
• api: api update (7038385)

Chores

• internal: bump @modelcontextprotocol/sdk, @hono/node-server, and minimatch (82934cc)
• internal: update dependencies to address dependabot vulnerabilities (f7a1e73)

4.16.0 (2026-03-09)

Full Changelog: v4.15.1...v4.16.0

Features

• api: api update (f518aa0)

Chores

• mcp-server: improve instructions (7ea144b)

4.15.1 (2026-03-07)

Full Changelog: v4.15.0...v4.15.1

Bug Fixes

• client: preserve URL params already embedded in path (742aaa8)

Chores

• ci: skip uploading artifacts on stainless-internal branches (dcfbb1b)
• internal: codegen related update (dc4ccb6)
• internal: codegen related update (a8c2ca2)
• internal: use x-stainless-mcp-client-envs header for MCP remote code tool calls (f82a316)
• mcp-server: return access instructions for 404 without API key (d6e609b)
• update placeholder string (0d2731c)

4.15.0 (2026-02-27)

Full Changelog: v4.14.0...v4.15.0

Features

• mcp: add an option to disable code tool (4cdbe34)

Bug Fixes

• mcp: update prompt (fd8d956)

Chores

• internal: fix MCP Dockerfiles so they can be built without buildkit (fb7d1f6)
• internal: fix MCP Dockerfiles so they can be built without buildkit (1dd35ca)
• internal: make MCP code execution location configurable via a flag (11d9837)
• internal: move stringifyQuery implementation to internal function (824e718)

4.14.0 (2026-02-24)

Full Changelog: v4.13.0...v4.14.0

Features

• api: api update (361f385)

Bug Fixes

• docs/contributing: correct pnpm link command (e0c46ad)

Chores

• internal: upgrade @modelcontextprotocol/sdk and hono (57a4564)

4.13.0 (2026-02-20)

Full Changelog: v4.12.0...v4.13.0

Features

• api: api update (c2bd0a4)

Bug Fixes

• mcp: initialize SDK lazily to avoid failing the connection on init errors (429e1d7)

Chores

• internal: cache fetch instruction calls in MCP server (96bdbba)
• internal: remove mock server code (2278d8f)
• mcp: correctly update version in sync with sdk (ce85b9d)
• update mock server docs (c7cb202)

4.12.0 (2026-02-18)

Full Changelog: v4.11.1...v4.12.0

Features

• api: api update (e9d22b1)

Chores

• internal/client: fix form-urlencoded requests (28e9418)
• internal: allow setting x-stainless-api-key header on mcp server requests (9ca6413)
• internal: avoid type checking errors with ts-reset (c702b36)
• internal: improve layout of generated MCP server files (7210253)
• mcp: forward STAINLESS_API_KEY to docs search endpoint (61b2b64)

4.11.1 (2026-02-10)

Full Changelog: v4.11.0...v4.11.1

Chores

• internal: allow basic filtering of methods allowed for MCP code mode (602094d)
• internal: always generate MCP server dockerfiles and upgrade associated dependencies (b6b4ef0)

4.11.0 (2026-02-09)

Full Changelog: v4.10.0...v4.11.0

Features

• api: api update (6c5198a)

4.10.0 (2026-02-09)

Full Changelog: v4.9.1...v4.10.0

Features

• api: api update (56795da)

Chores

• internal: add health check to MCP server when running in HTTP mode (57ae83b)

4.9.1 (2026-02-06)

Full Changelog: v4.9.0...v4.9.1

Bug Fixes

• client: avoid removing abort listener too early (d3af18e)

4.9.0 (2026-02-05)

Full Changelog: v4.8.0...v4.9.0

Features

• api: manual updates (7e95e85)
• mcp: add initial server instructions (25f77f5)

Chores

• client: restructure abort controller binding (801654c)
• internal: refactor flag parsing for MCP servers and add debug flag (2acc011)

4.8.0 (2026-02-03)

Full Changelog: v4.7.3...v4.8.0

Features

• api: api update (5bc2867)

4.7.3 (2026-02-03)

Full Changelog: v4.7.2...v4.7.3

Bug Fixes

• client: avoid memory leak with abort signals (8101444)

Chores

• client: do not parse responses with empty content-length (947bb74)
• internal: support oauth authorization code flow for MCP servers (50baa3b)

4.7.2 (2026-01-29)

Full Changelog: v4.7.1...v4.7.2

Bug Fixes

• docs: fix mcp installation instructions for remote servers (b255909)

Chores

• mcp: up tsconfig lib version to es2022 (6024829)

4.7.1 (2026-01-28)

Full Changelog: v4.7.0...v4.7.1

Bug Fixes

• mcp: allow falling back for required env variables (0ebb99e)

Chores

• ci: upgrade actions/github-script (43e0edb)
• internal: codegen related update (26d72d7)
• internal: update lock file (e7f670f)

4.7.0 (2026-01-20)

Full Changelog: v4.6.0...v4.7.0

Features

• api: api update (89f0158)
• api: api update (4300e3f)

Chores

• internal: update actions/checkout version (05d0b84)
• internal: upgrade babel, qs, js-yaml (7f8ba56)
• mcp: add intent param to execute tool (3893f67)
• mcp: pass intent param to execute handler (d494071)
• mcp: upgrade dependencies (bea7474)

4.6.0 (2026-01-14)

Full Changelog: v4.5.0...v4.6.0

Features

• api: api update (b76de5a)

4.5.0 (2026-01-13)

Full Changelog: v4.4.0...v4.5.0

Features

• api: api update (a6a6b1d)

Chores

• internal: codegen related update (7c4f9fc)
• internal: codegen related update (7608a0d)
• internal: codegen related update (9a21ecf)
• internal: codegen related update (fc20b52)
• internal: configure MCP Server hosting (2c80d1b)

4.4.0 (2026-01-09)

Full Changelog: v4.3.0...v4.4.0

Features

• api: api update (6a21df5)

Bug Fixes

• mcp: update code tool prompt (acc57ff)

4.3.0 (2026-01-09)

Full Changelog: v4.2.3...v4.3.0

Features

• api: api update (440a3c4)
• api: api update (c4c787f)

4.2.3 (2026-01-08)

Full Changelog: v4.2.2...v4.2.3

Bug Fixes

• mcp: fix env parsing (31952f5)

4.2.2 (2026-01-07)

Full Changelog: v4.2.1...v4.2.2

Bug Fixes

• mcp: fix options parsing (b42d492)

Chores

• break long lines in snippets into multiline (55593b3)

4.2.1 (2026-01-06)

Full Changelog: v4.2.0...v4.2.1

Bug Fixes

• mcp: correct code tool api output types (328783f)

Documentation

• prominently feature MCP server setup in root SDK readmes (e8ec001)

4.2.0 (2026-01-05)

Full Changelog: v4.1.0...v4.2.0

Features

• api: api update (2cec205)

4.1.0 (2025-12-29)

Full Changelog: v4.0.0...v4.1.0

Features

• api: api update (983ca0b)

4.0.0 (2025-12-19)

Full Changelog: v3.14.0...v4.0.0

Features

• api: api update (536fb02)

3.14.0 (2025-12-10)

Full Changelog: v3.13.0...v3.14.0

Features

• api: api update (fabea15)
• api: api update (6fe2255)
• api: manual updates (74bf6a6)
• api: manual updates (fe02134)
• api: manual updates (b81eda3)
• api: manual updates (7f51e4e)

3.13.0 (2025-12-10)

Full Changelog: v3.12.0...v3.13.0

Features

• api: manual updates (34c23ae)
• api: manual updates (9aad9ba)

3.12.0 (2025-12-09)

Full Changelog: v3.11.0...v3.12.0

Features

• api: manual updates (5db1034)

3.11.0 (2025-12-09)

Full Changelog: v3.10.0...v3.11.0

Features

• api: api update (8b15b2e)

Bug Fixes

• mcp: correct code tool API endpoint (679b47d)
• mcp: return correct lines on typescript errors (f299338)

Chores

• client: fix logger property type (17e3bd9)
• internal: codegen related update (b739d2e)
• internal: codegen related update (37449e3)
• internal: upgrade eslint (82765af)

3.10.0 (2025-11-27)

Full Changelog: v3.9.0...v3.10.0

Features

• api: api update (856b654)

3.9.0 (2025-11-26)

Full Changelog: v3.8.0...v3.9.0

Features

• api: manual updates (940b068)
• api: manual updates (ff15d92)
• api: manual updates (d02b088)
• api: manual updates (a31ae09)
• api: manual updates (5ff6ed1)
• api: manual updates (d4edc7f)
• api: manual updates (91034cb)
• api: manual updates (c40f02f)
• api: manual updates (bea6e27)

3.8.0 (2025-11-25)

Full Changelog: v3.7.0...v3.8.0

Features

• api: api update (29bd70a)
• api: api update (482a811)
• api: api update (ace4c8b)

3.7.0 (2025-11-06)

Full Changelog: v3.6.0...v3.7.0

Features

• api: api update (fcc686d)
• api: api update (09566db)

3.6.0 (2025-10-07)

Full Changelog: v3.5.0...v3.6.0

Features

• api: api update (81bfd53)
• api: api update (f43ec83)
• api: api update (80bfa4e)
• api: api update (7c85660)

Chores

• internal: remove .eslintcache (1175a1c)
• internal: use npm pack for build uploads (c14b460)
• jsdoc: fix @link annotations to refer only to parts of the package‘s public interface (16397d2)

3.5.0 (2025-09-27)

Full Changelog: v3.4.0...v3.5.0

Features

• api: api update (0563e28)

Performance Improvements

• faster formatting (5b0a9dd)

Chores

• internal: codegen related update (e0994c6)
• internal: fix incremental formatting in some cases (9ff7b43)
• internal: ignore .eslintcache (1ea5fb5)
• internal: remove deprecated compilerOptions.baseUrl from tsconfig.json (93eb1e5)

3.4.0 (2025-09-21)

Full Changelog: v3.3.0...v3.4.0

Features

• api: manual updates (4778090)

3.3.0 (2025-09-21)

Full Changelog: v3.2.0...v3.3.0

Features

• api: api update (59e1a6b)

3.2.0 (2025-09-21)

Full Changelog: v3.1.0...v3.2.0

Features

• api: api update (2fd5467)

3.1.0 (2025-09-20)

Full Changelog: v3.0.0-alpha.27...v3.1.0

Features

• api: api update (290de9a)
• api: api update (6d81959)
• api: manual updates (08bfcf3)
• api: manual updates (e3de154)

Chores

• do not install brew dependencies in ./scripts/bootstrap by default (7484585)

3.0.0-alpha.27 (2025-09-15)

Full Changelog: v3.0.0-alpha.26...v3.0.0-alpha.27

Features

• api: api update (4fd4c3f)
• api: api update (931f06e)
• api: api update (1867027)
• api: api update (ba68418)
• api: api update (e1af8d2)

Bug Fixes

• coerce nullable values to undefined (d3d7567)

Chores

• ci build action (e1f58f5)
• internal: update global Error reference (5c8e529)

3.0.0-alpha.26 (2025-08-26)

Full Changelog: v3.0.0-alpha.25...v3.0.0-alpha.26

Features

• api: api update (bea577f)
• api: api update (663b6c4)
• api: api update (b1070e3)
• api: api update (aa80f8d)

3.0.0-alpha.25 (2025-08-24)

Full Changelog: v3.0.0-alpha.24...v3.0.0-alpha.25

Features

• api: api update (76bebff)

3.0.0-alpha.24 (2025-08-24)

Full Changelog: v3.0.0-alpha.23...v3.0.0-alpha.24

Features

• api: api update (d15cac5)
• api: api update (c1967bf)
• mcp: add code execution tool (7f46f73)

Chores

• add package to package.json (46dddb3)
• client: qualify global Blob (652941a)
• update CI script (d80ffc7)

3.0.0-alpha.23 (2025-08-16)

Full Changelog: v3.0.0-alpha.22...v3.0.0-alpha.23

Features

• api: api update (6fcacef)
• api: manual updates (e9ca883)
• api: manual updates (c5915df)
• api: manual updates (aa8a5e2)

Chores

• deps: update dependency @types/node to v20.17.58 (9c611b7)
• internal: codegen related update (17e1e76)
• internal: formatting change (9e14ef7)

3.0.0-alpha.22 (2025-08-10)

Full Changelog: v3.0.0-alpha.21...v3.0.0-alpha.22

Features

• api: api update (823e151)
• api: api update (f30aec0)
• api: api update (3e5d79c)
• api: api update (edee8f4)
• api: api update (cad11a5)
• api: api update (99d1cc1)
• api: api update (e303ebb)
• api: api update (e243d83)

Chores

• internal: move publish config (580c9d0)
• internal: remove redundant imports config (fbc02b9)
• internal: update comment in script (ecfefab)
• ts: reorder package.json imports (0f96de1)
• update @stainless-api/prism-cli to v5.15.0 (0c7953d)

3.0.0-alpha.21 (2025-07-15)

Full Changelog: v3.0.0-alpha.20...v3.0.0-alpha.21

Features

• api: api update (0bd1242)
• api: api update (78a0aa3)

Chores

• make some internal functions async (10e868f)

3.0.0-alpha.20 (2025-07-03)

Full Changelog: v3.0.0-alpha.19...v3.0.0-alpha.20

Features

• api: api update (32eafab)
• api: api update (752f9cc)
• api: api update (b8d5994)
• api: manual updates (04c7fc5)

Bug Fixes

• ci: release-doctor — report correct token name (7aa5dd7)
• client: get fetchOptions type more reliably (6898034)

Chores

• add docs to RequestOptions type (f0862dd)
• ci: only run for pushes and fork pull requests (be5b494)
• client: improve path param validation (88ce022)

3.0.0-alpha.19 (2025-06-24)

Full Changelog: v3.0.0-alpha.18...v3.0.0-alpha.19

Features

• api: api update (7f31200)
• api: api update (fd23b75)
• api: api update (ca755ef)
• client: add support for endpoint-specific base URLs (950b6e6)

Bug Fixes

• client: explicitly copy fetch in withOptions (ea7d42b)

Chores

• ci: enable for pull requests (b9d3281)
• client: refactor imports (ae245a4)
• readme: update badges (74cd982)
• readme: use better example snippet for undocumented params (76142a1)

Refactors

• types: replace Record with mapped types (687fd59)

3.0.0-alpha.18 (2025-06-14)

Full Changelog: v3.0.0-alpha.17...v3.0.0-alpha.18

Features

• api: api update (9ef5fe1)
• api: api update (06dc425)
• api: api update (dc496a0)
• api: api update (06edf86)
• api: manual updates (4a4cef3)

Bug Fixes

• publish script — handle NPM errors correctly (5396449)

Chores

• internal: add pure annotations, make base APIResource abstract (6737a66)

3.0.0-alpha.17 (2025-06-09)

Full Changelog: v3.0.0-alpha.16...v3.0.0-alpha.17

Features

• api: api update (bc772bf)

3.0.0-alpha.16 (2025-06-08)

Full Changelog: v3.0.0-alpha.15...v3.0.0-alpha.16

Features

• api: api update (7528bc0)
• api: api update (e55a165)
• api: api update (2d7ca84)
• api: manual updates (d0a06cc)

Chores

• avoid type error in certain environments (1b90528)

3.0.0-alpha.15 (2025-06-04)

Full Changelog: v3.0.0-alpha.14...v3.0.0-alpha.15

Features

• api: api update (f22f3a3)
• api: manual updates (b182524)

Chores

• docs: use top-level-await in example snippets (6439032)
• internal: fix readablestream types in node 20 (5afc052)

3.0.0-alpha.14 (2025-06-03)

Full Changelog: v3.0.0-alpha.13...v3.0.0-alpha.14

Features

• api: api update (90e15ce)

3.0.0-alpha.13 (2025-06-03)

Full Changelog: v3.0.0-alpha.12...v3.0.0-alpha.13

Features

• api: add delete connection (474f207)
• api: api update (be72dd8)
• api: api update (d1d50f5)

Chores

• adjust eslint.config.mjs ignore pattern (09c32f9)

3.0.0-alpha.12 (2025-06-02)

Full Changelog: v3.0.0-alpha.11...v3.0.0-alpha.12

Features

• api: api update (edf418a)
• api: api update (fda2410)

3.0.0-alpha.11 (2025-06-02)

Full Changelog: v3.0.0-alpha.10...v3.0.0-alpha.11

Features

• api: api update (454c09d)

3.0.0-alpha.10 (2025-06-01)

Full Changelog: v3.0.0-alpha.9...v3.0.0-alpha.10

Chores

• deps: bump eslint-plugin-prettier (f943ca0)
• internal: update jest config (58e54b1)

3.0.0-alpha.9 (2025-05-30)

Full Changelog: v3.0.0-alpha.8...v3.0.0-alpha.9

Features

• api: api update (23e5400)
• api: manual updates (6b3a9a3)

Bug Fixes

• compat with more runtimes (2fed96b)

Chores

• improve publish-npm script --latest tag logic (90c4e9c)

3.0.0-alpha.8 (2025-05-27)

Full Changelog: v3.0.0-alpha.7...v3.0.0-alpha.8

Features

• api: manual updates (a3389b4)
• api: manual updates (cf0a461)

3.0.0-alpha.7 (2025-05-25)

Full Changelog: v3.0.0-alpha.6...v3.0.0-alpha.7

Features

• api: api update (41f3b9e)

3.0.0-alpha.6 (2025-05-25)

Full Changelog: v3.0.0-alpha.5...v3.0.0-alpha.6

Features

• api: api update (db77979)

3.0.0-alpha.5 (2025-05-25)

Full Changelog: v3.0.0-alpha.4...v3.0.0-alpha.5

Features

• api: api update (a89ecb6)
• api: api update (8d76f1b)
• api: api update (5ad7382)

3.0.0-alpha.4 (2025-05-25)

Full Changelog: v3.0.0-alpha.3...v3.0.0-alpha.4

Features

• api: api update (b26370f)
• api: api update (60986e4)
• api: manual updates (191a358)

3.0.0-alpha.3 (2025-05-24)

Full Changelog: v3.0.0-alpha.2...v3.0.0-alpha.3

Features

• api: api update (d87b9a8)

3.0.0-alpha.2 (2025-05-24)

Full Changelog: v3.0.0-alpha.1...v3.0.0-alpha.2

Features

• api: api update (fa3150f)
• api: api update (dd727a6)

Chores

• docs: grammar improvements (a149e15)

3.0.0-alpha.1 (2025-05-17)

Full Changelog: v3.0.0-alpha.0...v3.0.0-alpha.1

Features

• api: api update (01da5f8)
• api: update via SDK Studio (af9edfe)

Chores

• package: remove engines (aa5d3ae)

3.0.0-alpha.0 (2025-05-11)

Full Changelog: v0.0.1-alpha.0...v3.0.0-alpha.0

Features

• api: update via SDK Studio (9034522)

Chores

• update SDK settings (63954fe)
• update SDK settings (7b6ecb6)