GIMP Studio MCP
PYPI · TWELVETAKE-GIMP-STUDIO-MCP · SCANNED OCT 4
Lets an AI assistant edit images in GIMP 3, including print and DTF transfer prep.
Available components
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 Security100
- No malware found by supply-chain analysis.Pass
- No known CVEs affecting this package version or its production dependencies.Pass
- Runs hatchling.build at install time, a recognised build step with no custom scripting around it. View diagnostics → Pass
- 0 of 28 dependencies flagged as unhealthy. View diagnostics → Pass
Provenance & Transparency100
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Cryptographically verified build provenance (signed, bound to TwelveTake-Studios/gimp-studio-mcp). View diagnostics → Pass
- Clear OSI-approved license (MIT).Pass
- Actively maintained (last published 4 days ago).Pass
- Publishes a security disclosure policy (SECURITY.md).Pass
Schema Quality & AI Usability69
- AI-judged instruction clarity (good).Pass
- Tool/resource definitions use about 9684 tokens (~81/item across 119 items; 119 tools + 0 resources), lean.Pass
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management0
- Stability not yet verified: not enough scan history yet (needs a 30-day window).Unverified
Tool Coverage67
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 0% of tool parameters carry a description.Fail
Tool Safety75
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- 0 of 6 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation; "gimp_exec" implies "exec" and declares no destructiveHint at all, which the MCP spec reads as destructive by default. See how to fix → Fail
- An AI judge read all 120 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Unverified: 1 category
A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.
How do I install the GIMP Studio MCP server?
GIMP Studio MCP runs locally as a PyPI package, launched with uvx twelvetake-gimp-studio-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 · twelvetake-gimp-studio-mcp
claude mcp add com-twelvetake-gimp-studio-mcp -- uvx twelvetake-gimp-studio-mcp
{
"mcpServers": {
"com-twelvetake-gimp-studio-mcp": {
"command": "uvx",
"args": [
"twelvetake-gimp-studio-mcp"
]
}
}
} {
"servers": {
"com-twelvetake-gimp-studio-mcp": {
"command": "uvx",
"args": [
"twelvetake-gimp-studio-mcp"
]
}
}
} codex mcp add com-twelvetake-gimp-studio-mcp -- uvx twelvetake-gimp-studio-mcp
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"com-twelvetake-gimp-studio-mcp": {
"type": "local",
"command": [
"uvx",
"twelvetake-gimp-studio-mcp"
],
"enabled": true
}
}
} openclaw mcp add com-twelvetake-gimp-studio-mcp --command uvx --arg twelvetake-gimp-studio-mcp
mcp_servers:
com-twelvetake-gimp-studio-mcp:
command: "uvx"
args: ["twelvetake-gimp-studio-mcp"] {
"McpServers": {
"com-twelvetake-gimp-studio-mcp": {
"Transport": "stdio",
"Command": "uvx",
"Arguments": [
"twelvetake-gimp-studio-mcp"
]
}
}
} assistant mcp add com-twelvetake-gimp-studio-mcp -t stdio -c uvx -a twelvetake-gimp-studio-mcp
{
"mcpServers": {
"com-twelvetake-gimp-studio-mcp": {
"command": "uvx",
"args": [
"twelvetake-gimp-studio-mcp"
]
}
}
} 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.
- 30 Sept 26 +15
- Malware scan: unverified → pass ▲ security
- 29 Sept 26 61
First indexed and scored.
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 7 Oct 2026 · Analysed pypi/twelvetake-gimp-studio-mcp@0.3.4
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 | TwelveTake-Studios/gimp-studio-mcp |
| Certificate issuer | https://token.actions.githubusercontent.com |
| Certificate SAN | https://github.com/TwelveTake-Studios/gimp-studio-mcp/.github/workflows/publish.yml@refs/tags/v0.3.4 |
| Rekor log index | 3005126583 |
| Predicate type | PyPI publish attestation https://docs.pypi.org/attestations/publish/v1 |
| Subject digest | sha256:546f91479bbf6134b1a41b19bea981fe512b71f5192e9d0e3612aa522bb9a986 |
Background: How many MCP packages publish verified provenance →
Install scripts 1 script
| Hook | Tier | Command |
|---|---|---|
| build_backend | allowlisted | hatchling.build |
Background: Why install scripts are a supply-chain risk →
Dependencies 28 packages
| Packages resolved | 28 |
|---|---|
| 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 →
list_brushes ~24
List brush names, optionally filtered by substring.
| Name | Type | Req | Description |
|---|---|---|---|
| filter | – | – | – |
No output schema declared.
No examples provided.
list_checkpoints ~25
List live checkpoints: id, snapshot image_id, and whether it's still valid.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
list_fonts ~23
List installed font names, optionally filtered by substring.
| Name | Type | Req | Description |
|---|---|---|---|
| filter | – | – | – |
No output schema declared.
No examples provided.
list_gegl_ops ~27
List available GEGL operation names, optionally filtered by substring.
| Name | Type | Req | Description |
|---|---|---|---|
| filter | – | – | – |
No output schema declared.
No examples provided.
list_gradients ~23
List gradient names, optionally filtered by substring.
| Name | Type | Req | Description |
|---|---|---|---|
| filter | – | – | – |
No output schema declared.
No examples provided.
list_images ~25
List open images: id, name (basename), width, height, dirty flag.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
list_palettes ~23
List palette names, optionally filtered by substring.
| Name | Type | Req | Description |
|---|---|---|---|
| filter | – | – | – |
No output schema declared.
No examples provided.
list_patterns ~22
List pattern names, optionally filtered by substring.
| Name | Type | Req | Description |
|---|---|---|---|
| filter | – | – | – |
No output schema declared.
No examples provided.
list_procedures ~26
List PDB procedure names, optionally filtered by substring.
| Name | Type | Req | Description |
|---|---|---|---|
| filter | – | – | – |
No output schema declared.
No examples provided.
list_profiles ~55
NOT SUPPORTED: the libgimp API cannot enumerate installed ICC profiles — this ALWAYS fails. Returns ok=false with {supported: false, note}. Pass explicit .icc paths instead; get_profile reads an image's own profile.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
list_shirt_presets ~42
List the built-in garment / shirt-colour presets for knockout_background(shirt=...) — name, display, hex, technique, tolerance.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
lock_alpha ~38
Lock (or unlock) the layer's alpha channel against painting.
| Name | Type | Req | Description |
|---|---|---|---|
| image | – | – | – |
| layer | – | – | – |
| locked | boolean | – | – |
No output schema declared.
No examples provided.
luminance_to_alpha ~93
Map luminance to transparency per-pixel (destructive): default makes dark pixels transparent and bright pixels opaque (white-art-on-black); invert=True makes bright pixels transparent (knock out white/highlights). Computed directly over the layer buffer (no dedicated GEGL op exists in GIMP 3.0.4).
| Name | Type | Req | Description |
|---|---|---|---|
| image | – | – | – |
| invert | boolean | – | – |
| layer | – | – | – |
No output schema declared.
No examples provided.
merge_down ~45
Merge a layer down into the one below it (EXPAND_AS_NECESSARY). Destructive. Returns the resulting merged layer.
| Name | Type | Req | Description |
|---|---|---|---|
| image | – | – | – |
| layer | – | – | – |
No output schema declared.
No examples provided.
move_layer ~44
Move a layer to absolute canvas offsets (x, y).
| Name | Type | Req | Description |
|---|---|---|---|
| image | – | – | – |
| layer | – | – | – |
| x | integer | yes | – |
| y | integer | yes | – |
No output schema declared.
No examples provided.
new_image ~61
Create a new RGBA image. fill: white|transparent|background|foreground. Returns the new image id + size.
| Name | Type | Req | Description |
|---|---|---|---|
| fill | string | – | – |
| height | integer | yes | – |
| name | string | – | – |
| width | integer | yes | – |
No output schema declared.
No examples provided.
normalize ~91
Auto-stretch tones to fill the full 0-255 range (like Colors > Auto > Stretch Contrast). keep_colors=False (default) stretches each channel independently — maximum contrast, but may shift colour balance; keep_colors=True stretches all channels uniformly to preserve hue (gegl:stretch-contrast).
| Name | Type | Req | Description |
|---|---|---|---|
| image | – | – | – |
| keep_colors | boolean | – | – |
| layer | – | – | – |
No output schema declared.
No examples provided.
offset_content ~126
Roll a layer's PIXEL CONTENT by (dx, dy) — distinct from offset_layer, which repositions the layer on the canvas. wrap=True wraps edges around (use it to seam-check a tileable texture); wrap=False fills the vacated strip per fill: transparent|color (color uses the `color` name/hex, default clear).
| Name | Type | Req | Description |
|---|---|---|---|
| color | – | – | – |
| dx | integer | – | – |
| dy | integer | – | – |
| fill | string | – | – |
| image | – | – | – |
| layer | – | – | – |
| wrap | boolean | – | – |
No output schema declared.
No examples provided.
offset_layer ~49
Offset a layer by a relative delta (dx, dy) from its current position.
| Name | Type | Req | Description |
|---|---|---|---|
| dx | integer | – | – |
| dy | integer | – | – |
| image | – | – | – |
| layer | – | – | – |
No output schema declared.
No examples provided.
open_image ~33
Open an image file (any format GIMP loads). Returns new image id + size.
| Name | Type | Req | Description |
|---|---|---|---|
| path | string | yes | – |
No output schema declared.
No examples provided.
outline_text ~65
Add an outline beneath a text layer: alpha->selection, grow by `radius`, fill onto a new layer in `color`. Destructive (adds a layer).
| Name | Type | Req | Description |
|---|---|---|---|
| color | string | – | – |
| image | – | – | – |
| layer | – | yes | – |
| radius | integer | – | – |
No output schema declared.
No examples provided.
paintbrush ~77
Soft paintbrush stroke. points = flat [x1,y1,x2,y2,...]. Optional `brush` name + `size`; uses `color` or current fg.
| Name | Type | Req | Description |
|---|---|---|---|
| brush | – | – | – |
| color | – | – | – |
| image | – | – | – |
| layer | – | – | – |
| points | array | yes | – |
| size | – | – | – |
No output schema declared.
No examples provided.
pencil ~57
Hard-edged pencil stroke. points = flat [x1,y1,x2,y2,...]. Uses `color` or current fg.
| Name | Type | Req | Description |
|---|---|---|---|
| color | – | – | – |
| image | – | – | – |
| layer | – | – | – |
| points | array | yes | – |
No output schema declared.
No examples provided.
posterize ~39
Reduce each channel to `levels` discrete tones (2..255).
| Name | Type | Req | Description |
|---|---|---|---|
| image | – | – | – |
| layer | – | – | – |
| levels | integer | yes | – |
No output schema declared.
No examples provided.
print_geometry ~74
Set print resolution (dpi) and/or scale to a physical size in inches. Pass width_in and/or height_in to scale (aspect preserved if one given). Reports current inches @ dpi and warns on upscaling.
| Name | Type | Req | Description |
|---|---|---|---|
| dpi | – | – | – |
| height_in | – | – | – |
| image | – | – | – |
| width_in | – | – | – |
No output schema declared.
No examples provided.
read_region ~84
Structured 2D grid of [r,g,b,a] pixels for a rectangle. Capped at w*h<=4096 (raises if larger — use get_bitmap for big areas).
| Name | Type | Req | Description |
|---|---|---|---|
| h | integer | yes | – |
| image | – | – | – |
| layer | – | – | – |
| w | integer | yes | – |
| x | integer | yes | – |
| y | integer | yes | – |
No output schema declared.
No examples provided.
redo ~62
Redo the last undone operation — only if GIMP exposes scriptable redo, which GIMP 3.x does NOT, so this returns ok=false with {supported: false} and redoes nothing. Use checkpoint()/restore() for reliable rollback.
| Name | Type | Req | Description |
|---|---|---|---|
| image | – | – | – |
No output schema declared.
No examples provided.
remove_mask ~31
Discard the layer's mask without applying it (destructive).
| Name | Type | Req | Description |
|---|---|---|---|
| image | – | – | – |
| layer | – | – | – |
No output schema declared.
No examples provided.
rename_layer ~29
Rename a layer.
| Name | Type | Req | Description |
|---|---|---|---|
| image | – | – | – |
| layer | – | – | – |
| name | string | yes | – |
No output schema declared.
No examples provided.
reorder_layer ~59
Move a layer to absolute `position` (0=top) within its parent, or into a different `parent` group when given.
| Name | Type | Req | Description |
|---|---|---|---|
| image | – | – | – |
| layer | – | – | – |
| parent | – | – | – |
| position | integer | – | – |
No output schema declared.
No examples provided.
reset_namespace ~90
Reset the persistent namespace. scope='soft' (default): clear user-defined vars and re-seed the baseline; the canvas/open images are untouched. scope='scratch' (guarded HARD reset): soft + delete only bridge-created scratch images (checkpoint snapshots tagged in `_gimpmcp_scratch`); never touches user-opened or agent working images.
| Name | Type | Req | Description |
|---|---|---|---|
| scope | string | – | – |
No output schema declared.
No examples provided.
restore ~52
Roll an image back to a checkpoint by rebuilding its layer stack from the snapshot. The checkpoint stays usable. `image` = which image to restore into.
| Name | Type | Req | Description |
|---|---|---|---|
| checkpoint_id | integer | yes | – |
| image | – | – | – |
No output schema declared.
No examples provided.
seam_check ~100
Wrap-offset a layer's content by half its size so a tileable texture's seams land in the middle for inspection (pair with get_bitmap). axis: both|x|y. Destructive — undo to revert (re-running the same axis restores only when that dimension is even; for odd sizes floor(w/2) applied twice lands 1px off).
| Name | Type | Req | Description |
|---|---|---|---|
| axis | string | – | – |
| image | – | – | – |
| layer | – | – | – |
No output schema declared.
No examples provided.
select_all ~19
Select the entire image canvas.
| Name | Type | Req | Description |
|---|---|---|---|
| image | – | – | – |
No output schema declared.
No examples provided.
select_border ~33
Replace the selection with a border band `radius` pixels wide.
| Name | Type | Req | Description |
|---|---|---|---|
| image | – | – | – |
| radius | integer | yes | – |
No output schema declared.
No examples provided.
select_by_color ~76
Select all pixels matching a color (name/#rrggbb/(r,g,b[,a])) within threshold (0..1). op: replace|add|subtract|intersect.
| Name | Type | Req | Description |
|---|---|---|---|
| color | – | yes | – |
| image | – | – | – |
| layer | – | – | – |
| op | string | – | – |
| threshold | number | – | – |
No output schema declared.
No examples provided.
select_ellipse ~74
Elliptical selection inscribed in the x,y,w,h box. op: replace|add|subtract|intersect.
| Name | Type | Req | Description |
|---|---|---|---|
| h | integer | yes | – |
| image | – | – | – |
| op | string | – | – |
| w | integer | yes | – |
| x | integer | yes | – |
| y | integer | yes | – |
No output schema declared.
No examples provided.
select_feather ~35
Feather (soften) the selection edge by `radius` pixels.
| Name | Type | Req | Description |
|---|---|---|---|
| image | – | – | – |
| radius | number | yes | – |
No output schema declared.
No examples provided.
select_from_alpha ~59
Select from a layer's alpha (opaque pixels). layer = id/name or omit for the active drawable. op: replace|add|subtract|intersect.
| Name | Type | Req | Description |
|---|---|---|---|
| image | – | – | – |
| layer | – | – | – |
| op | string | – | – |
No output schema declared.
No examples provided.
select_from_path ~85
Select the region enclosed by a path. path = id/name or omit for the active path. op: replace|add|subtract|intersect. If the image has no paths and none is named, returns {"supported": false} (nothing to do) rather than erroring.
| Name | Type | Req | Description |
|---|---|---|---|
| image | – | – | – |
| op | string | – | – |
| path | – | – | – |
No output schema declared.
No examples provided.
select_grow ~31
Grow the selection outward by `steps` pixels.
| Name | Type | Req | Description |
|---|---|---|---|
| image | – | – | – |
| steps | integer | yes | – |
No output schema declared.
No examples provided.
select_invert ~20
Invert the current selection.
| Name | Type | Req | Description |
|---|---|---|---|
| image | – | – | – |
No output schema declared.
No examples provided.
select_none ~20
Clear the selection (select nothing).
| Name | Type | Req | Description |
|---|---|---|---|
| image | – | – | – |
No output schema declared.
No examples provided.
select_rect ~67
Rectangular selection. op: replace|add|subtract|intersect. Returns selection bounds.
| Name | Type | Req | Description |
|---|---|---|---|
| h | integer | yes | – |
| image | – | – | – |
| op | string | – | – |
| w | integer | yes | – |
| x | integer | yes | – |
| y | integer | yes | – |
No output schema declared.
No examples provided.
select_shrink ~32
Shrink the selection inward by `steps` pixels.
| Name | Type | Req | Description |
|---|---|---|---|
| image | – | – | – |
| steps | integer | yes | – |
No output schema declared.
No examples provided.
selection_to_channel ~33
Save the current selection to a new channel. Returns the channel id.
| Name | Type | Req | Description |
|---|---|---|---|
| image | – | – | – |
| name | – | – | – |
No output schema declared.
No examples provided.
set_active_image ~25
Set the working image by integer id or basename string.
| Name | Type | Req | Description |
|---|---|---|---|
| image | – | yes | – |
No output schema declared.
No examples provided.
set_bg ~34
Set the background color. color = name|'#rrggbb'|(r,g,b[,a]).
| Name | Type | Req | Description |
|---|---|---|---|
| color | – | yes | – |
No output schema declared.
No examples provided.
set_blend_mode ~59
Set a layer's blend mode (NORMAL, MULTIPLY, SCREEN, OVERLAY, ...). Case/sep insensitive; unknown names fall back to NORMAL.
| Name | Type | Req | Description |
|---|---|---|---|
| image | – | – | – |
| layer | – | – | – |
| mode | string | yes | – |
No output schema declared.
No examples provided.
set_brush ~35
Set the active paint brush by name (e.g. '2. Hardness 050').
| Name | Type | Req | Description |
|---|---|---|---|
| name | string | yes | – |
No output schema declared.
No examples provided.
What is the GIMP Studio MCP server?
GIMP Studio MCP is listed in the public MCP registry as com.twelvetake/gimp-studio-mcp. Lets an AI assistant edit images in GIMP 3, including print and DTF transfer prep. This page covers its PyPI package (twelvetake-gimp-studio-mcp).
Is the GIMP Studio MCP server safe to use?
GIMP Studio MCP scores 76 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 4 October 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 Studio MCP server expose?
GIMP Studio MCP exposes 119 tools: status, list_images, set_active_image, gimp_exec, reset_namespace, and 114 more. Their descriptions and schemas cost roughly 8,781 tokens of context every time the server is loaded.
Is the GIMP Studio MCP server still maintained?
GIMP Studio MCP is still listed as active in the MCP registry. We last reached this channel on 4 October 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 Studio MCP server under?
GIMP Studio MCP declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.