# ImageKit — MCP server on mcp.ai
> Connect your ImageKit account and use 26 tools for images and design straight from your AI agent. Connect with your own API key. ImageKit.io is a comprehensive media management solution offering real-time image and video optimization, transformation, and delivery through a global content delivery network (CDN).

By: mcp.ai · official
Page: https://mcp.ai/imagekit_io

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_imagekit_io?ms=1787293560000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/imagekit_io/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/imagekit_io/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/imagekit_io/skill.md
Postman collection (v2.1): https://mcp.ai/imagekit_io/postman.json

## Tools
- imagekit_io_bulk_job_status(jobId: string) — Retrieve the status of a bulk folder operation. Use this tool to monitor the progress of asynchronous Copy Folder or Move Folder operations by providing the jobId returned from those operations.
- imagekit_io_bulk_move_files(fileIds: string[], destinationPath: string) — Tool to move multiple files in bulk. Use when you need to relocate up to 100 ImageKit files to a specified folder in one API call.
- imagekit_io_bulk_remove_tags(tags: string[], fileIds: string[]) — Tool to remove tags from multiple files in bulk. Use when you need to strip specified tags from up to 50 existing files in one API call.
- imagekit_io_copy_folder(destinationPath: string, includeVersions?: boolean, sourceFolderPath: string) — Initiate an asynchronous bulk copy of a folder and all its contents to a new location. Use this tool when you need to: - Duplicate an entire folder structure including all nested files and subfolders 
- imagekit_io_create_custom_metadata_field(name: string, label: string, schema: object) — Create a new custom metadata field in ImageKit DAM. Use this tool to define custom metadata fields that can be attached to assets (images, videos, etc.) in your ImageKit media library. Once created, y
- imagekit_io_create_folder(folderName: string, parentFolderPath: string) — Creates a new folder in ImageKit.io media library. Use this to organize assets into structured folder hierarchies. The folder will be created at the specified parent path. If the parent folder doesn't
- imagekit_io_delete_custom_metadata_field(fieldId: string) — Permanently deletes a custom metadata field from ImageKit. This action is irreversible. Note: Even after deletion, you cannot create a new field with the same name. Use 'List Custom Metadata Fields' f
- imagekit_io_delete_file(fileId: string) — Permanently deletes a file from ImageKit by its unique file ID. WARNING: This action is irreversible. The file and all its versions will be permanently removed. Note: Cached versions of the file may s
- imagekit_io_delete_file_version(fileId: string, versionId: string) — Permanently deletes a specific non-current file version from ImageKit.io. Use this when you need to remove an older version of a file while keeping the current version intact. Note: This action is irr
- imagekit_io_delete_folder(folderPath: string) — Permanently delete a folder and all its contents from ImageKit Media Library. WARNING: This is a destructive operation that cannot be undone. All files and subfolders within the specified folder will 
- imagekit_io_delete_multiple_files(fileIds: string[]) — Permanently delete multiple files from ImageKit media library in a single batch operation. Use this tool when you need to: - Remove up to 100 files at once by their unique file IDs - Clean up unused a
- imagekit_io_get_authentication_parameters(token?: string, expireIn?: integer) — Tool to generate authentication parameters for client-side file uploads. Use when preparing client-side uploads.
- imagekit_io_get_file_details(fileId: string) — Tool to retrieve details of a specific file. Use after uploading or listing assets to get full metadata.
- imagekit_io_get_file_metadata(fileId: string) — Tool to retrieve metadata of an uploaded file. Use after confirming a successful upload to get EXIF, pHash, dimensions, and other image metadata.
- imagekit_io_get_file_version_details(fileId: string, versionId: string) — Tool to retrieve details of a specific file version. Use after listing or uploading assets when you need to inspect version metadata.
- imagekit_io_get_usage(endDate: string, startDate: string) — Retrieve ImageKit account usage metrics for a specified date range. Returns bandwidth consumption and media library storage usage. The response includes data from startDate up to (but not including) e
- imagekit_io_list_and_search_assets(name?: string, path?: string, skip?: integer, sort?: string, tags?: string, type?: string, limit?: integer, fileType?: string, searchQuery?: string) — List and search media assets (files, folders, file-versions) in your ImageKit media library. Use this tool to: - Browse all assets with optional pagination (limit/skip) - Filter by type (file, folder,
- imagekit_io_list_custom_metadata_fields(includeDeleted?: boolean) — List all custom metadata fields defined in the ImageKit Media Library. Use this tool to: - Retrieve all metadata field definitions (name, label, type, constraints) - Get field IDs required for updatin
- imagekit_io_list_file_versions(fileId: string) — Retrieves all versions of a specific file in ImageKit. Returns a list of file version objects including metadata like version ID, creation date, and publication status. Use this to view file history, 
- imagekit_io_move_folder(destinationPath: string, sourceFolderPath: string) — Move a folder from one location to another in your ImageKit media library. This operation is asynchronous - it returns a jobId immediately, and the actual move happens in the background. The folder wi
- imagekit_io_purge_cache(url: string) — Purge CDN and ImageKit internal caches for a specific URL or URL pattern. Use this action when you need to: - Invalidate cached content after updating an image - Force CDN to fetch the latest version 
- imagekit_io_purge_status(requestId: string) — Tool to check the status of a cache purge request. Use after initiating a purge to retrieve its current state. Example: "What's the status of purge request id abc123?"
- imagekit_io_rename_file(filePath: string, purgeCache?: boolean, newFileName: string) — Renames an existing file in the ImageKit media library. Use this action when you need to change a file's name. Important: Old URLs will stop working after rename (unless CDN cache is active). This ope
- imagekit_io_restore_file_version(fileId: string, versionId: string) — Restores a non-current file version to become the current version in ImageKit. Use this to revert a file to a previous state. First use the List File Versions API to find the versionId of the version 
- imagekit_io_update_custom_metadata_field(label?: string, schema?: object, fieldId: string) — Updates an existing custom metadata field's label or schema constraints in ImageKit DAM. Use this to: - Change the display label of a metadata field - Update validation constraints (min/max values, mi
- imagekit_io_update_file_details(tags?: string[], fileId: string, publish?: object, extensions?: object[], webhookUrl?: string, removeAITags?: string[], customMetadata?: object, customCoordinates?: string) — Update file details in ImageKit media library. Use this tool to modify tags, custom coordinates, custom metadata, AI tags, apply extensions (like background removal), or change publication status. Not

## Example prompts
- "What can I do in ImageKit?"
- "Show me a summary of my ImageKit account"

## Links
Docs: https://mcp.ai/docs/mcps/imagekit_io
Website: https://mcp.ai/mcps/imagekit_io