photoshop-mcp-pro
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| ps_create_documentA | Creates a new Photoshop document. Use a preset for common social-media / print sizes, or supply custom dimensions. Optionally fill a background color and add guide presets. |
| ps_get_document_infoA | Returns the full state of the active document — dimensions, resolution, color mode, layer count, active layer, and selection status. Use this to orient yourself before making changes. |
| ps_save_documentA | Saves the active document to disk. Supports PSD, JPEG, and PNG formats. For JPEG, quality ranges from 1 (lowest) to 12 (highest). |
| ps_create_layerB | Creates a new layer or group in the active document. Optionally positions it below a named layer. |
| ps_manage_layersA | Performs a layer operation: delete, duplicate, merge-visible, flatten, rasterize, group, ungroup, lock, unlock, show, or hide. Targets the named layer or the active layer if none is specified. This single tool replaces 10+ individual layer-action tools. |
| ps_get_layersA | Returns the full layer tree of the active document as JSON, including names, types, visibility, opacity, blend modes, and bounds. Use this to understand the document structure before editing. |
| ps_reorder_layerA | Moves a layer to a new position in the layer stack. Use "top"/"bottom" for absolute positioning, or "up"/"down" for relative moves. Optionally specify a targetLayer for relative placement. |
| ps_transformB | Applies a transform to the active (or named) layer. Supports move, scale, rotate, flip-horizontal, flip-vertical, and fit-to-document — all in one tool. Supply only the parameters relevant to your action. |
| ps_alignA | Aligns a layer relative to the document bounds. Use center-both to perfectly center a layer, or pick an edge alignment. |
| ps_create_textA | Creates a text layer with full typographic control in a single call — font, size, color, alignment, tracking, leading, and warp. Use type "point" for single-line text or "area" for a bounded text box. |
| ps_update_textA | Updates a single property on the active text layer — content, font, size, color, alignment, tracking, leading, or warp. Targets the currently active layer, so select the text layer first. |
| ps_set_layer_styleA | The POWER tool for layer effects. Supply any combination of effects — dropShadow, innerShadow, outerGlow, innerGlow, bevelEmboss, gradientOverlay, patternOverlay, satin, colorOverlay, stroke — and they are all applied in a single call. Omitted effects are left unchanged. This replaces a dozen individual effect tools. |
| ps_set_layer_propertiesA | Sets opacity, blend mode, and/or fill opacity on the active layer. Consolidates what was previously three separate tools. |
| ps_apply_filterA | Applies a destructive filter to the active layer. Supported: gaussian-blur, motion-blur, sharpen (unsharp mask), noise (add noise), radial-blur. Supply the filter type and its specific params object. |
| ps_add_adjustmentA | Creates a NON-DESTRUCTIVE adjustment layer above the active layer. Supports curves, levels, hue-saturation, color-balance, gradient-map, solid-color, photo-filter, brightness-contrast, and invert. Supply the type and its specific params object. |
| ps_draw_shapeA | Draws a vector shape on a new shape layer. Supports rectangle, rounded-rectangle, ellipse, line, polygon, star, and custom-path. Supply the type and its specific params. |
| ps_selectA | Creates or modifies selections. Use "all" to select everything, "none" to deselect, "inverse" to invert, or create geometric / color-range selections. For rectangle/ellipse, provide bounds; for color-range, provide a sample color and fuzziness. |
| ps_maskA | Creates or manages layer masks. "create" adds a reveal-all mask, "create-from-selection" adds a mask from the current selection, "apply" merges the mask into the layer, "delete" removes it. |
| ps_place_imageA | Places an external image file into the active document. By default it is placed as a Smart Object for non-destructive editing. Optionally set position and dimensions. |
| ps_resizeA | Resizes the canvas (adds/removes space around content) or the image (resamples all content). Use "canvas" to change document bounds without scaling, or "image" to scale everything. |
| ps_colorA | Manages foreground and background colors. "set-foreground" / "set-background" set the app color (provide color). "swap" swaps foreground and background. "sample-pixel" reads the color at the given x,y coordinate. |
| ps_guideA | Manages document guides. "add" places a single guide at a position. "add-grid" creates an evenly-spaced grid of guides. "remove-all" clears all guides. "get" returns current guide positions. |
| ps_exportA | Exports the active document to a file. Supports PNG (with optional scaling), JPEG (with quality), PSD, and TIFF. Provide an absolute file path. |
| ps_historyA | Manages document history. "undo" steps backward (default 1 step), "redo" steps forward, "get-states" returns the list of history states. Use undo to recover from mistakes. |
| ps_smart_objectA | Manages Smart Objects. "convert" converts the active layer to a Smart Object for non-destructive editing. "place-file" embeds an external file as a new Smart Object layer. |
| ps_create_designA | HIGH-LEVEL workflow tool that creates an entire design in a single call. Specify a document preset, background (solid/gradient/image), an array of layers (text, image, shape), and optional guides. Generates and executes ONE script for the whole composition. Perfect for quickly scaffolding social media posts, thumbnails, or print layouts. |
| ps_batchA | Executes multiple tool operations in sequence within a single call. Each operation specifies a tool name and its arguments. Results are returned as a combined array. Use this to chain several steps without round-trips. |
| ps_reviewA | Takes a screenshot of the current document via ExtendScript and returns it as base64-encoded image data alongside the full document state and a design analysis score (0-100) covering color harmony, contrast/WCAG, typography hierarchy, and composition balance. This is the visual feedback loop tool — use it after making changes to verify the result looks correct. |
| ps_execute_scriptA | Runs arbitrary ExtendScript code directly in Photoshop. This is the escape hatch for anything the other tools cannot do. The script string is passed to Photoshop as-is. Use with care — there are no guardrails. Returns whatever the script evaluates to. |
| ps_paletteA | Generate and work with color palettes. Four actions: "generate" — create a harmony from a base hex color; "from-mood" — pick a curated palette for a design mood; "from-image" — extract dominant colors from the active document/layer; "from-brand" — return the official palette for a known brand (jaipuria, rentdraft). |
| ps_typographyA | Font pairing, installation, and size recommendations. Three actions: "suggest" — get a curated font pairing for a mood + purpose combination; "install" — download and install a Google Fonts family to the system; "auto-size" — calculate optimal font sizes for a document (reads dimensions if not provided). |
| ps_apply_recipeA | Apply a pre-built visual effect recipe to the active layer. Choose a specific recipe by name, or provide a mood to get the best matching recipe automatically. Recipes combine multiple layer styles and adjustments for polished results in one call. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| create-social-post | Guided workflow for creating a social media post design in Photoshop. Walks through preset selection, color palette, typography, layout, and execution. |
| create-poster | Guided workflow for creating a poster design in Photoshop. Handles document setup, layout, typography, and visual elements. |
| apply-brand-kit | Apply a brand identity kit to the current Photoshop document. Sets up brand colors, fonts, and guidelines. |
| photo-edit | Guided photo editing workflow in Photoshop. Provides step-by-step guidance based on your editing intent. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| social-media-presets | Document presets for all major social media platforms including Instagram, LinkedIn, YouTube, Twitter, Facebook, Pinterest, and TikTok. |
| print-presets | Document presets for common print formats including A4, A3, Letter, posters, business cards, and flyers. All at 300 DPI in CMYK. |
| typography-guide | Comprehensive typography reference: hierarchy rules, font pairing, spacing, and anti-aliasing settings for Photoshop. |
| color-theory-guide | Color theory reference: harmony rules, popular palettes, contrast ratios, accessibility guidelines, and color psychology. |
| layout-guide | Layout and composition reference: rule of thirds, golden ratio, grid systems, alignment principles, social media safe zones. |
| blend-modes-guide | Complete guide to all 28 Photoshop blend modes: Normal, Darken, Lighten, Contrast, Inversion, and Component groups with practical tips and recipes. |
| design-palettes | 36 curated color palettes across 12 design moods (professional, energetic, elegant, minimal, cyberpunk, vintage, bold, natural, playful, luxury, warm, cool). 3 variants per mood. Each palette provides primary, secondary, accent, background, text, and muted hex values. |
| font-catalog | 24 curated font pairings across 12 design moods (professional, energetic, elegant, minimal, cyberpunk, vintage, bold, natural, playful, luxury, warm, cool). 2 pairings per mood with display/body specs, vibe description, and fonts to avoid. All names are exact Google Fonts names. |
| effect-recipes | 12 named Photoshop effect recipes (neon-glow, metallic-text, glass-text, embossed, long-shadow, duotone, vintage-photo, cinematic, frosted-glass, pop-art, watercolor, gold-foil). Each recipe documents what layer styles/adjustments to apply, best use contexts, compatible moods, and customizable parameters. Includes mood-to-recipe mapping. |
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/ayushnagvanshi101098-ship-it/photoshop-mcp-pro'
If you have feedback or need assistance with the MCP directory API, please join our Discord server