@imagekit/api-mcp 7.1.1

package/src/tools/files/upload-files.ts

@@ -0,0 +1,332 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { Metadata, asTextContentResult } from '@imagekit/api-mcp/tools/types';
+
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import ImageKit from '@imagekit/nodejs';
+
+export const metadata: Metadata = {
+  resource: 'files',
+  operation: 'write',
+  tags: [],
+  httpMethod: 'post',
+  httpPath: '/api/v1/files/upload',
+  operationId: 'upload-file',
+};
+
+export const tool: Tool = {
+  name: 'upload_files',
+  description:
+    'ImageKit.io allows you to upload files directly from both the server and client sides. For server-side uploads, private API key authentication is used. For client-side uploads, generate a one-time `token`, `signature`, and `expire` from your secure backend using private API. [Learn more](/docs/api-reference/upload-file/upload-file#how-to-implement-client-side-file-upload) about how to implement client-side file upload.\n\nThe [V2 API](/docs/api-reference/upload-file/upload-file-v2) enhances security by verifying the entire payload using JWT.\n\n**File size limit** \\\nOn the free plan, the maximum upload file sizes are 20MB for images, audio, and raw files and 100MB for videos. On the paid plan, these limits increase to 40MB for images, audio, and raw files and 2GB for videos. These limits can be further increased with higher-tier plans.\n\n**Version limit** \\\nA file can have a maximum of 100 versions.\n\n**Demo applications**\n\n- A full-fledged [upload widget using Uppy](https://github.com/imagekit-samples/uppy-uploader), supporting file selections from local storage, URL, Dropbox, Google Drive, Instagram, and more.\n- [Quick start guides](/docs/quick-start-guides) for various frameworks and technologies.\n',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      file: {
+        type: 'string',
+        description:
+          'The API accepts any of the following:\n\n- **Binary data** – send the raw bytes as `multipart/form-data`.\n- **HTTP / HTTPS URL** – a publicly reachable URL that ImageKit’s servers can fetch.\n- **Base64 string** – the file encoded as a Base64 data URI or plain Base64.\n\nWhen supplying a URL, the server must receive the response headers within 8 seconds; otherwise the request fails with 400 Bad Request.\n',
+      },
+      fileName: {
+        type: 'string',
+        description:
+          'The name with which the file has to be uploaded.\nThe file name can contain:\n\n  - Alphanumeric Characters: `a-z`, `A-Z`, `0-9`.\n  - Special Characters: `.`, `-`\n\nAny other character including space will be replaced by `_`\n',
+      },
+      token: {
+        type: 'string',
+        description:
+          'A unique value that the ImageKit.io server will use to recognize and prevent subsequent retries for the same request. We suggest using V4 UUIDs, or another random string with enough entropy to avoid collisions. This field is only required for authentication when uploading a file from the client side.\n\n**Note**: Sending a value that has been used in the past will result in a validation error. Even if your previous request resulted in an error, you should always send a new value for this field.\n',
+      },
+      checks: {
+        type: 'string',
+        description:
+          'Server-side checks to run on the asset.\nRead more about [Upload API checks](/docs/api-reference/upload-file/upload-file#upload-api-checks).\n',
+      },
+      customCoordinates: {
+        type: 'string',
+        description:
+          'Define an important area in the image. This is only relevant for image type files.\n\n  - To be passed as a string with the x and y coordinates of the top-left corner, and width and height of the area of interest in the format `x,y,width,height`. For example - `10,10,100,100`\n  - Can be used with fo-customtransformation.\n  - If this field is not specified and the file is overwritten, then customCoordinates will be removed.\n',
+      },
+      customMetadata: {
+        type: 'object',
+        description:
+          'JSON key-value pairs to associate with the asset. Create the custom metadata fields before setting these values.\n',
+        additionalProperties: true,
+      },
+      description: {
+        type: 'string',
+        description: 'Optional text to describe the contents of the file.\n',
+      },
+      expire: {
+        type: 'integer',
+        description:
+          'The time until your signature is valid. It must be a [Unix time](https://en.wikipedia.org/wiki/Unix_time) in less than 1 hour into the future. It should be in seconds. This field is only required for authentication when uploading a file from the client side.\n',
+      },
+      extensions: {
+        $ref: '#/$defs/extensions',
+      },
+      folder: {
+        type: 'string',
+        description:
+          "The folder path in which the image has to be uploaded. If the folder(s) didn't exist before, a new folder(s) is created.\n\nThe folder name can contain:\n\n  - Alphanumeric Characters: `a-z` , `A-Z` , `0-9`\n  - Special Characters: `/` , `_` , `-`\n\nUsing multiple `/` creates a nested folder.\n",
+      },
+      isPrivateFile: {
+        type: 'boolean',
+        description:
+          'Whether to mark the file as private or not.\n\nIf `true`, the file is marked as private and is accessible only using named transformation or signed URL.\n',
+      },
+      isPublished: {
+        type: 'boolean',
+        description:
+          'Whether to upload file as published or not.\n\nIf `false`, the file is marked as unpublished, which restricts access to the file only via the media library. Files in draft or unpublished state can only be publicly accessed after being published.\n\nThe option to upload in draft state is only available in custom enterprise pricing plans.\n',
+      },
+      overwriteAITags: {
+        type: 'boolean',
+        description:
+          'If set to `true` and a file already exists at the exact location, its AITags will be removed. Set `overwriteAITags` to `false` to preserve AITags.\n',
+      },
+      overwriteCustomMetadata: {
+        type: 'boolean',
+        description:
+          'If the request does not have `customMetadata`, and a file already exists at the exact location, existing customMetadata will be removed.\n',
+      },
+      overwriteFile: {
+        type: 'boolean',
+        description:
+          'If `false` and `useUniqueFileName` is also `false`, and a file already exists at the exact location, upload API will return an error immediately.\n',
+      },
+      overwriteTags: {
+        type: 'boolean',
+        description:
+          'If the request does not have `tags`, and a file already exists at the exact location, existing tags will be removed.\n',
+      },
+      publicKey: {
+        type: 'string',
+        description:
+          'Your ImageKit.io public key. This field is only required for authentication when uploading a file from the client side.\n',
+      },
+      responseFields: {
+        type: 'array',
+        description: 'Array of response field keys to include in the API response body.\n',
+        items: {
+          type: 'string',
+          enum: [
+            'tags',
+            'customCoordinates',
+            'isPrivateFile',
+            'embeddedMetadata',
+            'isPublished',
+            'customMetadata',
+            'metadata',
+            'selectedFieldsSchema',
+          ],
+        },
+      },
+      signature: {
+        type: 'string',
+        description:
+          'HMAC-SHA1 digest of the token+expire using your ImageKit.io private API key as a key. Learn how to create a signature on the page below. This should be in lowercase.\n\nSignature must be calculated on the server-side. This field is only required for authentication when uploading a file from the client side.\n',
+      },
+      tags: {
+        type: 'array',
+        description:
+          'Set the tags while uploading the file.\nProvide an array of tag strings (e.g. `["tag1", "tag2", "tag3"]`). The combined length of all tag characters must not exceed 500, and the `%` character is not allowed.\nIf this field is not specified and the file is overwritten, the existing tags will be removed.\n',
+        items: {
+          type: 'string',
+        },
+      },
+      transformation: {
+        type: 'object',
+        description:
+          "Configure pre-processing (`pre`) and post-processing (`post`) transformations.\n\n- `pre` — applied before the file is uploaded to the Media Library.  \n  Useful for reducing file size or applying basic optimizations upfront (e.g., resize, compress).\n\n- `post` — applied immediately after upload.  \n  Ideal for generating transformed versions (like video encodes or thumbnails) in advance, so they're ready for delivery without delay.\n\nYou can mix and match any combination of post-processing types.\n",
+        properties: {
+          post: {
+            type: 'array',
+            description:
+              'List of transformations to apply *after* the file is uploaded.  \nEach item must match one of the following types:\n`transformation`, `gif-to-video`, `thumbnail`, `abs`.\n',
+            items: {
+              anyOf: [
+                {
+                  type: 'object',
+                  title: 'Simple post-transformation',
+                  properties: {
+                    type: {
+                      type: 'string',
+                      description: 'Transformation type.',
+                      enum: ['transformation'],
+                    },
+                    value: {
+                      type: 'string',
+                      description:
+                        'Transformation string (e.g. `w-200,h-200`).  \nSame syntax as ImageKit URL-based transformations.\n',
+                    },
+                  },
+                  required: ['type', 'value'],
+                },
+                {
+                  type: 'object',
+                  title: 'Convert GIF to video',
+                  properties: {
+                    type: {
+                      type: 'string',
+                      description: 'Converts an animated GIF into an MP4.',
+                      enum: ['gif-to-video'],
+                    },
+                    value: {
+                      type: 'string',
+                      description:
+                        'Optional transformation string to apply to the output video.  \n**Example**: `q-80`\n',
+                    },
+                  },
+                  required: ['type'],
+                },
+                {
+                  type: 'object',
+                  title: 'Generate a thumbnail',
+                  properties: {
+                    type: {
+                      type: 'string',
+                      description: 'Generates a thumbnail image.',
+                      enum: ['thumbnail'],
+                    },
+                    value: {
+                      type: 'string',
+                      description: 'Optional transformation string.  \n**Example**: `w-150,h-150`\n',
+                    },
+                  },
+                  required: ['type'],
+                },
+                {
+                  type: 'object',
+                  title: 'Adaptive Bitrate Streaming',
+                  properties: {
+                    protocol: {
+                      type: 'string',
+                      description: 'Streaming protocol to use (`hls` or `dash`).',
+                      enum: ['hls', 'dash'],
+                    },
+                    type: {
+                      type: 'string',
+                      description: 'Adaptive Bitrate Streaming (ABS) setup.',
+                      enum: ['abs'],
+                    },
+                    value: {
+                      type: 'string',
+                      description:
+                        'List of different representations you want to create separated by an underscore.\n',
+                    },
+                  },
+                  required: ['protocol', 'type', 'value'],
+                },
+              ],
+            },
+          },
+          pre: {
+            type: 'string',
+            description:
+              'Transformation string to apply before uploading the file to the Media Library. Useful for optimizing files at ingestion.\n',
+          },
+        },
+      },
+      useUniqueFileName: {
+        type: 'boolean',
+        description:
+          'Whether to use a unique filename for this file or not.\n\nIf `true`, ImageKit.io will add a unique suffix to the filename parameter to get a unique filename.\n\nIf `false`, then the image is uploaded with the provided filename parameter, and any existing file with the same name is replaced.\n',
+      },
+      webhookUrl: {
+        type: 'string',
+        description:
+          'The final status of extensions after they have completed execution will be delivered to this endpoint as a POST request. [Learn more](/docs/api-reference/digital-asset-management-dam/managing-assets/update-file-details#webhook-payload-structure) about the webhook payload structure.\n',
+      },
+    },
+    required: ['file', 'fileName'],
+    $defs: {
+      extensions: {
+        type: 'array',
+        title: 'Extensions Array',
+        description:
+          'Array of extensions to be applied to the asset. Each extension can be configured with specific parameters based on the extension type.\n',
+        items: {
+          anyOf: [
+            {
+              type: 'object',
+              title: 'Remove background',
+              properties: {
+                name: {
+                  type: 'string',
+                  description: 'Specifies the background removal extension.',
+                  enum: ['remove-bg'],
+                },
+                options: {
+                  type: 'object',
+                  properties: {
+                    add_shadow: {
+                      type: 'boolean',
+                      description:
+                        'Whether to add an artificial shadow to the result. Default is false. Note: Adding shadows is currently only supported for car photos.\n',
+                    },
+                    bg_color: {
+                      type: 'string',
+                      description:
+                        'Specifies a solid color background using hex code (e.g., "81d4fa", "fff") or color name (e.g., "green"). If this parameter is set, `bg_image_url` must be empty.\n',
+                    },
+                    bg_image_url: {
+                      type: 'string',
+                      description:
+                        'Sets a background image from a URL. If this parameter is set, `bg_color` must be empty.\n',
+                    },
+                    semitransparency: {
+                      type: 'boolean',
+                      description:
+                        'Allows semi-transparent regions in the result. Default is true. Note: Semitransparency is currently only supported for car windows.\n',
+                    },
+                  },
+                },
+              },
+              required: ['name'],
+            },
+            {
+              type: 'object',
+              title: 'Auto tagging',
+              properties: {
+                maxTags: {
+                  type: 'integer',
+                  description: 'Maximum number of tags to attach to the asset.',
+                },
+                minConfidence: {
+                  type: 'integer',
+                  description: 'Minimum confidence level for tags to be considered valid.',
+                },
+                name: {
+                  type: 'string',
+                  description: 'Specifies the auto-tagging extension used.',
+                  enum: ['google-auto-tagging', 'aws-auto-tagging'],
+                },
+              },
+              required: ['maxTags', 'minConfidence', 'name'],
+            },
+            {
+              type: 'object',
+              title: 'Auto description',
+              properties: {
+                name: {
+                  type: 'string',
+                  description: 'Specifies the auto description extension.',
+                  enum: ['ai-auto-description'],
+                },
+              },
+              required: ['name'],
+            },
+          ],
+        },
+      },
+    },
+  },
+  annotations: {},
+};
+
+export const handler = async (client: ImageKit, args: Record<string, unknown> | undefined) => {
+  const body = args as any;
+  return asTextContentResult(await client.files.upload(body));
+};
+
+export default { metadata, tool, handler };

