# mcp-preflight

Guide to ImageKit's three MCP servers: media library, admin tasks like origins, URL endpoints and usage, and docs search.

Skill by ImageKit. Category: Agent craft.

## Install

Project (for this project only):

```sh
npx skills add imagekit-developer/skills --skill mcp-preflight
```

Works with: Claude Code, Codex CLI, Cursor, Antigravity, Copilot CLI, opencode.

Global (for every project on this machine):

```sh
npx skills add imagekit-developer/skills --skill mcp-preflight -g
```

Works with: Claude Code, Codex CLI, Cursor, Antigravity, Copilot CLI, opencode.

## Tags

- Runs on your computer: It runs as a program on your machine, with your access.

## Security audits

- Gen Agent Trust Hub: Pass
- Socket: Pass
- Snyk: Warn

Installs: 457. Installs counted by skills.sh. [Open on skills.sh](https://www.skills.sh/imagekit-developer/skills/mcp-preflight)

## Source

[Open the source](https://github.com/imagekit-developer/skills/tree/HEAD/skills/mcp-preflight). Checked 2026-10-10. This summary may contain AI-generated text, so it can be wrong. Check the source before you rely on it.

## SKILL.md

````markdown
---
name: mcp-preflight
description: "Routing guide for ImageKit's MCP servers (DAM, Admin, DevTools). Use before any ImageKit MCP call. DAM: media library search, upload, organize, share. Admin: origins, external storage, URL endpoints, account usage, usage analytics. DevTools: docs search and transformation URLs."
---

# MCP Preflight

ImageKit has three hosted MCP servers. Call the one that matches the job.

| Job | Server | Then |
|-----|--------|------|
| Search, upload, organize, tag, share, metadata, collections, path policies, public links, cache purge | DAM (`https://imagekit.io/mcp/dam`) | See skills below when the task is search, upload, sharing, or AI tasks |
| Origins / external storage (S3, GCS, Azure, web server, …) | Admin (`https://imagekit.io/mcp/admin`) | `list_origins`, `create_origin`, `get_origin`, `update_origin`, `delete_origin` |
| URL endpoints | Admin | `list_url_endpoints`, `create_url_endpoint`, `get_url_endpoint`, `update_url_endpoint`, `delete_url_endpoint` |
| Account usage totals or usage analytics | Admin | `get_account_usage`, `get_account_usage_analytics` |
| "How do I…", API/SDK details, whether a feature exists | DevTools `search_docs` | Read the `search-docs` skill first |
| Build a transformation URL | DevTools `transformation_builder` | Read the `transformation-builder` skill first |
| Integrate ImageKit into an app, CMS, or framework | — | Read `imagekit-integrations` to pick the SDK/plugin, then `search_docs` for details |

DAM and Admin each need a separate connection and ImageKit sign-in. DevTools does not. If a tool you need is missing, the user has not connected that server (or has not granted that permission).

## When a skill actually helps

Most DAM and Admin tools are self-explanatory. Read a companion skill only for the cases below — they have calling conventions that the tool schema does not make obvious.

| Task | Skill |
|------|--------|
| Search / filter / list assets | `search-assets` — Lucene `searchQuery`, and you must discover custom metadata fields and tags before guessing |
| Upload a file | `upload-files` — picker vs signed upload; never put file bytes in chat |
| Who can access a file, folder, or collection; grant or revoke access | `asset-access-control` — file/folder ACL tools are not the same as collection ACL tools |
| Create or apply AI tagging / metadata / QC workflows | `ai-tasks` — payload shape, vocabularies, and how they attach to saved extensions |
| Which SDK, plugin, or widget to use for a stack | `imagekit-integrations` — then `search_docs` for implementation details |

## Rules

1. **DAM for the media library. Admin for origins, URL endpoints, usage, and usage analytics.** Do not search DAM for origins or usage, and do not look for file tools on Admin.
2. **Never inline file bytes** (no base64, no paths as file contents). See `upload-files`.
3. **Filter search on the server** with `search_media_library`. See `search-assets`.
4. **Use `transformation_builder`** instead of hand-crafting transformation URLs.
5. **Use `search_docs`** before writing ImageKit integration code. Do not rely on training data for method names or parameters. If you need to pick an SDK or plugin first, read `imagekit-integrations`.
````

- Previous: [upload-files](https://syn4pse.dev/terminal/imagekit-upload-files.md)
- Next: [search-docs](https://syn4pse.dev/terminal/imagekit-search-docs.md)
- [Terminal](https://syn4pse.dev/terminal.md)
- [Suggest a change](mailto:terminal@syn4pse.dev?subject=Terminal%20suggestion)
