CHANGELOG.md

Changelog

0.31.0 (2026-03-18)

Full Changelog: v0.30.0...v0.31.0

Features

• api: api update (c9407d3)

0.30.0 (2026-03-18)

Full Changelog: v0.29.3...v0.30.0

Features

• api: api update (bde4a7d)

Chores

• internal: support x-stainless-mcp-client-permissions headers in MCP servers (e167d33)
• internal: tweak CI branches (7143eb4)

0.29.3 (2026-03-14)

Full Changelog: v0.29.2...v0.29.3

Chores

• internal: bump @modelcontextprotocol/sdk, @hono/node-server, and minimatch (ad5e1fb)
• internal: make generated MCP servers compatible with Cloudflare worker environments (57daae2)
• internal: support x-stainless-mcp-client-envs header in MCP servers (882dbe9)
• internal: update dependencies to address dependabot vulnerabilities (061f98b)

0.29.2 (2026-03-07)

Full Changelog: v0.29.1...v0.29.2

Bug Fixes

• client: preserve URL params already embedded in path (1d7e6f0)

Chores

• ci: skip uploading artifacts on stainless-internal branches (7ffeb53)
• mcp-server: improve instructions (8c60a40)

0.29.1 (2026-03-06)

Full Changelog: v0.29.0...v0.29.1

Chores

• internal: codegen related update (836c5e9)
• internal: codegen related update (aa92d3f)
• internal: use x-stainless-mcp-client-envs header for MCP remote code tool calls (4ef071f)
• mcp-server: return access instructions for 404 without API key (476d055)

0.29.0 (2026-03-01)

Full Changelog: v0.28.0...v0.29.0

Features

• api: api update (f61f789)
• api: api update (a0d0ace)
• mcp: add an option to disable code tool (62d0e57)

Bug Fixes

• docs/contributing: correct pnpm link command (981d7b2)
• mcp: update prompt (e317027)

Chores

• internal: fix MCP Dockerfiles so they can be built without buildkit (8fa9017)
• internal: fix MCP Dockerfiles so they can be built without buildkit (aafcf3e)
• internal: make MCP code execution location configurable via a flag (96b1198)
• internal: move stringifyQuery implementation to internal function (a5e1a07)
• internal: upgrade @modelcontextprotocol/sdk and hono (7fa1714)

0.28.0 (2026-02-24)

Full Changelog: v0.27.0...v0.28.0

Features

• api: api update (349b511)

0.27.0 (2026-02-23)

Full Changelog: v0.26.0...v0.27.0

Features

• api: manual updates (f0fcc0f)

0.26.0 (2026-02-22)

Full Changelog: v0.25.0...v0.26.0

Features

• api: api update (0b3258a)
• api: api update (5785b9a)

Bug Fixes

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

Chores

• internal/client: fix form-urlencoded requests (db0e168)
• internal: allow basic filtering of methods allowed for MCP code mode (92dfaab)
• internal: allow setting x-stainless-api-key header on mcp server requests (9c7a5bd)
• internal: always generate MCP server dockerfiles and upgrade associated dependencies (1971c44)
• internal: avoid type checking errors with ts-reset (a125dbb)
• internal: cache fetch instruction calls in MCP server (226aabb)
• internal: improve layout of generated MCP server files (d86325e)
• internal: remove mock server code (218d173)
• mcp: correctly update version in sync with sdk (ba9fe6a)
• mcp: forward STAINLESS_API_KEY to docs search endpoint (949d9d8)
• update mock server docs (6ca1d31)

0.25.0 (2026-02-09)

Full Changelog: v0.24.0...v0.25.0

Features

• api: manual updates (a709cf6)

0.24.0 (2026-02-07)

Full Changelog: v0.23.0...v0.24.0

Features

• api: api update (4bedfe8)

0.23.0 (2026-02-07)

Full Changelog: v0.22.0...v0.23.0

Features

• api: api update (fc0f307)
• mcp: add initial server instructions (26f830e)

Bug Fixes

• client: avoid memory leak with abort signals (60a5820)
• client: avoid removing abort listener too early (18599b7)

Chores

• client: do not parse responses with empty content-length (00c1b99)
• client: restructure abort controller binding (8dcedeb)
• internal: add health check to MCP server when running in HTTP mode (66562a1)
• internal: refactor flag parsing for MCP servers and add debug flag (fc3bcca)
• internal: support oauth authorization code flow for MCP servers (55744a2)

