GIMP Agent MCP server

Read from the package source without running it. The installed server may list more.

• gimp_adjust

  Common adjustments without discovery. action: brightness_contrast, hue_saturation, curves, desaturate, invert, blur, sharpen, noise, pixelate. mode='append' keeps GEGL actions editable; mode='merge' bakes pixels. curves is destructive and needs params={channel:'value', points:[0,0,1,1]}. Returns the installed operation description used.

• gimp_apply_filter

  Apply a GEGL operation to a layer. mode='merge' bakes it in; mode='append' adds a non-destructive layer effect. Examples: white outline = op="gegl:dropshadow", params={"x":0,"y":0,"radius":0,"grow-radius":8,"color":"white"}; soft shadow = {"x":0,"y":6,"radius":12,"opacity":0.4}; blur = op="gegl:gaussian-blur", params={"std-dev-x":4,"std-dev-y":4}. gimp_help("filters") lists the useful ops.

• gimp_batch_recipewrite action

  Run a recipe over every file matching input_glob, writing to output_dir. Recipes must accept input_path and output_path.

• gimp_canvas

  Common canvas operations without PDB discovery. action: scale, crop, resize, rotate (angle 90/180/270), flip (direction horizontal/vertical), merge_visible, flatten. Operations bake pixels or layer structure and return the installed PDB description plus final image info.

• gimp_close_image

  Close an image without saving.

• gimp_context

  Read a document's selected layers, selection bounds and bridge colour/brush context. Optionally select layers or present a GUI document. With multiple images pass image_id; focused-image detection is unavailable, never inferred from list order.

• gimp_draw

  Fill or draw without PDB discovery. action: fill_layer, fill_selection, rectangle, ellipse, rectangle_outline, ellipse_outline, line. Colours use the normal CSS/#hex convention; coordinates are image pixels. Shapes clear their temporary selection. Drawing bakes pixels and returns every installed PDB operation used.

• gimp_drop_snapshotwrite action

  Release a stored comparison snapshot. At most 16 may be retained per bridge; snapshots are also cleaned up when the bridge closes.

• gimp_edit_batchwrite action

  Run 1..100 edits on one image in ONE undo group. steps=[{op:'layer'|'text'|'select'|'path'|'layer_mask'|'apply_filter', params:{...}}]. Params use the corresponding tool arguments; image_id is injected. Reference an earlier result with {'$ref':'0.id'}. Check complete/error: failure stops later steps, preserves partial work, and always closes the undo group. One Ctrl+Z in GIMP reverts it; this is n

• gimp_export

  Export an image; the extension chooses the format (.png .webp .jpg .tiff .bmp .gif .xcf). options are passed to the format's export procedure, e.g. {"quality": 0.85} for JPEG (0..1), {"quality": 80, "lossless": false} for WebP, {"compression": 9} for PNG. Unknown option names return the valid list.

• gimp_filter_describe

  Describe a GEGL operation's properties (names, types, ranges, defaults).

• gimp_filter_search

  Search the GEGL operations available as filters (e.g. 'blur', 'shadow', 'levels', 'noise').

• gimp_help

  Read this first. How to work with GIMP through this server, by topic: start, filters, colours, text, masks, paths, layers, measure, recipes, compose, errors, or all.

• gimp_image_info

  Full structure of one image: layer tree with item ids, channels, paths, selection bounds, resolution.

• gimp_launch

  Start GIMP 3 with the bridge running. mode='gui' opens the normal window; 'headless' runs gimp-console with no UI.

• gimp_layer

  Layer operations. action: new (image_id, name, width, height, fill, x, y, position), set (name, visible, opacity, mode, x, y, lock), move (dx, dy), reorder (position, parent_id), duplicate, merge_down, delete, resize_to_image, scale (width, height), add_alpha, crop_to_content, info.

• gimp_layer_effect

  Edit or delete a non-destructive layer effect (ids from gimp_layer_effects). action='set' updates params/visible/opacity/blend_mode; 'delete' removes it.

• gimp_layer_effects

  List the non-destructive filters currently attached to a layer.

• gimp_layer_mask

  Layer masks. action='add' with type selection|alpha|alpha-transfer|white|black|copy; 'apply' bakes the mask in; 'remove' discards it; 'enable'/'disable' toggle it; 'show'/'hide' preview it.

• gimp_list_fonts

  List installed font names, optionally filtered by a regex.

• gimp_list_images

  List open images with ids, dimensions, file path, and layer count.

• gimp_list_recipes

  List tested multi-step recipes and their parameters.

• gimp_measure

  Measure pixels instead of guessing from a render. kind='color' (rgba at image x,y), 'bbox' (bounding box of non-transparent pixels), 'histogram' (mean/median/std per channel), 'dominant' (top k colours). Defaults to the selected layer.