package/src/tools/files/versions/delete-files-versions.ts

@@ -0,0 +1,52 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { maybeFilter } from '@imagekit/api-mcp/filtering';
+import { Metadata, asTextContentResult } from '@imagekit/api-mcp/tools/types';
+
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import ImageKit from '@imagekit/nodejs';
+
+export const metadata: Metadata = {
+  resource: 'files.versions',
+  operation: 'write',
+  tags: [],
+  httpMethod: 'delete',
+  httpPath: '/v1/files/{fileId}/versions/{versionId}',
+  operationId: 'delete-file-version',
+};
+
+export const tool: Tool = {
+  name: 'delete_files_versions',
+  description:
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nThis API deletes a non-current file version permanently. The API returns an empty response.\n\nNote: If you want to delete all versions of a file, use the delete file API.\n\n\n# Response Schema\n```json\n{\n  type: 'object',\n  properties: {}\n}\n```",
+  inputSchema: {
+    type: 'object',
+    properties: {
+      fileId: {
+        type: 'string',
+      },
+      versionId: {
+        type: 'string',
+      },
+      jq_filter: {
+        type: 'string',
+        title: 'jq Filter',
+        description:
+          'A jq filter to apply to the response to include certain fields. Consult the output schema in the tool description to see the fields that are available.\n\nFor example: to include only the `name` field in every object of a results array, you can provide ".results[].name".\n\nFor more information, see the [jq documentation](https://jqlang.org/manual/).',
+      },
+    },
+    required: ['fileId', 'versionId'],
+  },
+  annotations: {
+    idempotentHint: true,
+  },
+};
+
+export const handler = async (client: ImageKit, args: Record<string, unknown> | undefined) => {
+  const { versionId, jq_filter, ...body } = args as any;
+  return asTextContentResult(
+    await maybeFilter(jq_filter, await client.files.versions.delete(versionId, body)),
+  );
+};
+
+export default { metadata, tool, handler };

