@imagekit/api-mcp 7.1.1

package/src/tools/files/bulk/remove-tags-files-bulk.ts

@@ -0,0 +1,56 @@
+// 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.bulk',
+  operation: 'write',
+  tags: [],
+  httpMethod: 'post',
+  httpPath: '/v1/files/removeTags',
+  operationId: 'remove-tags-bulk',
+};
+
+export const tool: Tool = {
+  name: 'remove_tags_files_bulk',
+  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 removes tags from multiple files in bulk. A maximum of 50 files can be specified at a time.\n\n\n# Response Schema\n```json\n{\n  type: 'object',\n  properties: {\n    successfullyUpdatedFileIds: {\n      type: 'array',\n      description: 'An array of fileIds that in which tags were successfully removed.\\n',\n      items: {\n        type: 'string'\n      }\n    }\n  }\n}\n```",
+  inputSchema: {
+    type: 'object',
+    properties: {
+      fileIds: {
+        type: 'array',
+        description: 'An array of fileIds from which you want to remove tags.\n',
+        items: {
+          type: 'string',
+        },
+      },
+      tags: {
+        type: 'array',
+        description: 'An array of tags that you want to remove from the files.\n',
+        items: {
+          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: ['fileIds', 'tags'],
+  },
+  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.files.bulk.removeTags(body)));
+};
+
+export default { metadata, tool, handler };

package/src/tools/files/copy-files.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: 'files',
+  operation: 'write',
+  tags: [],
+  httpMethod: 'post',
+  httpPath: '/v1/files/copy',
+  operationId: 'copy-file',
+};
+
+export const tool: Tool = {
+  name: 'copy_files',
+  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 a file from one folder to another. \n\nNote: If any file at the destination has the same name as the source file, then the source file and its versions (if `includeFileVersions` is set to true) will be appended to the destination file version history.\n\n\n# Response Schema\n```json\n{\n  type: 'object',\n  properties: {}\n}\n```",
+  inputSchema: {
+    type: 'object',
+    properties: {
+      destinationPath: {
+        type: 'string',
+        description: 'Full path to the folder you want to copy the above file into.\n',
+      },
+      sourceFilePath: {
+        type: 'string',
+        description: 'The full path of the file you want to copy.\n',
+      },
+      includeFileVersions: {
+        type: 'boolean',
+        description:
+          'Option to copy all versions of a file. By default, only the current version of the file is copied. When set to true, all versions of the 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', 'sourceFilePath'],
+  },
+  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.files.copy(body)));
+};
+
+export default { metadata, tool, handler };

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

@@ -0,0 +1,41 @@
+// 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: 'delete',
+  httpPath: '/v1/files/{fileId}',
+  operationId: 'delete-file',
+};
+
+export const tool: Tool = {
+  name: 'delete_files',
+  description:
+    'This API deletes the file and all its file versions permanently.\n\nNote: If a file or specific transformation has been requested in the past, then the response is cached. Deleting a file does not purge the cache. You can purge the cache using purge cache API.\n',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      fileId: {
+        type: 'string',
+      },
+    },
+    required: ['fileId'],
+  },
+  annotations: {
+    idempotentHint: true,
+  },
+};
+
+export const handler = async (client: ImageKit, args: Record<string, unknown> | undefined) => {
+  const { fileId, ...body } = args as any;
+  const response = await client.files.delete(fileId).asResponse();
+  return asTextContentResult(await response.text());
+};
+
+export default { metadata, tool, handler };

package/src/tools/files/get-files.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',
+  operation: 'read',
+  tags: [],
+  httpMethod: 'get',
+  httpPath: '/v1/files/{fileId}/details',
+  operationId: 'get-file-details',
+};
+
+export const tool: Tool = {
+  name: 'get_files',
+  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 about the current version of the file.\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',
+      },
+      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.get(fileId)));
+};
+
+export default { metadata, tool, handler };