0.22.0 (2026-02-02)

Full Changelog: v0.21.0...v0.22.0

Features

• api: api update (e7fb26f)

Bug Fixes

• docs: fix mcp installation instructions for remote servers (9360478)
• mcp: allow falling back for required env variables (09dab63)
• mcp: correct code tool api output types (71f2de2)
• mcp: fix env parsing (f4e7c3b)
• mcp: fix options parsing (61485b9)
• mcp: update code tool prompt (d999ce6)

Chores

• break long lines in snippets into multiline (1e60c3c)
• ci: upgrade actions/github-script (b854ab5)
• internal: codegen related update (b0805b6)
• internal: codegen related update (f93b56c)
• internal: codegen related update (97b7fbd)
• internal: codegen related update (bef7684)
• internal: codegen related update (bd51f18)
• internal: fix dockerfile (f30592f)
• internal: update actions/checkout version (a3dfca1)
• internal: update lock file (d8e108e)
• internal: upgrade babel, qs, js-yaml (2da1738)
• mcp: add intent param to execute tool (2ec26d8)
• mcp: pass intent param to execute handler (0062abc)
• mcp: up tsconfig lib version to es2022 (ee9e681)
• mcp: upgrade dependencies (b376c8e)

Documentation

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

0.21.0 (2026-01-05)

Full Changelog: v0.20.0...v0.21.0

Features

• api: api update (38b98b8)
• api: api update (ad0b469)
• api: manual updates (41bef4b)

0.20.0 (2025-12-22)

Full Changelog: v0.19.0...v0.20.0

⚠ 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: manual updates (1d86d91)

Bug Fixes

• mcp: pass base url to code tool (bdae9f2)

Chores

• mcp: remove deprecated tool schemes (bba3e8f)

0.19.0 (2025-12-14)

Full Changelog: v0.18.0...v0.19.0

Features

• api: api update (925b93d)

0.18.0 (2025-12-11)

Full Changelog: v0.17.0...v0.18.0

Features

• api: api update (2f03734)
• mcp: add typescript check to code execution tool (8d242b6)
• mcp: handle code mode calls in the Stainless API (717986d)
• mcp: return logs on code tool errors (4eb0778)

Bug Fixes

• mcp: add client instantiation options to code tool (01fa9d6)
• mcp: correct code tool API endpoint (7d49b3d)
• mcp: return correct lines on typescript errors (2e33418)
• mcp: return tool execution error on api error (5d28f60)

Chores

• client: fix logger property type (27049b0)
• internal: codegen related update (9c16793)
• internal: codegen related update (9c2662d)
• internal: upgrade eslint (55ddd1d)
• mcp: update lockfile (d33ad7d)
• use latest @modelcontextprotocol/sdk (2d6174d)

0.17.0 (2025-12-01)

Full Changelog: v0.16.0...v0.17.0

Features

• api: api update (e64a50a)

0.16.0 (2025-11-29)

Full Changelog: v0.15.0...v0.16.0

Features

• api: manual updates (d776dcc)
• mcp: add detail field to docs search tool (27d3cbe)

0.15.0 (2025-11-24)

Full Changelog: v0.14.0...v0.15.0

Features

• api: api update (ef50d82)

0.14.0 (2025-11-24)

Full Changelog: v0.13.0...v0.14.0

Features

• api: api update (270745c)

0.13.0 (2025-11-19)

Full Changelog: v0.12.0...v0.13.0

Features

• api: manual updates (f0aac3b)

Bug Fixes

• mcp: return tool execution error on jq failure (3bea425)

Chores

• internal: codegen related update (b2a195b)
• internal: codegen related update (f6f2b96)
• internal: configure MCP Server hosting (6fbd477)
• mcp: add friendlier MCP code tool errors on incorrect method invocations (275e44b)
• mcp: add line numbers to code tool errors (f118d75)
• mcp: clarify http auth error (266ea4b)
• mcp: upgrade jq-web (f190a40)

Documentation

• mcp: add a README button for one-click add to Cursor (44a87a5)
• mcp: add a README link to add server to VS Code or Claude Code (fe2322b)

0.12.0 (2025-11-05)

Full Changelog: v0.11.0...v0.12.0

Features

• mcp: enable optional code execution tool on http mcp servers (0a88463)

