Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, get in touch and we’ll put it right.

GIMP

PYPI · GIMP-MCP

Inspect and edit images in a running GIMP 3.2+ (layers, text, filters, files) from any MCP client.

Available components

+3 this week 71 Trust /100

Last scanned (17 hours ago)

Scores higher than 64% of PyPI servers

Category Design and Media

Trust breakdown (7 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →

Supply Chain Security50
  • Malware scan not yet available for this package.Unverified
  • No known CVEs affecting this package version or its production dependencies.Pass
  • Runs uv_build at install time, a recognised build step with no custom scripting around it. View diagnostics → Pass
  • 1 of 28 dependencies flagged as unhealthy. View diagnostics → Partial
Provenance & Transparency100
  • Source repository is publicly reachable at the declared URL. View diagnostics → Pass
  • Cryptographically verified build provenance (signed, bound to mhbxyz/gimp-mcp). View diagnostics → Pass
  • Clear OSI-approved license (MIT).Pass
  • Actively maintained (last published 7 days ago).Pass
  • Publishes a security disclosure policy (SECURITY.md).Pass
Schema Quality & AI Usability77
  • 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
  • AI-judged instruction clarity (good).Pass
  • Context-footprint check failed: tool/resource definitions use about 6494 tokens (~129/item across 50 items; 49 tools + 1 resources), over budget; trim descriptions and params. See how to fix → Fail
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management39
  • Stability check failed: the tool surface changed between 0.5.0 and 0.7.0: 2 tool removals, 0 breaking changes, 1 additions. See how to fix → Fail
Tool Coverage86
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 51% of tool parameters carry a description.Partial
  • Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Tool Safety100
  • No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
  • All 4 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.Pass
  • An AI judge read all 51 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
  • Implements a current MCP spec version (2026-07-28).Pass
What we tested

Checks we ran (15)

  • Known CVEs
  • Install scripts
  • Dependency health
  • Source repository
  • Provenance
  • License
  • Maintenance
  • Security disclosure
  • Schema quality
  • Stability
  • Tool coverage
  • Injection markers
  • Destructive annotations
  • Judged manipulation
  • MCP protocol

Checks we could not complete (1)

These are gaps on our side, not findings about this package. We only credit what we can confirm, so a category made up entirely of them scores 0.

  • Malware scan in Supply Chain SecurityMalware scan not yet available for this package.

Does not apply to this package (2)

  • Endpoint SecurityScored on hosted endpoints only. A package has no live endpoint of its own for us to probe.
  • Transport & ReachabilityScored on hosted endpoints only. A package has no live endpoint of its own for us to probe.

The score does not measure everything. What the score does not measure →

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 21 Nov 26 −15
    • Malware scan: pass → unverified ▼ security
  • 20 Nov 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 33 to 36.

  • 19 Nov 26 +15
    • Malware scan: unverified → pass ▲ security
  • 18 Nov 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 26 to 29.

  • 16 Nov 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 19 to 23.

  • 13 Nov 26 −14
    • Malware scan: pass → unverified ▼ security
  • 12 Nov 26 +15
    • Stability: 0.10 → fail ▼ security
    • Malware scan: unverified → pass ▲ security
    • Package version: 0.6.0 → 0.7.0 functional
  • 11 Nov 26 −15
    • Malware scan: pass → unverified ▼ security
Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 21 Nov 2026 · Analysed pypi/gimp-mcp@0.7.0

Provenance Verified

A signed build attestation was found and verified, binding this exact artifact to the source repository it claims to come from.

Result Verified
Ecosystem pypi
Reason Verified
Discovered via Registry attestation endpoint
Source repo mhbxyz/gimp-mcp
Certificate issuer https://token.actions.githubusercontent.com
Certificate SAN https://github.com/mhbxyz/gimp-mcp/.github/workflows/release.yml@refs/tags/v0.7.0
Rekor log index 3826002871
Predicate type PyPI publish attestation https://docs.pypi.org/attestations/publish/v1
Subject digest sha256:4e6bfc64f2150b77f2d01f8941d17eb4cd0e6d16f7da5fc626824c2a6bc01791

Background: How many MCP packages publish verified provenance →

Install scripts 1 script
Hook Tier Command
build_backend Known build tool uv_build

Background: Why install scripts are a supply-chain risk →

Dependencies 28 packages
Packages resolved 28
No linked repository 1
Tree resolution Complete

Background: SBOMs and build attestations, explained →

MCP tools · 49 exposed · ~6,310 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →

Tool Tokens
gimp_add_layer_mask ~139

Add a mask to a layer or group. fill: 'white' (everything visible), 'black' (everything hidden), 'alpha' (from the layer's transparency), 'selection' (selected = visible; EMPTY_SELECTION if nothing is selected), 'grayscale' (from the layer's luminance). invert inverts it. Non-destructive: the layer's pixels are kept. One undo step.

NameTypeReqDescription
fillstring––
invertboolean––
itemstringyesItem id (layer, group, mask...) e.g. 'item:5@a1b2c3d4'.
NameTypeReqDescription
children––Child layers of a group, top-most first; null for non-groups.
has_alphabooleanyes–
heightintegeryes–
idstringyes–
kindstringyes–
locks–yes–
mask–yes–
modestringyesGIMP layer mode nick, e.g. 'normal', 'multiply'.
namestringyesLayer name. GIMP keeps names unique within an image ('Title #1').
opacitynumberyes0-100.
parent–yesId of the parent group, null at the top level.
visiblebooleanyes–
widthintegeryes–
xintegeryesOffset of the layer's top-left corner in image pixels.
yintegeryes–

No examples provided.

gimp_brightness_contrast ~203

Adjust brightness and contrast of a layer, each from -100 to 100 (0 = unchanged; GIMP's -1..1 curve, not a percentage: on mid-gray 128, brightness -30 gives 119 (7% darker), -100 gives 92; contrast pivots on light gray, +30 turns 128 into 54). For 'N% darker/lighter' use gimp_hue_saturation lightness -N/+N. One undo step.

NameTypeReqDescription
brightnessnumber––
contrastnumber––
destructiveboolean–true: change the layer's pixels (respects the selection). false: add an editable GIMP filter on the layer (pixels untouched, removable, saved in XCF; applied to the whole layer).
itemstringyesItem id (layer, group, mask...) e.g. 'item:5@a1b2c3d4'.
NameTypeReqDescription
destructivebooleanyesTrue when the layer's pixels were changed.
filter–yesId of the editable filter (non-destructive only), verified to exist.
idstring––
itemstringyes–
operationstringyesGEGL/GIMP operation that was applied.
restricted_to_selectionbooleanyesTrue when only the selected area was changed.

No examples provided.

gimp_close_image ~96

Close an image. Refused with UNSAVED_CHANGES when it has unsaved changes, unless discard_changes=true. Its id (and its items' ids) become invalid. Not undoable: the image and its undo history are gone.

NameTypeReqDescription
discard_changesboolean––
imagestringyesImage id from gimp_status, e.g. 'image:1@a1b2c3d4'.
NameTypeReqDescription
closedbooleanyes–
imagestringyes–

No examples provided.

gimp_create_checkpoint ~98

Keep a full copy of the image's current state (layers, text, masks, filters, selection) so it can be restored later: this is how to undo/redo. Copies are hidden from image lists and use memory; at most 20 per image.

NameTypeReqDescription
imagestringyesImage id from gimp_status, e.g. 'image:1@a1b2c3d4'.
label–––
NameTypeReqDescription
checkpointstringyes–
creatednumberyesUnix time.
heightintegeryes–
imagestringyesImage the checkpoint belongs to (follows restorations).
label–yes–
widthintegeryes–

No examples provided.

gimp_create_group ~104

Add an empty layer group at an explicit parent and position. One undo step.

NameTypeReqDescription
imagestringyesImage id from gimp_status, e.g. 'image:1@a1b2c3d4'.
namestringyes–
parent––Group id to put the layer in; null for the top level of the image.
positioninteger–Index within the parent, 0 = top-most (in front).
NameTypeReqDescription
children––Child layers of a group, top-most first; null for non-groups.
has_alphabooleanyes–
heightintegeryes–
idstringyes–
kindstringyes–
locks–yes–
mask–yes–
modestringyesGIMP layer mode nick, e.g. 'normal', 'multiply'.
namestringyesLayer name. GIMP keeps names unique within an image ('Title #1').
opacitynumberyes0-100.
parent–yesId of the parent group, null at the top level.
visiblebooleanyes–
widthintegeryes–
xintegeryesOffset of the layer's top-left corner in image pixels.
yintegeryes–

No examples provided.

gimp_create_image ~151

Create a new image with a single layer named layer_name filled with an explicit color (default white; 'transparent' gives an alpha layer). Like a new image in GIMP's UI, it starts without unsaved changes and without undo history. Shown in a window when GIMP has a UI.

NameTypeReqDescription
base_typestring––
fillstring–sRGB color as '#rrggbb', '#rrggbbaa', '#rgb' or one of: white, black, red, green, blue, transparent
heightintegeryesPixels.
layer_namestring––
resolution––Pixels per inch.
widthintegeryesPixels.
NameTypeReqDescription
dirtybooleanyes–
displayedbooleanyesTrue when a GIMP window shows the image (GUI sessions only).
file–yes–
heightintegeryes–
idstringyes–
layer_countintegeryesNumber of top-level layers.
namestringyesGIMP's display name (may be localized).
widthintegeryes–
xcf_file–yes–

No examples provided.

gimp_create_layer ~296

Add a new raster layer (with alpha) to an image, at an explicit parent and position. Size and offset are in image pixels (default: the image size at 0,0). fill: 'transparent' or a color. One undo step.

NameTypeReqDescription
fillstring–sRGB color as '#rrggbb', '#rrggbbaa', '#rgb' or one of: white, black, red, green, blue, transparent
height–––
imagestringyesImage id from gimp_status, e.g. 'image:1@a1b2c3d4'.
modestring–GIMP layer mode nick, e.g. normal, multiply, screen, overlay, soft-light, hard-light, addition, subtract, difference, darken-only, lighten-only, hue, saturation, color, dodge, burn, pass-through (gro…
namestringyes–
opacitynumber–0 (transparent) - 100 (opaque).
parent––Group id to put the layer in; null for the top level of the image.
positioninteger–Index within the parent, 0 = top-most (in front).
visibleboolean––
width–––
xinteger––
yinteger––
NameTypeReqDescription
children––Child layers of a group, top-most first; null for non-groups.
has_alphabooleanyes–
heightintegeryes–
idstringyes–
kindstringyes–
locks–yes–
mask–yes–
modestringyesGIMP layer mode nick, e.g. 'normal', 'multiply'.
namestringyesLayer name. GIMP keeps names unique within an image ('Title #1').
opacitynumberyes0-100.
parent–yesId of the parent group, null at the top level.
visiblebooleanyes–
widthintegeryes–
xintegeryesOffset of the layer's top-left corner in image pixels.
yintegeryes–

No examples provided.

gimp_create_text_layer ~303

Add an editable text layer. Position (x, y) is the top-left corner in image pixels. size is in size_unit ('px' or 'pt'). Without box_width/box_height the layer grows with the text; with both, the text wraps in a fixed box. The text stays editable (never rasterized). One undo step. Rich text, outlines, vertical text: gimp_set_text_style (toolset typography).

NameTypeReqDescription
antialiasboolean––
box_height–––
box_width–––
colorstring–sRGB color as '#rrggbb', '#rrggbbaa', '#rgb' or one of: white, black, red, green, blue, transparent
fontstring––
imagestringyesImage id from gimp_status, e.g. 'image:1@a1b2c3d4'.
justifystring––
letter_spacingnumber––
line_spacingnumber––
parent––Group id to put the layer in; null for the top level of the image.
positioninteger–Index within the parent, 0 = top-most (in front).
sizenumber–Font size, in size_unit.
size_unitstring––
textstringyes–
xinteger––
yinteger––
NameTypeReqDescription
children––Child layers of a group, top-most first; null for non-groups.
has_alphabooleanyes–
heightintegeryes–
idstringyes–
kindstringyes–
locks–yes–
mask–yes–
modestringyesGIMP layer mode nick, e.g. 'normal', 'multiply'.
namestringyesLayer name. GIMP keeps names unique within an image ('Title #1').
opacitynumberyes0-100.
parent–yesId of the parent group, null at the top level.
visiblebooleanyes–
widthintegeryes–
xintegeryesOffset of the layer's top-left corner in image pixels.
yintegeryes–

No examples provided.

gimp_crop_image ~111

Crop the image to the rectangle (x, y, width, height) in image pixels, which must lie inside the canvas. Destructive: layer pixels outside the rectangle are discarded. One undo step.

NameTypeReqDescription
heightintegeryesPixels.
imagestringyesImage id from gimp_status, e.g. 'image:1@a1b2c3d4'.
widthintegeryesPixels.
xintegeryes–
yintegeryes–
NameTypeReqDescription
dirtybooleanyes–
heightintegeryes–
idstring––
imagestringyes–
widthintegeryes–

No examples provided.

gimp_delete_checkpoint ~50

Free a checkpoint's memory. Closing an image deletes its checkpoints too. Checkpoints are not in GIMP's undo history.

NameTypeReqDescription
checkpointstringyesCheckpoint id from gimp_create_checkpoint.
NameTypeReqDescription
checkpointstringyes–
deletedbooleanyes–

No examples provided.

gimp_delete_layer ~83

Remove a layer or a group with all its children. Destructive: the pixels are lost unless undone in GIMP or the image is reverted from a saved file. Ids of removed items become invalid.

NameTypeReqDescription
itemstringyesItem id (layer, group, mask...) e.g. 'item:5@a1b2c3d4'.
NameTypeReqDescription
deletedbooleanyes–
itemstringyes–

No examples provided.

gimp_draw_path ~208

Stroke a polyline through points [[x, y], ...] (image pixels, at least 2 points) with a plain line of the given width, color and opacity; closed=true joins the last point to the first. Uses a solid line, never the user's brush. Points outside the layer are clipped. One undo step.

NameTypeReqDescription
antialiasboolean––
capstring––
closedboolean––
colorstringyessRGB color as '#rrggbb', '#rrggbbaa', '#rgb' or one of: white, black, red, green, blue, transparent
itemstringyesItem id (layer, group, mask...) e.g. 'item:5@a1b2c3d4'.
joinstring––
opacitynumber–0-100.
pointsarrayyes–
widthnumber–Line width in pixels.
NameTypeReqDescription
affected–yesImage-space box of the pixels that may have changed.
changedbooleanyesFalse when the painted area does not intersect the layer.
idstring––
itemstringyes–

No examples provided.

gimp_draw_shape ~238

Draw a rectangle or an ellipse (inscribed in x, y, width, height) on a layer, filled with fill_color and/or outlined with stroke_color (stroke centered on the outline). The image's selection is left unchanged. One undo step.

NameTypeReqDescription
antialiasboolean––
fill_color––sRGB color as '#rrggbb', '#rrggbbaa', '#rgb' or one of: white, black, red, green, blue, transparent
heightnumberyes–
itemstringyesItem id (layer, group, mask...) e.g. 'item:5@a1b2c3d4'.
opacitynumber–0-100.
shapestringyes–
stroke_color––sRGB color as '#rrggbb', '#rrggbbaa', '#rgb' or one of: white, black, red, green, blue, transparent
stroke_widthnumber–Line width in pixels.
widthnumberyes–
xnumberyes–
ynumberyes–
NameTypeReqDescription
affected–yesImage-space box of the pixels that may have changed.
changedbooleanyesFalse when the painted area does not intersect the layer.
idstring––
itemstringyes–

No examples provided.

gimp_duplicate_layer ~109

Copy a layer or a whole group (with masks and children). By default the copy is placed just above the original in the same parent. GIMP names it '<name> copy'. One undo step.

NameTypeReqDescription
itemstringyesItem id (layer, group, mask...) e.g. 'item:5@a1b2c3d4'.
parent––Group id to put the layer in; null for the top level of the image.
position–––
NameTypeReqDescription
children––Child layers of a group, top-most first; null for non-groups.
has_alphabooleanyes–
heightintegeryes–
idstringyes–
kindstringyes–
locks–yes–
mask–yes–
modestringyesGIMP layer mode nick, e.g. 'normal', 'multiply'.
namestringyesLayer name. GIMP keeps names unique within an image ('Title #1').
opacitynumberyes0-100.
parent–yesId of the parent group, null at the top level.
visiblebooleanyes–
widthintegeryes–
xintegeryesOffset of the layer's top-left corner in image pixels.
yintegeryes–

No examples provided.

gimp_enable_toolsets ~112

Add the tools of one or more toolsets (see gimp_list_toolsets) to your tool list for this session. The result gives each added tool's signature (usage): call them with those arguments. The server notifies the client that its tool list changed; a client that does not refresh its tool list needs a restart with the toolsets in --toolsets or GIMP_MCP_TOOLSETS. Images and their undo history are untouched.

NameTypeReqDescription
toolsetsarrayyesToolset names.
NameTypeReqDescription
added_toolsarrayyesTools added to the tool list by this call.
enabledarrayyesToolsets enabled now.
usagearray–How to call each added tool.

No examples provided.

gimp_export_image ~168

Export the visible composite of the image to PNG or JPEG (format from the extension). The image itself is not modified. Existing files are only replaced when overwrite=true. Defaults: PNG compression 9, not interlaced; JPEG quality 90, baseline, optimized, transparency flattened on white. WebP, AVIF, TIFF, PDF…: gimp_export_as (toolset formats). The undo history is unchanged.

NameTypeReqDescription
format–––
imagestringyesImage id from gimp_status, e.g. 'image:1@a1b2c3d4'.
jpeg_options–––
overwriteboolean––
pathstringyesAbsolute path ending in .png, .jpg or .jpeg.
png_options–––
NameTypeReqDescription
bytesintegeryes–
formatstringyes–
heightintegeryes–
imagestringyes–
optionsobjectyesEffective encoder options.
pathstringyes–
widthintegeryes–

No examples provided.

gimp_fill ~226

Fill a layer (or layer mask) with a solid color. area='selection' fills the selected part only (EMPTY_SELECTION if nothing is selected); area='layer' fills the whole layer and ignores (but keeps) the selection. Destructive for the pixels it covers. One undo step.

NameTypeReqDescription
areastring––
colorstringyessRGB color as '#rrggbb', '#rrggbbaa', '#rgb' or one of: white, black, red, green, blue, transparent
itemstringyesItem id (layer, group, mask...) e.g. 'item:5@a1b2c3d4'.
modestring–GIMP layer mode nick, e.g. normal, multiply, screen, overlay, soft-light, hard-light, addition, subtract, difference, darken-only, lighten-only, hue, saturation, color, dodge, burn, pass-through (gro…
opacitynumber–0-100.
NameTypeReqDescription
affected–yesImage-space box of the pixels that may have changed.
changedbooleanyesFalse when the painted area does not intersect the layer.
idstring––
itemstringyes–

No examples provided.

gimp_flip_layer ~68

Mirror a layer or group horizontally or vertically around its center. Lossless. One undo step.

NameTypeReqDescription
directionstringyes–
itemstringyesItem id (layer, group, mask...) e.g. 'item:5@a1b2c3d4'.
NameTypeReqDescription
children––Child layers of a group, top-most first; null for non-groups.
has_alphabooleanyes–
heightintegeryes–
idstringyes–
kindstringyes–
locks–yes–
mask–yes–
modestringyesGIMP layer mode nick, e.g. 'normal', 'multiply'.
namestringyesLayer name. GIMP keeps names unique within an image ('Title #1').
opacitynumberyes0-100.
parent–yesId of the parent group, null at the top level.
visiblebooleanyes–
widthintegeryes–
xintegeryesOffset of the layer's top-left corner in image pixels.
yintegeryes–

No examples provided.

gimp_gaussian_blur ~147

Blur a layer with a Gaussian of standard deviation `radius` pixels (radius_y defaults to radius). One undo step. Any other GEGL filter: gimp_apply_filter (toolset effects).

NameTypeReqDescription
destructiveboolean–true: change the layer's pixels (respects the selection). false: add an editable GIMP filter on the layer (pixels untouched, removable, saved in XCF; applied to the whole layer).
itemstringyesItem id (layer, group, mask...) e.g. 'item:5@a1b2c3d4'.
radiusnumberyesStandard deviation in pixels.
radius_y–––
NameTypeReqDescription
destructivebooleanyesTrue when the layer's pixels were changed.
filter–yesId of the editable filter (non-destructive only), verified to exist.
idstring––
itemstringyes–
operationstringyesGEGL/GIMP operation that was applied.
restricted_to_selectionbooleanyesTrue when only the selected area was changed.

No examples provided.

gimp_get_selection ~70

Whether the image has a selection, its bounds, and optionally whether a point is selected.

NameTypeReqDescription
imagestringyesImage id from gimp_status, e.g. 'image:1@a1b2c3d4'.
probe_x–––
probe_y–––
NameTypeReqDescription
bounds–yesBounding box of the selection, clipped to the canvas; null when empty.
contains––Whether (probe_x, probe_y) is selected (> 50%), when a probe point was given.
emptybooleanyes–
idstring––
imagestringyes–

No examples provided.

gimp_hue_saturation ~233

Rotate hue (degrees, -180..180) and change saturation and lightness (-100..100, 0 = unchanged) of a layer, for all colors or one hue range. Lightness is proportional: -30 makes it 30% darker (mid-gray 128 -> 90), +30 goes 30% of the way to white (128 -> 166). One undo step. Levels, curves, exposure…: gimp_levels (toolset color).

NameTypeReqDescription
destructiveboolean–true: change the layer's pixels (respects the selection). false: add an editable GIMP filter on the layer (pixels untouched, removable, saved in XCF; applied to the whole layer).
huenumber––
hue_rangestring––
itemstringyesItem id (layer, group, mask...) e.g. 'item:5@a1b2c3d4'.
lightnessnumber––
overlapnumber–Blend with neighbouring ranges, 0-100.
saturationnumber––
NameTypeReqDescription
destructivebooleanyesTrue when the layer's pixels were changed.
filter–yesId of the editable filter (non-destructive only), verified to exist.
idstring––
itemstringyes–
operationstringyesGEGL/GIMP operation that was applied.
restricted_to_selectionbooleanyesTrue when only the selected area was changed.

No examples provided.

gimp_import_layer ~170

Load an image file (PNG, JPEG, XCF... absolute path) as a new layer of an existing image. Multi-layer files are flattened into one layer. Placed at x,y (default 0,0); name defaults to the file name. One undo step.

NameTypeReqDescription
imagestringyesImage id from gimp_status, e.g. 'image:1@a1b2c3d4'.
name–––
parent––Group id to put the layer in; null for the top level of the image.
pathstringyesAbsolute path of the file to import.
positioninteger–Index within the parent, 0 = top-most (in front).
xinteger––
yinteger––
NameTypeReqDescription
children––Child layers of a group, top-most first; null for non-groups.
has_alphabooleanyes–
heightintegeryes–
idstringyes–
kindstringyes–
locks–yes–
mask–yes–
modestringyesGIMP layer mode nick, e.g. 'normal', 'multiply'.
namestringyesLayer name. GIMP keeps names unique within an image ('Title #1').
opacitynumberyes0-100.
parent–yesId of the parent group, null at the top level.
visiblebooleanyes–
widthintegeryes–
xintegeryesOffset of the layer's top-left corner in image pixels.
yintegeryes–

No examples provided.

gimp_inspect_image ~91

Describe one image: size, mode, precision, resolution, unsaved changes, associated files and the full ordered layer tree (groups, children, masks, offsets, opacity, blend mode, locks). Does not depend on GIMP's active selection.

NameTypeReqDescription
imagestringyesImage id from gimp_status, e.g. 'image:1@a1b2c3d4'.
NameTypeReqDescription
base_typestringyes'rgb', 'gray' or 'indexed'.
channelsarray–Saved selections and masks.
dirtybooleanyes–
exported_file–yes–
file–yes–
heightintegeryes–
idstringyes–
imported_file–yes–
layersarrayyesLayer tree, top-most layer first.
namestringyesGIMP's display name (may be localized).
pathsarray–Paths (vectors), top first.
precisionstringyes–
resolution–yes–
unit––Display/print unit abbreviation, e.g. 'in', 'mm'.
widthintegeryes–
xcf_file–yesXCF file the image was loaded from or saved to.

No examples provided.

gimp_inspect_item ~86

Describe one item by id: kind (layer, group, text, mask, channel, path), owning image, parent and position, and its layer properties. Fails with NOT_FOUND once the item is deleted.

NameTypeReqDescription
itemstringyesItem id (layer, group, mask...) e.g. 'item:5@a1b2c3d4'.
NameTypeReqDescription
children––Child ids for groups, top-most first.
has_alpha–––
height–––
idstringyes–
imagestringyes–
kindstringyes–
locks–––
mask–––
mode–––
namestringyes–
opacity–––
parent–yesParent group id (layers) or owning layer id (masks).
position–yesIndex within the parent, 0 = top-most.
visiblebooleanyes–
width–––
x–––
y–––

No examples provided.

gimp_inspect_text ~64

Text, font, size and unit, color, justification, spacing, antialiasing and geometry.

NameTypeReqDescription
itemstringyesItem id (layer, group, mask...) e.g. 'item:5@a1b2c3d4'.
NameTypeReqDescription
antialiasbooleanyes–
colorstringyes#rrggbb (sRGB).
fontstringyes–
heightintegeryes–
itemstringyes–
justifystringyes–
letter_spacingnumberyesExtra pixels between letters.
line_spacingnumberyesExtra pixels between lines.
sizenumberyes–
size_unitstringyes'px' (pixels) or 'pt' (points, converted with the image resolution).
textstringyes–
widthintegeryes–
xintegeryes–
yintegeryes–

No examples provided.

gimp_list_checkpoints ~50

Checkpoints of an image, oldest first.

NameTypeReqDescription
imagestringyesImage id from gimp_status, e.g. 'image:1@a1b2c3d4'.
NameTypeReqDescription
checkpointsarrayyesOldest first.
imagestringyes–

No examples provided.

gimp_list_filters ~54

Editable (non-destructive) filters attached to a layer.

NameTypeReqDescription
itemstringyesItem id (layer, group, mask...) e.g. 'item:5@a1b2c3d4'.
NameTypeReqDescription
filtersarrayyesEditable filters on the layer, top of the filter stack first (most recently added first).
idstring––
itemstringyes–

No examples provided.

gimp_list_fonts ~38

Fonts GIMP knows (fontconfig names), filtered by a substring.

NameTypeReqDescription
limitinteger––
querystring––
NameTypeReqDescription
fontsarrayyes–
totalintegeryes–

No examples provided.

gimp_list_toolsets ~51

List the groups of GIMP tools (toolsets), what each contains and which are enabled. Tools of disabled toolsets are not in your tool list: enable them with gimp_enable_toolsets.

Input schema present but exposes no named parameters.

NameTypeReqDescription
toolsetsarrayyes–

No examples provided.

gimp_modify_selection ~73

'all' selects the whole canvas, 'none' clears the selection, 'invert' inverts it. One undo step.

NameTypeReqDescription
actionstringyes–
imagestringyesImage id from gimp_status, e.g. 'image:1@a1b2c3d4'.
NameTypeReqDescription
bounds–yesBounding box of the selection, clipped to the canvas; null when empty.
contains––Whether (probe_x, probe_y) is selected (> 50%), when a probe point was given.
emptybooleanyes–
idstring––
imagestringyes–

No examples provided.

gimp_move_layer ~125

Move a layer or group to another parent (a group of the same image, or null for the top level) and position (0 = top-most). Does not change pixels or offsets. One undo step.

NameTypeReqDescription
itemstringyesItem id (layer, group, mask...) e.g. 'item:5@a1b2c3d4'.
parent–yesGroup id to put the layer in; null for the top level of the image.
positionintegeryesIndex within the parent, 0 = top-most (in front).
NameTypeReqDescription
children––Child layers of a group, top-most first; null for non-groups.
has_alphabooleanyes–
heightintegeryes–
idstringyes–
kindstringyes–
locks–yes–
mask–yes–
modestringyesGIMP layer mode nick, e.g. 'normal', 'multiply'.
namestringyesLayer name. GIMP keeps names unique within an image ('Title #1').
opacitynumberyes0-100.
parent–yesId of the parent group, null at the top level.
visiblebooleanyes–
widthintegeryes–
xintegeryesOffset of the layer's top-left corner in image pixels.
yintegeryes–

No examples provided.

gimp_open_image ~90

Open a local file (XCF or any format GIMP can load: PNG, JPEG, WebP, TIFF...) as a new image. The path must be absolute (~ allowed). PDF pages, SVG size, RAW: gimp_open_with_options (toolset formats). A new image: nothing in an undo history changes.

NameTypeReqDescription
pathstringyesAbsolute path of the file to open.
NameTypeReqDescription
dirtybooleanyes–
displayedbooleanyesTrue when a GIMP window shows the image (GUI sessions only).
file–yes–
heightintegeryes–
idstringyes–
layer_countintegeryesNumber of top-level layers.
namestringyesGIMP's display name (may be localized).
widthintegeryes–
xcf_file–yes–

No examples provided.

gimp_preview ~124

Render the composite of an image (all visible layers, with transparency) as a PNG whose longest side is at most max_size pixels (16-1024, default 512 or $GIMP_MCP_PREVIEW_MAX_SIZE). Proportions are kept and the image is never upscaled. Does not modify the document, its undo history or its saved state.

NameTypeReqDescription
imagestringyesImage id from gimp_status, e.g. 'image:1@a1b2c3d4'.
max_size––Longest side of the preview.
NameTypeReqDescription
bytesintegeryesSize of the PNG payload.
downscaled_for_sizebooleanyesTrue when the preview was made smaller than requested to respect the byte limit.
heightintegeryes–
imagestringyes–
mime_typestring––
scalenumberyesPreview pixels per image pixel (<= 1).
source_heightintegeryes–
source_widthintegeryesImage width in pixels.
widthintegeryesPreview width in pixels.

No examples provided.

gimp_remove_filter ~79

Remove an editable filter from a layer: the layer renders as if it had never been applied. One undo step.

NameTypeReqDescription
filterstringyesFilter id from gimp_list_filters.
itemstringyesItem id (layer, group, mask...) e.g. 'item:5@a1b2c3d4'.
NameTypeReqDescription
filtersarrayyesEditable filters on the layer, top of the filter stack first (most recently added first).
idstring––
itemstringyes–

No examples provided.

gimp_remove_layer_mask ~95

Remove a layer's mask. mode='apply' bakes it into the layer's alpha (destructive: hidden pixels become transparent); mode='discard' drops it (the layer is shown unmasked). One undo step.

NameTypeReqDescription
itemstringyesItem id (layer, group, mask...) e.g. 'item:5@a1b2c3d4'.
modestringyes–
NameTypeReqDescription
children––Child layers of a group, top-most first; null for non-groups.
has_alphabooleanyes–
heightintegeryes–
idstringyes–
kindstringyes–
locks–yes–
mask–yes–
modestringyesGIMP layer mode nick, e.g. 'normal', 'multiply'.
namestringyesLayer name. GIMP keeps names unique within an image ('Title #1').
opacitynumberyes0-100.
parent–yesId of the parent group, null at the top level.
visiblebooleanyes–
widthintegeryes–
xintegeryesOffset of the layer's top-left corner in image pixels.
yintegeryes–

No examples provided.

gimp_resize_canvas ~156

Change the canvas size without resampling. Layers move by (offset_x, offset_y) and keep their size, unless resize_layers is 'all' or 'image-sized' (layers that covered the old canvas): those grow or shrink to the canvas, new areas transparent or fill_color. One undo step.

NameTypeReqDescription
fill_color––Fill new layer areas (default: transparent).
heightintegeryesPixels.
imagestringyesImage id from gimp_status, e.g. 'image:1@a1b2c3d4'.
offset_xinteger––
offset_yinteger––
resize_layersstring––
widthintegeryesPixels.
NameTypeReqDescription
dirtybooleanyes–
heightintegeryes–
idstring––
imagestringyes–
widthintegeryes–

No examples provided.

gimp_resize_image ~152

Scale the whole image and every layer to width x height pixels (layer sizes and offsets scale proportionally). Give only width or only height to keep the aspect ratio. Lossy: pixels are resampled with the given interpolation. One undo step.

NameTypeReqDescription
height––Pixels; omit one of width/height to keep the aspect ratio.
imagestringyesImage id from gimp_status, e.g. 'image:1@a1b2c3d4'.
interpolationstring–Resampling: none (nearest neighbour, hard edges), linear, cubic, nohalo, lohalo.
width––Pixels; omit one of width/height to keep the aspect ratio.
NameTypeReqDescription
dirtybooleanyes–
heightintegeryes–
idstring––
imagestringyes–
widthintegeryes–

No examples provided.

gimp_restore_checkpoint ~142

Replace the image with the state saved in a checkpoint. The restored image gets a NEW image id and new item ids (the old ones become invalid); GIMP windows showing it are reconnected; its file association is kept and it is marked as having unsaved changes; its GIMP undo history starts empty. Checkpoints are kept, so restoring a later one redoes. Destructive for the current state unless it was checkpointed.

NameTypeReqDescription
checkpointstringyesCheckpoint id from gimp_create_checkpoint.
imagestringyesImage id from gimp_status, e.g. 'image:1@a1b2c3d4'.
NameTypeReqDescription
dirtybooleanyes–
displayedbooleanyesTrue when a GIMP window shows the image (GUI sessions only).
file–yes–
heightintegeryes–
idstringyes–
imagestringyesId of the restored image (a new id: all item ids changed).
layer_countintegeryesNumber of top-level layers.
namestringyesGIMP's display name (may be localized).
previous_imagestringyesId the image had before; it is no longer valid.
widthintegeryes–
xcf_file–yes–

No examples provided.

gimp_rotate_image ~79

Rotate the whole image (canvas, layers, selection, paths) by 90, 180 or 270 degrees clockwise. Lossless. One undo step.

NameTypeReqDescription
angleintegeryes–
imagestringyesImage id from gimp_status, e.g. 'image:1@a1b2c3d4'.
NameTypeReqDescription
dirtybooleanyes–
heightintegeryes–
idstring––
imagestringyes–
widthintegeryes–

No examples provided.

Install

How do I install the GIMP MCP server?

GIMP runs locally as a PyPI package, launched with uvx gimp-mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

pypi · gimp-mcp

# add to Claude Code
claude mcp add mhbxyz-gimp-mcp -- uvx gimp-mcp
Common questions

What is the GIMP MCP server?

GIMP is an MCP server listed in the public MCP registry as io.github.mhbxyz/gimp-mcp. Inspect and edit images in a running GIMP 3.2+ (layers, text, filters, files) from any MCP client. This page covers its PyPI package (gimp-mcp).

Is the GIMP MCP server safe to use?

GIMP scores 71 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 21 November 2026. Its build provenance is signed and verified. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

What tools does the GIMP MCP server expose?

GIMP exposes 49 tools: gimp_status, gimp_list_toolsets, gimp_enable_toolsets, gimp_inspect_image, gimp_inspect_item, and 44 more. Their descriptions and schemas cost roughly 6,310 tokens of context every time the server is loaded.

Is the GIMP MCP server still maintained?

GIMP is still listed as active in the MCP registry. We last reached this channel on 21 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

What licence is the GIMP MCP server under?

GIMP declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

What did VerifyMCP test on the GIMP MCP server?

VerifyMCP ran 15 checks on GIMP, covering Known CVEs, Install scripts, Dependency health, Source repository and 11 more. One item could not be completed, a gap on our side rather than a finding about GIMP: Malware scan. Endpoint Security and Transport & Reachability do not apply to a PyPI package, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.