v7.4.0

7.4.0 (2026-04-06)

Full Changelog: v7.3.0...v7.4.0

Features

• api: add xCenter, yCenter, and anchorPoint parameters for overlay positioning (0fcec28)
• api: dpr type update (81ec737)
• api: Introduce lxc, lyc, lap parameters in overlays. (6853a32)
• api: revert dpr breaking change (2543278)
• mcp: add an option to disable code tool (af87a8b)
• mcp: add initial server instructions (cdce131)

Bug Fixes

• client: avoid memory leak with abort signals (c08f7c0)
• client: avoid removing abort listener too early (0738e88)
• client: preserve URL params already embedded in path (9fed3c5)
• docs/contributing: correct pnpm link command (743a112)
• fix request delays for retrying to be more respectful of high requested delays (8cc484f)
• mcp: bump agents version in cloudflare worker MCP servers (207aff5)
• mcp: initialize SDK lazily to avoid failing the connection on init errors (66c5305)
• mcp: update prompt (db925be)

Chores

• ci: escape input path in publish-npm workflow (cbb4d36)
• ci: skip lint on metadata-only changes (a4ff868)
• ci: skip uploading artifacts on stainless-internal branches (7d86a36)
• client: do not parse responses with empty content-length (4b5fcbf)
• client: restructure abort controller binding (46c04e1)
• internal/client: fix form-urlencoded requests (d96f483)
• internal: add health check to MCP server when running in HTTP mode (83d1174)
• internal: allow basic filtering of methods allowed for MCP code mode (4a86182)
• internal: allow setting x-stainless-api-key header on mcp server requests (a72133c)
• internal: always generate MCP server dockerfiles and upgrade associated dependencies (90eae18)
• internal: avoid type checking errors with ts-reset (7cd3980)
• internal: bump @modelcontextprotocol/sdk, @hono/node-server, and minimatch (a0031e0)
• internal: cache fetch instruction calls in MCP server (7738ab8)
• internal: codegen related update (60e54a6)
• internal: codegen related update (5c368b8)
• internal: codegen related update (4178900)
• internal: fix MCP docker image builds in yarn projects (5f10f73)
• internal: fix MCP Dockerfiles so they can be built without buildkit (9dde351)
• internal: fix MCP Dockerfiles so they can be built without buildkit (62b9ad0)
• internal: fix MCP server TS errors that occur with required client options (14154e2)
• internal: improve layout of generated MCP server files (b2e0a75)
• internal: improve local docs search for MCP servers (ad984eb)
• internal: improve local docs search for MCP servers (d4db198)
• internal: make generated MCP servers compatible with Cloudflare worker environments (419e72f)
• internal: make MCP code execution location configurable via a flag (497c926)
• internal: move stringifyQuery implementation to internal function (60f7ea6)
• internal: refactor flag parsing for MCP servers and add debug flag (ff4b97e)
• internal: remove mock server code (f1deef8)
• internal: support custom-instructions-path flag in MCP servers (14dec19)
• internal: support local docs search in MCP servers (03eef26)
• internal: support oauth authorization code flow for MCP servers (5f6c688)
• internal: support type annotations when running MCP in local execution mode (bd8528f)
• internal: support x-stainless-mcp-client-envs header in MCP servers (6b2f378)
• internal: support x-stainless-mcp-client-permissions headers in MCP servers (6e75dad)
• internal: switch MCP servers to use pino for logging (f08d300)
• internal: tweak CI branches (aae2960)
• internal: update agents version (e39e377)
• internal: update dependencies to address dependabot vulnerabilities (c6f8d11)
• internal: update gitignore (d36a938)
• internal: upgrade @modelcontextprotocol/sdk and hono (446fc85)
• internal: upgrade hono (61a5d88)
• internal: use link instead of file in MCP server package.json files (4939cda)
  *...

v7.3.0

7.3.0 (2026-02-02)

Full Changelog: v7.2.2...v7.3.0

Features

• api: add customMetadata property to folder schema (e51825b)

Bug Fixes

• api: add missing embeddedMetadata and video properties to FileDetails (6100f86)

v7.2.2

7.2.2 (2026-01-29)

Full Changelog: v7.2.1...v7.2.2

Bug Fixes

• docs: fix mcp installation instructions for remote servers (ee47d5b)
• mcp: allow falling back for required env variables (f028ce8)
• overlay: update subtitle overlay parameter to plural form (22f0dfb)

Chores

• ci: upgrade actions/github-script (0f7befe)
• internal: codegen related update (5adb9c4)
• internal: codegen related update (4a66092)
• internal: codegen related update (20d55fc)
• internal: update lock file (1a431a8)
• internal: upgrade wrangler version (3042a38)
• mcp: up tsconfig lib version to es2022 (f9bd7c0)