package/src/tools/files/versions/get-files-versions.ts

@@ -0,0 +1,50 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { maybeFilter } from '@imagekit/api-mcp/filtering';
+import { Metadata, asTextContentResult } from '@imagekit/api-mcp/tools/types';
+
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import ImageKit from '@imagekit/nodejs';
+
+export const metadata: Metadata = {
+  resource: 'files.versions',
+  operation: 'read',
+  tags: [],
+  httpMethod: 'get',
+  httpPath: '/v1/files/{fileId}/versions/{versionId}',
+  operationId: 'get-file-version-details',
+};
+
+export const tool: Tool = {
+  name: 'get_files_versions',
+  description:
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nThis API returns an object with details or attributes of a file version.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/file',\n  $defs: {\n    file: {\n      type: 'object',\n      title: 'File & File Version',\n      description: 'Object containing details of a file or file version.',\n      properties: {\n        AITags: {\n          type: 'array',\n          description: 'An array of tags assigned to the file by auto tagging.\\n',\n          items: {\n            type: 'object',\n            properties: {\n              confidence: {\n                type: 'number',\n                description: 'Confidence score of the tag.'\n              },\n              name: {\n                type: 'string',\n                description: 'Name of the tag.'\n              },\n              source: {\n                type: 'string',\n                description: 'Source of the tag. Possible values are `google-auto-tagging` and `aws-auto-tagging`.'\n              }\n            }\n          }\n        },\n        createdAt: {\n          type: 'string',\n          description: 'Date and time when the file was uploaded. The date and time is in ISO8601 format.\\n',\n          format: 'date-time'\n        },\n        customCoordinates: {\n          type: 'string',\n          description: 'An string with custom coordinates of the file.\\n'\n        },\n        customMetadata: {\n          type: 'object',\n          description: 'An object with custom metadata for the file.\\n',\n          additionalProperties: true\n        },\n        description: {\n          type: 'string',\n          description: 'Optional text to describe the contents of the file. Can be set by the user or the ai-auto-description extension.\\n'\n        },\n        fileId: {\n          type: 'string',\n          description: 'Unique identifier of the asset.'\n        },\n        filePath: {\n          type: 'string',\n          description: 'Path of the file. This is the path you would use in the URL to access the file. For example, if the file is at the root of the media library, the path will be `/file.jpg`. If the file is inside a folder named `images`, the path will be `/images/file.jpg`.\\n'\n        },\n        fileType: {\n          type: 'string',\n          description: 'Type of the file. Possible values are `image`, `non-image`.\\n'\n        },\n        hasAlpha: {\n          type: 'boolean',\n          description: 'Specifies if the image has an alpha channel.\\n'\n        },\n        height: {\n          type: 'number',\n          description: 'Height of the file.\\n'\n        },\n        isPrivateFile: {\n          type: 'boolean',\n          description: 'Specifies if the file is private or not.\\n'\n        },\n        isPublished: {\n          type: 'boolean',\n          description: 'Specifies if the file is published or not.\\n'\n        },\n        mime: {\n          type: 'string',\n          description: 'MIME type of the file.\\n'\n        },\n        name: {\n          type: 'string',\n          description: 'Name of the asset.'\n        },\n        selectedFieldsSchema: {\n          type: 'object',\n          description: 'This field is included in the response only if the Path policy feature is available in the plan.\\nIt contains schema definitions for the custom metadata fields selected for the specified file path.\\nField selection can only be done when the Path policy feature is enabled.\\n\\nKeys are the names of the custom metadata fields; the value object has details about the custom metadata schema.\\n',\n          additionalProperties: true\n        },\n        size: {\n          type: 'number',\n          description: 'Size of the file in bytes.\\n'\n        },\n        tags: {\n          type: 'array',\n          description: 'An array of tags assigned to the file. Tags are used to search files in the media library.\\n',\n          items: {\n            type: 'string'\n          }\n        },\n        thumbnail: {\n          type: 'string',\n          description: 'URL of the thumbnail image. This URL is used to access the thumbnail image of the file in the media library.\\n'\n        },\n        type: {\n          type: 'string',\n          description: 'Type of the asset.',\n          enum: [            'file',\n            'file-version'\n          ]\n        },\n        updatedAt: {\n          type: 'string',\n          description: 'Date and time when the file was last updated. The date and time is in ISO8601 format.\\n',\n          format: 'date-time'\n        },\n        url: {\n          type: 'string',\n          description: 'URL of the file.\\n'\n        },\n        versionInfo: {\n          type: 'object',\n          description: 'An object with details of the file version.\\n',\n          properties: {\n            id: {\n              type: 'string',\n              description: 'Unique identifier of the file version.'\n            },\n            name: {\n              type: 'string',\n              description: 'Name of the file version.'\n            }\n          }\n        },\n        width: {\n          type: 'number',\n          description: 'Width of the file.\\n'\n        }\n      }\n    }\n  }\n}\n```",
+  inputSchema: {
+    type: 'object',
+    properties: {
+      fileId: {
+        type: 'string',
+      },
+      versionId: {
+        type: 'string',
+      },
+      jq_filter: {
+        type: 'string',
+        title: 'jq Filter',
+        description:
+          'A jq filter to apply to the response to include certain fields. Consult the output schema in the tool description to see the fields that are available.\n\nFor example: to include only the `name` field in every object of a results array, you can provide ".results[].name".\n\nFor more information, see the [jq documentation](https://jqlang.org/manual/).',
+      },
+    },
+    required: ['fileId', 'versionId'],
+  },
+  annotations: {
+    readOnlyHint: true,
+  },
+};
+
+export const handler = async (client: ImageKit, args: Record<string, unknown> | undefined) => {
+  const { versionId, jq_filter, ...body } = args as any;
+  return asTextContentResult(await maybeFilter(jq_filter, await client.files.versions.get(versionId, body)));
+};
+
+export default { metadata, tool, handler };

