Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
51 commits
Select commit Hold shift + click to select a range
bdfd369
chore(internal): use npm pack for build uploads
stainless-app[bot] Oct 6, 2025
de606ba
chore: extract some types in mcp docs
stainless-app[bot] Oct 8, 2025
9ea439a
feat(api): add GetImageAttributesOptions and ResponsiveImageAttribute…
stainless-app[bot] Oct 21, 2025
34840d0
codegen metadata
stainless-app[bot] Oct 21, 2025
e5bc430
codegen metadata
stainless-app[bot] Oct 30, 2025
94fff85
codegen metadata
stainless-app[bot] Oct 30, 2025
b700dc8
codegen metadata
stainless-app[bot] Oct 30, 2025
d81e225
fix(mcpb): pin @anthropic-ai/mcpb version
stainless-app[bot] Oct 30, 2025
71e22a3
chore(internal): grammar fix (it's -> its)
stainless-app[bot] Nov 3, 2025
451f306
chore: use structured error when code execution tool errors
stainless-app[bot] Nov 3, 2025
6678ee1
chore: mcp code tool explicit error message when missing a run function
stainless-app[bot] Nov 4, 2025
cc68e38
feat(mcp): enable optional code execution tool on http mcp servers
stainless-app[bot] Nov 4, 2025
636829d
chore(mcp): add friendlier MCP code tool errors on incorrect method i…
stainless-app[bot] Nov 5, 2025
25e4e59
chore(mcp): add line numbers to code tool errors
stainless-app[bot] Nov 5, 2025
a7575d3
docs(mcp): add a README button for one-click add to Cursor
stainless-app[bot] Nov 5, 2025
8c9026a
chore(internal): codegen related update
stainless-app[bot] Nov 6, 2025
2a90d28
docs(mcp): add a README link to add server to VS Code or Claude Code
stainless-app[bot] Nov 6, 2025
662aa87
chore(internal): codegen related update
stainless-app[bot] Nov 7, 2025
00789ac
chore(mcp): clarify http auth error
stainless-app[bot] Nov 10, 2025
d1949db
fix(mcp): return tool execution error on jq failure
stainless-app[bot] Nov 12, 2025
0750770
chore(mcp): upgrade jq-web
stainless-app[bot] Nov 12, 2025
f36d795
feat(mcp): add detail field to docs search tool
stainless-app[bot] Nov 25, 2025
6269318
chore(client): fix logger property type
stainless-app[bot] Dec 1, 2025
1e866f8
fix(mcp): return tool execution error on api error
stainless-app[bot] Dec 1, 2025
6118fe4
feat(mcp): return logs on code tool errors
stainless-app[bot] Dec 1, 2025
310bf0d
chore(internal): upgrade eslint
stainless-app[bot] Dec 2, 2025
f7b9b4e
chore: use latest @modelcontextprotocol/sdk
stainless-app[bot] Dec 4, 2025
63ab735
feat(mcp): add typescript check to code execution tool
stainless-app[bot] Dec 4, 2025
eb22f08
feat(mcp): handle code mode calls in the Stainless API
stainless-app[bot] Dec 5, 2025
aa7ae07
fix(mcp): return correct lines on typescript errors
stainless-app[bot] Dec 5, 2025
26acc3a
chore(internal): codegen related update
stainless-app[bot] Dec 5, 2025
f4d2b6c
fix(mcp): correct code tool API endpoint
stainless-app[bot] Dec 5, 2025
b6b0d1a
chore(internal): codegen related update
stainless-app[bot] Dec 5, 2025
570f4c4
codegen metadata
stainless-app[bot] Dec 8, 2025
08984d1
codegen metadata
stainless-app[bot] Dec 8, 2025
967c8d9
fix(mcp): add client instantiation options to code tool
stainless-app[bot] Dec 10, 2025
0703827
chore(mcp): update lockfile
stainless-app[bot] Dec 10, 2025
a043056
fix(docs): remove extraneous example object fields
stainless-app[bot] Dec 11, 2025
08a69fe
codegen metadata
stainless-app[bot] Dec 12, 2025
9bc0245
codegen metadata
stainless-app[bot] Dec 12, 2025
ebb95af
codegen metadata
stainless-app[bot] Dec 12, 2025
908fa87
fix(mcp): pass base url to code tool
stainless-app[bot] Dec 17, 2025
b1a0e60
chore(mcp)!: remove deprecated tool schemes
stainless-app[bot] Dec 18, 2025
4b79947
chore(internal): codegen related update
stainless-app[bot] Jan 5, 2026
80ce57e
docs: prominently feature MCP server setup in root SDK readmes
stainless-app[bot] Jan 5, 2026
0371082
fix(mcp): correct code tool api output types
stainless-app[bot] Jan 5, 2026
664a668
fix(mcp): update cloudflare worker host page
stainless-app[bot] Jan 6, 2026
011013e
chore: break long lines in snippets into multiline
stainless-app[bot] Jan 6, 2026
de44ed6
fix(mcp): fix options parsing
stainless-app[bot] Jan 6, 2026
b33b4e9
fix(mcp): fix env parsing
stainless-app[bot] Jan 7, 2026
20154fe
release: 8.0.0
stainless-app[bot] Jan 7, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .release-please-manifest.json
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
{
".": "7.1.1"
".": "8.0.0"
}
6 changes: 3 additions & 3 deletions .stats.yml
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
configured_endpoints: 42
openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/imagekit-inc%2Fimagekit-c7ad6f552b38f2145781847f8b390fa1ec43068d64e45a33012a97a9299edc10.yml
openapi_spec_hash: 50f281e91210ad5018ac7e4eee216f56
config_hash: 74a8263b80c732a2b016177e7d56bb9c
openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/imagekit-inc%2Fimagekit-9d184cb502ab32a85db2889c796cdfebe812f2a55a604df79c85dd4b5e7e2add.yml
openapi_spec_hash: a9aa620376fce66532c84f9364209b0b
config_hash: 71cab8223bb5610c6c7ca6e9c4cc1f89
65 changes: 65 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,70 @@
# Changelog

## 8.0.0 (2026-01-07)

Full Changelog: [v7.1.1...v8.0.0](https://github.com/imagekit-developer/imagekit-nodejs/compare/v7.1.1...v8.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:** add GetImageAttributesOptions and ResponsiveImageAttributes schemas; update resource references in main.yaml; remove dummy endpoint ([9ea439a](https://github.com/imagekit-developer/imagekit-nodejs/commit/9ea439a2d0a4c8300d14d4424dc72ab40a67c4d4))
* **mcp:** add detail field to docs search tool ([f36d795](https://github.com/imagekit-developer/imagekit-nodejs/commit/f36d79523b0613a27afd45d56f4e1e906e6fdfe9))
* **mcp:** add typescript check to code execution tool ([63ab735](https://github.com/imagekit-developer/imagekit-nodejs/commit/63ab735bf6c8458a53bd66c8c437b45a7aef60fe))
* **mcp:** enable optional code execution tool on http mcp servers ([cc68e38](https://github.com/imagekit-developer/imagekit-nodejs/commit/cc68e38fa61078db6a5c961e7ed75dad342dc7e8))
* **mcp:** handle code mode calls in the Stainless API ([eb22f08](https://github.com/imagekit-developer/imagekit-nodejs/commit/eb22f0883fc74c94959fdd97e50d41d940e1aed6))
* **mcp:** return logs on code tool errors ([6118fe4](https://github.com/imagekit-developer/imagekit-nodejs/commit/6118fe4804be492482268ff25e0afc714bea7613))


### Bug Fixes

* **docs:** remove extraneous example object fields ([a043056](https://github.com/imagekit-developer/imagekit-nodejs/commit/a043056abd2f86bcb5a691ac8f5c7ccf8a17663c))
* **mcp:** add client instantiation options to code tool ([967c8d9](https://github.com/imagekit-developer/imagekit-nodejs/commit/967c8d90503b2e0ed0576b919be09f3b924ec890))
* **mcpb:** pin @anthropic-ai/mcpb version ([d81e225](https://github.com/imagekit-developer/imagekit-nodejs/commit/d81e22560aab772ee9b241fb44a50561b8837034))
* **mcp:** correct code tool API endpoint ([f4d2b6c](https://github.com/imagekit-developer/imagekit-nodejs/commit/f4d2b6c9989e8cc6c69badba7de0abb57e6de398))
* **mcp:** correct code tool api output types ([0371082](https://github.com/imagekit-developer/imagekit-nodejs/commit/03710823b0d477506a6a321c8aa68cba1a95e452))
* **mcp:** fix env parsing ([b33b4e9](https://github.com/imagekit-developer/imagekit-nodejs/commit/b33b4e9c4f595d850403d292057e5d0810303e62))
* **mcp:** fix options parsing ([de44ed6](https://github.com/imagekit-developer/imagekit-nodejs/commit/de44ed62ad53d22aa4b196ca2416d33d784242ee))
* **mcp:** pass base url to code tool ([908fa87](https://github.com/imagekit-developer/imagekit-nodejs/commit/908fa874d20613761caa76cd4b2151524ef87606))
* **mcp:** return correct lines on typescript errors ([aa7ae07](https://github.com/imagekit-developer/imagekit-nodejs/commit/aa7ae07286cf492a7b1fecce34697006837beeef))
* **mcp:** return tool execution error on api error ([1e866f8](https://github.com/imagekit-developer/imagekit-nodejs/commit/1e866f8e5254ecc305b3dfee53ec232455143cc4))
* **mcp:** return tool execution error on jq failure ([d1949db](https://github.com/imagekit-developer/imagekit-nodejs/commit/d1949dbef79859b446ee9ee2c8a2d562568c1cca))
* **mcp:** update cloudflare worker host page ([664a668](https://github.com/imagekit-developer/imagekit-nodejs/commit/664a6686e0b268c2b3d3985508c744358b937cf3))


### Chores

* break long lines in snippets into multiline ([011013e](https://github.com/imagekit-developer/imagekit-nodejs/commit/011013e6bac4c2ca8c6253d3ef482641bb089560))
* **client:** fix logger property type ([6269318](https://github.com/imagekit-developer/imagekit-nodejs/commit/6269318024cd320f3038def32c3d5bf1f1da77a1))
* extract some types in mcp docs ([de606ba](https://github.com/imagekit-developer/imagekit-nodejs/commit/de606ba3b734389e1c52a9929dbf8487828822e0))
* **internal:** codegen related update ([4b79947](https://github.com/imagekit-developer/imagekit-nodejs/commit/4b79947c8eb22cf9c609da4efd9ea703caea0c41))
* **internal:** codegen related update ([b6b0d1a](https://github.com/imagekit-developer/imagekit-nodejs/commit/b6b0d1a7d2f00d9ecaa9e0e630a012c25f6a00f4))
* **internal:** codegen related update ([26acc3a](https://github.com/imagekit-developer/imagekit-nodejs/commit/26acc3a9fe08c7c478eed956dd553333bd8cf210))
* **internal:** codegen related update ([662aa87](https://github.com/imagekit-developer/imagekit-nodejs/commit/662aa87091dc519bb811554438eaf978660d035e))
* **internal:** codegen related update ([8c9026a](https://github.com/imagekit-developer/imagekit-nodejs/commit/8c9026ace5d217264e5753c01309a02a2c09095e))
* **internal:** grammar fix (it's -> its) ([71e22a3](https://github.com/imagekit-developer/imagekit-nodejs/commit/71e22a30017324842fed5ab08ee1efbb1eecb6d2))
* **internal:** upgrade eslint ([310bf0d](https://github.com/imagekit-developer/imagekit-nodejs/commit/310bf0d0cc1d5b15d08a2cbb483a9969ebf4f11d))
* **internal:** use npm pack for build uploads ([bdfd369](https://github.com/imagekit-developer/imagekit-nodejs/commit/bdfd369118542dad02cf8a0fae8713d0d8bea4eb))
* mcp code tool explicit error message when missing a run function ([6678ee1](https://github.com/imagekit-developer/imagekit-nodejs/commit/6678ee13cc1eee5ce1ac51b672144be77c38e9ea))
* **mcp:** add friendlier MCP code tool errors on incorrect method invocations ([636829d](https://github.com/imagekit-developer/imagekit-nodejs/commit/636829d18a7dda730b65c0549298258afcea6341))
* **mcp:** add line numbers to code tool errors ([25e4e59](https://github.com/imagekit-developer/imagekit-nodejs/commit/25e4e59f434c07c2d9afeef3f548dd99e250a7ab))
* **mcp:** clarify http auth error ([00789ac](https://github.com/imagekit-developer/imagekit-nodejs/commit/00789acfb9ceb07af0cd03b1951090f430691592))
* **mcp:** remove deprecated tool schemes ([b1a0e60](https://github.com/imagekit-developer/imagekit-nodejs/commit/b1a0e607e55f27ffed93b2862e8f4466bc609809))
* **mcp:** update lockfile ([0703827](https://github.com/imagekit-developer/imagekit-nodejs/commit/07038271d5ec459516a8a936eb49f31490ccf6b0))
* **mcp:** upgrade jq-web ([0750770](https://github.com/imagekit-developer/imagekit-nodejs/commit/075077081fc5826a4502a76a2abc40788f7915a3))
* use latest @modelcontextprotocol/sdk ([f7b9b4e](https://github.com/imagekit-developer/imagekit-nodejs/commit/f7b9b4e55919b644d9445730c03c8972ecdfe0b7))
* use structured error when code execution tool errors ([451f306](https://github.com/imagekit-developer/imagekit-nodejs/commit/451f306f6328e6c48374d0525dad9a0ddc6511d6))


### Documentation

* **mcp:** add a README button for one-click add to Cursor ([a7575d3](https://github.com/imagekit-developer/imagekit-nodejs/commit/a7575d308e3038715964f7416284bb012e27b240))
* **mcp:** add a README link to add server to VS Code or Claude Code ([2a90d28](https://github.com/imagekit-developer/imagekit-nodejs/commit/2a90d2802e4814d97ec5bba77097eec2f0a5a718))
* prominently feature MCP server setup in root SDK readmes ([80ce57e](https://github.com/imagekit-developer/imagekit-nodejs/commit/80ce57e3dee9eb822c8251ee8ed1c66afcfc156a))

## 7.1.1 (2025-10-06)

Full Changelog: [v7.1.0...v7.1.1](https://github.com/imagekit-developer/imagekit-nodejs/compare/v7.1.0...v7.1.1)
Expand Down
2 changes: 1 addition & 1 deletion LICENSE
Original file line number Diff line number Diff line change
Expand Up @@ -186,7 +186,7 @@
same "printed page" as the copyright notice for easier
identification within third-party archives.

Copyright 2025 Image Kit
Copyright 2026 Image Kit

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
Expand Down
19 changes: 17 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -40,6 +40,15 @@ If you are looking to integrate file uploads in browsers, use one of our [fronte
- [Requirements](#requirements)
- [Contributing](#contributing)

## MCP Server

Use the Image Kit MCP Server to enable AI assistants to interact with this API, allowing them to explore endpoints, make test requests, and use documentation to help integrate this SDK into your application.

[![Add to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en-US/install-mcp?name=%40imagekit%2Fapi-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBpbWFnZWtpdC9hcGktbWNwIl19)
[![Install in VS Code](https://img.shields.io/badge/_-Add_to_VS_Code-blue?style=for-the-badge&logo=data:image/svg%2bxml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIGZpbGw9Im5vbmUiIHZpZXdCb3g9IjAgMCA0MCA0MCI+PHBhdGggZmlsbD0iI0VFRSIgZmlsbC1ydWxlPSJldmVub2RkIiBkPSJNMzAuMjM1IDM5Ljg4NGEyLjQ5MSAyLjQ5MSAwIDAgMS0xLjc4MS0uNzNMMTIuNyAyNC43OGwtMy40NiAyLjYyNC0zLjQwNiAyLjU4MmExLjY2NSAxLjY2NSAwIDAgMS0xLjA4Mi4zMzggMS42NjQgMS42NjQgMCAwIDEtMS4wNDYtLjQzMWwtMi4yLTJhMS42NjYgMS42NjYgMCAwIDEgMC0yLjQ2M0w3LjQ1OCAyMCA0LjY3IDE3LjQ1MyAxLjUwNyAxNC41N2ExLjY2NSAxLjY2NSAwIDAgMSAwLTIuNDYzbDIuMi0yYTEuNjY1IDEuNjY1IDAgMCAxIDIuMTMtLjA5N2w2Ljg2MyA1LjIwOUwyOC40NTIuODQ0YTIuNDg4IDIuNDg4IDAgMCAxIDEuODQxLS43MjljLjM1MS4wMDkuNjk5LjA5MSAxLjAxOS4yNDVsOC4yMzYgMy45NjFhMi41IDIuNSAwIDAgMSAxLjQxNSAyLjI1M3YuMDk5LS4wNDVWMzMuMzd2LS4wNDUuMDk1YTIuNTAxIDIuNTAxIDAgMCAxLTEuNDE2IDIuMjU3bC04LjIzNSAzLjk2MWEyLjQ5MiAyLjQ5MiAwIDAgMS0xLjA3Ny4yNDZabS43MTYtMjguOTQ3LTExLjk0OCA5LjA2MiAxMS45NTIgOS4wNjUtLjAwNC0xOC4xMjdaIi8+PC9zdmc+)](https://vscode.stainless.com/mcp/%7B%22name%22%3A%22%40imagekit%2Fapi-mcp%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40imagekit%2Fapi-mcp%22%5D%7D)

> Note: You may need to set environment variables in your MCP client.

## Installation

```sh
Expand Down Expand Up @@ -112,8 +121,14 @@ await client.files.upload({ file: new File(['my bytes'], 'file'), fileName: 'fil
await client.files.upload({ file: await fetch('https://somesite/file'), fileName: 'fileName' });

// Finally, if none of the above are convenient, you can use our `toFile` helper:
await client.files.upload({ file: await toFile(Buffer.from('my bytes'), 'file'), fileName: 'fileName' });
await client.files.upload({ file: await toFile(new Uint8Array([0, 1, 2]), 'file'), fileName: 'fileName' });
await client.files.upload({
file: await toFile(Buffer.from('my bytes'), 'file'),
fileName: 'fileName',
});
await client.files.upload({
file: await toFile(new Uint8Array([0, 1, 2]), 'file'),
fileName: 'fileName',
});
```

## URL generation
Expand Down
2 changes: 2 additions & 0 deletions api.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,10 +4,12 @@ Types:

- <code><a href="./src/resources/shared.ts">BaseOverlay</a></code>
- <code><a href="./src/resources/shared.ts">Extensions</a></code>
- <code><a href="./src/resources/shared.ts">GetImageAttributesOptions</a></code>
- <code><a href="./src/resources/shared.ts">ImageOverlay</a></code>
- <code><a href="./src/resources/shared.ts">Overlay</a></code>
- <code><a href="./src/resources/shared.ts">OverlayPosition</a></code>
- <code><a href="./src/resources/shared.ts">OverlayTiming</a></code>
- <code><a href="./src/resources/shared.ts">ResponsiveImageAttributes</a></code>
- <code><a href="./src/resources/shared.ts">SolidColorOverlay</a></code>
- <code><a href="./src/resources/shared.ts">SolidColorOverlayTransformation</a></code>
- <code><a href="./src/resources/shared.ts">SrcOptions</a></code>
Expand Down
4 changes: 2 additions & 2 deletions package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "@imagekit/nodejs",
"version": "7.1.1",
"version": "8.0.0",
"description": "Offical NodeJS SDK for ImageKit.io integration",
"author": "Image Kit <developer@imagekit.io>",
"types": "dist/index.d.ts",
Expand Down Expand Up @@ -37,7 +37,7 @@
"@types/node": "^20.17.6",
"@typescript-eslint/eslint-plugin": "8.31.1",
"@typescript-eslint/parser": "8.31.1",
"eslint": "^9.20.1",
"eslint": "^9.39.1",
"eslint-plugin-prettier": "^5.4.1",
"eslint-plugin-unused-imports": "^4.1.4",
"iconv-lite": "^0.6.3",
Expand Down
Loading