Chores

• internal: grammar fix (it's -> its) (edaf715)
• mcp code tool explicit error message when missing a run function (e08bfb8)
• use structured error when code execution tool errors (1a9c653)

0.11.0 (2025-10-31)

Full Changelog: v0.10.0...v0.11.0

Features

• api: manual updates (3e591a0)

Bug Fixes

• mcpb: pin @anthropic-ai/mcpb version (9988475)

0.10.0 (2025-10-30)

Full Changelog: v0.9.1...v0.10.0

Features

• api: api update (428d5ac)
• api: api update (011abe8)
• api: manual updates (927022d)

0.9.1 (2025-10-09)

Full Changelog: v0.9.0...v0.9.1

Chores

• extract some types in mcp docs (3b8f61b)

0.9.0 (2025-10-08)

Full Changelog: v0.8.0...v0.9.0

Features

• api: api update (ce64b29)
• api: api update (411fb44)
• api: api update (62304b0)

Bug Fixes

• mcp: fix cli argument parsing logic (4d93d5a)
• mcp: resolve a linting issue in server code (c5cc506)

Chores

• internal: remove .eslintcache (506f8c0)
• internal: use npm pack for build uploads (baeea68)
• jsdoc: fix @link annotations to refer only to parts of the package‘s public interface (b74deb8)
• update lockfile (e3498ad)

0.8.0 (2025-09-27)

Full Changelog: v0.7.0...v0.8.0

Features

• api: api update (1e16acb)
• mcp: add docs search tool (0a055f3)
• mcp: add option for including docs tools (73ad28b)
• mcp: enable experimental docs search tool (589b047)

Bug Fixes

• ci: set permissions for DXT publish action (1020169)

Performance Improvements

• faster formatting (9ded0f3)

Chores

• codegen: internal codegen update (8e46689)
• do not install brew dependencies in ./scripts/bootstrap by default (b07f40c)
• internal: codegen related update (1c0857f)
• internal: fix incremental formatting in some cases (e27e1ef)
• internal: gitignore .mcpb files (c6ed0ce)
• internal: ignore .eslintcache (2b752fe)
• internal: remove deprecated compilerOptions.baseUrl from tsconfig.json (9f8d8e2)
• mcp: allow pointing docs_search tool at other URLs (af8c410)
• mcp: rename dxt to mcpb (42531d2)

0.7.0 (2025-09-14)

Full Changelog: v0.6.0...v0.7.0

Features

• api: api update (360996b)

Bug Fixes

• coerce nullable values to undefined (7e219a5)
• mcp: fix uploading dxt release assets (9f0931e)

Chores

• mcp: upload dxt as release asset (4142308)

0.6.0 (2025-09-07)

Full Changelog: v0.5.0...v0.6.0

Features

• api: manual updates (afbcb79)

0.5.0 (2025-09-07)

Full Changelog: v0.4.0...v0.5.0

Features

• api: api update (5657c5b)
• mcp: allow setting logging level (fc2ba05)
• mcp: expose client options in streamableHTTPApp (2652b70)

Bug Fixes

• mcp: fix query options parsing (661f292)

Chores

• ci build action (c14bc35)
• internal: codegen related update (ccf944b)
• internal: codegen related update (29a572a)
• internal: codegen related update (d0588aa)
• internal: update global Error reference (fa20dfd)
• update CI script (a9b3ce6)

0.4.0 (2025-08-22)

Full Changelog: v0.3.0...v0.4.0

Features

• mcp: add code execution tool (0c37834)
• mcp: add option to infer mcp client (38a98d1)

Chores

• add package to package.json (f4afc21)
• client: qualify global Blob (e01d45a)
• internal: codegen related update (3839f68)
• internal: make mcp-server publishing public by defaut (90b04c8)
• mcp: add cors to oauth metadata route (c03f17a)
• mcp: update package.json (078179f)
• mcp: update types (a57d2fc)

0.3.0 (2025-08-19)

Full Changelog: v0.2.0...v0.3.0

Features

• api: api update (687376d)
• api: api update (2185b42)
• api: api update (c5e5171)
• mcp: parse query string as mcp client options in mcp server (35bbdf5)

Chores

• deps: update dependency @types/node to v20.17.58 (bc313d7)
• internal: codegen related update (388e0d3)
• internal: formatting change (62a8d7d)
• internal: refactor array check (d999332)
• internal: update comment in script (48243f3)
• mcp: document remote server in README.md (8265fa8)
• mcp: minor cleanup of types and package.json (fa6eb07)
• mcp: update README (025b597)
• update @stainless-api/prism-cli to v5.15.0 (8510713)

0.2.0 (2025-08-07)

Full Changelog: v0.1.0...v0.2.0

Features

• mcp: add logging when environment variable is set (6364c45)
• mcp: add unix socket option for remote MCP (cb8dbf0)
• mcp: remote server with passthru auth (8683693)

Bug Fixes

• mcp: avoid sending jq_filter to base API (3672f68)
• mcp: fix bug in header handling (c541ba4)
• mcp: reverse validJson capability option and limit scope (0b58267)

Chores

• internal: move publish config (9ce6753)
• mcp: refactor streamable http transport (c0d86b9)

0.1.0 (2025-07-31)

Full Changelog: v0.0.1...v0.1.0

Features

• api: manual updates (78879ce)
• api: manual updates (69a7a88)
• api: manual updates (51f9de8)
• api: manual updates (553a065)
• api: manual updates (17e2f82)
• api: manual updates (f405c69)
• api: manual updates (437ffa2)
• api: manual updates (bb954b6)
• api: manual updates (d997f7b)
• api: manual updates (f9ef6a0)
• api: manual updates (e71b7eb)
• api: manual updates (1cc75cd)
• api: manual updates (dbd6df5)
• client: add support for endpoint-specific base URLs (bd84840)
• mcp: implement support for binary responses (4d35e49)
• mcp: include http information in tools (608a554)
• mcp: set X-Stainless-MCP header (9f8bca8)
• mcp: support filtering tool results by a jq expression (7bb7ed6)

Bug Fixes

• ci: release-doctor — report correct token name (14af55d)
• client: explicitly copy fetch in withOptions (17dfeaf)
• client: get fetchOptions type more reliably (5b28587)
• compat with more runtimes (4595f13)
• mcp: fix cursor schema transformation issue with recursive references (ab24ba0)
• mcp: fix tool description of jq_filter (e2f432e)
• mcp: include description in dynamic tool search (d698f91)
• mcp: include required section for top-level properties and support naming transformations (8a3d09d)
• mcp: relax input type for asTextContextResult (b604761)
• mcp: support jq filtering on cloudflare workers (05a640e)
• publish script — handle NPM errors correctly (ce784cd)

Chores

• add docs to RequestOptions type (f4b33df)
• adjust eslint.config.mjs ignore pattern (95468aa)
• avoid type error in certain environments (0b97df8)
• ci: enable for pull requests (623b5d6)
• ci: only run for pushes and fork pull requests (63b08b8)
• client: improve path param validation (2f2fc76)
• client: refactor imports (d90fb77)
• configure new SDK language (fa4bf57)
• deps: bump eslint-plugin-prettier (4637721)
• docs: use top-level-await in example snippets (2376ef9)
• improve publish-npm script --latest tag logic (a096145)
• internal: add pure annotations, make base APIResource abstract (d8a845c)
• internal: codegen related update (708e6d6)
• internal: codegen related update (0bdcf4b)
• internal: fix readablestream types in node 20 (d753e24)
• internal: remove redundant imports config (8215e1e)
• internal: update jest config (261cd8e)
• make some internal functions async (683286e)
• mcp: formatting (0939837)
• mcp: provides high-level initMcpServer function and exports known clients (cd28940)
• mcp: remove duplicate assignment (1984da9)
• mcp: rework imports in tools (497fc6c)
• readme: update badges (46380e0)
• readme: use better example snippet for undocumented params (56c698d)
• ts: reorder package.json imports (4495729)
• update SDK settings (0ce8ece)
• update SDK settings (a090aec)

0.0.1 (2025-07-21)

Full Changelog: v0.1.0-alpha.12...v0.0.1

Features

• api: manual updates (51f9de8)
• mcp: support filtering tool results by a jq expression (7bb7ed6)

Bug Fixes

• mcp: include required section for top-level properties and support naming transformations (8a3d09d)
• mcp: relax input type for asTextContextResult (b604761)
• mcp: support jq filtering on cloudflare workers (05a640e)

Chores

• add docs to RequestOptions type (f4b33df)
• client: improve path param validation (2f2fc76)
• make some internal functions async (683286e)
• mcp: formatting (0939837)
• mcp: rework imports in tools (497fc6c)
• ts: reorder package.json imports (4495729)

0.1.0-alpha.12 (2025-06-29)

Full Changelog: v0.1.0-alpha.11...v0.1.0-alpha.12

Features

• api: manual updates (553a065)

0.1.0-alpha.11 (2025-06-28)

Full Changelog: v0.1.0-alpha.10...v0.1.0-alpha.11

Bug Fixes

• ci: release-doctor — report correct token name (14af55d)
• client: explicitly copy fetch in withOptions (17dfeaf)
• client: get fetchOptions type more reliably (5b28587)

Chores

• ci: only run for pushes and fork pull requests (63b08b8)

0.1.0-alpha.10 (2025-06-19)

Full Changelog: v0.1.0-alpha.9...v0.1.0-alpha.10

Features

• api: manual updates (17e2f82)

0.1.0-alpha.9 (2025-06-19)

Full Changelog: v0.1.0-alpha.8...v0.1.0-alpha.9

Features

• api: manual updates (f405c69)
• api: manual updates (437ffa2)
• client: add support for endpoint-specific base URLs (bd84840)
• mcp: set X-Stainless-MCP header (9f8bca8)

Bug Fixes

• publish script — handle NPM errors correctly (ce784cd)

Chores

• ci: enable for pull requests (623b5d6)
• client: refactor imports (d90fb77)
• internal: add pure annotations, make base APIResource abstract (d8a845c)
• mcp: provides high-level initMcpServer function and exports known clients (cd28940)
• readme: update badges (46380e0)
• readme: use better example snippet for undocumented params (56c698d)

0.1.0-alpha.8 (2025-06-08)

Full Changelog: v0.1.0-alpha.7...v0.1.0-alpha.8

Features

• api: manual updates (bb954b6)

Chores

• avoid type error in certain environments (0b97df8)

0.1.0-alpha.7 (2025-06-06)

Full Changelog: v0.1.0-alpha.6...v0.1.0-alpha.7

Features

• api: manual updates (d997f7b)

0.1.0-alpha.6 (2025-06-06)

Full Changelog: v0.1.0-alpha.5...v0.1.0-alpha.6

Features

• api: manual updates (f9ef6a0)

0.1.0-alpha.5 (2025-06-06)

Full Changelog: v0.1.0-alpha.4...v0.1.0-alpha.5

Features

• api: manual updates (e71b7eb)

0.1.0-alpha.4 (2025-06-06)

Full Changelog: v0.1.0-alpha.3...v0.1.0-alpha.4

Features

• api: manual updates (1cc75cd)
• mcp: implement support for binary responses (4d35e49)

Chores

• adjust eslint.config.mjs ignore pattern (95468aa)
• docs: use top-level-await in example snippets (2376ef9)
• internal: fix readablestream types in node 20 (d753e24)

0.1.0-alpha.3 (2025-06-02)

Full Changelog: v0.1.0-alpha.2...v0.1.0-alpha.3

Features

• api: manual updates (dbd6df5)

0.1.0-alpha.2 (2025-05-31)

Full Changelog: v0.1.0-alpha.1...v0.1.0-alpha.2

Bug Fixes

• compat with more runtimes (4595f13)

Chores

• deps: bump eslint-plugin-prettier (4637721)
• internal: update jest config (261cd8e)

0.1.0-alpha.1 (2025-05-29)

Full Changelog: v0.0.1-alpha.2...v0.1.0-alpha.1

Features

• mcp: include http information in tools (608a554)

Bug Fixes

• mcp: fix cursor schema transformation issue with recursive references (ab24ba0)
• mcp: include description in dynamic tool search (d698f91)

Chores

• improve publish-npm script --latest tag logic (a096145)
• internal: codegen related update (0bdcf4b)
• mcp: remove duplicate assignment (1984da9)

0.0.1-alpha.2 (2025-05-21)

Full Changelog: v0.0.1-alpha.1...v0.0.1-alpha.2

Chores

• configure new SDK language (fa4bf57)

0.0.1-alpha.1 (2025-05-21)

Full Changelog: v0.0.1-alpha.0...v0.0.1-alpha.1

Chores

• update SDK settings (0ce8ece)
• update SDK settings (a090aec)