package/src/tools/files/versions/list-files-versions.ts

@@ -0,0 +1,47 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { maybeFilter } from '@imagekit/api-mcp/filtering';
+import { Metadata, asTextContentResult } from '@imagekit/api-mcp/tools/types';
+
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import ImageKit from '@imagekit/nodejs';
+
+export const metadata: Metadata = {
+  resource: 'files.versions',
+  operation: 'read',
+  tags: [],
+  httpMethod: 'get',
+  httpPath: '/v1/files/{fileId}/versions',
+  operationId: 'list-file-versions',
+};
+
+export const tool: Tool = {
+  name: 'list_files_versions',
+  description:
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nThis API returns details of all versions of a file.\n\n\n# Response Schema\n```json\n{\n  type: 'array',\n  items: {\n    $ref: '#/$defs/file'\n  },\n  $defs: {\n    file: {\n      type: 'object',\n      title: 'File & File Version',\n      description: 'Object containing details of a file or file version.',\n      properties: {\n        AITags: {\n          type: 'array',\n          description: 'An array of tags assigned to the file by auto tagging.\\n',\n          items: {\n            type: 'object',\n            properties: {\n              confidence: {\n                type: 'number',\n                description: 'Confidence score of the tag.'\n              },\n              name: {\n                type: 'string',\n                description: 'Name of the tag.'\n              },\n              source: {\n                type: 'string',\n                description: 'Source of the tag. Possible values are `google-auto-tagging` and `aws-auto-tagging`.'\n              }\n            }\n          }\n        },\n        createdAt: {\n          type: 'string',\n          description: 'Date and time when the file was uploaded. The date and time is in ISO8601 format.\\n',\n          format: 'date-time'\n        },\n        customCoordinates: {\n          type: 'string',\n          description: 'An string with custom coordinates of the file.\\n'\n        },\n        customMetadata: {\n          type: 'object',\n          description: 'An object with custom metadata for the file.\\n',\n          additionalProperties: true\n        },\n        description: {\n          type: 'string',\n          description: 'Optional text to describe the contents of the file. Can be set by the user or the ai-auto-description extension.\\n'\n        },\n        fileId: {\n          type: 'string',\n          description: 'Unique identifier of the asset.'\n        },\n        filePath: {\n          type: 'string',\n          description: 'Path of the file. This is the path you would use in the URL to access the file. For example, if the file is at the root of the media library, the path will be `/file.jpg`. If the file is inside a folder named `images`, the path will be `/images/file.jpg`.\\n'\n        },\n        fileType: {\n          type: 'string',\n          description: 'Type of the file. Possible values are `image`, `non-image`.\\n'\n        },\n        hasAlpha: {\n          type: 'boolean',\n          description: 'Specifies if the image has an alpha channel.\\n'\n        },\n        height: {\n          type: 'number',\n          description: 'Height of the file.\\n'\n        },\n        isPrivateFile: {\n          type: 'boolean',\n          description: 'Specifies if the file is private or not.\\n'\n        },\n        isPublished: {\n          type: 'boolean',\n          description: 'Specifies if the file is published or not.\\n'\n        },\n        mime: {\n          type: 'string',\n          description: 'MIME type of the file.\\n'\n        },\n        name: {\n          type: 'string',\n          description: 'Name of the asset.'\n        },\n        selectedFieldsSchema: {\n          type: 'object',\n          description: 'This field is included in the response only if the Path policy feature is available in the plan.\\nIt contains schema definitions for the custom metadata fields selected for the specified file path.\\nField selection can only be done when the Path policy feature is enabled.\\n\\nKeys are the names of the custom metadata fields; the value object has details about the custom metadata schema.\\n',\n          additionalProperties: true\n        },\n        size: {\n          type: 'number',\n          description: 'Size of the file in bytes.\\n'\n        },\n        tags: {\n          type: 'array',\n          description: 'An array of tags assigned to the file. Tags are used to search files in the media library.\\n',\n          items: {\n            type: 'string'\n          }\n        },\n        thumbnail: {\n          type: 'string',\n          description: 'URL of the thumbnail image. This URL is used to access the thumbnail image of the file in the media library.\\n'\n        },\n        type: {\n          type: 'string',\n          description: 'Type of the asset.',\n          enum: [            'file',\n            'file-version'\n          ]\n        },\n        updatedAt: {\n          type: 'string',\n          description: 'Date and time when the file was last updated. The date and time is in ISO8601 format.\\n',\n          format: 'date-time'\n        },\n        url: {\n          type: 'string',\n          description: 'URL of the file.\\n'\n        },\n        versionInfo: {\n          type: 'object',\n          description: 'An object with details of the file version.\\n',\n          properties: {\n            id: {\n              type: 'string',\n              description: 'Unique identifier of the file version.'\n            },\n            name: {\n              type: 'string',\n              description: 'Name of the file version.'\n            }\n          }\n        },\n        width: {\n          type: 'number',\n          description: 'Width of the file.\\n'\n        }\n      }\n    }\n  }\n}\n```",
+  inputSchema: {
+    type: 'object',
+    properties: {
+      fileId: {
+        type: 'string',
+      },
+      jq_filter: {
+        type: 'string',
+        title: 'jq Filter',
+        description:
+          'A jq filter to apply to the response to include certain fields. Consult the output schema in the tool description to see the fields that are available.\n\nFor example: to include only the `name` field in every object of a results array, you can provide ".results[].name".\n\nFor more information, see the [jq documentation](https://jqlang.org/manual/).',
+      },
+    },
+    required: ['fileId'],
+  },
+  annotations: {
+    readOnlyHint: true,
+  },
+};
+
+export const handler = async (client: ImageKit, args: Record<string, unknown> | undefined) => {
+  const { fileId, jq_filter, ...body } = args as any;
+  return asTextContentResult(await maybeFilter(jq_filter, await client.files.versions.list(fileId)));
+};
+
+export default { metadata, tool, handler };