package/src/tools/files/metadata/get-files-metadata.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.metadata',
+  operation: 'read',
+  tags: [],
+  httpMethod: 'get',
+  httpPath: '/v1/files/{fileId}/metadata',
+  operationId: 'get-uploaded-file-metadata',
+};
+
+export const tool: Tool = {
+  name: 'get_files_metadata',
+  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\nYou can programmatically get image EXIF, pHash, and other metadata for uploaded files in the ImageKit.io media library using this API.\n\nYou can also get the metadata in upload API response by passing `metadata` in `responseFields` parameter.\n\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/metadata',\n  $defs: {\n    metadata: {\n      type: 'object',\n      description: 'JSON object containing metadata.',\n      properties: {\n        audioCodec: {\n          type: 'string',\n          description: 'The audio codec used in the video (only for video).'\n        },\n        bitRate: {\n          type: 'integer',\n          description: 'The bit rate of the video in kbps (only for video).'\n        },\n        density: {\n          type: 'integer',\n          description: 'The density of the image in DPI.'\n        },\n        duration: {\n          type: 'integer',\n          description: 'The duration of the video in seconds (only for video).'\n        },\n        exif: {\n          type: 'object',\n          properties: {\n            exif: {\n              type: 'object',\n              description: 'Object containing Exif details.',\n              properties: {\n                ApertureValue: {\n                  type: 'number'\n                },\n                ColorSpace: {\n                  type: 'integer'\n                },\n                CreateDate: {\n                  type: 'string'\n                },\n                CustomRendered: {\n                  type: 'integer'\n                },\n                DateTimeOriginal: {\n                  type: 'string'\n                },\n                ExifImageHeight: {\n                  type: 'integer'\n                },\n                ExifImageWidth: {\n                  type: 'integer'\n                },\n                ExifVersion: {\n                  type: 'string'\n                },\n                ExposureCompensation: {\n                  type: 'number'\n                },\n                ExposureMode: {\n                  type: 'integer'\n                },\n                ExposureProgram: {\n                  type: 'integer'\n                },\n                ExposureTime: {\n                  type: 'number'\n                },\n                Flash: {\n                  type: 'integer'\n                },\n                FlashpixVersion: {\n                  type: 'string'\n                },\n                FNumber: {\n                  type: 'number'\n                },\n                FocalLength: {\n                  type: 'integer'\n                },\n                FocalPlaneResolutionUnit: {\n                  type: 'integer'\n                },\n                FocalPlaneXResolution: {\n                  type: 'number'\n                },\n                FocalPlaneYResolution: {\n                  type: 'number'\n                },\n                InteropOffset: {\n                  type: 'integer'\n                },\n                ISO: {\n                  type: 'integer'\n                },\n                MeteringMode: {\n                  type: 'integer'\n                },\n                SceneCaptureType: {\n                  type: 'integer'\n                },\n                ShutterSpeedValue: {\n                  type: 'number'\n                },\n                SubSecTime: {\n                  type: 'string'\n                },\n                WhiteBalance: {\n                  type: 'integer'\n                }\n              }\n            },\n            gps: {\n              type: 'object',\n              description: 'Object containing GPS information.',\n              properties: {\n                GPSVersionID: {\n                  type: 'array',\n                  items: {\n                    type: 'integer'\n                  }\n                }\n              }\n            },\n            image: {\n              type: 'object',\n              description: 'Object containing EXIF image information.',\n              properties: {\n                ExifOffset: {\n                  type: 'integer'\n                },\n                GPSInfo: {\n                  type: 'integer'\n                },\n                Make: {\n                  type: 'string'\n                },\n                Model: {\n                  type: 'string'\n                },\n                ModifyDate: {\n                  type: 'string'\n                },\n                Orientation: {\n                  type: 'integer'\n                },\n                ResolutionUnit: {\n                  type: 'integer'\n                },\n                Software: {\n                  type: 'string'\n                },\n                XResolution: {\n                  type: 'integer'\n                },\n                YCbCrPositioning: {\n                  type: 'integer'\n                },\n                YResolution: {\n                  type: 'integer'\n                }\n              }\n            },\n            interoperability: {\n              type: 'object',\n              description: 'JSON object.',\n              properties: {\n                InteropIndex: {\n                  type: 'string'\n                },\n                InteropVersion: {\n                  type: 'string'\n                }\n              }\n            },\n            makernote: {\n              type: 'object',\n              additionalProperties: true\n            },\n            thumbnail: {\n              type: 'object',\n              description: 'Object containing Thumbnail information.',\n              properties: {\n                Compression: {\n                  type: 'integer'\n                },\n                ResolutionUnit: {\n                  type: 'integer'\n                },\n                ThumbnailLength: {\n                  type: 'integer'\n                },\n                ThumbnailOffset: {\n                  type: 'integer'\n                },\n                XResolution: {\n                  type: 'integer'\n                },\n                YResolution: {\n                  type: 'integer'\n                }\n              }\n            }\n          }\n        },\n        format: {\n          type: 'string',\n          description: 'The format of the file (e.g., \\'jpg\\', \\'mp4\\').'\n        },\n        hasColorProfile: {\n          type: 'boolean',\n          description: 'Indicates if the image has a color profile.'\n        },\n        hasTransparency: {\n          type: 'boolean',\n          description: 'Indicates if the image contains transparent areas.'\n        },\n        height: {\n          type: 'integer',\n          description: 'The height of the image or video in pixels.'\n        },\n        pHash: {\n          type: 'string',\n          description: 'Perceptual hash of the image.'\n        },\n        quality: {\n          type: 'integer',\n          description: 'The quality indicator of the image.'\n        },\n        size: {\n          type: 'integer',\n          description: 'The file size in bytes.'\n        },\n        videoCodec: {\n          type: 'string',\n          description: 'The video codec used in the video (only for video).'\n        },\n        width: {\n          type: 'integer',\n          description: 'The width of the image or video in pixels.'\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.metadata.get(fileId)));
+};
+
+export default { metadata, tool, handler };

