Illustrator MCP Server

Findings (16)

• highHigh. Something risky that needs a close look before you install.
  code-execution issue

  Details are available to the maintainer after claiming this listing.
• highHigh. Something risky that needs a close look before you install.
  dependencies issue

  Details are available to the maintainer after claiming this listing.
• mediumMedium. Worth checking, often a vulnerable dependency or a setup problem.
  @modelcontextprotocol/sdk@1.30.0: 6 known vulnerabilities

  GHSA-22jm-h49p-29qw, GHSA-46jr-4wx8-v453, GHSA-6prh-2h8m-c8cw, GHSA-6qxp-vccf-f47h, GHSA-f897-62hf-6gxq +1 more

  package-lock.json
• mediumMedium. Worth checking, often a vulnerable dependency or a setup problem.
  body-parser@2.2.2: 2 known vulnerabilities

  GHSA-27r3-jxmh-p828, GHSA-v422-hmwv-36x6

  package-lock.json
• mediumMedium. Worth checking, often a vulnerable dependency or a setup problem.
  fast-uri@3.1.2: 11 known vulnerabilities

  GHSA-333x-w4r6-6crp, GHSA-4c8g-83qw-93j6, GHSA-7p8r-x3mc-p8w7, GHSA-f65p-4m7j-42xc, GHSA-fph4-wmhf-6fwf +6 more

  package-lock.json
• mediumMedium. Worth checking, often a vulnerable dependency or a setup problem.
  hono@4.12.23: 17 known vulnerabilities

  GHSA-54fx-42gc-7vw4, GHSA-5r4p-p66f-jhc7, GHSA-79qm-7rj5-m7r9, GHSA-88fw-hqm2-52qc, GHSA-8j4g-w8fx-2239 +12 more

  package-lock.json
• mediumMedium. Worth checking, often a vulnerable dependency or a setup problem.
  ip-address@10.2.0: 8 known vulnerabilities

  GHSA-22jq-vg5j-6vgg, GHSA-2vr4-cq9g-pvrc, GHSA-4xrf-jv44-h6hh, GHSA-h3mg-xc3c-68pw, GHSA-j6r3-76f7-8jcv +3 more

  package-lock.json
• mediumMedium. Worth checking, often a vulnerable dependency or a setup problem.
  source-map-js@1.2.1: 1 known vulnerability

  GHSA-68fv-2mgg-jv7q

  package-lock.json
• mediumMedium. Worth checking, often a vulnerable dependency or a setup problem.
  vite@8.2.1: 6 known vulnerabilities

  GHSA-587h-7wmj-h5pm, GHSA-698v-4r3x-3vcv, GHSA-9jrq-w75r-8gcw, GHSA-r825-w8mm-5pxw, GHSA-rq7h-c2jc-7f22 +1 more

  package-lock.json
• mediumMedium. Worth checking, often a vulnerable dependency or a setup problem.
  zod@4.3.6: 1 known vulnerability

  GHSA-mrhx-c7xc-m3w5

  package-lock.json
• lowLow. Minor, or common in normal tools. Shown for information.
  @hono/node-server@1.19.14: 2 known vulnerabilities

  GHSA-frvp-7c67-39w9, GHSA-rmxm-3fg6-px4f

  package-lock.json
• lowLow. Minor, or common in normal tools. Shown for information.
  @vitest/mocker@4.1.10: 2 known vulnerabilities

  GHSA-82fw-gwwq-j7x9, GHSA-qxg6-89mg-rqv8

  package-lock.json
• lowLow. Minor, or common in normal tools. Shown for information.
  esbuild@0.28.0: 1 known vulnerability

  GHSA-g7r4-m6w7-qqqr

  package-lock.json
• lowLow. Minor, or common in normal tools. Shown for information.
  qs@6.15.2: 3 known vulnerabilities

  GHSA-4mjr-xmp4-gh2g, GHSA-6pq8-jhm2-2vcw, GHSA-x5fp-wj9c-mxmx

  package-lock.json
• lowLow. Minor, or common in normal tools. Shown for information.
  vitest@4.1.10: 1 known vulnerability

  GHSA-82fw-gwwq-j7x9

  package-lock.json