package/src/tools/files/versions/restore-files-versions.ts

@@ -0,0 +1,52 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { maybeFilter } from '@imagekit/api-mcp/filtering';
+import { Metadata, asTextContentResult } from '@imagekit/api-mcp/tools/types';
+
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import ImageKit from '@imagekit/nodejs';
+
+export const metadata: Metadata = {
+  resource: 'files.versions',
+  operation: 'write',
+  tags: [],
+  httpMethod: 'put',
+  httpPath: '/v1/files/{fileId}/versions/{versionId}/restore',
+  operationId: 'restore-file-version',
+};
+
+export const tool: Tool = {
+  name: 'restore_files_versions',
+  description:
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nThis API restores a file version as the current file version.\n\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/file',\n  $defs: {\n    file: {\n      type: 'object',\n      title: 'File & File Version',\n      description: 'Object containing details of a file or file version.',\n      properties: {\n        AITags: {\n          type: 'array',\n          description: 'An array of tags assigned to the file by auto tagging.\\n',\n          items: {\n            type: 'object',\n            properties: {\n              confidence: {\n                type: 'number',\n                description: 'Confidence score of the tag.'\n              },\n              name: {\n                type: 'string',\n                description: 'Name of the tag.'\n              },\n              source: {\n                type: 'string',\n                description: 'Source of the tag. Possible values are `google-auto-tagging` and `aws-auto-tagging`.'\n              }\n            }\n          }\n        },\n        createdAt: {\n          type: 'string',\n          description: 'Date and time when the file was uploaded. The date and time is in ISO8601 format.\\n',\n          format: 'date-time'\n        },\n        customCoordinates: {\n          type: 'string',\n          description: 'An string with custom coordinates of the file.\\n'\n        },\n        customMetadata: {\n          type: 'object',\n          description: 'An object with custom metadata for the file.\\n',\n          additionalProperties: true\n        },\n        description: {\n          type: 'string',\n          description: 'Optional text to describe the contents of the file. Can be set by the user or the ai-auto-description extension.\\n'\n        },\n        fileId: {\n          type: 'string',\n          description: 'Unique identifier of the asset.'\n        },\n        filePath: {\n          type: 'string',\n          description: 'Path of the file. This is the path you would use in the URL to access the file. For example, if the file is at the root of the media library, the path will be `/file.jpg`. If the file is inside a folder named `images`, the path will be `/images/file.jpg`.\\n'\n        },\n        fileType: {\n          type: 'string',\n          description: 'Type of the file. Possible values are `image`, `non-image`.\\n'\n        },\n        hasAlpha: {\n          type: 'boolean',\n          description: 'Specifies if the image has an alpha channel.\\n'\n        },\n        height: {\n          type: 'number',\n          description: 'Height of the file.\\n'\n        },\n        isPrivateFile: {\n          type: 'boolean',\n          description: 'Specifies if the file is private or not.\\n'\n        },\n        isPublished: {\n          type: 'boolean',\n          description: 'Specifies if the file is published or not.\\n'\n        },\n        mime: {\n          type: 'string',\n          description: 'MIME type of the file.\\n'\n        },\n        name: {\n          type: 'string',\n          description: 'Name of the asset.'\n        },\n        selectedFieldsSchema: {\n          type: 'object',\n          description: 'This field is included in the response only if the Path policy feature is available in the plan.\\nIt contains schema definitions for the custom metadata fields selected for the specified file path.\\nField selection can only be done when the Path policy feature is enabled.\\n\\nKeys are the names of the custom metadata fields; the value object has details about the custom metadata schema.\\n',\n          additionalProperties: true\n        },\n        size: {\n          type: 'number',\n          description: 'Size of the file in bytes.\\n'\n        },\n        tags: {\n          type: 'array',\n          description: 'An array of tags assigned to the file. Tags are used to search files in the media library.\\n',\n          items: {\n            type: 'string'\n          }\n        },\n        thumbnail: {\n          type: 'string',\n          description: 'URL of the thumbnail image. This URL is used to access the thumbnail image of the file in the media library.\\n'\n        },\n        type: {\n          type: 'string',\n          description: 'Type of the asset.',\n          enum: [            'file',\n            'file-version'\n          ]\n        },\n        updatedAt: {\n          type: 'string',\n          description: 'Date and time when the file was last updated. The date and time is in ISO8601 format.\\n',\n          format: 'date-time'\n        },\n        url: {\n          type: 'string',\n          description: 'URL of the file.\\n'\n        },\n        versionInfo: {\n          type: 'object',\n          description: 'An object with details of the file version.\\n',\n          properties: {\n            id: {\n              type: 'string',\n              description: 'Unique identifier of the file version.'\n            },\n            name: {\n              type: 'string',\n              description: 'Name of the file version.'\n            }\n          }\n        },\n        width: {\n          type: 'number',\n          description: 'Width of the file.\\n'\n        }\n      }\n    }\n  }\n}\n```",
+  inputSchema: {
+    type: 'object',
+    properties: {
+      fileId: {
+        type: 'string',
+      },
+      versionId: {
+        type: 'string',
+      },
+      jq_filter: {
+        type: 'string',
+        title: 'jq Filter',
+        description:
+          'A jq filter to apply to the response to include certain fields. Consult the output schema in the tool description to see the fields that are available.\n\nFor example: to include only the `name` field in every object of a results array, you can provide ".results[].name".\n\nFor more information, see the [jq documentation](https://jqlang.org/manual/).',
+      },
+    },
+    required: ['fileId', 'versionId'],
+  },
+  annotations: {
+    idempotentHint: true,
+  },
+};
+
+export const handler = async (client: ImageKit, args: Record<string, unknown> | undefined) => {
+  const { versionId, jq_filter, ...body } = args as any;
+  return asTextContentResult(
+    await maybeFilter(jq_filter, await client.files.versions.restore(versionId, body)),
+  );
+};
+
+export default { metadata, tool, handler };