package/src/tools/files/metadata/get-from-url-files-metadata.ts

@@ -0,0 +1,48 @@
+// 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.metadata',
+  operation: 'read',
+  tags: [],
+  httpMethod: 'get',
+  httpPath: '/v1/files/metadata',
+  operationId: 'get-metadata-from-url',
+};
+
+export const tool: Tool = {
+  name: 'get_from_url_files_metadata',
+  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\nGet image EXIF, pHash, and other metadata from ImageKit.io powered remote URL using this API.\n\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/metadata',\n  $defs: {\n    metadata: {\n      type: 'object',\n      description: 'JSON object containing metadata.',\n      properties: {\n        audioCodec: {\n          type: 'string',\n          description: 'The audio codec used in the video (only for video).'\n        },\n        bitRate: {\n          type: 'integer',\n          description: 'The bit rate of the video in kbps (only for video).'\n        },\n        density: {\n          type: 'integer',\n          description: 'The density of the image in DPI.'\n        },\n        duration: {\n          type: 'integer',\n          description: 'The duration of the video in seconds (only for video).'\n        },\n        exif: {\n          type: 'object',\n          properties: {\n            exif: {\n              type: 'object',\n              description: 'Object containing Exif details.',\n              properties: {\n                ApertureValue: {\n                  type: 'number'\n                },\n                ColorSpace: {\n                  type: 'integer'\n                },\n                CreateDate: {\n                  type: 'string'\n                },\n                CustomRendered: {\n                  type: 'integer'\n                },\n                DateTimeOriginal: {\n                  type: 'string'\n                },\n                ExifImageHeight: {\n                  type: 'integer'\n                },\n                ExifImageWidth: {\n                  type: 'integer'\n                },\n                ExifVersion: {\n                  type: 'string'\n                },\n                ExposureCompensation: {\n                  type: 'number'\n                },\n                ExposureMode: {\n                  type: 'integer'\n                },\n                ExposureProgram: {\n                  type: 'integer'\n                },\n                ExposureTime: {\n                  type: 'number'\n                },\n                Flash: {\n                  type: 'integer'\n                },\n                FlashpixVersion: {\n                  type: 'string'\n                },\n                FNumber: {\n                  type: 'number'\n                },\n                FocalLength: {\n                  type: 'integer'\n                },\n                FocalPlaneResolutionUnit: {\n                  type: 'integer'\n                },\n                FocalPlaneXResolution: {\n                  type: 'number'\n                },\n                FocalPlaneYResolution: {\n                  type: 'number'\n                },\n                InteropOffset: {\n                  type: 'integer'\n                },\n                ISO: {\n                  type: 'integer'\n                },\n                MeteringMode: {\n                  type: 'integer'\n                },\n                SceneCaptureType: {\n                  type: 'integer'\n                },\n                ShutterSpeedValue: {\n                  type: 'number'\n                },\n                SubSecTime: {\n                  type: 'string'\n                },\n                WhiteBalance: {\n                  type: 'integer'\n                }\n              }\n            },\n            gps: {\n              type: 'object',\n              description: 'Object containing GPS information.',\n              properties: {\n                GPSVersionID: {\n                  type: 'array',\n                  items: {\n                    type: 'integer'\n                  }\n                }\n              }\n            },\n            image: {\n              type: 'object',\n              description: 'Object containing EXIF image information.',\n              properties: {\n                ExifOffset: {\n                  type: 'integer'\n                },\n                GPSInfo: {\n                  type: 'integer'\n                },\n                Make: {\n                  type: 'string'\n                },\n                Model: {\n                  type: 'string'\n                },\n                ModifyDate: {\n                  type: 'string'\n                },\n                Orientation: {\n                  type: 'integer'\n                },\n                ResolutionUnit: {\n                  type: 'integer'\n                },\n                Software: {\n                  type: 'string'\n                },\n                XResolution: {\n                  type: 'integer'\n                },\n                YCbCrPositioning: {\n                  type: 'integer'\n                },\n                YResolution: {\n                  type: 'integer'\n                }\n              }\n            },\n            interoperability: {\n              type: 'object',\n              description: 'JSON object.',\n              properties: {\n                InteropIndex: {\n                  type: 'string'\n                },\n                InteropVersion: {\n                  type: 'string'\n                }\n              }\n            },\n            makernote: {\n              type: 'object',\n              additionalProperties: true\n            },\n            thumbnail: {\n              type: 'object',\n              description: 'Object containing Thumbnail information.',\n              properties: {\n                Compression: {\n                  type: 'integer'\n                },\n                ResolutionUnit: {\n                  type: 'integer'\n                },\n                ThumbnailLength: {\n                  type: 'integer'\n                },\n                ThumbnailOffset: {\n                  type: 'integer'\n                },\n                XResolution: {\n                  type: 'integer'\n                },\n                YResolution: {\n                  type: 'integer'\n                }\n              }\n            }\n          }\n        },\n        format: {\n          type: 'string',\n          description: 'The format of the file (e.g., \\'jpg\\', \\'mp4\\').'\n        },\n        hasColorProfile: {\n          type: 'boolean',\n          description: 'Indicates if the image has a color profile.'\n        },\n        hasTransparency: {\n          type: 'boolean',\n          description: 'Indicates if the image contains transparent areas.'\n        },\n        height: {\n          type: 'integer',\n          description: 'The height of the image or video in pixels.'\n        },\n        pHash: {\n          type: 'string',\n          description: 'Perceptual hash of the image.'\n        },\n        quality: {\n          type: 'integer',\n          description: 'The quality indicator of the image.'\n        },\n        size: {\n          type: 'integer',\n          description: 'The file size in bytes.'\n        },\n        videoCodec: {\n          type: 'string',\n          description: 'The video codec used in the video (only for video).'\n        },\n        width: {\n          type: 'integer',\n          description: 'The width of the image or video in pixels.'\n        }\n      }\n    }\n  }\n}\n```",
+  inputSchema: {
+    type: 'object',
+    properties: {
+      url: {
+        type: 'string',
+        description: 'Should be a valid file URL. It should be accessible using your ImageKit.io account.\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: ['url'],
+  },
+  annotations: {
+    readOnlyHint: true,
+  },
+};
+
+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.files.metadata.getFromURL(body)));
+};
+
+export default { metadata, tool, handler };

