Bragproof

← Reports

illustrator-mcp-server

Starts with no setup1.14.0npm

Installed, started with no arguments, no environment and no input, and listed its tools. Run 2026-11-16.

Needs to start: nothing
Returns a result when called with no setup: 0 of 5 tools tried
Contacts while installing and starting: nothing

68tools listed
0hosts contacted
0files written
0.2 sto start
97dependencies

What it contacted

Nothing besides the npm registry it was installed from. Watched from outside its sandbox while it was installed and started with no input. Its tools may still contact things when called.

Starting it

npx -y illustrator-mcp-server@1.14.0

Installing a package runs its code. Use a sandbox for anything you have not read.

Calling its tools

5 tools that take no input and look read-only were called once with nothing. 0 returned a result.

get_document_infoNo usable answer tool reported an error: Could not auto-detect the coordinate system: Unsupported platform: linux. Only macOS and Windows are supported. (Pass coordinate_system
get_artboardsNo usable answer tool reported an error: Could not auto-detect the coordinate system: Unsupported platform: linux. Only macOS and Windows are supported. (Pass coordinate_system
get_layersNo usable answer tool reported an error: Could not auto-detect the coordinate system: Unsupported platform: linux. Only macOS and Windows are supported. (Pass coordinate_system
get_selectionNo usable answer tool reported an error: Could not auto-detect the coordinate system: Unsupported platform: linux. Only macOS and Windows are supported. (Pass coordinate_system
list_text_framesNo usable answer tool reported an error: Could not auto-detect the coordinate system: Unsupported platform: linux. Only macOS and Windows are supported. (Pass coordinate_system

During the calls it contacted nothing it had not already contacted.

Only tools whose names read like looking something up, with no required input, are tried, five at most. Tools that need input, and anything that sounds like it changes or sends something, are not called.

What its tools tell an agent

In the tool descriptions, nothing that talks about the user, other tools or private files, or uses hidden characters.

Found by simple pattern rules in each tool's description (up to 3,000 characters), quoted as written. Parameter descriptions are not scanned. A clean result is not a safety review.

Tools

get_document_info coordinate_system
Get document metadata
get_artboards index, coordinate_system
Get all artboard information
get_layers include_sublayers, include_items, coordinate_system
Get layer structure as a tree
get_selection coordinate_system
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 layer_name, artboard_index, sort, contents_only, offset, limit, coordinate_system
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.
63 more tools
get_text_frame_detail uuid, coordinate_system
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 links (nextFrameUUID/previousFrameUUID). Returns cssHints for web/CSS reproduction.
get_colors include_swatches, include_used_colors, include_diagnostics
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 layer_name, include_points, selection_only, coordinate_system
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 coordinate_system
Get guide information
get_groups layer_name, depth, coordinate_system
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 target, selection_only, coordinate_system
Get effect and appearance information
get_images coordinate_system, include_print_info
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 coordinate_system
Get symbol definitions and instances
get_document_structure depth, artboard_index, coordinate_system
Get tree structure of layers, groups, and objects
find_objects name, type, layer_name, fill_color, stroke_color, font_name, font_size, artboard_index, coordinate_system
Search for objects by specified criteria
check_contrast color1, color2, auto_detect
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 colors are converted without ICC profiles, so their ratio is approximate and WCAG pass/fail is null. GrayColor uses ink-quantity interpretation (0=white, 100=black), which differs from the API reference.
extract_design_tokens format, output_path, overwrite
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 target, format, output_path, overwrite, scale, svg_options, raster_options
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 only; images larger than ~3.75MB are not inlined). An explicit output_path that already exists is not overwritten unless overwrite is true.
export_pdf output_path, overwrite, preset, options
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 specify are kept from the preset. An explicit output_path that already exists is not overwritten unless overwrite is true. Note: Illustrator will be activated (brought to foreground) only when generating Japanese trim marks. The exported PDF should be verified by a human before final submission.
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 inspected.
preflight_check coordinate_system, min_dpi, target_pdf_profile
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 such as symbols, linked files, live effects under x1a) or skipped — a check marked partial/skipped is not a clean pass. Results are capped at 20 per category; the rest are summarized in one entry with counts and UUIDs (`categoryCounts` has totals). Not exhaustive — does not replace a human final review. GrayColor uses ink-quantity interpretation (0=white/no ink, 100=black/full ink), which differs from the API reference.
check_text_consistency artboard_index, coordinate_system
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 replace a human text review.
set_workflow workflow, coordinate_system, clear
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/web → artboard-web).
set_illustrator_version version, clear
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 behavior (connect to any running Illustrator).
create_rectangle x, y, width, height, corner_radius, fill, stroke, layer_name, name, coordinate_system
Create a rectangle.
create_ellipse x, y, width, height, fill, stroke, layer_name, name, coordinate_system
Create an ellipse.
create_line x1, y1, x2, y2, stroke, layer_name, name, coordinate_system
Create a line.
create_text_frame x, y, contents, kind, width, height, font_name, font_size, tracking, leading, justification, fill, layer_name, name, coordinate_system
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 right edge). For area text (x, y) is the top-left of the text area. verified.bounds always reports the resulting bounding box (top-left, width, height) — that box is what modify_object position moves. If font_name is not found, nothing is created and an error with font_candidates is returned. Note: Illustrator is brought to the foreground for this tool — creating text while it is in the background blocks for minutes.
create_path anchors, closed, fill, stroke, layer_name, name, coordinate_system
Create a custom path.
modify_object uuid, properties, coordinate_system
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.descendantFills). success is false if any of them could not be painted. Per-property failures are listed in failed as { property, message }. Note: when properties.contents is given, Illustrator is brought to the foreground, because assigning text contents while it is in the background blocks for minutes.
convert_to_outlines target
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 message; success is false if any failed. The outlined group does not inherit the text frame's UUID, so converted reports each oldUuid → newUuid pair and the name is carried over — use it to keep working with the artwork after converting.
place_image file_path, x, y, embed, layer_name, name, coordinate_system
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.
import_svg_as_editable file_path, x, y, layer_name, group, fit_to_artboard, padding, name, coordinate_system
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: importing into a CMYK document keeps the SVG's RGB colors, and the result then includes a warning with the count (fix with replace_color). Font caveat: Illustrator does not fall back per glyph across a font-family list. If the FIRST family in the list is installed but lacks a glyph, that character is dropped silently and the import still reports success. Specify a single font-family per text element, and pick one that actually contains the glyphs you use (symbols such as U+2713 are the common failure case). An uninstalled family is substituted by Illustrator and is NOT affected by this.
resize_for_variation source_artboard_index, target_sizes, scale_mode, coordinate_system
Create size variations from a source artboard. Duplicates all objects and scales them, and the gaps between them, by the same factor, so the layout keeps its proportions instead of being stretched along one axis. The scaled artwork is centered on the target artboard, so changing the aspect ratio leaves empty space rather than distorting the composition — move or realign it afterwards if you want it elsewhere. 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 manual adjustment, no smart layout.
align_objects uuids, alignment, distribute, reference, coordinate_system
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 from_color, to_color, tolerance, target, scope
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 replacement is read back; matches that could not be replaced (e.g. locked) are listed in failed and make success false. A layer scope includes groups and sublayers inside it. from_color must be cmyk or rgb and matches only objects whose current color is stored in that same color type (check with get_colors) — an RGB from_color does not match CMYK-colored objects. to_color can be any type, e.g. replace an RGB color with a CMYK one. Spot, gray, gradient and pattern colors are never matched.
manage_layers action, layer_name, new_name, position, above
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 artboard_index, chip_size, position, include_info, layer_name, coordinate_system
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 skippedColors. Items already on the chip layer are ignored.
place_style_guide artboard_index, position, layer_name, annotate_artboard, coordinate_system
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 kept and a warning is returned). By default nothing is drawn on the artboard itself; set annotate_artboard=true to also draw semi-transparent measurement bars and numbers ON the artboard (same non-printing layer, but visible on screen and possibly in screen/image exports).
create_crop_marks style, locale, use_selection, artboard_index
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 selected object(s) without modifying the artboard. Automatically selects Japanese-style (日本式) or Western-style crop marks based on locale. The Illustrator crop mark style preference, selection and active artboard are restored afterwards. Note: Illustrator will be activated (brought to foreground) during execution.
make_trap_stroke uuids, target, weight, round
Add a trap to filled paths: a stroke in the same color as the fill, set to overprint, so a press misregistration does not leave a white gap along the edge. Illustrator has no trapping API; this is the manual prepress technique, applied for you. Only paths with a solid fill are trapped — gradients and patterns are skipped (there is no single color to stroke with), as are locked objects; both are listed in skipped. strokeOverprint is read back after writing, and objects where it did not stick are listed in failed. Ask your printer for the trap width before using this: 0.25–0.5 pt is common for offset, but it depends on the press and the stock.
toggle_prepress_view view
Switch a prepress view or panel on screen so a human can check the file before it goes to print: overprint preview, print tiling, the separations preview panel, the flattener preview panel, or the attributes panel. Illustrator does not report whether a view or panel is currently showing, so these switch rather than set: call the tool again to switch back. Note: Illustrator will be activated (brought to the foreground) during execution, because this runs a menu command and menu commands fail when it is in the background.
create_document width, height, color_mode
Create a new Illustrator document.
close_document save
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.
save_document mode, path, overwrite
Save the active Illustrator document. save_as refuses to replace an existing file unless overwrite is true.
open_document path, color_space
Open an Illustrator document from a file path.
group_objects uuids, name, clipped
Group multiple objects into a single group. The first UUID in the array becomes the bottommost item, the last becomes the topmost. All objects must be directly in the same parent (layer or group); objects on different layers or in different groups are rejected (use move_to_layer / ungroup_objects first). The new group takes the stacking position of the frontmost object. Nothing is changed and an error is returned if any UUID is not found (notFound), any object is locked or on a hidden layer, or clipped: true is given with fewer than 2 objects or a last object that is not a path or compound path (convert text to outlines first). If grouping fails midway, the objects are moved back and the empty group is removed (see rollback in the error).
ungroup_objects uuid
Ungroup a group, releasing its children to the parent layer.
duplicate_objects uuids, offset, target_layer, coordinate_system
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 failed (success is then false, but copies that were made are still returned).
list_fonts filter, limit
List fonts available in Illustrator. Does not require an open document.
manage_artboards action, index, rect, name, layout, rows_or_cols, spacing
Add, remove, resize, rename, fit, or rearrange artboards.
set_z_order uuid, command
Change the stacking order of an object.
move_to_layer uuids, target_layer, position
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 failed (success is false if either is non-empty).
delete_objects uuids, force_unlock
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 / failed). The undo tool may revert it, but undo steps are Illustrator history steps, not tied to MCP calls. To delete a whole layer use manage_layers instead.
apply_graphic_style style_name, uuids, merge
Apply a graphic style to objects. Objects that are found are styled; missing UUIDs are listed in notFound and per-object failures in failed (success is false if either is non-empty).
list_graphic_styles
List all graphic styles in the active document.
manage_swatches action, name, color
Add, update, or delete swatches in the active document.
apply_text_style uuid, style_type, style_name, clear_overrides
Apply a character or paragraph style to a text frame.
list_text_styles
List all character and paragraph styles in the active document.
create_gradient name, type, stops, apply_to_uuids, angle, coordinate_system
Create a gradient in the document and optionally apply it to objects.
manage_linked_images uuid, action, new_path
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.
undo action, count
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.
manage_datasets action, dataset_name, variable_name, object_name, dataset_name_prefix, file_path, overwrite
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. export refuses to replace an existing file unless overwrite is true. Note: import_csv and apply_dataset bring Illustrator to the foreground, because writing text contents while it is in the background blocks for minutes. import_csv does not create variables or datasets: it copies the objects on artboard 0 (left unchanged as the template) onto one new artboard per CSV row, placed to the right of existing artboards, and sets the text of copied text frames whose name matches a CSV header.
place_symbol action, symbol_name, x, y, uuid, coordinate_system
Place a new symbol instance or replace the symbol definition of an existing instance.
create_path_text path_uuid, contents, font_name, font_size, tracking, justification, layer_name, name, coordinate_system
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 is brought to the foreground for this tool — creating text while it is in the background blocks for minutes.
select_objects uuids
Select objects by UUID. Pass an empty array to deselect all. Selected objects can then be manipulated interactively in Illustrator.
convert_coordinate point, from, to
Convert a point between artboard and document coordinate systems in the active document.

Descriptions are the package's own words, cut at 3,000 characters. Treat them as data.

Install facts

LicenseMIT
Needsnode >=20.0.0
Sourcegithub.com/ie3jp/illustrator-mcp-server
Install scriptsNone declared by it or anything installed with it.
Tarballsha512-OP/6BmeHqUI2g5u2BQJv6JBL9tMv6tIHeMCqW0fMY+G2wsM8+cYdFofhSfLfA32jxEL2w6rurtdGvV2HdLi8mA==

Check this report yourself

This site did not write the report. A public job on a GitHub-hosted machine did: the run, from this commit of the open-source runner. GitHub signed a token that names that job and the hash of the report, so any edit since would show.

Show it on your README

Bragproof: Starts with no setup

[![Bragproof](https://bragproof.smaverk.com/badge/illustrator-mcp-server.svg)](https://bragproof.smaverk.com/r/illustrator-mcp-server)

New version out? Ask for a fresh report.