DOCS BLOG ABOUT TRY THE GATEWAY

// MCP TOOL REFERENCE

PHOTOPEA TOOLS

34 tools from the Photopea MCP Server, categorised by risk level.

View the Photopea policy → Token cost: 5,996 tokens →

// ALL 34 PHOTOPEA TOOLS

READ 4 tools

Read photopea_get_document_info Get metadata about the active document including name, width, height, resolution (DPI), layer count, and co... Read photopea_get_layers Get the full layer tree of the active document as JSON. Returns an array of layer objects with name, type, ... Read photopea_list_fonts List available fonts in Photopea. Returns font PostScript names that can be used with add_text and edit_text. Read photopea_load_font Load a custom font from a URL (TTF, OTF, or WOFF2) into Photopea. The font becomes available for add_text a...

WRITE 26 tools

Write photopea_add_fill_layer Add a non-destructive solid color fill layer that covers the entire canvas. Unlike fill_selection, this cre... Write photopea_add_gradient Apply a linear gradient fill to a layer, replacing its current pixel content. The target layer must already... Write photopea_add_layer Add a new empty layer to the active document. The new layer becomes the active layer. Use this before opera... Write photopea_add_shape Add a vector shape layer (rectangle or ellipse) to the active document. The shape layer becomes the active ... Write photopea_add_text Add a new text layer to the active document at the specified position. The text layer becomes the active la... Write photopea_apply_adjustment Apply a destructive image adjustment to the active layer's pixel data. Use select_layer to target a specifi... Write photopea_apply_filter Apply a destructive filter effect to the active layer's pixel data. Use select_layer to target a specific l... Write photopea_close_document Close the active document. Set save to true to save changes before closing. Unsaved changes are discarded i... Write photopea_create_document Create a new blank document and make it the active document. This is typically the first step in a workflow... Write photopea_duplicate_layer Create a copy of a layer in the active document. The duplicate becomes the active layer and is placed above... Write photopea_edit_text Modify the content or style of an existing text layer. Only specified properties are changed — omit paramet... Write photopea_export_image Export the active document to a file and save it to the local filesystem. The entire document is flattened ... Write photopea_fill_selection Fill the current selection with a solid color on the active layer. Requires an active selection — use make_... Write photopea_group_layers Group multiple layers into a layer group (folder). Layers are specified by name — use get_layers to find la... Write photopea_make_selection Create a pixel selection region in the active document. After creating a selection, use fill_selection to f... Write photopea_modify_selection Modify the current active selection. Requires an existing selection created by make_selection. For expand, ... Write photopea_move_layer Translate a layer by a relative x/y offset in pixels from its current position. Positive x moves right, pos... Write photopea_open_file Open an existing image file in Photopea as a new document. Supports PSD, PNG, JPG, WebP, SVG, and other com... Write photopea_place_image Place an image into the active document from a URL or local file path. Creates a new layer with the placed ... Write photopea_redo Redo one or more previously undone actions in the active document. Only available after using undo — the re... Write photopea_reorder_layer Move a layer to a new position in the layer stack. Use 'top' or 'bottom' to move to the ends of the stack, ... Write photopea_resize_document Resize the active document canvas to new pixel dimensions, resampling all layer content to fit. This is a d... Write photopea_select_layer Set a layer as the active layer by name or index. Many tools (apply_filter, apply_adjustment, fill_selectio... Write photopea_set_layer_properties Update one or more properties on a layer. Only specified properties are changed; others remain at their cur... Write photopea_undo Undo one or more recent actions in the active document. Each step reverses one operation from the history. ... Write photopea_ungroup_layers Dissolve a layer group, moving all child layers to the document root. The group folder is removed but its c...

DESTRUCTIVE 2 tools

Destructive photopea_clear_selection Deselect the current selection in the active document, removing the marching ants. Does not modify any pixe... Destructive photopea_delete_layer Permanently remove a layer from the active document by name or index. The next layer in the stack becomes a...

EXECUTE 2 tools

Execute photopea_run_script Execute arbitrary Photopea/ExtendScript JavaScript in the Photopea environment. Use this for advanced opera... Execute photopea_transform_layer Scale, rotate, or flip a layer in-place. Modifies the layer's pixel data destructively. Use get_layers to c...

// RUNNING THIS SERVER

The managed route: connect Photopea through the PolicyLayer gateway — every tool call above is checked against your policy before it runs, with a full audit log.

DIRECT INSTALL (UNMANAGED) npx -y photopea-mcp-server

// FAQ

How many tools does the Photopea MCP server have? +

The Photopea MCP server exposes 34 tools across 4 categories: Read, Write, Destructive, Execute.

How do I enforce policies on Photopea tools? +

Route the Photopea server through the PolicyLayer gateway. Define allow, deny, or approval rules per tool in the dashboard — they are enforced on every call before it reaches the server.

What risk categories do Photopea tools fall into? +

Photopea tools are categorised as Read (4), Write (26), Destructive (2), Execute (2). Each category has a recommended default policy.

Let agents act without letting them run wild.

Route your MCP servers through PolicyLayer and every tool call is checked against your policy before it runs — allow, deny, or require approval. Per-identity grants. Full audit log. Live in minutes.

SECURE YOUR MCP →

Free to start. No card required.

4,600+ MCP servers and 31,000+ tools scanned and risk-classified.