v7.2.1

7.2.1 (2026-01-20)

Full Changelog: v7.2.0...v7.2.1

Bug Fixes

• vocab field is required (e6d0e58)

Chores

• internal: update actions/checkout version (6f64673)

v7.2.0

7.2.0 (2026-01-16)

Full Changelog: v7.1.1...v7.2.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: add GetImageAttributesOptions and ResponsiveImageAttributes schemas; update resource references in main.yaml; remove dummy endpoint (9ea439a)
• api: Add saved extensions API and enhance transformation options (7916069)
• mcp: add detail field to docs search tool (f36d795)
• mcp: add typescript check to code execution tool (63ab735)
• mcp: enable optional code execution tool on http mcp servers (cc68e38)
• mcp: handle code mode calls in the Stainless API (eb22f08)
• mcp: return logs on code tool errors (6118fe4)
• saved-extensions: update example for creating saved extension to use AI tasks for fashion item categorization (79e535b)
• transformation: add colorReplace and distort transformations; update tests for new parameters (e59b5a7)

Bug Fixes

• add ai-tasks property to response schemas with enum values (370cf0f)
• docs: remove extraneous example object fields (a043056)
• mcp: add client instantiation options to code tool (967c8d9)
• mcpb: pin @anthropic-ai/mcpb version (d81e225)
• mcp: correct code tool API endpoint (f4d2b6c)
• mcp: correct code tool api output types (0371082)
• mcp: fix env parsing (b33b4e9)
• mcp: fix options parsing (de44ed6)
• mcp: pass base url to code tool (908fa87)
• mcp: return correct lines on typescript errors (aa7ae07)
• mcp: return tool execution error on api error (1e866f8)
• mcp: return tool execution error on jq failure (d1949db)
• mcp: update cloudflare worker host page (664a668)
• mcp: update code tool prompt (e3a5c5e)

Chores

