culling

analyze_photos

Run AI quality scoring and auto-culling on all pending photos.

What it does

Scores sharpness, exposure, and composition, detects duplicates, and sorts photos into keep, trash, or culled (undecided). Optional thresholds are 0.0 to 1.0: a photo scoring at or above keep_threshold becomes keep, at or below trash_threshold becomes trash. Leave both unset to use the user's configured defaults. Can take a while on a large library; heavier AI models are skipped automatically when not installed. Returns analysis stats plus per-status library counts.

Parameters

NameTypeRequired
keep_threshold float | None optional
trash_threshold float | None optional

Asking for it

You do not call this by name. You say what you want, and the agent picks the tool:

Cull the wedding shoot in D:/Shoots/eva_tom, keep the best frames, and tell me what you dropped.

The rest of the culling tools

reselect_photos set_photo_status

Workflows that use it

Where it runs

On your machine. imagic's MCP server is a local process that your AI client starts; the photos never leave your disk and nothing is uploaded. That is true of every tool in the reference, including this one.

To call it you need an MCP client connected to imagic. Setup takes about three minutes for Claude Code, Cursor, VS Code, Codex, Gemini CLI and ten others.

Give your AI the whole pipeline

analyze_photos is one of 18 tools in imagic Max. The free 7-day trial includes all of them.