release: 3.0.0

[stainless-app]

Automated Release PR

3.0.0 (2026-04-23)

Full Changelog: v2.7.4...v3.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.

Features

• api: api update (0602cc7)
• api: api update (f5f76e7)
• api: api update (f9d4d09)
• api: api update (53404bd)
• mcp: add an option to disable code tool (2219842)
• mcp: add client infer to cloudflare oauth screen (3ea626e)
• mcp: add code execution tool (1e00ca0)
• mcp: add detail field to docs search tool (122e298)
• mcp: add docs search tool (269087f)
• mcp: add initial server instructions (f0ae533)
• mcp: add logging when environment variable is set (be36e15)
• mcp: add mcp bundles to build script (1bb1db5)
• mcp: add option for including docs tools (7ec226e)
• mcp: add option to infer mcp client (2d55b8d)
• mcp: add typescript check to code execution tool (01c6570)
• mcp: add unix socket option for remote MCP (e2fdc8b)
• mcp: allow setting logging level (92e01a7)
• mcp: change remote server query option parsing logic (1ce88f0)
• mcp: enable experimental docs search tool (c09861a)
• mcp: enable optional code execution tool on http mcp servers (5aa88d4)
• mcp: expose client options in streamableHTTPApp (c79c312)
• mcp: handle code mode calls in the Stainless API (e4ad4ae)
• mcp: parse query string as mcp client options in mcp server (ca31e54)
• mcp: remote server with passthru auth (e98a089)
• mcp: return logs on code tool errors (67c1ed9)

Bug Fixes

• ci: set permissions for DXT publish action (ce6f62c)
• client: incorrect offset pagination check (87e78b8)
• client: preserve URL params already embedded in path (68777a4)
• coerce nullable values to undefined (3d6056f)
• docs/contributing: correct pnpm link command (f8fe092)
• docs: fix mcp installation instructions for remote servers (05daa38)
• mcp: add client instantiation options to code tool (adb99b7)
• mcp: allow falling back for required env variables (b593ded)
• mcpb: pin @anthropic-ai/mcpb version (e2809b3)
• mcp: bump agents version in cloudflare worker MCP servers (4e43395)
• mcp: correct code tool API endpoint (b19afe0)
• mcp: correct code tool api output types (4f83af8)
• mcp: do not fallback on baseUrl if environment env variable is set (b60cead)
• mcp: fix bug in header handling (c0d1022)
• mcp: fix cli argument parsing logic (e0d84e5)
• mcp: fix env parsing (a985915)
• mcp: fix options parsing (23285ec)
• mcp: fix query options parsing (1fa531c)
• mcp: fix some response schemas used for jq filtering (b0f97cf)
• mcp: fix uploading dxt release assets (7854bfd)
• mcp: generate additionalProperties=true for map schemas to avoid validation issues (12bd79f)
• mcp: initialize SDK lazily to avoid failing the connection on init errors (011fc93)
• mcp: pass base url to code tool (9650d43)
• mcp: resolve a linting issue in server code (e866428)
• mcp: return correct lines on typescript errors (4d8eb4c)
• mcp: return tool execution error on api error (48209fc)
• mcp: return tool execution error on jq failure (c717c94)
• mcp: update cloudflare worker host page (04faac6)
• mcp: update code tool prompt (e93faff)
• mcp: update prompt (8a606fa)

Performance Improvements

• faster formatting (fbb1589)

Chores

