Skip to content

Assistant tools

The assistant in the pane and a connected agent call the same tools. Every tool that works on a photo takes a photograph argument that names the subject. The path must be inside a folder you opened in Fotometis. No tool erases a photo, and no tool deletes a snapshot. See Connect an MCP client.

These tools change nothing.

Tool Description
list_folders The open folders, every folder below them, and the photo on the canvas.
list_photographs The photos in one folder, with the rating, the flag, the tags, and the edit state. A filter narrows the list by rating, flag, edit state, and tags.
describe_photograph Every control value of one photo, with its style, its curves, its layers, its patches, its tags, and what the camera recorded.
show_photograph The photo as developed now, as a JPEG. The size runs from 256 to 2048 pixels on the longest edge.
measure_photograph The distribution of brightness in the photo, and how much of each channel clips to black or white.
locate_subject The box that holds each subject and the center of its weight, as fractions of the uncropped frame.
Tool Description
set_controls Sets the controls, the tone curves, the style, and the white balance of one layer. Every value is absolute. A control left out keeps its value.
set_layers States the whole stack: the order of the layers, their names, and which ones are on. A layer left out is removed.
set_layer_mask Sets where a layer applies. If no layer carries that name, Fotometis makes one.

A patch is numbered by its position in the list, and the count starts at 0.

Tool Description
repair_photograph Paints a patch over a region of the photo. The mode is clone, heal, or erase.
adjust_repair Changes the mode, the feather, the opacity, or the source of a patch. The stroke stays where it is.
remove_repair Takes one patch off the photo. The patches after it get new numbers.
Tool Description
mark_photograph Sets the rating and the flag of a photo. It changes nothing about how the photo looks.
list_snapshots Every snapshot of a photo, with its name, its id, and which one shows.
save_snapshot Saves the current state as a new snapshot, under a name.
show_snapshot Returns the photo to a saved snapshot, by id.
Tool Description
tag_photograph Adds tags to a photo, and removes tags from it. A tag left out stays on the photo.
list_tags The tags in one folder, or in every open folder, with the number of photos that carry each one.

Fotometis never overwrites a file. If the name is taken, it writes the next free name.

Tool Description
export_photograph Writes one developed photo into a folder.
export_directory Writes every photo in a folder, narrowed by rating, flag, edit state, and tags.

Both export tools take the format, the longest edge in pixels, the color profile, and the quality. See Export a photo.