release: 4.0.0

[stainless-app]

Automated Release PR

4.0.0 (2026-04-17)

Full Changelog: v3.1.7...v4.0.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.
• Re-prioritize MCP tooling

Features

• api: api update (5d7092d)
• api: api update (88f7535)
• api: api update (2425cc6)
• api: api update (578bfba)
• api: api update (33a6ea2)
• api: api update (9be3bfe)
• api: api update (c7cf66d)
• api: api update (14c2d5e)
• api: api update (5885c61)
• api: api update (f5e8c36)
• api: manual updates (8441326)
• api: manual updates (e9c62ee)
• api: New endpoints (f5d13e0)
• api: Update example response (d163a61)
• client: add support for endpoint-specific base URLs (b356451)
• mcp: add an option to disable code tool (f029472)
• mcp: add code execution tool (abd8635)
• mcp: add detail field to docs search tool (35f25d0)
• mcp: add docs search tool (00b47d5)
• mcp: add initial server instructions (2bae525)
• mcp: add logging when environment variable is set (cafaf6b)
• mcp: add option for including docs tools (1d4963b)
• mcp: add option to infer mcp client (74d6c6b)
• mcp: add typescript check to code execution tool (af79303)
• mcp: add unix socket option for remote MCP (5882167)
• mcp: allow setting logging level (e853c6c)
• mcp: enable experimental docs search tool (e824d72)
• mcp: enable optional code execution tool on http mcp servers (d245aeb)
• mcp: expose client options in streamableHTTPApp (bbd3f7f)
• mcp: handle code mode calls in the Stainless API (8a6b99f)
• mcp: parse query string as mcp client options in mcp server (adcd8fa)
• mcp: remote server with passthru auth (b7ccf5a)
• mcp: return logs on code tool errors (21c3c65)
• mcp: set X-Stainless-MCP header (317c1b4)
• mcp: support filtering tool results by a jq expression (e0f7de2)
• Re-prioritize MCP tooling (6209fec)
• Surface more tools for MCP (6ccba84)

Bug Fixes

• ci: release-doctor — report correct token name (75c2827)
• ci: set permissions for DXT publish action (138fd3c)
• client: avoid memory leak with abort signals (dadee02)
• client: avoid removing abort listener too early (908d107)
• client: explicitly copy fetch in withOptions (15d6359)
• client: get fetchOptions type more reliably (bfcf183)
• client: preserve URL params already embedded in path (6ed9ffd)
• coerce nullable values to undefined (e3682ab)
• docs: fix mcp installation instructions for remote servers (2cb9f7a)
• mcp: add client instantiation options to code tool (7fee0f8)
• mcp: allow falling back for required env variables (827d244)
• mcp: avoid sending jq_filter to base API (540ad24)
• mcpb: pin @anthropic-ai/mcpb version (cd0a76f)
• mcp: correct code tool API endpoint (2a3a062)
• mcp: correct code tool api output types (c9bc35c)
• mcp: do not fallback on baseUrl if environment env variable is set (46a03f0)
• mcp: fix cli argument parsing logic (9c57445)
• mcp: fix options parsing (fbf5dbb)
• mcp: fix query options parsing (580fa9a)
• mcp: fix tool description of jq_filter (7dc2755)
• mcp: fix uploading dxt release assets (a0c3294)
• mcp: generate additionalProperties=true for map schemas to avoid validation issues (ba36b8d)
• mcp: include required section for top-level properties and support naming transformations (426f523)
• mcp: pass base url to code tool (cfc755c)
• mcp: relax input type for asTextContextResult (5b31a3a)
• mcp: resolve a linting issue in server code (321828a)
• mcp: return correct lines on typescript errors (d747bd3)
• mcp: return tool execution error on api error (f803047)
• mcp: return tool execution error on jq failure (aa1340c)
• mcp: reverse validJson capability option and limit scope (53c1704)
• mcp: support jq filtering on cloudflare workers (c282ffa)
• mcp: update code tool prompt (315dcf5)
• mcp: update prompt (5e99a3a)
• Merge public_treasury config (d1b7774)
• publish script — handle NPM errors correctly (4e6a793)
• Stainless config to match the latest endpoints (4ca5e2e)

Performance Improvements

• faster formatting (e83bf5b)

Chores

