Mcp Photo Edit

Advanced Image Info

• Use preview_path for aesthetic intent and overall image judgment.
• Use diagnostic_dashboard_path for quick technical pattern reading, especially clipping, balance, and saturation distribution.
• Use diagnostic_summary for exact numeric facts when deciding whether exposure, white balance, or saturation still needs adjustment.
• Use the current adjustment state for continuity, so each patch builds on the session's actual edit history instead of re-inferencing from scratch.
• When dashboard and preview disagree, favor the preview for aesthetic intent and the summary JSON for hard facts.
• When advanced image info is disabled or absent, stay preview-first and continue using the current adjustment state and history as the source of continuity.

Editing Order

Follow this order unless the user asks for a different look:

1. Composition first: crop and orientation before tonal polish.
2. White balance next: color temperature and green balance before stronger tonal shaping.
3. Tone and exposure: adjust exposure, highlights, shadows, and contrast after the image is framed and balanced.
4. Saturation after tone is stable: avoid pushing color until exposure and white balance are settled.
5. Finishing last: denoise and sharpening should come after the image's core look is established.

Guardrails

• Do not over-trust histograms or chase a perfectly centered graph.
• Do not flatten stylized scenes into technical neutrality when the image intentionally reads warm, cool, low-key, high-key, or otherwise stylized.
• Do not assume the most technically neutral result is always the right edit.
• Treat diagnostic signals as support for judgment, not as a replacement for the preview.

Interactive Mode

• If the user requests "interactive mode", you MUST NOT automatically call export_image.
• Once you believe the edits are complete based on the preview, stop and ask the user for confirmation (e.g., using the ask_user tool or simply asking in the chat).
• Only call export_image after the user has explicitly confirmed the preview is satisfactory.

Preview History

• Every preview render is preserved as a numbered artifact.
• preview_path always points at the latest preview.
• preview_count tells you how many preview artifacts exist for the session.

Undo / Redo

• Semantic edit history is tracked separately from preview history.
• history_index points to the current committed edit step.
• can_undo and can_redo indicate whether cursor movement is available.
• Applying a new edit after undo truncates the redo branch.

Adjustment Notes

• crop uses normalized 0..1 coordinates.
• orientation uses quarter turns: -90, 0, 90, 180.
• rgb_mixer uses per-output RGB rows in percentage units.
• denoise_luma, denoise_detail, and denoise_chroma are separate controls.
• color_temperature and green_balance provide manual white balance control.
• sharpen_amount, sharpen_radius, and sharpen_contrast control the main sharpening tool.
• Prefer incremental changes instead of large blind jumps.

Example Patch

{
  "exposure": 0.8,
  "contrast": 12,
  "saturation": 8,
  "denoise_luma": 10,
  "denoise_chroma": 18,
  "color_temperature": 5200,
  "green_balance": 1.03,
  "highlights": 12,
  "shadows": 16,
  "sharpen_amount": 180,
  "sharpen_radius": 0.8,
  "sharpen_contrast": 30,
  "orientation": 90,
  "crop": {
    "left": 0.1,
    "top": 0.1,
    "right": 0.9,
    "bottom": 0.95
  }
}

Notes

• This skill assumes RawTherapee is the active backend.
• The legacy darktable-cli backend has been removed.