• break long lines in snippets into multiline (a60ce49)
• ci build action (82be9a4)
• ci: escape input path in publish-npm workflow (fcfb53d)
• ci: skip lint on metadata-only changes (e202d8f)
• ci: skip uploading artifacts on stainless-internal branches (a8f6594)
• ci: upgrade actions/github-script (53d6cd1)
• client: do not parse responses with empty content-length (093077c)
• codegen: internal codegen update (a7f4ec9)
• deps: update dependency node-fetch to v2.6.13 (c62fad2)
• do not install brew dependencies in ./scripts/bootstrap by default (ad1dec4)
• extract some types in mcp docs (438f807)
• fix typo in descriptions (6cee00e)
• internal: add health check to MCP server when running in HTTP mode (bbc38ee)
• internal: allow basic filtering of methods allowed for MCP code mode (bb39c62)
• internal: allow setting x-stainless-api-key header on mcp server requests (be6c595)
• internal: always generate MCP server dockerfiles and upgrade associated dependencies (f7edfed)
• internal: bump @modelcontextprotocol/sdk, @hono/node-server, and minimatch (3ffe8a3)
• internal: bump MCP dependencies (650313f)
• internal: cache fetch instruction calls in MCP server (7019a7f)
• internal: codegen related update (5edc9bb)
• internal: codegen related update (f9228eb)
• internal: codegen related update (ce94b68)
• internal: codegen related update (af60a89)
• internal: codegen related update (0612bd5)
• internal: codegen related update (0b334db)
• internal: codegen related update (8b8ceaf)
• internal: codegen related update (3df78ae)
• internal: codegen related update (4d9100f)
• internal: codegen related update (1e6655c)
• internal: codegen related update (5783182)
• internal: codegen related update (47bcda4)
• internal: codegen related update (7fb00f0)
• internal: codegen related update (6fd386f)
• internal: codegen related update (14f1d5a)
• internal: codegen related update (afd9e2f)
• internal: codegen related update (cf90b27)
• internal: codegen related update (f9801ac)
• internal: codegen related update (b09d85c)
• internal: fix incremental formatting in some cases (9db3270)
• internal: fix MCP docker image builds in yarn projects (0a95651)
• internal: fix MCP Dockerfiles so they can be built without buildkit (08a9df6)
• internal: fix MCP Dockerfiles so they can be built without buildkit (6f70f99)
• internal: fix MCP server import ordering (9702a7d)
• internal: fix MCP server TS errors that occur with required client options (b837153)
• internal: formatting change (12fb0e6)
• internal: gitignore .mcpb files (1379dad)
• internal: grammar fix (it's -> its) (0683aeb)
• internal: ignore .eslintcache (19aa6c1)
• internal: improve layout of generated MCP server files (5dbe7e6)
• internal: improve local docs search for MCP servers (6aa2f3b)
• internal: make generated MCP servers compatible with Cloudflare worker environments (b96aed5)
• internal: make MCP code execution location configurable via a flag (04819f0)
• internal: make mcp-server publishing public by defaut (a80dd72)
• internal: more robust bootstrap script (c909c52)
• internal: move publish config (e9e8777)
• internal: move stringifyQuery implementation to internal function (cad2b7b)
• internal: refactor array check (fd2fa21)
• internal: refactor flag parsing for MCP servers and add debug flag (108db42)
• internal: remove .eslintcache (0a2fdd6)
• internal: remove deprecated compilerOptions.baseUrl from tsconfig.json (1174a7f)
• internal: show error causes in MCP servers when running in local mode (9c2dff4)
• internal: support custom-instructions-path flag in MCP servers (df1f35d)
• internal: support local docs search in MCP servers (ad564a7)
• internal: support oauth authorization code flow for MCP servers (9b420b6)
• internal: support type annotations when running MCP in local execution mode (d714c04)
• internal: support x-stainless-mcp-client-envs header in MCP servers (308a359)
• internal: support x-stainless-mcp-client-permissions headers in MCP servers (6500bef)
• internal: tweak CI branches (b4dec8a)
• internal: update actions/checkout version (54f6539)
• internal: update agents version (16a7ae1)
• internal: update comment in script (dae9b0f)
• internal: update dependencies to address dependabot vulnerabilities (f1c4c46)
• internal: update gitignore (a2b641d)
• internal: update multipart form array serialization (c000412)
• internal: upgrade @modelcontextprotocol/sdk and hono (e671738)
• internal: upgrade babel, qs, js-yaml (5e48026)
• internal: upgrade hono (c2c19a7)
• internal: upgrade wrangler version (b1dac50)
• internal: use link instead of file in MCP server package.json files (8aee377)
• internal: use npm pack for build uploads (5c45d4c)
• internal: use x-stainless-mcp-client-envs header for MCP remote code tool calls (ba5d919)
• mcp code tool explicit error message when missing a run function (bc1b68e)
• mcp-server: add support for session id, forward client info (62a6382)
• mcp-server: improve instructions (07cd946)
• mcp-server: increase local docs search result count from 5 to 10 (7b291ea)
• mcp-server: log client info (5c84254)
• mcp-server: return access instructions for 404 without API key (f8a6c88)
• mcp: add cors to oauth metadata route (cc312bc)
• mcp: add friendlier MCP code tool errors on incorrect method invocations (3341c0e)
• mcp: add intent param to execute tool (d460803)
• mcp: add line numbers to code tool errors (70bf6d0)
• mcp: allow pointing docs_search tool at other URLs (29f1271)
• mcp: clarify http auth error (b8623e9)
• mcp: correctly update version in sync with sdk (a4bb9b3)
• mcp: document remote server in README.md (0b818f2)
• mcp: forward STAINLESS_API_KEY to docs search endpoint (61599b5)
• mcp: minor cleanup of types and package.json (dc011fe)
• mcp: pass intent param to execute handler (0b69eda)
• mcp: refactor streamable http transport (00cb972)
• mcp: remove deprecated tool schemes (b4e317d)
• mcp: rename dxt to mcpb (551b096)
• mcp: up tsconfig lib version to es2022 (9efac91)
• mcp: update lockfile (5b0ef90)
• mcp: update package.json (0d2ee4b)
• mcp: update README (0d69b8d)
• mcp: update types (6b6f77c)
• mcp: upgrade dependencies (4977c78)
• mcp: upgrade jq-web (62ddb5b)
• mcp: upload dxt as release asset (8565331)
• test: do not count install time for mock server timeout (92d3dfe)
• tests: bump steady to v0.19.4 (6b489ac)
• tests: bump steady to v0.19.5 (c586f1c)
• tests: bump steady to v0.19.6 (cea3a42)
• tests: bump steady to v0.19.7 (d1b6fb6)
• tests: bump steady to v0.20.1 (1b517ca)
• tests: bump steady to v0.20.2 (4bfc8ce)
• tests: bump steady to v0.22.1 (8f72b8f)
• update @stainless-api/prism-cli to v5.15.0 (3237c3b)
• update CI script (eb0d865)
• update lockfile (1fb9f41)
• update mock server docs (ef69c2e)
• use latest @modelcontextprotocol/sdk (4832ece)
• use proper capitalization for WebSockets (dd98637)
• use structured error when code execution tool errors (db94eb7)

Documentation

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

Refactors

• tests: switch from prism to steady (ecea3ce)

---

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

[amazon-q-developer]

⏳ I'm reviewing this pull request for security vulnerabilities and code quality issues. I'll provide an update when I'm done

[ellipsis-dev]

Important

Looks good to me! 👍

Reviewed everything up to e832731 in 39 seconds. Click for details.

• Reviewed 74 lines of code in 6 files
• Skipped 0 files when reviewing.
• Skipped posting 6 draft comments. View those below.
• Modify your settings and rules to customize what types of comments Ellipsis leaves. And don't forget to react with 👍 or 👎 to teach Ellipsis.

1. .release-please-manifest.json:1

• Draft comment:
  Version bump updated to 2.8.0 in the release manifest. This is consistent with other version declarations; ensure that all generated release files align.
• Reason this comment was not posted:
  Confidence changes required: 0% <= threshold 50% None

2. CHANGELOG.md:3

• Draft comment:
  Changelog entry for 2.8.0 is added with the new feature entry. Verify the release date and details align with expectations.
• Reason this comment was not posted:
  Confidence changes required: 0% <= threshold 50% None

3. package.json:3

• Draft comment:
  Package version updated to 2.8.0. This ensures consistency with the release manifest and changelog.
• Reason this comment was not posted:
  Confidence changes required: 0% <= threshold 50% None

4. packages/mcp-server/package.json:2

• Draft comment:
  MCP server package version updated to 2.8.0. All version references appear consistent.
• Reason this comment was not posted:
  Confidence changes required: 0% <= threshold 50% None

5. packages/mcp-server/src/server.ts:29

• Draft comment:
  Updated version to 2.8.0 and enabled the logging capability by adding 'logging: {}' to the capabilities. Ensure that the logging functionality is properly supported whenever the corresponding environment variable is set.
• Reason this comment was not posted:
  Confidence changes required: 0% <= threshold 50% None

6. src/version.ts:1

• Draft comment:
  Version constant updated to 2.8.0. This maintains consistency across the codebase.
• Reason this comment was not posted:
  Confidence changes required: 0% <= threshold 50% None

Workflow ID: wflow_9L8qKBDwKNhqq5xy

^{You can customize by changing your verbosity settings, reacting with 👍 or 👎, replying to comments, or adding code review rules.}

[stainless-app]

🧪 Testing

To try out this version of the SDK, run:

npm install 'https://pkg.stainless.com/s/julep-node/7019a7fb0d1cbf0fd7be22b7725160ff113688dc/dist.tar.gz'

Expires at: Sat, 21 Mar 2026 08:57:37 GMT
Updated at: Thu, 19 Feb 2026 08:57:37 GMT

[amazon-q-developer]

✅ I finished the code review, and didn't find any security or code quality issues.