ImageKit
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).
Verdict
Common use cases
- Reorganize campaign assets into dated folders
- Bulk-tag product images after a photoshoot
- Check CDN purge status after deploy
- Copy versioned folders for A/B tests
- Define custom metadata for SKU tracking
Integration
- Vendor
- ImageKit
- Category
- developer-tools
- Auth
- API_KEY
- Tools
- 26
- Composio slug
imagekit_io
Tools
- Bulk Job Status
Tool to check status of a bulk job. Use when monitoring progress of a bulk copy or move folder operation.
- Bulk Move Files
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.
- Bulk Remove Tagsdestructive
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.
- Check purge cache statusdestructive
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?"
- Copy Folder
Tool to initiate a bulk copy of a folder. Use when you need to asynchronously duplicate a directory (optionally including all versions) at another path in ImageKit. Returns a jobId to track progress with IMAGEKIT_IO_BULK_JOB_STATUS.
- Create Custom Metadata Field
Tool to create a custom metadata field. Use when you need to define a new field in ImageKit DAM.
- Create Folder
Tool to create a new folder. Use when you need to organize assets into a structured folder hierarchy.
- Delete Custom Metadata Fielddestructive
Tool to delete a custom metadata field. Use when you have the field ID and need to permanently remove the metadata schema field. Call after confirming irreversible deletion.
- Delete Filedestructive
Tool to delete a file. Use when you have the file ID and need to permanently remove the file. Call after confirming irreversible deletion.
- Delete File Versiondestructive
Tool to delete a specific non-current file version. Use when permanently removing an older version of a file.
- Delete Folderdestructive
Tool to delete a folder. Use when you need to permanently remove an existing folder and its contents. Call after confirming irreversible deletion.
- Delete Multiple Filesdestructive
Tool to delete multiple files. Use when you need to remove up to 100 assets by their file IDs in one batch operation.
- Get File Details
Tool to retrieve details of a specific file. Use after uploading or listing assets to get full metadata.
- Get File Metadata
Tool to retrieve metadata of an uploaded file. Use after confirming a successful upload to get EXIF, pHash, dimensions, and other image metadata.
- Get File Version Details
Tool to retrieve details of a specific file version. Use after listing or uploading assets when you need to inspect version metadata.
- Get Upload Authentication Parameters
Tool to generate authentication parameters for client-side file uploads. Use when preparing client-side uploads.
- Get Usage
Tool to retrieve account usage metrics. Use when you need usage stats for a specific date range (max 90 days).
- List and Search Assets
Tool to list and search assets in your ImageKit account. Use when you want to retrieve or filter media library assets by criteria such as name, tags, folder path, or advanced queries.
- List Custom Metadata Fields
Tool to list all custom metadata fields. Use when you need to retrieve all defined metadata fields, optionally including deleted ones.
- List File Versions
Tool to list all versions of a file. Use after confirming the fileId to retrieve all historical and published versions of an asset.
- Move Folder
Tool to initiate a bulk move of a folder. Use when you need to asynchronously relocate a directory to another path in ImageKit. Returns a jobId to track progress with IMAGEKIT_IO_BULK_JOB_STATUS.
- Purge ImageKit Cachedestructive
Tool to purge CDN and ImageKit caches for a given URL. Use when you need to invalidate cached content on ImageKit.
- Rename File
Tool to rename a file. Use when you need to update an existing asset's name; optionally purge CDN cache for old URLs.
- Restore File Version
Tool to restore a specific non-current file version as the current one. Use when you need to revert a file to a previous version after confirming the versionId.
- Update Custom Metadata Field
Tool to update an existing custom metadata field. Use when you need to modify the label or schema of a metadata field.
- Update File Details
Tool to update details of a file. Use when you need to modify tags, coordinates, metadata, or extensions on an ImageKit asset.
Setup
Setup guide
- 11. In Switchy, open Settings → Integrations → Developer Tools and click 'Connect' next to ImageKit. 2. You'll be prompted to paste three values: your ImageKit Public Key, Private Key, and URL Endpoint (all found in your ImageKit dashboard under Developer Options → API Keys). 3. Switchy stores these credentials encrypted and uses them to authenticate every tool call. 4. Click 'Test Connection' — Switchy will attempt to list folders in your media library to confirm access. 5. Once connected, open any Space and type '@ImageKit create a folder called /campaign-assets' to invoke the Create Folder tool. 6. If the command succeeds, you'll see a confirmation message with the new folder path. 7. Grant the API key write permissions in ImageKit if you plan to move files or update metadata; read-only keys will fail on mutation tools.
What teammates see: by default, memories from ImageKit are scoped to the Space (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Spaces have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
Create Campaign Folder
@ImageKit create a folder at /campaigns/spring-2024 and confirm the path once it's ready.Open in a Space →
Bulk Move Screenshots
@ImageKit move all files from /staging/feature-x-screenshots to /archive/2024-q1 and report how many files were relocated.Open in a Space →
Tag Product Images
@ImageKit add the tags 'footwear' and 'summer-2024' to all files in the /products/shoes folder.Open in a Space →
Check Purge Status
@ImageKit check the status of purge request ID 7a3f9c2e and tell me if the cache is fully cleared.Open in a Space →
Define SKU Metadata
@ImageKit create a custom metadata field called 'product_sku' with type text and mark it required for all new uploads.Open in a Space →
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@ImageKit show me all images in the /marketing/campaigns folder that are tagged 'holiday-2024' and larger than 2MB
Based on the ImageKit DAM query, 14 images match your criteria in /marketing/campaigns with the 'holiday-2024' tag exceeding 2MB. The largest is hero-banner.jpg at 4.3MB (3840×2160px), followed by product-grid.png at 3.1MB. All files were uploaded between Nov 15-Dec 3, 2024. Most are JPEGs with one PNG. Would you like me to generate a CSV export or bulk-move these to a subfolder for archival?
This example demonstrates ImageKit's search and filtering capabilities across the DAM. The MCP requires API key authentication with read permissions. Response times depend on your media library size—accounts with 100K+ assets may see 2-3 second query delays.
@ImageKit move all files tagged 'draft' from /product-photos to /archive/drafts and remove the draft tag after moving
Initiated bulk move operation for 23 files from /product-photos to /archive/drafts (jobId: job_8x3k9m). Once the move completes (typically 30-90 seconds for this batch size), I'll trigger a bulk tag removal to strip 'draft' from all 23 files. You can check progress with the jobId. Note: This operation preserves file versions and metadata but updates the file path permanently.
This showcases ImageKit's bulk operations for asset management workflows. The MCP chains two operations—bulk move followed by bulk tag removal—which is common in content lifecycle automation. Be aware: moves are permanent and affect all references to those file paths in your applications.
@ImageKit create a custom metadata field called 'campaign_id' for tracking which marketing campaign each asset belongs to, then tag all images in /ads with campaign_id=Q1-2025
Created custom metadata field 'campaign_id' (fieldId: fld_7h2p9x) with text schema in your ImageKit account. However, bulk metadata assignment isn't directly supported via the current MCP tools—you'll need to update each file individually or use ImageKit's dashboard for batch metadata edits. I can help update files one-by-one if you have a specific subset, or we can explore using the bulk update API endpoint if you have developer access.
This example highlights both a strength (flexible custom metadata schema creation) and a current limitation (no bulk metadata write tool in this MCP). It's realistic about workarounds. Custom metadata is powerful for DAM organization but requires planning—fields can't be easily renamed once assets reference them.
Use-case deep-dives
When ImageKit wins for moving 10k SKU images between folders
A 6-person e-commerce team launching a new product line needs to reorganize 8,000 product images from a staging folder into production categories. The ImageKit MCP is the right call here because Bulk Move Files handles up to 100 files per operation, and Copy Folder can duplicate entire directories asynchronously while the team works on other tasks. The jobId tracking means you can check Bulk Job Status in Switchy without blocking your workflow. This breaks down if your images need complex transformation during the move—ImageKit's bulk ops are strictly relocate-and-copy, not resize-and-optimize. If your team is moving more than 50k files weekly, you'll hit rate limits and need a dedicated migration script instead. For one-time or monthly catalog refreshes at this scale, the MCP saves 4-6 hours of manual folder work.
Why this MCP handles seasonal campaign asset cleanup fast
A 3-person marketing team wraps a Black Friday campaign and needs to strip "BF2024" tags from 2,000 hero images so next year's search doesn't surface stale assets. Bulk Remove Tags processes up to 50 files per call, so the team queues 40 operations in Switchy and finishes the job in under 10 minutes. The API_KEY auth means no OAuth dance—just plug credentials into the shared workspace and anyone can run the cleanup. This approach falls apart if your tagging logic is conditional ("remove tag X only if tag Y exists")—the MCP doesn't support tag queries, so you'd need to export metadata first. For straightforward bulk tag removal after campaigns or product discontinuations, the MCP is faster than logging into the ImageKit dashboard and clicking through pagination.
When purge-and-check beats waiting for CDN propagation
A 5-person customer support team fields tickets about outdated product images showing on the website. The ImageKit MCP lets them purge the CDN cache for specific URLs and immediately check purge status without switching to the vendor dashboard. In Switchy, a support agent runs the purge, pastes the jobId into a shared thread, and the next agent confirms propagation 90 seconds later using Check Purge Cache Status. This workflow works because ImageKit's purge is near-instant for single-file or small-batch requests. It's not the right tool if your support team is purging hundreds of URLs daily—at that volume, you want automated purge-on-upload rules in ImageKit's settings, not manual MCP calls. For reactive troubleshooting where 2-3 purges per day resolve customer complaints, the MCP keeps the team in one workspace instead of juggling tabs.
Frequently asked
What does the ImageKit MCP let me do in Switchy?
It connects your ImageKit media library to Switchy's AI workspace so you can manage assets, folders, metadata, and cache operations through conversation. You can bulk-move files, create custom metadata fields, check purge status, and copy folders without leaving the chat. Useful when your team needs to script repetitive DAM tasks or query asset state across projects.
Do I need admin access to connect ImageKit MCP?
You need an ImageKit API key with write permissions if you plan to create folders, move files, or define custom metadata. Read-only keys work for checking job status or purge requests, but most of the 26 tools require write scope. Generate the key in your ImageKit dashboard under Developer Options, then paste it into Switchy's auth flow.
Can the ImageKit MCP upload new images or transform existing ones?
No. The MCP focuses on asset management—moving files, tagging, folder operations, cache purging, and metadata schema changes. If you need to upload images or apply transformations, use ImageKit's upload API or dashboard directly. This integration is for organising and querying assets that already live in your media library.
Why use the MCP instead of ImageKit's dashboard or REST API?
The MCP lets non-technical team members run bulk operations through plain English prompts instead of writing curl commands or clicking through the dashboard. It's faster for repetitive tasks like tagging 50 files or checking purge status across multiple requests. If you already have scripts calling the ImageKit API, keep using those—this is for ad-hoc team workflows.
Who on the team should connect the ImageKit MCP?
Whoever owns your ImageKit account and can generate API keys. Once connected in Switchy, any workspace member can invoke the tools, so limit access if you don't want junior team members bulk-deleting metadata fields. The MCP doesn't count against ImageKit's bandwidth or storage limits, only your Switchy seat count.