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.

PhotoFresco

NPM · PHOTOFRESCO · 2 COMPONENTS

Let AI agents edit images in a PhotoFresco window you approve: layers, masks, previews and export.

0 this week 79 Trust /100

Last scanned (15 hours ago)

Scores higher than 63% of npm 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 Security100
  • No malware found by supply-chain analysis.Pass
  • No known CVEs affecting this package version or its production dependencies.Pass
  • No install/post-install scripts declared.Pass
  • No production dependencies, so there is no dependency health to assess. View diagnostics → Pass
Provenance & Transparency97
  • Source repository is publicly reachable at the declared URL. View diagnostics → Pass
  • Cryptographically verified build provenance (signed, bound to photofresco/photofresco-agent). View diagnostics → Pass
  • Clear OSI-approved license (MIT).Pass
  • Actively maintained (last published 14 days ago).Pass
  • Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail
Schema Quality & AI Usability63
  • AI-judged instruction clarity (good).Pass
  • Context-footprint check failed: tool/resource definitions use about 7558 tokens (~198/item across 38 items; 38 tools + 0 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 Management0
  • Stability not yet verified: not enough scan history yet (needs a 30-day window).Unverified
Tool Coverage100
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 100% of tool parameters carry a description.Pass
Tool Safety100
  • No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
  • All 2 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.Pass
  • An AI judge read all 39 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

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.

What we tested

Checks we ran (15)

  • Malware scan
  • Known CVEs
  • Install scripts
  • Dependency health
  • Source repository
  • Provenance
  • License
  • Maintenance
  • Security disclosure
  • Schema quality
  • 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.

  • Stability in Stability & Change Management (scores 0 for this)Stability not yet verified: not enough scan history yet (needs a 30-day window).

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.

  • 10 Nov 26 +5
    • Source repository: unverified → pass ▲ security
  • 9 Nov 26 −5
    • Provenance: pass → unverified ▼ security
  • 7 Nov 26 79

    First indexed and scored.

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 npm/photofresco@0.1.2

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 npm
Reason Verified
Discovered via Registry attestation endpoint
Source repo photofresco/photofresco-agent
Certificate issuer https://token.actions.githubusercontent.com
Certificate SAN https://github.com/photofresco/photofresco-agent/.github/workflows/release.yml@refs/heads/main
Rekor log index 3730442018
Predicate type SLSA build provenance https://slsa.dev/provenance/v1
Subject digest sha512:89c4514a3952c6788adb64e2df22bb1889ce2ccd248dc4be6c049de17a8607e922baee7e759356ef70e01d131c68f4d89d40aac34d81aaa3603fd1e97

Background: How many MCP packages publish verified provenance →

Dependencies 0 packages
Packages resolved 0
Tree resolution Complete

Background: SBOMs and build attestations, explained →

MCP tools · 38 exposed · ~7,318 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
adjust_add ~315

Add a non-destructive adjustment layer above the active node. Types include brightness-contrast, levels, curves, exposure, hue-saturation, vibrance, color-balance, black-white, photo-filter, channel-mixer, gradient-map, selective-color, color-lookup, shadows-highlights, match-replace-color, invert, posterize, and threshold. Pass type-specific params in "params". Match color accepts source_layer_id/target_layer_id to sample RGB statistics. Set clipped=true (layer.set_props) to affect only the layer below. Inputs: adjustment_type (required), params. Units, ranges and allowed values are in the input schema; the editor rejects arguments outside it before anything runs. Effect: Edits the document through an undoable command that appears in History. Undo: history_undo reverts it. Permission: Edit, granted by the user in the PhotoFresco window (ask with photofresco_request_access). Returns immediately with the result. Results carry document_id and revision. PhotoFresco operation: adjust.add.

NameTypeReqDescription
adjustment_typestringyesWhich adjustment
paramsobject–Adjustment parameter patch. Choose the branch matching adjustment_type for adjust.add, or the existing adjustment type for adjust.set_params; type may be omitted. Only supplied top-level fields chang…

No output schema declared.

No examples provided.

adjust_set_params ~211

Update the active adjustment layer’s parameters (same shapes as adjust.add). Undoable. Inputs: params (required). Units, ranges and allowed values are in the input schema; the editor rejects arguments outside it before anything runs. Effect: Edits the document through an undoable command that appears in History. Undo: history_undo reverts it. Permission: Edit, granted by the user in the PhotoFresco window (ask with photofresco_request_access). Returns immediately with the result. Results carry document_id and revision. PhotoFresco operation: adjust.set_params.

NameTypeReqDescription
paramsobjectyesAdjustment parameter patch. Choose the branch matching adjustment_type for adjust.add, or the existing adjustment type for adjust.set_params; type may be omitted. Only supplied top-level fields chang…

No output schema declared.

No examples provided.

canvas_resize ~200

Change canvas size without resampling; content shifts by (dx, dy) px (e.g. dx=(newW−oldW)/2 to center). Clears the selection. Undoable. Inputs: width (required), height (required), dx, dy. Units, ranges and allowed values are in the input schema; the editor rejects arguments outside it before anything runs. Effect: Edits the document through an undoable command that appears in History. Undo: history_undo reverts it. Permission: Edit, granted by the user in the PhotoFresco window (ask with photofresco_request_access). Returns immediately with the result. Results carry document_id and revision. PhotoFresco operation: canvas.resize.

NameTypeReqDescription
dxnumber–Content shift x (default 0)
dynumber–Content shift y (default 0)
heightnumberyesNew height px
widthnumberyesNew width px

No output schema declared.

No examples provided.

crop_apply ~156

Apply pending crop or set a rectangle then apply. Undoable. Inputs: x, y, width, height. Units, ranges and allowed values are in the input schema; the editor rejects arguments outside it before anything runs. Effect: Edits the document through an undoable command that appears in History. Undo: history_undo reverts it. Permission: Edit, granted by the user in the PhotoFresco window (ask with photofresco_request_access). Returns immediately with the result. Results carry document_id and revision. PhotoFresco operation: crop.apply.

NameTypeReqDescription
heightnumber–Height
widthnumber–Width
xnumber–Document x
ynumber–Document y

No output schema declared.

No examples provided.

doc_get_state ~130

Get the full document state: document_id and content revision (agent sessions), dimensions, color mode, the layer tree (ids, names, kinds, blend modes, opacity, visibility, locks, pixel bounds), the active node id, and the current selection bounds. Call this first to orient yourself. Inputs: none. Effect: Reads the document or editor state; changes nothing. Permission: Read, granted by the user in the PhotoFresco window (ask with photofresco_request_access). Returns immediately with the result. Results carry document_id and revision. PhotoFresco operation: doc.get_state.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

doc_histogram ~148

Return 256-bin histogram counts for the flattened visible document, restricted to the active selection when one exists. mode defaults to luminosity; rgb returns composite plus red/green/blue counts. Inputs: mode. Units, ranges and allowed values are in the input schema; the editor rejects arguments outside it before anything runs. Effect: Reads the document or editor state; changes nothing. Permission: Read, granted by the user in the PhotoFresco window (ask with photofresco_request_access). Returns immediately with the result. Results carry document_id and revision. PhotoFresco operation: doc.histogram.

NameTypeReqDescription
modestring–rgb, red, green, blue, or luminosity

No output schema declared.

No examples provided.

doc_new ~253

Create a new document tab. Width/height use unit (px, in, cm, mm) and resolution; background is white, transparent, or color. Inputs: name, width, height, unit, resolution, background, background_color, preset. Units, ranges and allowed values are in the input schema; the editor rejects arguments outside it before anything runs. Effect: Opens, closes, duplicates or reverts documents (tabs); history_undo does not reverse it. Undo: not reversible with history_undo. Permission: Edit, granted by the user in the PhotoFresco window (ask with photofresco_request_access). Returns immediately with the result. Results carry document_id and revision. PhotoFresco operation: doc.new.

NameTypeReqDescription
backgroundstring–Background contents
background_colorarray–[r,g,b] when background=color
heightnumber–Height in the selected unit
namestring–Document name (default Untitled)
presetstring–Preset id for UI bookkeeping
resolutionnumber–Pixels per inch for physical units
unitstring–Measurement unit
widthnumber–Width in the selected unit

No output schema declared.

No examples provided.

doc_sample_color ~146

Read the flattened composite color at document coordinate (x, y). Returns RGB, RGBA, and HSB; does not change the foreground color. Inputs: x (required), y (required). Units, ranges and allowed values are in the input schema; the editor rejects arguments outside it before anything runs. Effect: Reads the document or editor state; changes nothing. Permission: Read, granted by the user in the PhotoFresco window (ask with photofresco_request_access). Returns immediately with the result. Results carry document_id and revision. PhotoFresco operation: doc.sample_color.

NameTypeReqDescription
xnumberyesDoc x
ynumberyesDoc y

No output schema declared.

No examples provided.

edit_fill ~239

Fill the selection (or the whole canvas if none) on the active layer. Default contents=color uses color [r,g,b] or the current foreground; contents=pattern uses the active pattern or pattern_id. Inputs: contents, color, pattern_id, blend_mode, opacity. Units, ranges and allowed values are in the input schema; the editor rejects arguments outside it before anything runs. Effect: Edits the document through an undoable command that appears in History. Undo: history_undo reverts it. Permission: Edit, granted by the user in the PhotoFresco window (ask with photofresco_request_access). Returns immediately with the result. Results carry document_id and revision. PhotoFresco operation: edit.fill.

NameTypeReqDescription
blend_modestring–Pattern blend mode (default normal)
colorarray–[r, g, b] each 0-255
contentsstring–color (default) or pattern
opacitynumber–Pattern opacity 0..1 (default 1)
pattern_idstring–Pattern preset id; defaults to the active pattern when contents=pattern

No output schema declared.

No examples provided.

export_artifact ~391

Export the active document and keep the file in the editor as a retrievable artifact instead of starting a browser download. format "png" is the flattened visible composite (or, with layer_id, that layer's own pixels at its content bounds); "psd" is the layered Photoshop interchange file from File > Save; "pfd" is PhotoFresco's native editable document from Save to My Documents. Returns { artifact_id, format, mime_type, filename, byte_length, sha256, document_id, revision, width, height, layer_id, fidelity, loss, created_at, expires_at }; read the bytes with artifact.read. Artifacts are bound to this caller and document, kept 10 minutes, at most 256.0 MiB each and 16 per caller (the oldest is evicted). Errors: export_failed, export_timeout (120 s), artifact_too_large, artifact_limit, stale_revision (the document changed during the export). Nothing is written to disk. The result links an MCP resource (photofresco://artifact/<id>) holding the bytes; photofresco_export_file writes the export to a granted folder in one step. Inputs: format (required), layer_id. Units, ranges and allowed values are in the input schema; the editor rejects arguments outside it before anything runs. Effect: Reads the document or editor state; changes nothing. Permission: Read + Export, granted by the user in the PhotoFresco window (ask with photofresco_request_access). Returns when the operation has finished (it may take seconds). Results carry document_id and revision. PhotoFresco operation: export.artifact.

NameTypeReqDescription
formatstringyespng (flattened or one layer), psd (layered interchange) or pfd (native, full fidelity)
layer_idstring–PNG only: export this layer's own pixels instead of the composite

No output schema declared.

No examples provided.

filter_apply ~477

Apply a destructive filter to the active layer (selection restricts it). Types: gaussian-blur {radius px}, sharpen {amount 0..3, radius px}, sharpen-more, sharpen-edges, unsharp-mask {amount percent 1..500, radius px, threshold 0..255}, noise {amount 0..1}, box-blur {radius px}, motion-blur {angle deg, distance px}, radial-blur {amount 1..100, method spin|zoom}, average, median {radius 1..8}, mosaic {cellSize px}, high-pass {radius px}, ripple {amount px, wavelength px}, twirl {angle deg}, spherize {amount -100..100}, wave {amplitude px, wavelength px}, zigzag {amount px, ridges}, polar-coordinates {mode rect-to-polar|polar-to-rect}, crystallize {cellSize px}, pointillize {cellSize px}, facet, fragment, despeckle, dust-and-scratches {radius px, threshold 0..255}, emboss {angle deg, height px, amount 0..5}, find-edges, solarize, trace-contour {level 0..255, edge lower|upper}, wind {method wind|blast|stagger, direction left|right}, clouds, difference-clouds, lens-flare {brightness percent 10..300, centerX 0..1, centerY 0..1}, fibers {variance 1..64, strength 1..64}, maximum {radius px}, minimum {radius px}, offset {dx px, dy px}, custom {kernel 25 numbers, scale, offset}. Pass params in "params". Inputs: filter_type (required), params. Units, ranges and allowed values are in the input schema; the editor rejects arguments outside it before anything runs. Effect: Edits the document through an undoable command that appears in History. Undo: history_undo reverts it. Permission: Edit, granted by the user in the PhotoFresco window (ask with photofresco_request_access). Returns immediately with the result. Results carry document_id and revision. PhotoFresco operation: filter.apply.

NameTypeReqDescription
filter_typestringyesWhich filter
paramsobject–Type-specific parameters

No output schema declared.

No examples provided.

history_redo ~92

Redo the next edit. Returns the label of what was redone, or null. Inputs: none. Effect: Edits the document through an undoable command that appears in History. Permission: Edit, granted by the user in the PhotoFresco window (ask with photofresco_request_access). Returns immediately with the result. Results carry document_id and revision. PhotoFresco operation: history.redo.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

history_undo ~103

Undo the last edit. Returns the label of what was undone, or null. Reverts the last History entry, including edits made by the user. Inputs: none. Effect: Edits the document through an undoable command that appears in History. Permission: Edit, granted by the user in the PhotoFresco window (ask with photofresco_request_access). Returns immediately with the result. Results carry document_id and revision. PhotoFresco operation: history.undo.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

image_resize ~145

Resample the whole document to new pixel dimensions (bilinear). Undoable. Inputs: width (required), height (required). Units, ranges and allowed values are in the input schema; the editor rejects arguments outside it before anything runs. Effect: Edits the document through an undoable command that appears in History. Undo: history_undo reverts it. Permission: Edit, granted by the user in the PhotoFresco window (ask with photofresco_request_access). Returns immediately with the result. Results carry document_id and revision. PhotoFresco operation: image.resize.

NameTypeReqDescription
heightnumberyesNew height px
widthnumberyesNew width px

No output schema declared.

No examples provided.

image_rotate ~158

Rotate the whole canvas by quarter turns: 1 = 90° clockwise, 2 = 180°, 3 = 90° counter-clockwise. Undoable. Inputs: turns (required). Units, ranges and allowed values are in the input schema; the editor rejects arguments outside it before anything runs. Effect: Edits the document through an undoable command that appears in History. Undo: history_undo reverts it. Permission: Edit, granted by the user in the PhotoFresco window (ask with photofresco_request_access). Returns immediately with the result. Results carry document_id and revision. PhotoFresco operation: image.rotate.

NameTypeReqDescription
turnsnumberyes1, 2, or 3 quarter turns

No output schema declared.

No examples provided.

layer_add ~131

Add a new empty layer above the active node and make it active. Inputs: name. Units, ranges and allowed values are in the input schema; the editor rejects arguments outside it before anything runs. Effect: Edits the document through an undoable command that appears in History. Undo: history_undo reverts it. Permission: Edit, granted by the user in the PhotoFresco window (ask with photofresco_request_access). Returns immediately with the result. Results carry document_id and revision. PhotoFresco operation: layer.add.

NameTypeReqDescription
namestring–Layer name (default "Layer N")

No output schema declared.

No examples provided.

layer_delete ~95

Delete the active node. Refused if it would leave no layers. Inputs: none. Effect: Edits the document through an undoable command that appears in History. Undo: history_undo reverts it. Permission: Edit, granted by the user in the PhotoFresco window (ask with photofresco_request_access). Returns immediately with the result. Results carry document_id and revision. PhotoFresco operation: layer.delete.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

layer_duplicate ~96

Duplicate the active node (deep for groups); the copy becomes active. Inputs: none. Effect: Edits the document through an undoable command that appears in History. Undo: history_undo reverts it. Permission: Edit, granted by the user in the PhotoFresco window (ask with photofresco_request_access). Returns immediately with the result. Results carry document_id and revision. PhotoFresco operation: layer.duplicate.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

layer_set_active ~129

Set the active node (layers paint/transform; groups move as a unit). Inputs: id (required). Units, ranges and allowed values are in the input schema; the editor rejects arguments outside it before anything runs. Effect: Changes editor view or tool settings; not a document edit and not in History. Permission: Edit, granted by the user in the PhotoFresco window (ask with photofresco_request_access). Returns immediately with the result. Results carry document_id and revision. PhotoFresco operation: layer.set_active.

NameTypeReqDescription
idstringyesNode id from doc.get_state

No output schema declared.

No examples provided.

layer_set_props ~484

Set properties on a node (default: the active one). Only provided fields change. blend_mode "pass-through" is groups-only. Inputs: id, name, visible, opacity, blend_mode, locked, lock_pixels, lock_position, lock_transparency, clipped, blend_if, channel_mask, knockout, blend_interior_as_group, blend_clipped_as_group, transparency_shapes_layer, mask_hides_effects, vector_mask_hides_effects. Units, ranges and allowed values are in the input schema; the editor rejects arguments outside it before anything runs. Effect: Edits the document through an undoable command that appears in History. Undo: history_undo reverts it. Permission: Edit, granted by the user in the PhotoFresco window (ask with photofresco_request_access). Returns immediately with the result. Results carry document_id and revision. PhotoFresco operation: layer.set_props.

NameTypeReqDescription
blend_clipped_as_groupboolean–Apply the clipping base blend/opacity to the whole clip unit
blend_ifobject|null–Raster layer Blend If {channel,thisLayer:[b0,b1,w1,w0],underlying:[...]}; null clears it
blend_interior_as_groupboolean–Blend fill and interior effects as one source
blend_modestring–Blend mode
channel_maskobject–Raster layer RGB write mask {r:boolean,g:boolean,b:boolean}
clippedboolean–Clipping mask: confine rendering to the alpha of the layer below (⌥⌘G)
idstring–Target node id (default: active)
knockoutstring–Knockout depth
lock_pixelsboolean–Raster layer pixel lock
lock_positionboolean–Raster layer position lock
lock_transparencyboolean–Raster layer transparency lock
lockedboolean–Lock/unlock
mask_hides_effectsboolean–Apply the raster layer mask to generated effect output
namestring–Rename
opacitynumber–0..1
transparency_shapes_layerboolean–Use source transparency to shape fill and interior effects
vector_mask_hides_effectsboolean–Apply the vector mask to generated effect output
visibleboolean–Show/hide

No output schema declared.

No examples provided.

mask_add ~149

Add a raster mask to the active layer. mode "selection" rasterizes the current selection (selected = visible); default is "selection" when one exists, else "reveal". Inputs: mode. Units, ranges and allowed values are in the input schema; the editor rejects arguments outside it before anything runs. Effect: Edits the document through an undoable command that appears in History. Undo: history_undo reverts it. Permission: Edit, granted by the user in the PhotoFresco window (ask with photofresco_request_access). Returns immediately with the result. Results carry document_id and revision. PhotoFresco operation: mask.add.

NameTypeReqDescription
modestring–Mask contents

No output schema declared.

No examples provided.

mask_remove ~95

Delete the active layer’s mask (the layer becomes fully visible again). Inputs: none. Effect: Edits the document through an undoable command that appears in History. Undo: history_undo reverts it. Permission: Edit, granted by the user in the PhotoFresco window (ask with photofresco_request_access). Returns immediately with the result. Results carry document_id and revision. PhotoFresco operation: mask.remove.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

photofresco_attach ~81

Make this session target another open document by document_id (from photofresco_documents). Operations run only while the target is the active tab, so ask the user to switch tabs if needed. Inputs: document (required). Effect: changes the session target; no document edit. Needs a connected session.

NameTypeReqDescription
documentstringyesdocument_id to target

No output schema declared.

No examples provided.

photofresco_connect ~286

Open PhotoFresco in its own browser window on this computer and ask the user to allow this agent. The window shows a connection code; tell the user the code returned here so they can check it before clicking Allow. Inputs: access (optional) asks for permissions right away; document is "active" (default), "none" or a document_id; wait_seconds (default 40, at most 170) is how long this call waits for the user. Returns state "connected" with the session status, or state "pairing" with the code while the user has not decided yet: call photofresco_connect again to keep waiting (the request expires after 3 minutes). A session starts with no permissions; the editing tools appear (tools/list_changed) once the user grants them in the Permissions dialog. Effect: starts a browser process and loads photofresco.com on the first call; nothing is edited. Safe to call again while connected (returns the current status).

NameTypeReqDescription
accessobject–Permissions to ask the user for once connected. Asking grants nothing; the user decides in the PhotoFresco window
documentstring–"active" (default), "none", or a document_id from photofresco_documents
wait_secondsnumber–Seconds to wait for the user's decision before returning the pending code (default 40)

No output schema declared.

No examples provided.

photofresco_disconnect ~93

End this session (same as the user pressing Stop): in-flight work is interrupted, permissions are cleared, applied edits stay in History. The window stays open for the user unless close_window is true. Reconnecting needs the user's Allow again. Inputs: close_window (optional). Effect: ends the session; edits nothing.

NameTypeReqDescription
close_windowboolean–Also close the PhotoFresco browser window this server opened

No output schema declared.

No examples provided.

photofresco_documents ~58

Open documents in the PhotoFresco window: document_id, name, whether it is the active tab, revision, which agent controls it and whether it is paused. Inputs: none. Effect: reads state only. Needs a connected session.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

photofresco_list_tool_groups ~45

The op groups this server can list as tools, which are enabled, and how many tools each adds now. Inputs: none. Effect: reads server state only.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

photofresco_request_access ~211

Ask the user for permissions in the PhotoFresco window (replaces any pending request). The user may grant fewer; nothing is granted until they click Allow there. Tools appear as permissions arrive (tools/list_changed); photofresco_status shows grants and the pending request. Inputs: capabilities (required), budget_credits (required with spend, 1–100000 credits), reason (shown to the user, at most 200 characters). Effect: shows a request in the editor; changes no document. Needs a connected session.

NameTypeReqDescription
budget_creditsinteger–Credit budget for paid AI (required with spend)
capabilitiesarrayyesPermissions to ask for: read (see the document and previews), edit (change documents, open/close tabs), export (files leave the editor), external-write (send data to PhotoFresco services), spend (pai…
reasonstring–Why, shown to the user (at most 200 characters)

No output schema declared.

No examples provided.

photofresco_select_tool_groups ~100

Enable or disable op groups to change which PhotoFresco operations are listed as tools (sends tools/list_changed). Use it when a needed operation is not listed. Listing never grants permissions. Inputs: enable, disable (group IDs from photofresco_list_tool_groups, or "all"). Effect: changes this server's tool list only.

NameTypeReqDescription
disablearray–Groups to remove
enablearray–Groups to add

No output schema declared.

No examples provided.

photofresco_status ~66

Connection state, the pending connection code, the session (target document_id, revision, granted permissions, pending permission request, credit budget, pause state), folders granted for import/export and the enabled tool groups. Inputs: none. Effect: reads state only; never starts a browser.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

render_mask ~611

Preview a mask over a document-space region as a grayscale PNG (black 0 = hidden/unselected, white 255 = shown/selected) with exact coverage statistics { pixels, nonzero, full, mean } computed at document resolution over the region. source "layer" (default) is a layer's raster mask (layer_id, default the active layer), placed at its document position; source "selection" is the current selection. Read-only. Returns image { mime_type: "image/png", data_base64, width, height, byte_length } plus document_id, revision (the document revision rendered), document { width, height }, requested and region { x, y, width, height } (region = requested clipped to the canvas; clipped: true when they differ), scale { x, y } and the coordinate convention. Errors carry code: invalid_region, region_out_of_bounds, preview_too_large, unknown_layer, unsupported_layer_kind, mask_unavailable, stale_revision (the document changed while rendering). Limits: output ≤ 2048 px per side and 4194304 px, PNG ≤ 8.0 MiB; the source is read in strips of ≤ 8.0 MiB so a small region of a huge document stays small. Inputs: x, y, width, height, max_size, scale, source, layer_id. Units, ranges and allowed values are in the input schema; the editor rejects arguments outside it before anything runs. Effect: Reads the document or editor state; changes nothing. Permission: Read, granted by the user in the PhotoFresco window (ask with photofresco_request_access). Returns when the operation has finished (it may take seconds). Results carry document_id and revision. PhotoFresco operation: render.mask.

NameTypeReqDescription
heightnumber–Region height in document pixels (whole number; default: to the bottom canvas edge)
layer_idstring–Layer whose raster mask to show (source layer; default the active layer)
max_sizenumber–Fit the preview inside this many pixels per side, never magnifying (default 1024). Use scale instead for exact detail
scalenumber–Exact output pixels per document pixel (1 = actual pixels, 4 = 4× magnified with nearest sampling, 0.25 = area-averaged). Output is limited to 2048 px per side and 4194304 px
sourcestring–layer: the raster mask of layer_id (default); selection: the active selection
widthnumber–Region width in document pixels (whole number; default: to the right canvas edge)
xnumber–Left edge in document pixels (whole number, default 0). May be negative; the region is clipped to the canvas
ynumber–Top edge in document pixels (whole number, default 0). May be negative; the region is clipped to the canvas

No output schema declared.

No examples provided.

render_preview ~168

Render the whole flattened composite to a PNG data URL, downscaled to fit max_size (never magnified). Use after edits to see the result. For a region at detail scale, one layer, a mask, or coordinate metadata use render.region / render.mask. Inputs: max_size. Units, ranges and allowed values are in the input schema; the editor rejects arguments outside it before anything runs. Effect: Reads the document or editor state; changes nothing. Permission: Read, granted by the user in the PhotoFresco window (ask with photofresco_request_access). Returns immediately with the result. Results carry document_id and revision. PhotoFresco operation: render.preview.

NameTypeReqDescription
max_sizenumber–Max width/height in px (default 512, at most 2048)

No output schema declared.

No examples provided.

render_region ~598

Preview a document-space region at a chosen scale as a PNG, without rendering the whole document. Without layer_id it shows the flattened visible composite (same compositor as PNG export); with layer_id it shows that layer's own pixels (raster, text, shape or smart object) before its mask, opacity, blend mode and effects. Use scale 1–16 to inspect detail at actual or magnified pixels, or max_size to fit an overview. Read-only; nothing is added to history. Returns image { mime_type: "image/png", data_base64, width, height, byte_length } plus document_id, revision (the document revision rendered), document { width, height }, requested and region { x, y, width, height } (region = requested clipped to the canvas; clipped: true when they differ), scale { x, y } and the coordinate convention. Errors carry code: invalid_region, region_out_of_bounds, preview_too_large, unknown_layer, unsupported_layer_kind, mask_unavailable, stale_revision (the document changed while rendering). Limits: output ≤ 2048 px per side and 4194304 px, PNG ≤ 8.0 MiB; the source is read in strips of ≤ 8.0 MiB so a small region of a huge document stays small. Inputs: x, y, width, height, max_size, scale, layer_id. Units, ranges and allowed values are in the input schema; the editor rejects arguments outside it before anything runs. Effect: Reads the document or editor state; changes nothing. Permission: Read, granted by the user in the PhotoFresco window (ask with photofresco_request_access). Returns when the operation has finished (it may take seconds). Results carry document_id and revision. PhotoFresco operation: render.region.

NameTypeReqDescription
heightnumber–Region height in document pixels (whole number; default: to the bottom canvas edge)
layer_idstring–Optional layer id (doc.get_state) to preview that layer alone instead of the composite
max_sizenumber–Fit the preview inside this many pixels per side, never magnifying (default 1024). Use scale instead for exact detail
scalenumber–Exact output pixels per document pixel (1 = actual pixels, 4 = 4× magnified with nearest sampling, 0.25 = area-averaged). Output is limited to 2048 px per side and 4194304 px
widthnumber–Region width in document pixels (whole number; default: to the right canvas edge)
xnumber–Left edge in document pixels (whole number, default 0). May be negative; the region is clipped to the canvas
ynumber–Top edge in document pixels (whole number, default 0). May be negative; the region is clipped to the canvas

No output schema declared.

No examples provided.

selection_all ~86

Select the whole document. Inputs: none. Effect: Edits the document through an undoable command that appears in History. Undo: history_undo reverts it. Permission: Edit, granted by the user in the PhotoFresco window (ask with photofresco_request_access). Returns immediately with the result. Results carry document_id and revision. PhotoFresco operation: selection.all.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

selection_ellipse ~198

Select an ellipse inscribed in the given rect (doc coordinates). Inputs: x (required), y (required), w (required), h (required), mode, feather. Units, ranges and allowed values are in the input schema; the editor rejects arguments outside it before anything runs. Effect: Edits the document through an undoable command that appears in History. Undo: history_undo reverts it. Permission: Edit, granted by the user in the PhotoFresco window (ask with photofresco_request_access). Returns immediately with the result. Results carry document_id and revision. PhotoFresco operation: selection.ellipse.

NameTypeReqDescription
feathernumber–Feather radius in px (softens the edge)
hnumberyesHeight
modestring–How to combine with the existing selection
wnumberyesWidth
xnumberyesLeft
ynumberyesTop

No output schema declared.

No examples provided.

selection_invert ~89

Invert the current selection. Inputs: none. Effect: Edits the document through an undoable command that appears in History. Undo: history_undo reverts it. Permission: Edit, granted by the user in the PhotoFresco window (ask with photofresco_request_access). Returns immediately with the result. Results carry document_id and revision. PhotoFresco operation: selection.invert.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

selection_none ~95

Deselect — clear the selection so edits affect the whole canvas again. Inputs: none. Effect: Edits the document through an undoable command that appears in History. Undo: history_undo reverts it. Permission: Edit, granted by the user in the PhotoFresco window (ask with photofresco_request_access). Returns immediately with the result. Results carry document_id and revision. PhotoFresco operation: selection.none.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

selection_rect ~190

Select a rectangle in doc coordinates. Inputs: x (required), y (required), w (required), h (required), mode, feather. Units, ranges and allowed values are in the input schema; the editor rejects arguments outside it before anything runs. Effect: Edits the document through an undoable command that appears in History. Undo: history_undo reverts it. Permission: Edit, granted by the user in the PhotoFresco window (ask with photofresco_request_access). Returns immediately with the result. Results carry document_id and revision. PhotoFresco operation: selection.rect.

NameTypeReqDescription
feathernumber–Feather radius in px (softens the edge)
hnumberyesHeight
modestring–How to combine with the existing selection
wnumberyesWidth
xnumberyesLeft
ynumberyesTop

No output schema declared.

No examples provided.

Install

How do I install the PhotoFresco MCP server?

PhotoFresco runs locally as an npm package, launched with npx -y photofresco mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

npm · photofresco

# add to Claude Code
claude mcp add photofresco-photofresco -- npx -y photofresco mcp
Common questions

What is the PhotoFresco MCP server?

PhotoFresco is an MCP server listed in the public MCP registry as io.github.photofresco/photofresco. Let AI agents edit images in a PhotoFresco window you approve: layers, masks, previews and export. This page covers its npm package (photofresco).

Is the PhotoFresco MCP server safe to use?

PhotoFresco scores 79 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 21 November 2026. It declares no install or post-install scripts. 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 PhotoFresco MCP server expose?

PhotoFresco exposes 38 tools: photofresco_connect, photofresco_status, photofresco_request_access, photofresco_documents, photofresco_attach, and 33 more. Their descriptions and schemas cost roughly 7,318 tokens of context every time the server is loaded.

Is the PhotoFresco MCP server still maintained?

PhotoFresco 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 PhotoFresco MCP server under?

PhotoFresco 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 PhotoFresco MCP server?

VerifyMCP ran 15 checks on PhotoFresco, covering Malware scan, Known CVEs, Install scripts, Dependency health and 11 more. One item could not be completed, a gap on our side rather than a finding about PhotoFresco: Stability. One category scores 0 for that reason, because we only credit what we can confirm. Endpoint Security and Transport & Reachability do not apply to an npm package, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.