release: 3.0.0

[stainless-app]

Automated Release PR

3.0.0 (2026-02-20)

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 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)
• coerce nullable values to undefined (3d6056f)
• 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: 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)

Performance Improvements

• faster formatting (fbb1589)

Chores

• break long lines in snippets into multiline (a60ce49)
• ci build action (82be9a4)
• 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 MCP dependencies (650313f)
• internal: cache fetch instruction calls in MCP server (7019a7f)
• 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: 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: make mcp-server publishing public by defaut (a80dd72)
• internal: move publish config (e9e8777)
• 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: support oauth authorization code flow for MCP servers (9b420b6)
• internal: update actions/checkout version (54f6539)
• internal: update comment in script (dae9b0f)
• internal: upgrade babel, qs, js-yaml (5e48026)
• internal: upgrade hono (c2c19a7)
• internal: upgrade wrangler version (b1dac50)
• internal: use npm pack for build uploads (5c45d4c)
• mcp code tool explicit error message when missing a run function (bc1b68e)
• 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)
• 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 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)

---

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.