GIMP
PYPI · GIMP-MCP
Inspect and edit images in a running GIMP 3.2+ (layers, text, filters, files) from any MCP client.
Available components
Last scanned (17 hours ago)
Scores higher than 64% of PyPI servers
Category Design and Media
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
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 →
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
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 →
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 →
gimp_add_layer_mask 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.
| Name | Type | Req | Description |
|---|---|---|---|
| fill | string | – | – |
| invert | boolean | – | – |
| item | string | yes | Item id (layer, group, mask...) e.g. 'item:5@a1b2c3d4'. |
| Name | Type | Req | Description |
|---|---|---|---|
| children | – | – | Child layers of a group, top-most first; null for non-groups. |
| has_alpha | boolean | yes | – |
| height | integer | yes | – |
| id | string | yes | – |
| kind | string | yes | – |
| locks | – | yes | – |
| mask | – | yes | – |
| mode | string | yes | GIMP layer mode nick, e.g. 'normal', 'multiply'. |
| name | string | yes | Layer name. GIMP keeps names unique within an image ('Title #1'). |
| opacity | number | yes | 0-100. |
| parent | – | yes | Id of the parent group, null at the top level. |
| visible | boolean | yes | – |
| width | integer | yes | – |
| x | integer | yes | Offset of the layer's top-left corner in image pixels. |
| y | integer | yes | – |
No examples provided.
gimp_brightness_contrast 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.
| Name | Type | Req | Description |
|---|---|---|---|
| brightness | number | – | – |
| contrast | number | – | – |
| destructive | boolean | – | 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). |
| item | string | yes | Item id (layer, group, mask...) e.g. 'item:5@a1b2c3d4'. |
| Name | Type | Req | Description |
|---|---|---|---|
| destructive | boolean | yes | True when the layer's pixels were changed. |
| filter | – | yes | Id of the editable filter (non-destructive only), verified to exist. |
| id | string | – | – |
| item | string | yes | – |
| operation | string | yes | GEGL/GIMP operation that was applied. |
| restricted_to_selection | boolean | yes | True when only the selected area was changed. |
No examples provided.
gimp_close_image 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.
| Name | Type | Req | Description |
|---|---|---|---|
| discard_changes | boolean | – | – |
| image | string | yes | Image id from gimp_status, e.g. 'image:1@a1b2c3d4'. |
| Name | Type | Req | Description |
|---|---|---|---|
| closed | boolean | yes | – |
| image | string | yes | – |
No examples provided.
gimp_create_checkpoint 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.
| Name | Type | Req | Description |
|---|---|---|---|
| image | string | yes | Image id from gimp_status, e.g. 'image:1@a1b2c3d4'. |
| label | – | – | – |
| Name | Type | Req | Description |
|---|---|---|---|
| checkpoint | string | yes | – |
| created | number | yes | Unix time. |
| height | integer | yes | – |
| image | string | yes | Image the checkpoint belongs to (follows restorations). |
| label | – | yes | – |
| width | integer | yes | – |
No examples provided.
gimp_create_group Create layer group ~104
Add an empty layer group at an explicit parent and position. One undo step.
| Name | Type | Req | Description |
|---|---|---|---|
| image | string | yes | Image id from gimp_status, e.g. 'image:1@a1b2c3d4'. |
| name | string | yes | – |
| parent | – | – | Group id to put the layer in; null for the top level of the image. |
| position | integer | – | Index within the parent, 0 = top-most (in front). |
| Name | Type | Req | Description |
|---|---|---|---|
| children | – | – | Child layers of a group, top-most first; null for non-groups. |
| has_alpha | boolean | yes | – |
| height | integer | yes | – |
| id | string | yes | – |
| kind | string | yes | – |
| locks | – | yes | – |
| mask | – | yes | – |
| mode | string | yes | GIMP layer mode nick, e.g. 'normal', 'multiply'. |
| name | string | yes | Layer name. GIMP keeps names unique within an image ('Title #1'). |
| opacity | number | yes | 0-100. |
| parent | – | yes | Id of the parent group, null at the top level. |
| visible | boolean | yes | – |
| width | integer | yes | – |
| x | integer | yes | Offset of the layer's top-left corner in image pixels. |
| y | integer | yes | – |
No examples provided.
gimp_create_image 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.
| Name | Type | Req | Description |
|---|---|---|---|
| base_type | string | – | – |
| fill | string | – | sRGB color as '#rrggbb', '#rrggbbaa', '#rgb' or one of: white, black, red, green, blue, transparent |
| height | integer | yes | Pixels. |
| layer_name | string | – | – |
| resolution | – | – | Pixels per inch. |
| width | integer | yes | Pixels. |
| Name | Type | Req | Description |
|---|---|---|---|
| dirty | boolean | yes | – |
| displayed | boolean | yes | True when a GIMP window shows the image (GUI sessions only). |
| file | – | yes | – |
| height | integer | yes | – |
| id | string | yes | – |
| layer_count | integer | yes | Number of top-level layers. |
| name | string | yes | GIMP's display name (may be localized). |
| width | integer | yes | – |
| xcf_file | – | yes | – |
No examples provided.
gimp_create_layer 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.
| Name | Type | Req | Description |
|---|---|---|---|
| fill | string | – | sRGB color as '#rrggbb', '#rrggbbaa', '#rgb' or one of: white, black, red, green, blue, transparent |
| height | – | – | – |
| image | string | yes | Image id from gimp_status, e.g. 'image:1@a1b2c3d4'. |
| mode | string | – | 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… |
| name | string | yes | – |
| opacity | number | – | 0 (transparent) - 100 (opaque). |
| parent | – | – | Group id to put the layer in; null for the top level of the image. |
| position | integer | – | Index within the parent, 0 = top-most (in front). |
| visible | boolean | – | – |
| width | – | – | – |
| x | integer | – | – |
| y | integer | – | – |
| Name | Type | Req | Description |
|---|---|---|---|
| children | – | – | Child layers of a group, top-most first; null for non-groups. |
| has_alpha | boolean | yes | – |
| height | integer | yes | – |
| id | string | yes | – |
| kind | string | yes | – |
| locks | – | yes | – |
| mask | – | yes | – |
| mode | string | yes | GIMP layer mode nick, e.g. 'normal', 'multiply'. |
| name | string | yes | Layer name. GIMP keeps names unique within an image ('Title #1'). |
| opacity | number | yes | 0-100. |
| parent | – | yes | Id of the parent group, null at the top level. |
| visible | boolean | yes | – |
| width | integer | yes | – |
| x | integer | yes | Offset of the layer's top-left corner in image pixels. |
| y | integer | yes | – |
No examples provided.
gimp_create_text_layer 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).
| Name | Type | Req | Description |
|---|---|---|---|
| antialias | boolean | – | – |
| box_height | – | – | – |
| box_width | – | – | – |
| color | string | – | sRGB color as '#rrggbb', '#rrggbbaa', '#rgb' or one of: white, black, red, green, blue, transparent |
| font | string | – | – |
| image | string | yes | Image id from gimp_status, e.g. 'image:1@a1b2c3d4'. |
| justify | string | – | – |
| letter_spacing | number | – | – |
| line_spacing | number | – | – |
| parent | – | – | Group id to put the layer in; null for the top level of the image. |
| position | integer | – | Index within the parent, 0 = top-most (in front). |
| size | number | – | Font size, in size_unit. |
| size_unit | string | – | – |
| text | string | yes | – |
| x | integer | – | – |
| y | integer | – | – |
| Name | Type | Req | Description |
|---|---|---|---|
| children | – | – | Child layers of a group, top-most first; null for non-groups. |
| has_alpha | boolean | yes | – |
| height | integer | yes | – |
| id | string | yes | – |
| kind | string | yes | – |
| locks | – | yes | – |
| mask | – | yes | – |
| mode | string | yes | GIMP layer mode nick, e.g. 'normal', 'multiply'. |
| name | string | yes | Layer name. GIMP keeps names unique within an image ('Title #1'). |
| opacity | number | yes | 0-100. |
| parent | – | yes | Id of the parent group, null at the top level. |
| visible | boolean | yes | – |
| width | integer | yes | – |
| x | integer | yes | Offset of the layer's top-left corner in image pixels. |
| y | integer | yes | – |
No examples provided.
gimp_crop_image 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.
| Name | Type | Req | Description |
|---|---|---|---|
| height | integer | yes | Pixels. |
| image | string | yes | Image id from gimp_status, e.g. 'image:1@a1b2c3d4'. |
| width | integer | yes | Pixels. |
| x | integer | yes | – |
| y | integer | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| dirty | boolean | yes | – |
| height | integer | yes | – |
| id | string | – | – |
| image | string | yes | – |
| width | integer | yes | – |
No examples provided.
gimp_delete_checkpoint Delete checkpoint ~50
Free a checkpoint's memory. Closing an image deletes its checkpoints too. Checkpoints are not in GIMP's undo history.
| Name | Type | Req | Description |
|---|---|---|---|
| checkpoint | string | yes | Checkpoint id from gimp_create_checkpoint. |
| Name | Type | Req | Description |
|---|---|---|---|
| checkpoint | string | yes | – |
| deleted | boolean | yes | – |
No examples provided.
gimp_delete_layer 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.
| Name | Type | Req | Description |
|---|---|---|---|
| item | string | yes | Item id (layer, group, mask...) e.g. 'item:5@a1b2c3d4'. |
| Name | Type | Req | Description |
|---|---|---|---|
| deleted | boolean | yes | – |
| item | string | yes | – |
No examples provided.
gimp_draw_path Draw line / polyline ~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.
| Name | Type | Req | Description |
|---|---|---|---|
| antialias | boolean | – | – |
| cap | string | – | – |
| closed | boolean | – | – |
| color | string | yes | sRGB color as '#rrggbb', '#rrggbbaa', '#rgb' or one of: white, black, red, green, blue, transparent |
| item | string | yes | Item id (layer, group, mask...) e.g. 'item:5@a1b2c3d4'. |
| join | string | – | – |
| opacity | number | – | 0-100. |
| points | array | yes | – |
| width | number | – | Line width in pixels. |
| Name | Type | Req | Description |
|---|---|---|---|
| affected | – | yes | Image-space box of the pixels that may have changed. |
| changed | boolean | yes | False when the painted area does not intersect the layer. |
| id | string | – | – |
| item | string | yes | – |
No examples provided.
gimp_draw_shape Draw rectangle / ellipse ~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.
| Name | Type | Req | Description |
|---|---|---|---|
| antialias | boolean | – | – |
| fill_color | – | – | sRGB color as '#rrggbb', '#rrggbbaa', '#rgb' or one of: white, black, red, green, blue, transparent |
| height | number | yes | – |
| item | string | yes | Item id (layer, group, mask...) e.g. 'item:5@a1b2c3d4'. |
| opacity | number | – | 0-100. |
| shape | string | yes | – |
| stroke_color | – | – | sRGB color as '#rrggbb', '#rrggbbaa', '#rgb' or one of: white, black, red, green, blue, transparent |
| stroke_width | number | – | Line width in pixels. |
| width | number | yes | – |
| x | number | yes | – |
| y | number | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| affected | – | yes | Image-space box of the pixels that may have changed. |
| changed | boolean | yes | False when the painted area does not intersect the layer. |
| id | string | – | – |
| item | string | yes | – |
No examples provided.
gimp_duplicate_layer 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.
| Name | Type | Req | Description |
|---|---|---|---|
| item | string | yes | Item 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 | – | – | – |
| Name | Type | Req | Description |
|---|---|---|---|
| children | – | – | Child layers of a group, top-most first; null for non-groups. |
| has_alpha | boolean | yes | – |
| height | integer | yes | – |
| id | string | yes | – |
| kind | string | yes | – |
| locks | – | yes | – |
| mask | – | yes | – |
| mode | string | yes | GIMP layer mode nick, e.g. 'normal', 'multiply'. |
| name | string | yes | Layer name. GIMP keeps names unique within an image ('Title #1'). |
| opacity | number | yes | 0-100. |
| parent | – | yes | Id of the parent group, null at the top level. |
| visible | boolean | yes | – |
| width | integer | yes | – |
| x | integer | yes | Offset of the layer's top-left corner in image pixels. |
| y | integer | yes | – |
No examples provided.
gimp_enable_toolsets 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.
| Name | Type | Req | Description |
|---|---|---|---|
| toolsets | array | yes | Toolset names. |
| Name | Type | Req | Description |
|---|---|---|---|
| added_tools | array | yes | Tools added to the tool list by this call. |
| enabled | array | yes | Toolsets enabled now. |
| usage | array | – | How to call each added tool. |
No examples provided.
gimp_export_image Export PNG/JPEG ~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.
| Name | Type | Req | Description |
|---|---|---|---|
| format | – | – | – |
| image | string | yes | Image id from gimp_status, e.g. 'image:1@a1b2c3d4'. |
| jpeg_options | – | – | – |
| overwrite | boolean | – | – |
| path | string | yes | Absolute path ending in .png, .jpg or .jpeg. |
| png_options | – | – | – |
| Name | Type | Req | Description |
|---|---|---|---|
| bytes | integer | yes | – |
| format | string | yes | – |
| height | integer | yes | – |
| image | string | yes | – |
| options | object | yes | Effective encoder options. |
| path | string | yes | – |
| width | integer | yes | – |
No examples provided.
gimp_fill 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.
| Name | Type | Req | Description |
|---|---|---|---|
| area | string | – | – |
| color | string | yes | sRGB color as '#rrggbb', '#rrggbbaa', '#rgb' or one of: white, black, red, green, blue, transparent |
| item | string | yes | Item id (layer, group, mask...) e.g. 'item:5@a1b2c3d4'. |
| mode | string | – | 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… |
| opacity | number | – | 0-100. |
| Name | Type | Req | Description |
|---|---|---|---|
| affected | – | yes | Image-space box of the pixels that may have changed. |
| changed | boolean | yes | False when the painted area does not intersect the layer. |
| id | string | – | – |
| item | string | yes | – |
No examples provided.
gimp_flip_layer Flip layer ~68
Mirror a layer or group horizontally or vertically around its center. Lossless. One undo step.
| Name | Type | Req | Description |
|---|---|---|---|
| direction | string | yes | – |
| item | string | yes | Item id (layer, group, mask...) e.g. 'item:5@a1b2c3d4'. |
| Name | Type | Req | Description |
|---|---|---|---|
| children | – | – | Child layers of a group, top-most first; null for non-groups. |
| has_alpha | boolean | yes | – |
| height | integer | yes | – |
| id | string | yes | – |
| kind | string | yes | – |
| locks | – | yes | – |
| mask | – | yes | – |
| mode | string | yes | GIMP layer mode nick, e.g. 'normal', 'multiply'. |
| name | string | yes | Layer name. GIMP keeps names unique within an image ('Title #1'). |
| opacity | number | yes | 0-100. |
| parent | – | yes | Id of the parent group, null at the top level. |
| visible | boolean | yes | – |
| width | integer | yes | – |
| x | integer | yes | Offset of the layer's top-left corner in image pixels. |
| y | integer | yes | – |
No examples provided.
gimp_gaussian_blur 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).
| Name | Type | Req | Description |
|---|---|---|---|
| destructive | boolean | – | 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). |
| item | string | yes | Item id (layer, group, mask...) e.g. 'item:5@a1b2c3d4'. |
| radius | number | yes | Standard deviation in pixels. |
| radius_y | – | – | – |
| Name | Type | Req | Description |
|---|---|---|---|
| destructive | boolean | yes | True when the layer's pixels were changed. |
| filter | – | yes | Id of the editable filter (non-destructive only), verified to exist. |
| id | string | – | – |
| item | string | yes | – |
| operation | string | yes | GEGL/GIMP operation that was applied. |
| restricted_to_selection | boolean | yes | True when only the selected area was changed. |
No examples provided.
gimp_get_selection Get selection ~70
Whether the image has a selection, its bounds, and optionally whether a point is selected.
| Name | Type | Req | Description |
|---|---|---|---|
| image | string | yes | Image id from gimp_status, e.g. 'image:1@a1b2c3d4'. |
| probe_x | – | – | – |
| probe_y | – | – | – |
| Name | Type | Req | Description |
|---|---|---|---|
| bounds | – | yes | Bounding 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. |
| empty | boolean | yes | – |
| id | string | – | – |
| image | string | yes | – |
No examples provided.
gimp_hue_saturation 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).
| Name | Type | Req | Description |
|---|---|---|---|
| destructive | boolean | – | 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). |
| hue | number | – | – |
| hue_range | string | – | – |
| item | string | yes | Item id (layer, group, mask...) e.g. 'item:5@a1b2c3d4'. |
| lightness | number | – | – |
| overlap | number | – | Blend with neighbouring ranges, 0-100. |
| saturation | number | – | – |
| Name | Type | Req | Description |
|---|---|---|---|
| destructive | boolean | yes | True when the layer's pixels were changed. |
| filter | – | yes | Id of the editable filter (non-destructive only), verified to exist. |
| id | string | – | – |
| item | string | yes | – |
| operation | string | yes | GEGL/GIMP operation that was applied. |
| restricted_to_selection | boolean | yes | True when only the selected area was changed. |
No examples provided.
gimp_import_layer Import file as 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.
| Name | Type | Req | Description |
|---|---|---|---|
| image | string | yes | Image 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. |
| path | string | yes | Absolute path of the file to import. |
| position | integer | – | Index within the parent, 0 = top-most (in front). |
| x | integer | – | – |
| y | integer | – | – |
| Name | Type | Req | Description |
|---|---|---|---|
| children | – | – | Child layers of a group, top-most first; null for non-groups. |
| has_alpha | boolean | yes | – |
| height | integer | yes | – |
| id | string | yes | – |
| kind | string | yes | – |
| locks | – | yes | – |
| mask | – | yes | – |
| mode | string | yes | GIMP layer mode nick, e.g. 'normal', 'multiply'. |
| name | string | yes | Layer name. GIMP keeps names unique within an image ('Title #1'). |
| opacity | number | yes | 0-100. |
| parent | – | yes | Id of the parent group, null at the top level. |
| visible | boolean | yes | – |
| width | integer | yes | – |
| x | integer | yes | Offset of the layer's top-left corner in image pixels. |
| y | integer | yes | – |
No examples provided.
gimp_inspect_image 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.
| Name | Type | Req | Description |
|---|---|---|---|
| image | string | yes | Image id from gimp_status, e.g. 'image:1@a1b2c3d4'. |
| Name | Type | Req | Description |
|---|---|---|---|
| base_type | string | yes | 'rgb', 'gray' or 'indexed'. |
| channels | array | – | Saved selections and masks. |
| dirty | boolean | yes | – |
| exported_file | – | yes | – |
| file | – | yes | – |
| height | integer | yes | – |
| id | string | yes | – |
| imported_file | – | yes | – |
| layers | array | yes | Layer tree, top-most layer first. |
| name | string | yes | GIMP's display name (may be localized). |
| paths | array | – | Paths (vectors), top first. |
| precision | string | yes | – |
| resolution | – | yes | – |
| unit | – | – | Display/print unit abbreviation, e.g. 'in', 'mm'. |
| width | integer | yes | – |
| xcf_file | – | yes | XCF file the image was loaded from or saved to. |
No examples provided.
gimp_inspect_item 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.
| Name | Type | Req | Description |
|---|---|---|---|
| item | string | yes | Item id (layer, group, mask...) e.g. 'item:5@a1b2c3d4'. |
| Name | Type | Req | Description |
|---|---|---|---|
| children | – | – | Child ids for groups, top-most first. |
| has_alpha | – | – | – |
| height | – | – | – |
| id | string | yes | – |
| image | string | yes | – |
| kind | string | yes | – |
| locks | – | – | – |
| mask | – | – | – |
| mode | – | – | – |
| name | string | yes | – |
| opacity | – | – | – |
| parent | – | yes | Parent group id (layers) or owning layer id (masks). |
| position | – | yes | Index within the parent, 0 = top-most. |
| visible | boolean | yes | – |
| width | – | – | – |
| x | – | – | – |
| y | – | – | – |
No examples provided.
gimp_inspect_text Inspect text layer ~64
Text, font, size and unit, color, justification, spacing, antialiasing and geometry.
| Name | Type | Req | Description |
|---|---|---|---|
| item | string | yes | Item id (layer, group, mask...) e.g. 'item:5@a1b2c3d4'. |
| Name | Type | Req | Description |
|---|---|---|---|
| antialias | boolean | yes | – |
| color | string | yes | #rrggbb (sRGB). |
| font | string | yes | – |
| height | integer | yes | – |
| item | string | yes | – |
| justify | string | yes | – |
| letter_spacing | number | yes | Extra pixels between letters. |
| line_spacing | number | yes | Extra pixels between lines. |
| size | number | yes | – |
| size_unit | string | yes | 'px' (pixels) or 'pt' (points, converted with the image resolution). |
| text | string | yes | – |
| width | integer | yes | – |
| x | integer | yes | – |
| y | integer | yes | – |
No examples provided.
gimp_list_checkpoints List checkpoints ~50
Checkpoints of an image, oldest first.
| Name | Type | Req | Description |
|---|---|---|---|
| image | string | yes | Image id from gimp_status, e.g. 'image:1@a1b2c3d4'. |
| Name | Type | Req | Description |
|---|---|---|---|
| checkpoints | array | yes | Oldest first. |
| image | string | yes | – |
No examples provided.
gimp_list_filters List editable filters ~54
Editable (non-destructive) filters attached to a layer.
| Name | Type | Req | Description |
|---|---|---|---|
| item | string | yes | Item id (layer, group, mask...) e.g. 'item:5@a1b2c3d4'. |
| Name | Type | Req | Description |
|---|---|---|---|
| filters | array | yes | Editable filters on the layer, top of the filter stack first (most recently added first). |
| id | string | – | – |
| item | string | yes | – |
No examples provided.
gimp_list_fonts List fonts ~38
Fonts GIMP knows (fontconfig names), filtered by a substring.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | – |
| query | string | – | – |
| Name | Type | Req | Description |
|---|---|---|---|
| fonts | array | yes | – |
| total | integer | yes | – |
No examples provided.
gimp_list_toolsets 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.
| Name | Type | Req | Description |
|---|---|---|---|
| toolsets | array | yes | – |
No examples provided.
gimp_modify_selection Select all / none / invert ~73
'all' selects the whole canvas, 'none' clears the selection, 'invert' inverts it. One undo step.
| Name | Type | Req | Description |
|---|---|---|---|
| action | string | yes | – |
| image | string | yes | Image id from gimp_status, e.g. 'image:1@a1b2c3d4'. |
| Name | Type | Req | Description |
|---|---|---|---|
| bounds | – | yes | Bounding 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. |
| empty | boolean | yes | – |
| id | string | – | – |
| image | string | yes | – |
No examples provided.
gimp_move_layer Move layer in the stack ~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.
| Name | Type | Req | Description |
|---|---|---|---|
| item | string | yes | Item id (layer, group, mask...) e.g. 'item:5@a1b2c3d4'. |
| parent | – | yes | Group id to put the layer in; null for the top level of the image. |
| position | integer | yes | Index within the parent, 0 = top-most (in front). |
| Name | Type | Req | Description |
|---|---|---|---|
| children | – | – | Child layers of a group, top-most first; null for non-groups. |
| has_alpha | boolean | yes | – |
| height | integer | yes | – |
| id | string | yes | – |
| kind | string | yes | – |
| locks | – | yes | – |
| mask | – | yes | – |
| mode | string | yes | GIMP layer mode nick, e.g. 'normal', 'multiply'. |
| name | string | yes | Layer name. GIMP keeps names unique within an image ('Title #1'). |
| opacity | number | yes | 0-100. |
| parent | – | yes | Id of the parent group, null at the top level. |
| visible | boolean | yes | – |
| width | integer | yes | – |
| x | integer | yes | Offset of the layer's top-left corner in image pixels. |
| y | integer | yes | – |
No examples provided.
gimp_open_image 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.
| Name | Type | Req | Description |
|---|---|---|---|
| path | string | yes | Absolute path of the file to open. |
| Name | Type | Req | Description |
|---|---|---|---|
| dirty | boolean | yes | – |
| displayed | boolean | yes | True when a GIMP window shows the image (GUI sessions only). |
| file | – | yes | – |
| height | integer | yes | – |
| id | string | yes | – |
| layer_count | integer | yes | Number of top-level layers. |
| name | string | yes | GIMP's display name (may be localized). |
| width | integer | yes | – |
| xcf_file | – | yes | – |
No examples provided.
gimp_preview Preview image ~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.
| Name | Type | Req | Description |
|---|---|---|---|
| image | string | yes | Image id from gimp_status, e.g. 'image:1@a1b2c3d4'. |
| max_size | – | – | Longest side of the preview. |
| Name | Type | Req | Description |
|---|---|---|---|
| bytes | integer | yes | Size of the PNG payload. |
| downscaled_for_size | boolean | yes | True when the preview was made smaller than requested to respect the byte limit. |
| height | integer | yes | – |
| image | string | yes | – |
| mime_type | string | – | – |
| scale | number | yes | Preview pixels per image pixel (<= 1). |
| source_height | integer | yes | – |
| source_width | integer | yes | Image width in pixels. |
| width | integer | yes | Preview width in pixels. |
No examples provided.
gimp_remove_filter Remove editable filter ~79
Remove an editable filter from a layer: the layer renders as if it had never been applied. One undo step.
| Name | Type | Req | Description |
|---|---|---|---|
| filter | string | yes | Filter id from gimp_list_filters. |
| item | string | yes | Item id (layer, group, mask...) e.g. 'item:5@a1b2c3d4'. |
| Name | Type | Req | Description |
|---|---|---|---|
| filters | array | yes | Editable filters on the layer, top of the filter stack first (most recently added first). |
| id | string | – | – |
| item | string | yes | – |
No examples provided.
gimp_remove_layer_mask 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.
| Name | Type | Req | Description |
|---|---|---|---|
| item | string | yes | Item id (layer, group, mask...) e.g. 'item:5@a1b2c3d4'. |
| mode | string | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| children | – | – | Child layers of a group, top-most first; null for non-groups. |
| has_alpha | boolean | yes | – |
| height | integer | yes | – |
| id | string | yes | – |
| kind | string | yes | – |
| locks | – | yes | – |
| mask | – | yes | – |
| mode | string | yes | GIMP layer mode nick, e.g. 'normal', 'multiply'. |
| name | string | yes | Layer name. GIMP keeps names unique within an image ('Title #1'). |
| opacity | number | yes | 0-100. |
| parent | – | yes | Id of the parent group, null at the top level. |
| visible | boolean | yes | – |
| width | integer | yes | – |
| x | integer | yes | Offset of the layer's top-left corner in image pixels. |
| y | integer | yes | – |
No examples provided.
gimp_resize_canvas 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.
| Name | Type | Req | Description |
|---|---|---|---|
| fill_color | – | – | Fill new layer areas (default: transparent). |
| height | integer | yes | Pixels. |
| image | string | yes | Image id from gimp_status, e.g. 'image:1@a1b2c3d4'. |
| offset_x | integer | – | – |
| offset_y | integer | – | – |
| resize_layers | string | – | – |
| width | integer | yes | Pixels. |
| Name | Type | Req | Description |
|---|---|---|---|
| dirty | boolean | yes | – |
| height | integer | yes | – |
| id | string | – | – |
| image | string | yes | – |
| width | integer | yes | – |
No examples provided.
gimp_resize_image Scale 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.
| Name | Type | Req | Description |
|---|---|---|---|
| height | – | – | Pixels; omit one of width/height to keep the aspect ratio. |
| image | string | yes | Image id from gimp_status, e.g. 'image:1@a1b2c3d4'. |
| interpolation | string | – | Resampling: none (nearest neighbour, hard edges), linear, cubic, nohalo, lohalo. |
| width | – | – | Pixels; omit one of width/height to keep the aspect ratio. |
| Name | Type | Req | Description |
|---|---|---|---|
| dirty | boolean | yes | – |
| height | integer | yes | – |
| id | string | – | – |
| image | string | yes | – |
| width | integer | yes | – |
No examples provided.
gimp_restore_checkpoint Restore checkpoint (undo/redo) ~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.
| Name | Type | Req | Description |
|---|---|---|---|
| checkpoint | string | yes | Checkpoint id from gimp_create_checkpoint. |
| image | string | yes | Image id from gimp_status, e.g. 'image:1@a1b2c3d4'. |
| Name | Type | Req | Description |
|---|---|---|---|
| dirty | boolean | yes | – |
| displayed | boolean | yes | True when a GIMP window shows the image (GUI sessions only). |
| file | – | yes | – |
| height | integer | yes | – |
| id | string | yes | – |
| image | string | yes | Id of the restored image (a new id: all item ids changed). |
| layer_count | integer | yes | Number of top-level layers. |
| name | string | yes | GIMP's display name (may be localized). |
| previous_image | string | yes | Id the image had before; it is no longer valid. |
| width | integer | yes | – |
| xcf_file | – | yes | – |
No examples provided.
gimp_rotate_image Rotate image ~79
Rotate the whole image (canvas, layers, selection, paths) by 90, 180 or 270 degrees clockwise. Lossless. One undo step.
| Name | Type | Req | Description |
|---|---|---|---|
| angle | integer | yes | – |
| image | string | yes | Image id from gimp_status, e.g. 'image:1@a1b2c3d4'. |
| Name | Type | Req | Description |
|---|---|---|---|
| dirty | boolean | yes | – |
| height | integer | yes | – |
| id | string | – | – |
| image | string | yes | – |
| width | integer | yes | – |
No examples provided.
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
claude mcp add mhbxyz-gimp-mcp -- uvx gimp-mcp
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.