package/src/tools/files/move-files.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',
+  operation: 'write',
+  tags: [],
+  httpMethod: 'post',
+  httpPath: '/v1/files/move',
+  operationId: 'move-file',
+};
+
+export const tool: Tool = {
+  name: 'move_files',
+  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 move a file and all its versions from one folder to another. \n\nNote: 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.\n\n\n# Response Schema\n```json\n{\n  type: 'object',\n  properties: {}\n}\n```",
+  inputSchema: {
+    type: 'object',
+    properties: {
+      destinationPath: {
+        type: 'string',
+        description: 'Full path to the folder you want to move the above file into.\n',
+      },
+      sourceFilePath: {
+        type: 'string',
+        description: 'The full path of the file you want to move.\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', 'sourceFilePath'],
+  },
+  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.files.move(body)));
+};
+
+export default { metadata, tool, handler };

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

@@ -0,0 +1,58 @@
+// 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',
+  operation: 'write',
+  tags: [],
+  httpMethod: 'put',
+  httpPath: '/v1/files/rename',
+  operationId: 'rename-file',
+};
+
+export const tool: Tool = {
+  name: 'rename_files',
+  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\nYou can rename an already existing file in the media library using rename file API. This operation would rename all file versions of the file. \n\nNote: The old URLs will stop working. The file/file version URLs cached on CDN will continue to work unless a purge is requested.\n\n\n# Response Schema\n```json\n{\n  type: 'object',\n  properties: {\n    purgeRequestId: {\n      type: 'string',\n      description: 'Unique identifier of the purge request. This can be used to check the status of the purge request.\\n'\n    }\n  }\n}\n```",
+  inputSchema: {
+    type: 'object',
+    properties: {
+      filePath: {
+        type: 'string',
+        description: 'The full path of the file you want to rename.\n',
+      },
+      newFileName: {
+        type: 'string',
+        description:
+          'The new name of the file. A filename can contain:\n\nAlphanumeric Characters: `a-z`, `A-Z`, `0-9` (including Unicode letters, marks, and numerals in other languages).\nSpecial Characters: `.`, `_`, and `-`.\n\nAny other character, including space, will be replaced by `_`.\n',
+      },
+      purgeCache: {
+        type: 'boolean',
+        description:
+          "Option to purge cache for the old file and its versions' URLs.\n\nWhen set to true, it will internally issue a purge cache request on CDN to remove cached content of old file and its versions. This purge request is counted against your monthly purge quota.\n\nNote: If the old file were accessible at `https://ik.imagekit.io/demo/old-filename.jpg`, a purge cache request would be issued against `https://ik.imagekit.io/demo/old-filename.jpg*` (with a wildcard at the end). It will remove the file and its versions' URLs and any transformations made using query parameters on this file or its versions. However, the cache for file transformations made using path parameters will persist. You can purge them using the purge API. For more details, refer to the purge API documentation.\n\n\n\nDefault 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: ['filePath', 'newFileName'],
+  },
+  annotations: {
+    idempotentHint: true,
+  },
+};
+
+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.files.rename(body)));
+};
+
+export default { metadata, tool, handler };

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