• lowLow. Minor, or common in normal tools. Shown for information.
  Reads environment variables not listed in the manifest

  ILLUSTRATOR_MCP_TRANSPORT, ILLUSTRATOR_MCP_TIMEOUT_NORMAL, ILLUSTRATOR_MCP_TIMEOUT_HEAVY

Network activity

Tools exposed (66)

• get_document_info

  Get document metadata

• get_artboards

  Get all artboard information

• get_layers

  Get layer structure as a tree

• get_selection

  Get detailed information about the currently selected objects. While editing text (text cursor or selected characters), the containing text frame is returned with a textSelection field (selected contents, length, start; insertionPoint: true for a bare cursor).

• list_text_frames

  List text frames with summary-level information (including orientation and threaded-frame links nextFrameUUID/previousFrameUUID). Supports reading-order sort, pagination, and a lightweight contents-only mode. layer_name includes text inside groups and sublayers of that layer.

• get_text_frame_detail

  Get detailed text frame attributes including per-character runs (font, tracking, akiLeft/akiRight, tsume, proportionalMetrics), kerning pairs with manual kerning values (1/1000 em), paragraph attributes (leading, autoLeading, paragraph style), orientation (horizontal/vertical) and threaded-frame lin

• get_colors

  Get all color information used in the document. usedFillColors / usedStrokeColors list each distinct color once with a count of how many paths and text ranges use it (most used first).

• get_path_items

  Get path and shape data, including paths inside groups and compound paths (clipping: true marks a clipping-mask path). Note: fill/stroke do not include per-attribute opacity; use the item-level opacity field for transparency.

• get_guidelines

  Get guide information

• get_groups

  Get structure of groups, clipping masks, and compound paths. Children of a clipping-mask group mark the mask path with clipping: true. When depth cuts the tree off, the item has childrenTruncated: true and childCount (children is empty only because of the depth limit).

• get_effects

  Get effect and appearance information

• get_images

  Get embedded and linked image information: file path, broken-link status (linkBroken: file missing on disk), pixel size, and effective resolution (ppi at the placed size; rotation-safe).

• get_symbols

  Get symbol definitions and instances

• get_document_structure

  Get tree structure of layers, groups, and objects

• find_objects

  Search for objects by specified criteria

• check_contrast

  Check WCAG color contrast ratios. Manual mode: provide color1 and color2. Auto mode (auto_detect: true): find visible foreground/background pairs by bounding-box overlap (stacking order, opacity and clipping are not considered; gradient/pattern/image backgrounds are reported as unevaluated). Non-RGB

• extract_design_tokens

  Extract colors, typography, and spacing from the document as design tokens in CSS custom properties, JSON, or Tailwind format. Optionally writes the result to output_path (never overwrites an existing file unless overwrite: true).