package/src/tools/folders/copy-folders.ts

@@ -0,0 +1,55 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { maybeFilter } from '@imagekit/api-mcp/filtering';
+import { Metadata, asTextContentResult } from '@imagekit/api-mcp/tools/types';
+
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import ImageKit from '@imagekit/nodejs';
+
+export const metadata: Metadata = {
+  resource: 'folders',
+  operation: 'write',
+  tags: [],
+  httpMethod: 'post',
+  httpPath: '/v1/bulkJobs/copyFolder',
+  operationId: 'copy-folder',
+};
+
+export const tool: Tool = {
+  name: 'copy_folders',
+  description:
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nThis will copy one folder into another. The selected folder, its nested folders, files, and their versions (in `includeVersions` is set to true) are copied in this operation. Note: If any file at the destination has the same name as the source file, then the source file and its versions will be appended to the destination file version history.\n\n\n# Response Schema\n```json\n{\n  type: 'object',\n  title: 'Async Bulk Job Response',\n  description: 'Job submitted successfully. A `jobId` will be returned.',\n  properties: {\n    jobId: {\n      type: 'string',\n      description: 'Unique identifier of the bulk job. This can be used to check the status of the bulk job.\\n'\n    }\n  },\n  required: [    'jobId'\n  ]\n}\n```",
+  inputSchema: {
+    type: 'object',
+    properties: {
+      destinationPath: {
+        type: 'string',
+        description: 'Full path to the destination folder where you want to copy the source folder into.\n',
+      },
+      sourceFolderPath: {
+        type: 'string',
+        description: 'The full path to the source folder you want to copy.\n',
+      },
+      includeVersions: {
+        type: 'boolean',
+        description:
+          'Option to copy all versions of files that are nested inside the selected folder. By default, only the current version of each file will be copied. When set to true, all versions of each file will be copied. Default value - `false`.\n',
+      },
+      jq_filter: {
+        type: 'string',
+        title: 'jq Filter',
+        description:
+          'A jq filter to apply to the response to include certain fields. Consult the output schema in the tool description to see the fields that are available.\n\nFor example: to include only the `name` field in every object of a results array, you can provide ".results[].name".\n\nFor more information, see the [jq documentation](https://jqlang.org/manual/).',
+      },
+    },
+    required: ['destinationPath', 'sourceFolderPath'],
+  },
+  annotations: {},
+};
+
+export const handler = async (client: ImageKit, args: Record<string, unknown> | undefined) => {
+  const { jq_filter, ...body } = args as any;
+  return asTextContentResult(await maybeFilter(jq_filter, await client.folders.copy(body)));
+};
+
+export default { metadata, tool, handler };