@@ -0,0 +1,196 @@
+// 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: 'patch',
+  httpPath: '/v1/files/{fileId}/details',
+  operationId: 'update-file-details',
+};
+
+export const tool: Tool = {
+  name: 'update_files',
+  description:
+    'This API updates the details or attributes of the current version of the file. You can update `tags`, `customCoordinates`, `customMetadata`, publication status, remove existing `AITags` and apply extensions using this API.\n',
+  inputSchema: {
+    type: 'object',
+    anyOf: [
+      {
+        type: 'object',
+        properties: {
+          fileId: {
+            type: 'string',
+          },
+          customCoordinates: {
+            type: 'string',
+            description:
+              'Define an important area in the image in the format `x,y,width,height` e.g. `10,10,100,100`. Send `null` to unset this value.\n',
+          },
+          customMetadata: {
+            type: 'object',
+            description:
+              'A key-value data to be associated with the asset. To unset a key, send `null` value for that key. Before setting any custom metadata on an asset you have to create the field using custom metadata fields API.\n',
+            additionalProperties: true,
+          },
+          description: {
+            type: 'string',
+            description: 'Optional text to describe the contents of the file.\n',
+          },
+          extensions: {
+            $ref: '#/$defs/extensions',
+          },
+          removeAITags: {
+            anyOf: [
+              {
+                type: 'array',
+                items: {
+                  type: 'string',
+                },
+              },
+              {
+                type: 'string',
+                enum: ['all'],
+              },
+            ],
+            description:
+              'An array of AITags associated with the file that you want to remove, e.g. `["car", "vehicle", "motorsports"]`. \n\nIf you want to remove all AITags associated with the file, send a string - "all".\n\nNote: The remove operation for `AITags` executes before any of the `extensions` are processed.\n',
+          },
+          tags: {
+            type: 'array',
+            description:
+              'An array of tags associated with the file, such as `["tag1", "tag2"]`. Send `null` to unset all tags associated with the file.\n',
+            items: {
+              type: 'string',
+            },
+          },
+          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: ['fileId'],
+      },
+      {
+        type: 'object',
+        properties: {
+          fileId: {
+            type: 'string',
+          },
+          publish: {
+            type: 'object',
+            description: 'Configure the publication status of a file and its versions.\n',
+            properties: {
+              isPublished: {
+                type: 'boolean',
+                description: 'Set to `true` to publish the file. Set to `false` to unpublish the file.\n',
+              },
+              includeFileVersions: {
+                type: 'boolean',
+                description:
+                  'Set to `true` to publish/unpublish all versions of the file. Set to `false` to publish/unpublish only the current version of the file.\n',
+              },
+            },
+            required: ['isPublished'],
+          },
+        },
+        required: ['fileId'],
+      },
+    ],
+    $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 { fileId, ...body } = args as any;
+  return asTextContentResult(await client.files.update(fileId, body));
+};
+
+export default { metadata, tool, handler };