Free Photoshop MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| ps_statusA | Conecta con Photoshop (lo abre si está cerrado) y devuelve versión, documentos abiertos, documento y capa activos. |
| ps_openC | Abre un PSD/PSB/imagen/PDF/AI en Photoshop y devuelve su configuración. |
| ps_new_documentB | Crea un documento con toda su configuración: tamaño, unidad, resolución, modo de color, profundidad, perfil ICC, fondo, guías y, para carruseles, diapositivas continuas (slides: {count, width}) con guías en cada corte. |
| ps_document_infoB | Todo lo que define el proyecto: tamaño, resolución, modo, profundidad, perfil, guías, artboards, canales, trazados, composiciones, conteo de capas por tipo e historial. |
| ps_project_reportA | Un solo informe en texto: configuración del documento, recursos que toma (fuentes, vinculados, bibliotecas CC, incrustados, problemas), estructura de capas en 2 niveles y cómo está definido el diseño (tipografía, color, efectos, mezcla, opacidad vs relleno, imágenes). Es lo primero que conviene leer al recibir un PSD ajeno. |
| ps_resourcesA | Qué recursos usa el proyecto y cómo están definidos: fuentes (instaladas o no), archivos vinculados (ruta, biblioteca de Creative Cloud, perdidos/modificados), objetos inteligentes incrustados, colores de texto y problemas detectados. |
| ps_set_documentC | Cambia la configuración del documento: tamaño de imagen/lienzo, resolución, modo, profundidad, perfil de color (convertir/asignar), recortar, rotar, guías. |
| ps_saveA | Guarda el documento (PSD, PSB, TIFF, PNG, JPG). Sin path guarda sobre su archivo. asCopy=true no cambia el documento abierto. |
| ps_closeB | Cierra un documento (sin guardar salvo save=true). |
| ps_exportB | Exporta copias sin tocar el documento: todo el documento, cada artboard, cada grupo de nivel superior, o recortes (slices). Para un carrusel panorámico usa mode:'slides'. |
| ps_previewA | Renderiza el documento (o una parte) y te DEVUELVE LA IMAGEN para que la veas. Se usa un duplicado: el original no se toca. Úsala después de cada cambio importante. Opciones: crop (zona en px), layer/artboard (recorta a esa capa), showOnly/hide/show (aislar capas). |
| ps_layersB | Lista las capas con tipo, visibilidad, opacidad, relleno, modo de fusión, contorno, máscaras, efectos activos, texto y objetos inteligentes (vinculado/incrustado). depth limita los niveles; group baja a un grupo. |
| ps_layer_infoA | Todo sobre una capa: texto con cada tramo (fuente, tamaño real, tracking, interlineado, color), efectos en esquema amigable, trazo y radios de formas, máscara, objeto inteligente, mezcla. raw=true añade el descriptor completo. |
| ps_add_textA | Crea una capa de texto con control tipográfico completo. Un solo estilo con 'style', o varios tramos con 'runs' (p. ej. una línea Light y otra Black). x,y + anchor colocan el contorno visible; box={width,height} crea texto de párrafo. Admite efectos en la misma llamada. |
| ps_edit_textC | Cambia el contenido y/o el estilo de una capa de texto existente (conserva lo que no indiques). También mover, rotar, efectos y mezcla. |
| ps_fontsA | Busca entre las fuentes instaladas (nombre PostScript, familia y estilo) para usar en ps_add_text. |
| ps_text_infoB | Lee una capa de texto: contenido, tipo (punto/párrafo), rotación, escala y cada tramo con su estilo real. |
| ps_add_shapeB | Crea una forma vectorial: rectangle, roundRect (radius número, [tl,tr,br,bl] o 'pill'), ellipse, circle, polygon, star, line o path (points). Relleno sólido o degradado, trazo (ancho, alineación, guiones), efectos, mezcla y opacidad. |
| ps_create_layerC | Crea una capa de píxeles (opcionalmente rellena), un grupo, o una capa de relleno sólido/degradado a todo el lienzo. |
| ps_set_layerC | Cambia casi todo de una capa: nombre, visibilidad, opacidad, relleno, modo de fusión, recorte, bloqueo, etiqueta de color; posición (x,y,anchor / moveBy), tamaño (size / resize %), rotación, sesgo, volteo; orden (order/parent/above/below); color de una forma, trazo de forma, 'Mezclar si' (blendIf), máscara y efectos. |
| ps_layer_styleA | Aplica estilos de capa: sombras (varias apiladas), sombra interior, resplandores, bisel y relieve, satinado, superposición de color/degradado, trazo. mode:'replace' (por defecto) reemplaza los efectos; 'merge' conserva los demás. copyFrom copia los efectos de otra capa. Devuelve los efectos resultantes leídos de Photoshop. |
| ps_capture_styleA | Lee los efectos, mezcla, relleno y (si es texto) la tipografía de una capa como receta reutilizable. Con name la guarda en el estilo activo para usarla luego con effects:{recipe}. |
| ps_place_imageB | Coloca un archivo como objeto inteligente (incrustado o vinculado). Con box={x,y,width,height} y fit ('cover' recorta con máscara, 'contain', 'stretch') la encaja en un marco; radius redondea el marco. También escala/posición libres. |
| ps_smart_objectC | Convertir una capa en objeto inteligente, reemplazar su contenido por otro archivo, abrir su contenido para editar, revincular, incrustar o convertir a vinculado. |
| ps_maskB | Máscaras de capa: revealAll, hideAll, rect/ellipse (con radius y feather), selection (usa la selección actual), gradient (desvanecido lineal o radial, direction: up/down/left/right/radial), delete, apply, clip/unclip (máscara de recorte). density y maskFeather ajustan la máscara. |
| ps_add_adjustmentB | Crea una capa de ajuste no destructiva. type y params: brightnessContrast{brightness,contrast} · levels{inBlack,inWhite,gamma,outBlack,outWhite,channel} · curves{points:[[x,y]..],channel | channels:{red,green,blue}} · hueSaturation{hue,saturation,lightness,colorize} · vibrance{vibrance,saturation} · colorBalance{shadows,midtones,highlights:[c-r,m-g,y-b]} · blackAndWhite{red,yellow,green,cyan,blue,magenta,tint} · photoFilter{color,density} · gradientMap{stops} · exposure{exposure,offset,gamma} · selectiveColor{colors:{reds:{cyan,magenta,yellow,black}}} · invert · threshold{level} · posterize{levels}. clip=true la limita a la capa de abajo. |
| ps_filterA | Aplica un filtro a una capa: gaussianBlur{radius} · motionBlur{angle,distance} · radialBlur{amount,method} · addNoise/grain{amount,distribution,monochrome} · unsharpMask{amount,radius,threshold} · highPass{radius} · median{radius} · sharpen · dustAndScratches · surfaceBlur · smartSharpen · filmGrain · diffuseGlow · cameraRaw{exposure,contrast,highlights,shadows,whites,blacks,texture,clarity,dehaze,vibrance,saturation,temperature,tint,vignette,grain}. toSmart=true lo hace como filtro inteligente (editable). |
| ps_selectionC | Crea o modifica la selección: all, none, invert, rect, ellipse, polygon, layer (transparencia de una capa), subject (IA), colorRange. mode: replace/add/subtract/intersect. grow/shrink/smooth/border/feather. then: fill, clear, stroke, copyToLayer, cutToLayer, saveAs, mask, deselect. |
| ps_fillC | Rellena la selección (o toda la capa) con un color, un degradado, o con relleno según contenido (contentAware). |
| ps_remove_backgroundB | Quita el fondo de una capa con la IA de Photoshop (crea una máscara). |
| ps_create_artboardB | Crea una mesa de trabajo (artboard) con nombre, posición y tamaño exactos, y color de fondo opcional. Útil para varias piezas (diapositivas, formatos) en un mismo documento; luego ps_export mode:"artboards" las exporta una por una. |
| ps_delete_layerC | Borra una o varias capas. |
| ps_duplicate_layerC | Duplica una capa (en el mismo documento u otro con toDocument), con nombre, desplazamiento o posición nuevos. |
| ps_groupC | Agrupa capas en un grupo (con nombre, modo de fusión, efectos) o desagrupa un grupo. |
| ps_merge_rasterizeC | Combina capas (merge), crea una capa de sello con todo lo visible (mode:'stamp'), o rasteriza (what: layer|style|text|shape). |
| ps_alignC | Alinea capas al lienzo, a la primera capa, a un artboard o a un rectángulo {x,y,width,height}; distribuye en h/v con espacios iguales. |
| ps_historyB | Lista los pasos del historial, deshace/rehace (steps), vuelve a un paso (revert con index) o crea una instantánea. |
| ps_batchA | Ejecuta varias herramientas en orden y las agrupa en UN solo paso del historial. Cada elemento: {tool:'add_shape'|'add_text'|'place_image'|'layer_style'|'set_layer'|'create_layer'|'add_adjustment'|'filter'|'mask'|'group'|'align'|'duplicate_layer'|'delete_layer'|'selection'|'fill', args:{...}} con los mismos parámetros que la herramienta ps_. Ideal para armar una composición completa. Se detiene en el primer error y dice cuál fue. |
| ps_action_managerA | Ejecuta cualquier evento de Photoshop con un descriptor en JSON etiquetado (objeto {_c:'clase'}, unidad {_u:'pixelsUnit',v}, enum {_e:[tipo,valor]}, entero {_i}, referencia {ref:[{cls,form,...}]}). get:[referencia] lee propiedades. Es la salida para cualquier herramienta avanzada que no tenga ps* propio. |
| ps_execute_scriptA | Ejecuta código ExtendScript (JS ES3) dentro de Photoshop con acceso total a app, documentos, capas y a las ayudas VZ/U/AM. |
| ps_run_actionC | Reproduce una acción grabada en Photoshop (nombre y conjunto). |
| ps_run_script_fileC | Ejecuta un script .jsx/.jsxbin del disco dentro de Photoshop. |
| ps_style_analyzeA | Lee uno o varios PSD (abiertos o por ruta; los abre y los cierra sin guardar) y aprende el estilo de la persona: formato del lienzo, paleta (incluida la real del render), tipografía por jerarquía, recetas de efectos, hábitos de mezcla/opacidad/relleno, formas, recursos, estructura de capas y maquetación. Lo guarda como estilo con nombre y genera una guía. Úsalo con trabajos terminados de la persona. |
| ps_style_listA | Lista los estilos guardados y cuál está activo. |
| ps_style_getA | Devuelve la guía de un estilo (dirección de arte en palabras, paleta con roles, tipografía por jerarquía, presets de texto, recetas de efectos, hábitos y reglas de composición). Léela ANTES de diseñar para la persona y sigue sus reglas. section limita: guide | tokens | recipes | presets | raw. |
| ps_style_setB | Activa un estilo, o agrega/edita presets de texto, recetas de efectos o colores con nombre. Útil para afinar lo que el análisis dedujo. |
| ps_paletteA | Calcula los colores dominantes de lo que se VE en el documento (no solo de las capas), con porcentaje. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 47 tools
Several tools provide overlapping information (ps_status, ps_document_info, ps_project_report, ps_resources) or can perform similar operations (ps_selection can fill/mask, overlapping with ps_fill and ps_mask). However, detailed descriptions clarify intended use, so boundaries are mostly discernible.
All tools share the ps_ prefix and snake_case, but the naming pattern is mixed: some are noun-only (ps_layers, ps_fonts, ps_mask), some verb_noun (ps_add_text, ps_create_layer), and some verb (ps_open, ps_save). This inconsistency makes the pattern less predictable.
47 tools is excessive for an MCP server, exceeding the 25+ threshold for 'too many'. While Photoshop is complex, many tools could be consolidated (e.g., info tools, script runners), and the sheer count increases selection complexity.
The surface covers document, layer, text, shape, mask, selection, filter, adjustment, style, and export operations comprehensively. Minor gaps exist (e.g., layer comps, channel operations, artboard editing), but escape hatches like ps_execute_script and ps_action_manager allow workarounds.