• break long lines in snippets into multiline (011013e)
• client: fix logger property type (6269318)
• extract some types in mcp docs (de606ba)
• internal: bump MCP dependencies (7c9719e)
• internal: codegen related update (21edf78)
• internal: codegen related update (b42a623)
• internal: codegen related update (9c3b709)
• internal: codegen related update (1170954)
• internal: codegen related update (4b79947)
• internal: codegen related update (b6b0d1a)
• internal: codegen related update (26acc3a)
• internal: codegen related update (662aa87)
• internal: codegen related update (8c9026a)
• internal: grammar fix (it's -> its) (71e22a3)
• internal: upgrade babel, qs, js-yaml (6896958)
• internal: upgrade eslint (310bf0d)
• internal: use npm pack for build uploads (bdfd369)
• mcp code tool explicit error message when missing a run function (6678ee1)
• mcp: add friendlier MCP code tool errors on incorrect method invocations (636829d)
• mcp: add intent param to execute tool (fb2ca9e)
• mcp: add line numbers to code tool errors (25e4e59)
• mcp: clarify http auth error (00789ac)
• mcp: pass intent param to execute handler (ffd4b9f)
• mcp: remove deprecated tool schemes (b1a0e60)
• mcp: update lockfile (0703827)
• mcp: upgrade dependencies (7fcf371)
• mcp: upgrade jq-web (0750770)
• use latest @modelcontextprotocol/sdk (f7b9b4e)
• use structured error when code execution tool errors (451f306)

Documentation

• add MCP Server Package section to README with details on usage and versioning (5710576)
• mcp: add a README button for one-click add to Cursor (a7575d3)
• mcp: add a README link to add server to VS Code or Claude Code (2a90d28)
• prominently feature MCP server setup in root SDK readmes (80ce57e)
• remove MCP Server section from README ([df32859](df3285946139b100f60c812cf65...

v7.1.1

7.1.1 (2025-10-06)

Full Changelog: v7.1.0...v7.1.1

Features

• api: use scoped package for mcp server (af9b0f4)

Bug Fixes

• add missing 'color' parameter mapping for subtitle overlays transformation. (2c4a6d2)
• lint error (b320d6f)
• linting issues (3794fe5)
• update raw parameter example in README for clarity (e86beab)
• update serverConfig to include valid URLs and improve label descriptions (49d048f)

Chores

• configure new SDK language (33d1237)
• internal: remove .eslintcache (ec12af7)
• jsdoc: fix @link annotations to refer only to parts of the package‘s public interface (4332a7e)

Documentation

• update README to enhance Table of Contents and add raw transformations parameter (892d31c)

Refactors

• streamline transformation string handling in URL construction (6e99777)

v7.1.0

7.1.0 (2025-09-30)

Full Changelog: v7.0.1...v7.1.0

Features

• api: add path policy related non-breaking changes (d50cbcf)
• api: add selectedFieldsSchema in upload and list API response (ec8c8b8)
• api: fix upload API request params (467d77b)
• api: updated docs (962390f)
• mcp: add option for including docs tools (e1a3b52)

Bug Fixes

• mcp: fix cli argument parsing logic (a8da550)
• mcp: resolve a linting issue in server code (e805d24)

Performance Improvements

• faster formatting (7e8cfad)

Chores

• internal: codegen related update (ca24cab)
• internal: codegen related update (2acb106)
• internal: fix incremental formatting in some cases (863e6b7)
• internal: ignore .eslintcache (f991673)
• internal: remove deprecated compilerOptions.baseUrl from tsconfig.json (9e0e5b0)
• mcp: allow pointing docs_search tool at other URLs (bbe84b3)
• update lockfile (dcdc0b7)

Documentation

• correct typo in default value description for custom metadata field (a957209)
• fix link to deploy template in README (ba86045)

v7.0.1

7.0.1 (2025-09-21)

Full Changelog: v7.0.0...v7.0.1

Chores

• update SDK settings (0a6ec00)

v7.0.0

7.0.0 (2025-09-21)

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

Features

• add examples for URL generation and transformations in README (4bad591)
• add url signing and test cases (b1594d8)
• add webhook verification section to README with example code (b28d7b3)
• allow file parameter in FileUploadParams to accept string type for HTTP URL base base64 case. (738f6d9)
• api: add ai-auto-description field with status options to components schema (96c640d)
• api: add BaseWebhookEvent (dac30e1)
• api: add new webhook events for upload transformations to enhance event tracking (dd98040)
• api: add signed URL options with expiration settings to enhance security features (55d2dd1)
• api: extract UpdateFileDetailsRequest to model (30d976b)
• api: manual updates (608ef99)
• api: manual updates (d0d45ee)
• api: manual updates (78f9507)
• api: manual updates (af5fd2f)
• api: manual updates (2ac7656)
• api: manual updates (d208673)
• api: manual updates (76f3ed7)
• api: manual updates (01bdaa0)
• api: manual updates (9d913fa)
• api: manual updates (dc932e3)
• api: manual updates (50c8520)
• api: manual updates (1d0423a)
• api: manual updates (64fc454)
• api: manual updates (f70d1c2)
• api: manual updates (4efbfee)
• api: manual updates (174eee8)
• api: manual updates (1b740df)
• api: manual updates (636a5a9)
• api: manual updates (c1bc59b)
• api: manual updates (4d7286a)
• api: manual updates (8986981)
• api: manual updates (693e3cf)
• api: manual updates (ace1909)
• api: remove Stainless attribution from readme (454c722)
• api: update api docs link (34d2eb1)
• api: Update env var name (70c98e0)
• docs: add URL generation examples and authentication parameters to README (7a2bc8f)
• docs: improve descriptions for private API key and password fields in client settings (7ab6b37)
• helper: implement getAuthenticationParameters method and test cases (297bb95)
• implement serializeUploadOptions function for upload option serialization and add tests (cfce32f)
• remove password field from ImageKit client initialization in tests and documentation (08a5744)
• tests: add test for transformationPosition as path in signed URL generation (2f37641)
• tests: add tests for transformation handling with absolute URLs and non-default endpoints (188eeee)
• update README to enhance SDK description and usage examples (e1e5abf)
• webhooks: use toBase64 for webhook key in verification (433eb44)
• webhooks: use toBase64 for webhook key in verification (3d0571d)

Bug Fixes

• 24 (5610765)
• add repository details for package (b9e4231)
• added folder object in ListFileResponse (#106) (bfcfbb9)
• coerce nullable values to undefined (66e3b81)
• correct SDK description in package.json (f5d2713)
• docs: add missing commas in URL generation examples for clarity (21caa93)
• package: removed unnecessary types and install-types package (a254d4b)
• update privateAPIKey to privateKey in code and tests (2f93b89)
• updated signed url generations for urls with symbols and unicode characters (#102) (5e264de)
• webhooks: revert toBase64 conversion for webhook key (13c716e)

Chores

• bumped package version to 6.0.0 (85c7ef3)
• ci build action (06a9882)
• do not install brew dependencies in ./scripts/bootstrap by default (69968b1)
• esm: Improved Support for ES Modules (5a4127f)
• lint and format fix ([788885c](788885c3cc5e88341...

Version 6.0.0

What's Changed

• Feature/code enhance: Code enhancement and proper documentation by @vikramparihar in #103
• fix url for ' by @ankur-dwivedi in #102
• fix: added folder object in ListFileResponse by @ahnv in #106
  • This is a breaking change, please refer to ChangeLog for more details

New Contributors

• @vikramparihar made their first contribution in #103

Full Changelog: 5.2.0...6.0.0