• export

  Export objects, groups, artboards, or selection. Use target "artboard:all" to batch-export every artboard in one call. For single PNG/JPG exports, the exported image is returned as base64 in the response — you can view it directly without reading the file from disk ("artboard:all" returns file paths

• export_pdf

  Export print-ready PDF. Japanese trim marks (marks_style "japanese" + trim_marks) are drawn temporarily on the document and removed after export; they are only supported for single-artboard documents (multi-artboard documents return an error). When a preset is given, trim mark settings you do not sp

• get_overprint_info

  Get overprint settings of paths (incl. compound paths), text (per character) and raster images, each with a heuristic label (K100 / rich black / spot / likely accidental) inferred from colors only. The result includes the scan scope; placed files, symbols and meshes are not inspected.

• get_separation_info

  Get color separation info: process and spot plates actually used by the artwork (paths, gradients, text, rasters) with usage counts, inks with no detected usage, global process colors, and Illustrator's document ink list. The result includes the scan scope; placed files, patterns and symbols are not

• preflight_check

  Run pre-press quality checks (RGB in CMYK incl. gradient stops, text colors and embedded images; broken links; low resolution; fonts; white overprint on paths and text; transparency; spot colors). `coverage` reports per check whether it was fully checked, partial (sampled or uninspectable contents s

• check_text_consistency

  Analyze text frames for dummy/placeholder text and known notation variation patterns (katakana long vowel, fullwidth/halfwidth, wave dash/tilde). Returns all text contents for LLM-driven deeper analysis of inconsistencies, typos, and version mismatches. Note: AI analysis may miss errors and does not

• set_workflow

  Set the session-level workflow and default coordinate system. Call this after confirming the user's intent (web, print, or video). Once set, all tools that omit coordinate_system will use the session default. Use clear: true to reset to auto-detection from document (CMYK/print → document coords, RGB

• set_illustrator_version

  Set which Illustrator version to target when multiple versions are installed. Specify a version year (e.g. "2024", "2025"). If Illustrator is already running, connects to the running instance regardless of version. If not running, launches the specified version. Use clear: true to reset to default b

• create_rectangle

  Create a rectangle. Note: Illustrator will be activated (brought to foreground) during execution.

• create_ellipse

  Create an ellipse. Note: Illustrator will be activated (brought to foreground) during execution.

• create_line

  Create a line. Note: Illustrator will be activated (brought to foreground) during execution.

• create_text_frame

  Create a text frame. Positioning differs by kind: for point text (x, y) is the text ANCHOR — y is the BASELINE of the first line (glyphs extend above it), and x is the left edge, center, or right edge depending on justification (so right-aligned text only needs justification: "right" with x at the r

• create_path

  Create a custom path. Note: Illustrator will be activated (brought to foreground) during execution.

• modify_object

  Modify properties of an existing object. fill/stroke on a group or compound path are applied to every path and text frame inside it (like Illustrator's UI; clipping paths and guides are skipped) and the result reports how many were changed (painted) and the colors they actually have (verified.descen

• convert_to_outlines

  Convert text to outlines (irreversible except via undo). Text frames that cannot be converted (e.g. locked) are left as-is and listed in "failed" with the reason; success is false if any failed. Note: Illustrator will be activated (brought to foreground) during execution.

• place_image

  Place a raster or PDF image file (PNG, JPG, TIFF, PSD, PDF, etc.) into the document as a linked or embedded image. SVG is NOT supported here because PlacedItems produces a non-editable linked artwork — use import_svg_as_editable instead to bring SVG content in as editable paths/text. Note: Illustrat

• import_svg_as_editable

  Import an SVG file into the active document as editable Illustrator paths/text/groups (NOT as a linked image). Internally opens the SVG as a temporary document, duplicates its contents into the target document, then closes the source. Use this instead of place_image for SVG. Colors are NOT converted

• resize_for_variation

  Create size variations from a source artboard. Duplicates all objects and scales/repositions them proportionally to fit target sizes. New artboards are placed to the right of all existing artboards; copies get new UUIDs. Limitations: no text reflow, effects/strokes scale with objects but may need ma

• align_objects

  Align and/or distribute multiple objects by their UUIDs. If any UUID is not found, nothing is moved and the missing UUIDs are returned in notFound.

• replace_color

  Find and replace fill/stroke colors of paths and text characters across the document or within a specific layer. replacedCount counts replaced path fills/strokes; textFramesChanged counts text frames in which at least one character color was replaced (text strokes with weight 0 are ignored). Every r

• manage_layers

  Add, rename, show/hide, lock/unlock, reorder, or delete top-level layers by name. If several layers share a name, rename/show/hide/lock/unlock/reorder act on the topmost one with a warning, and delete is refused.

• place_color_chips

  Extract all unique colors used in the document (path fills/strokes including inside groups and compound paths, text colors, gradient stop colors; spot colors per tint) and place color chip swatches with labels outside the artboard. Pattern fills cannot be shown as chips and are counted in skippedCol

• place_style_guide

  Place a visual style guide next to the artboard: color chips (path, text and gradient stop colors), font samples, and legends of recurring spacings, artboard margins and guide gaps. Everything goes on a NON-PRINTING layer (created with Print off; if layer_name already exists its print setting is kep

• create_crop_marks

  Create crop marks (トンボ / trim marks) on the active artboard or selected objects. By default, creates marks for the artboard and expands the artboard to include all marks; the original (trim) rectangle is returned as original_artboard_rect. With use_selection=true, creates marks for the currently sel

• create_document

  Create a new Illustrator document. Note: Illustrator will be activated (brought to foreground) during execution.

• close_document

  Close the active Illustrator document. If the document has unsaved changes and save is omitted, the document is NOT closed and an error is returned — pass save: true to save, or save: false to explicitly discard the changes. Note: Illustrator will be activated (brought to foreground) during executio

• save_document

  Save the active Illustrator document. save_as refuses to replace an existing file unless overwrite is true. Note: Illustrator will be activated (brought to foreground) during execution.

• open_document

  Open an Illustrator document from a file path. Note: Illustrator will be activated (brought to foreground) during execution.

• group_objects

  Group multiple objects into a single group. The first UUID in the array becomes the bottommost item, the last becomes the topmost. If any UUID is not found, nothing is grouped and the missing UUIDs are returned in notFound. Note: Illustrator will be activated (brought to foreground) during execution

• ungroup_objects

  Ungroup a group, releasing its children to the parent layer. Note: Illustrator will be activated (brought to foreground) during execution.

• duplicate_objects

  Duplicate one or more objects, optionally offsetting the copies. Copies (and their group/compound-path children) get new UUIDs; notes/memos are kept (objects whose note cannot be rewritten keep the source UUID and are listed in warnings). Missing UUIDs are listed in notFound and per-item failures in

• list_fonts

  List fonts available in Illustrator. Does not require an open document.

• manage_artboards

  Add, remove, resize, rename, fit, or rearrange artboards. Note: Illustrator will be activated (brought to foreground) during execution.

• set_z_order

  Change the stacking order of an object. Note: Illustrator will be activated (brought to foreground) during execution.

• move_to_layer

  Move one or more objects to a different layer. Objects that are found are moved; missing UUIDs are listed in notFound and per-object failures in errors (success is false if either is non-empty). Note: Illustrator will be activated (brought to foreground) during execution.

• delete_objects

  Delete one or more objects by UUID (get UUIDs from find_objects / get_layers / get_selection). Locked objects are skipped unless force_unlock is true. success is false if any UUID was not found or could not be deleted (see notFound / errors). The undo tool may revert it, but undo steps are Illustrat

• apply_graphic_style

  Apply a graphic style to objects. Objects that are found are styled; missing UUIDs are listed in notFound and per-object failures in errors (success is false if either is non-empty). Note: Illustrator will be activated (brought to foreground) during execution.

• list_graphic_styles

  List all graphic styles in the active document.

• manage_swatches

  Add, update, or delete swatches in the active document. Note: Illustrator will be activated (brought to foreground) during execution.

• apply_text_style

  Apply a character or paragraph style to a text frame. Note: Illustrator will be activated (brought to foreground) during execution.

• list_text_styles

  List all character and paragraph styles in the active document.

• create_gradient

  Create a gradient in the document and optionally apply it to objects. Note: Illustrator will be activated (brought to foreground) during execution.

• manage_linked_images

  Relink or embed a placed (linked) image. embed converts PlacedItem to RasterItem — the original UUID becomes invalid and a new UUID for the RasterItem is returned. Note: Illustrator will be activated (brought to foreground) during execution.

• undo

  Undo or redo steps in Illustrator's history. Steps are Illustrator history entries, not MCP tool calls (one tool call may create several steps). Returns count = steps actually performed; if a step fails, the result is an error that still reports how many were performed. Note: Illustrator will be act

• manage_datasets

  List variables/datasets, apply or create datasets, bind variables to objects, import/export variable XML, or generate artboards from CSV. import (XML) replaces ALL existing variables and datasets in the document. import_csv does not create variables or datasets: it copies the objects on artboard 0 (

• place_symbol

  Place a new symbol instance or replace the symbol definition of an existing instance. Note: Illustrator will be activated (brought to foreground) during execution.

• create_path_text

  Create a text frame that flows along a path. If font_name is not found, nothing is created and an error with font_candidates is returned. Note: Illustrator will be activated (brought to foreground) during execution.

• select_objects

  Select objects by UUID. Pass an empty array to deselect all. Selected objects can then be manipulated interactively in Illustrator.

• convert_coordinate

  Convert a point between artboard and document coordinate systems in the active document.