• add docs to RequestOptions type (c2dfd02)
• add package to package.json (36b52c9)
• add registry url so setup node generated .npmrc, I dont thinkt this will fix but trying (35e8b5e)
• avoid type error in certain environments (d1dbd0f)
• break long lines in snippets into multiline (aaf10fc)
• ci build action (66c6013)
• ci: enable for pull requests (e6578d3)
• ci: escape input path in publish-npm workflow (b90cf7d)
• ci: only run for pushes and fork pull requests (b54f71d)
• ci: skip lint on metadata-only changes (9259a33)
• ci: skip uploading artifacts on stainless-internal branches (bd57a94)
• ci: upgrade actions/github-script (e14f30f)
• client: do not parse responses with empty content-length (ab8acbe)
• client: fix logger property type (2cb85a4)
• client: improve path param validation (38e333d)
• client: qualify global Blob (0a7d0c2)
• client: refactor imports (36f0acf)
• client: restructure abort controller binding (95cbca8)
• codegen: internal codegen update (077ab08)
• deps: update dependency @types/node to v20.17.58 (59c03b6)
• do not install brew dependencies in ./scripts/bootstrap by default (8222497)
• docs: use simpler mcp tool name (0f8f66d)
• extract some types in mcp docs (720280e)
• internal: add health check to MCP server when running in HTTP mode (e67ee3e)
• internal: add pure annotations, make base APIResource abstract (0a7e13d)
• internal: allow basic filtering of methods allowed for MCP code mode (d2c5d2c)
• internal: always generate MCP server dockerfiles and upgrade associated dependencies (0f14ff1)
• internal: avoid type checking errors with ts-reset (b9a91f5)
• internal: bump @modelcontextprotocol/sdk, @hono/node-server, and minimatch (98ac251)
• internal: codegen related update (1258a82)
• internal: codegen related update (3fc7a0c)
• internal: codegen related update (a6dc59e)
• internal: codegen related update (eac863d)
• internal: codegen related update (1c4f603)
• internal: codegen related update (37b24cd)
• internal: codegen related update (4ae87d5)
• internal: codegen related update (6d4938d)
• internal: codegen related update (41bbab5)
• internal: codegen related update (b3d39f5)
• internal: codegen related update (a5d24dc)
• internal: codegen related update (404631b)
• internal: codegen related update (2768afe)
• internal: codegen related update (6b79c30)
• internal: codegen related update (fe62d00)
• internal: codegen related update (9054a95)
• internal: codegen related update (86b89f4)
• internal: codegen related update (d17744c)
• internal: codegen related update (cf7b848)
• internal: codegen related update (512eb38)
• internal: codegen related update (03be2bf)
• internal: codegen related update (081cdee)
• internal: fix incremental formatting in some cases (a439909)
• internal: fix MCP docker image builds in yarn projects (5f46e24)
• internal: fix MCP Dockerfiles so they can be built without buildkit (578129b)
• internal: fix MCP Dockerfiles so they can be built without buildkit (b51f78d)
• internal: fix MCP server import ordering (dcc5ac6)
• internal: fix MCP server TS errors that occur with required client options (1ed7fb4)
• internal: formatting change (c0e34f5)
• internal: gitignore .mcpb files (7bacb41)
• internal: grammar fix (it's -> its) (53fc78e)
• internal: ignore .eslintcache (f96ef05)
• internal: improve layout of generated MCP server files (b747646)
• internal: improve local docs search for MCP servers (dc59ab7)
• internal: improve local docs search for MCP servers (9811884)
• internal: make generated MCP servers compatible with Cloudflare worker environments (2654d84)
• internal: make mcp-server publishing public by defaut (c1fc494)
• internal: move publish config (e0c7557)
• internal: move stringifyQuery implementation to internal function (af180c8)
• internal: refactor array check (08151d0)
• internal: refactor flag parsing for MCP servers and add debug flag (922aadd)
• internal: remove .eslintcache (7b70ed2)
• internal: remove deprecated compilerOptions.baseUrl from tsconfig.json (24b2c4d)
• internal: remove redundant imports config (1cfee57)
• internal: show error causes in MCP servers when running in local mode (397d8c1)
• internal: support custom-instructions-path flag in MCP servers (086a8a6)
• internal: support local docs search in MCP servers (39d2d19)
• internal: support oauth authorization code flow for MCP servers (e356f46)
• internal: support type annotations when running MCP in local execution mode (d6ffafb)
• internal: support x-stainless-mcp-client-envs header in MCP servers (b84775d)
• internal: support x-stainless-mcp-client-permissions headers in MCP servers (d695bc1)
• internal: tweak CI branches (d727076)
• internal: update actions/checkout version (daf1ac0)
• internal: update comment in script (4e73226)
• internal: update dependencies to address dependabot vulnerabilities (c6ec1d3)
• internal: update gitignore (7571f0d)
• internal: update global Error reference (219beb9)
• internal: update lock file (06ead12)
• internal: upgrade babel, qs, js-yaml (72d694b)
• internal: upgrade eslint (04bd781)
• internal: use link instead of file in MCP server package.json files (2604eec)
• internal: use npm pack for build uploads (668f673)
• internal: use x-stainless-mcp-client-envs header for MCP remote code tool calls (ddac6bc)
• jsdoc: fix @link annotations to refer only to parts of the package‘s public interface (191e6e2)
• make some internal functions async (97ae2fc)
• mcp code tool explicit error message when missing a run function (a37ad16)
• mcp-server: add support for session id, forward client info (a6285f7)
• mcp-server: improve instructions (2aeef2d)
• mcp-server: increase local docs search result count from 5 to 10 (df2ea38)
• mcp-server: log client info (a79194e)
• mcp-server: return access instructions for 404 without API key (51caa26)
• mcp: add cors to oauth metadata route (73883c6)
• mcp: add friendlier MCP code tool errors on incorrect method invocations (8226931)
• mcp: add intent param to execute tool (668d8d4)
• mcp: add line numbers to code tool errors (5a1380f)
• mcp: allow pointing docs_search tool at other URLs (fac0c39)
• mcp: clarify http auth error (0dd0dbf)
• mcp: document remote server in README.md (f95b1e5)
• mcp: formatting (2523d15)
• mcp: forward STAINLESS_API_KEY to docs search endpoint (1eca251)
• mcp: minor cleanup of types and package.json (20a7de0)
• mcp: pass intent param to execute handler (0e88b4e)
• mcp: provides high-level initMcpServer function and exports known clients (6a2476c)
• mcp: refactor streamable http transport (33b2ba7)
• mcp: remove deprecated tool schemes (116baf7)
• mcp: rename dxt to mcpb (2d423f3)
• mcp: rework imports in tools (fccae9a)
• mcp: up tsconfig lib version to es2022 (c714cfc)
• mcp: update lockfile (9df2a0e)
• mcp: update package.json (80e8aa3)
• mcp: update README (e4b4034)
• mcp: update types (314ea4e)
• mcp: upgrade dependencies (6b8914f)
• mcp: upgrade jq-web (3c7fa4b)
• mcp: upload dxt as release asset (14ac389)
• npm trusted publisher supprot (7dad4ec)
• point npm registry not yarnpkg and remove tokens from env var (d75a74e)
• readme: update badges (b6a481f)
• readme: use better example snippet for undocumented params (a35d8e9)
• remove release doctor, we don't need npm token anymore so its redundant (76cc604)
• replace yarn with npx (6c6afe8)
• trusted publisher requires npm>11, node20 doesnt include npm>11 (4ee9b74)
• ts: reorder package.json imports (159fec5)
• update @stainless-api/prism-cli to v5.15.0 (945955a)
• update CI script (1ded6ea)
• update lockfile (b2bc3ed)
• use latest @modelcontextprotocol/sdk (6fa3e5d)
• use structured error when code execution tool errors (5dad257)

Documentation

• mcp: add a README button for one-click add to Cursor (ea4002b)
• mcp: add a README link to add server to VS Code or Claude Code (c446643)
• prominently feature MCP server setup in root SDK readmes (9047366)

Refactors

• types: replace Record with mapped types (cd28aac)

---

This pull request is managed by Stainless's GitHub App.

The semver version number is based on included commit messages. Alternatively, you can manually set the version number in the title of this pull request.

For a better experience, it is recommended to use either rebase-merge or squash-merge when merging this pull request.

🔗 Stainless website
📚 Read the docs
🙋 Reach out for help or questions

[stainless-app]

🧪 Testing

To try out this version of the SDK:

npm install 'https://pkg.stainless.com/s/coingecko-typescript/ac9e96a1f79089eea525c0d0e8623301629d0099/dist.tar.gz'

Expires at: Sun, 17 May 2026 03:44:12 GMT
Updated at: Fri, 17 Apr 2026 03:44:12 GMT