• gimp_new_imagewrite action

  Create an RGB image with one layer. fill: 'transparent', 'white', 'black', 'foreground', 'background' or any colour.

• gimp_open

  Open an image file (PNG, JPEG, WebP, XCF, PSD, SVG, ...) and return its structure.

• gimp_path

  Vector paths. action='create' (image_id, strokes=[{type:'line'|'bezier', points:[[x,y],...], closed:bool}]; bezier points after the first are control1, control2, anchor triples), 'select' (path to selection), 'stroke' (draw it on layer_id with color and width), 'fill' (fill it on layer_id), 'delete'.

• gimp_pdb_call

  Call any PDB procedure by name with arguments keyed by name. Pass images/items as ids, colours as strings, enums by nick. Example: name="gimp-image-scale", args={"image": 3, "new-width": 800, "new-height": 600}; name="gimp-image-select-round-rectangle", args={"image": 3, "operation": "replace", "x": 10, "y": 10, "width": 200, "height": 80, "corner-radius-x": 20, "corner-radius-y": 20}. Use gimp_pd

• gimp_pdb_describe

  Describe a PDB procedure: arguments with types, defaults and enum choices, plus return values.

• gimp_pdb_search

  Search GIMP's Procedure Database by words in the procedure name (e.g. 'image scale', 'layer text', 'file png').

• gimp_remove_backgroundwrite action

  AI subject cut-out. Runs a segmentation model on the layer and writes the result as an editable layer mask (mode='mask') or bakes it into the alpha channel (mode='apply'). Needs the optional segmentation extra. Models: u2net (default), isnet-general-use, u2net_human_seg, isnet-anime, silueta.

• gimp_render

  Render an image as PNG. layer_id isolates a layer; region crops. Diagnostic overlays may include grid, layers, selection and points. points=[{"x": 100, "y": 80, "label": "target"}]. Overlays affect only the returned preview.

• gimp_render_compare

  Side-by-side render of a snapshot and the current image. panels is a comma list of before, after, diff (diff = pixel difference, black means identical).

• gimp_run_pythonwrite action

  Run Python inside GIMP. Gimp, Gegl, Gio, GLib and helpers image_by_id/item_by_id/make_color are available; the namespace persists between calls. Returns stdout plus the expression value or `result`. Pass image_id to wrap the call in one undo step.

• gimp_run_recipewrite action

  Run a recipe by name with parameters. Recipes are Python jobs executed inside GIMP with defaults applied.

• gimp_select

  Selection in one tool. mode: rect, ellipse (x,y,width,height), color (color, threshold 0..1, layer_id), alpha (layer_id: select the layer's opaque pixels), item (item_id: path or channel), all, none, invert, grow/shrink/feather/border (amount), bounds (just report). op: replace, add, subtract, intersect. Returns the selection bounds.

• gimp_shutdown

  Stop the bridge. quit_gimp defaults to True for headless sessions and False for the GUI (unsaved work is not prompted for).

• gimp_snapshot

  Take a hidden snapshot of an image's current state so gimp_render_compare can show before/after later.

• gimp_status

  Check whether GIMP and the agent bridge are reachable. Returns GIMP version, mode, and open images.

• gimp_textwrite action

  Create a text layer (image_id + text) or edit one (layer_id). size in px, font by name (gimp_list_fonts), colour, justify left|center|right|fill, spacing, optional fixed box.

• Code scan28 source files scanned20/25
• –Live reliabilityno gateway calls yet and no remote to proben/a
• –Tool poisoningtools not inspected (local package is not executed); not countedn/a
• Auth qualitylocal package, no credentials required12/15
• Maintenancelast push 0 days ago15/15
• Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10

Safety score

85/100

higher than 73% of 4,460 AI and agents servers

Tools

39

the typical AI and agents server has 6

Tools that change things

21%

typical: 0%. Fewer write tools means less an agent can break

GitHub stars

4

more than 77% of 2,711 AI and agents servers

Downloads a week

104

more than 65% of 1,538 AI and agents servers with a package

GIMP Agent MCP: common questions

Is GIMP Agent MCP server safe?

Yes, by our scan: it is graded A (85/100). Read the GIMP Agent MCP safety report

How do I install GIMP Agent MCP?

It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.

Does GIMP Agent MCP need an API key?

No secret keys are declared. It reads 1 setting from the environment.

Is GIMP Agent MCP maintained?

The last commit was 20 days ago (2026-10-15). The latest release is v0.5.0.

What can I use instead of GIMP Agent MCP?

Servers from other publishers that do the same job: Openflowkit MCP server, Pm Claude Skills MCP server and Agent-Native Slides MCP server.

How does GIMP Agent MCP compare with other AI and agents MCP servers?

safety score 85/100 (higher than 73% of 4,460 AI and agents servers); tools 39 (the typical AI and agents server has 6); tools that change things 21% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.