io.github.ie3jp/illustrator-mcp-server

NPM · ILLUSTRATOR-MCP-SERVER · SCANNED AUG 3

Read, manipulate, and export Adobe Illustrator design data. 26 tools. macOS | Windows.

Available components

+28 this week 80 80 Trust /100

Trust breakdown (6 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →

Supply Chain Security87

No malware found by supply-chain analysis.Pass
Only part of the dependency tree could be resolved (96 of 100), so this covers what we could see, not the whole tree.Partial
No install/post-install scripts declared.Pass
Only part of the dependency tree could be resolved (96 of 100), so this covers what we could see, not the whole tree. View diagnostics → Partial

Provenance & Transparency97

Source repository is publicly reachable at the declared URL. View diagnostics → Pass
Cryptographically verified build provenance (signed, bound to ie3jp/illustrator-mcp-server). View diagnostics → Pass
Clear OSI-approved license (MIT).Pass
Actively maintained (last published 65 days ago).Pass
Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail

Schema Quality & AI Usability79

100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
AI-judged instruction clarity (good).Pass
Context-footprint check failed: tool/resource definitions use about 8124 tokens (~123/item across 66 items; 66 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
Usage-examples check failed: none of the tools include examples. See how to fix → Fail

Stability & Change Management27

Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial

Tool Coverage100

100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
99% of tool parameters carry a description.Partial

Capabilities100

Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass

Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

npm · illustrator-mcp-server

Claude Codex opencode OpenClaw Hermes Other

# add to Claude Code

claude mcp add ie3jp-illustrator-mcp-server -- npx -y illustrator-mcp-server

# add to Codex CLI

codex mcp add ie3jp-illustrator-mcp-server -- npx -y illustrator-mcp-server

// opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "ie3jp-illustrator-mcp-server": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "illustrator-mcp-server"
      ],
      "enabled": true
    }
  }
}

# add to OpenClaw

openclaw mcp add ie3jp-illustrator-mcp-server --command npx --arg -y --arg illustrator-mcp-server

# ~/.hermes/config.yaml

mcp_servers:
  ie3jp-illustrator-mcp-server:
    command: "npx"
    args: ["-y", "illustrator-mcp-server"]

// mcp.json

{
  "mcpServers": {
    "ie3jp-illustrator-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "illustrator-mcp-server"
      ]
    }
  }
}

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

2 Aug 26 +55
- Install scripts: unverified → pass ▲ security
- Provenance: unverified → pass ▲ security
- Known CVEs: unverified → partial ▲ security
- Malware scan: unverified → pass ▲ security
- The attested source repository moved: ie3jp/illustrator-mcp-server security
- MCP protocol: unverified → pass ▲ functional
- Stability: unverified → 0.23 ▲ functional
- Schema quality: unverified → good ▲ functional
- License: unverified → pass ▲ functional
- Dependency health: unverified → partial ▲ functional
- Maintenance: unverified → pass ▲ functional
- Licence: MIT functional
31 Jul 26 −27
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
27 Jul 26 52

First indexed and scored.

Show 2 earlier entries Hide earlier entries

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 3 Aug 2026 · Analysed npm/[email protected]

Provenance verified

Ecosystem: npm · Outcome: verified

Reason: verified

Source repo:: ie3jp/illustrator-mcp-server
Certificate issuer:: https://token.actions.githubusercontent.com
Certificate SAN:: https://github.com/ie3jp/illustrator-mcp-server/.github/workflows/ci.yml@refs/tags/v1.5.1
Rekor log index:: 1668109393
Predicate type:: https://slsa.dev/provenance/v1
Subject digest:: sha512:db5353a4337922416423adc2a6515cf61e08b59b8b141cf03aa98fd2ea39011eeb8289d65e77ca9785c7bd78d16384be1a82f3fecadcd71c3025fa4ac
Discovery method:: attestation_endpoint

Dependencies 96 packages

96 packages in the resolved dependency tree · 96 deprecated · 29 stale.

The dependency tree was only partially resolved, so these counts may be incomplete.

MCP tools — 66 exposed · ~8,124 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens

align_objects Align Objects ~146

Align and/or distribute multiple objects by their UUIDs

Input Output Examples

Name	Type	Req	Description
alignment	string	—	Alignment direction
coordinate_system	string	—	Coordinate system. Auto-detected from document by default (CMYK/print → document, RGB/web → artboard-web). artboard-web: origin at active artboard top-left, Y-down. document: Illustrator native coord…
distribute	string	—	Distribute objects evenly
reference	string	—	Align relative to selection bounding box or active artboard
uuids	array	yes	UUIDs of objects to align (minimum 2)

No output schema declared.

No examples provided.

apply_graphic_style Apply Graphic Style ~77

Apply a graphic style to objects. Note: Illustrator will be activated (brought to foreground) during execution.

Input Output Examples

Name	Type	Req	Description
merge	boolean	—	true = merge with existing appearance, false = replace
style_name	string	yes	Name of the graphic style to apply
uuids	array	yes	UUIDs of target objects

No output schema declared.

No examples provided.

apply_text_style Apply Text Style ~87

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

Input Output Examples

Name	Type	Req	Description
clear_overrides	boolean	—	Clear existing formatting overrides before applying
style_name	string	yes	Name of the style
style_type	string	yes	Type of style to apply
uuid	string	yes	UUID of the text frame

No output schema declared.

No examples provided.

assign_color_profile Assign Color Profile ~79

Assign (tag) a color profile to the document. WARNING: This only changes the profile tag — it does NOT convert color values (ICC conversion). For full conversion, use Edit > Convert to Profile in Illustrator. Note: Illustrator will be activated (brought to foreground) during execution.

Input Output Examples

Name	Type	Req	Description
profile	string	yes	Color profile name or path

No output schema declared.

No examples provided.

check_contrast Check Contrast ~106

Check WCAG color contrast ratios. Manual mode: provide two colors. Auto mode: detect overlapping foreground/background pairs in the document. Note: GrayColor uses ink-quantity interpretation (0=white, 100=black), which differs from the API reference.

Input Output Examples

Name	Type	Req	Description
auto_detect	boolean	—	Auto-detect overlapping foreground/background color pairs in the document
color1	object	—	First color (manual mode)
color2	object	—	Second color (manual mode)

No output schema declared.

No examples provided.

check_text_consistency Check Text Consistency ~168

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.

Input Output Examples

Name	Type	Req	Description
artboard_index	integer	—	Filter by artboard index (0-based)
coordinate_system	string	—	Coordinate system. Auto-detected from document by default (CMYK/print → document, RGB/web → artboard-web). artboard-web: origin at active artboard top-left, Y-down. document: Illustrator native coord…

No output schema declared.

No examples provided.

close_document Close Document ~45

Close the active Illustrator document. Note: Illustrator will be activated (brought to foreground) during execution.

Input Output Examples

Name	Type	Req	Description
save	boolean	—	Whether to save before closing (default: false)

No output schema declared.

No examples provided.

convert_coordinate Convert Coordinate ~53

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

Input Output Examples

Name	Type	Req	Description
from	string	yes	Source coordinate system
point	object	yes	Point to convert
to	string	yes	Destination coordinate system

No output schema declared.

No examples provided.

convert_to_outlines Convert to Outlines ~55

Convert text to outlines. Note: Illustrator will be activated (brought to foreground) during execution.

Input Output Examples

Name	Type	Req	Description
target	string	yes	Target: "selection" (selected), "all" (all text), or layer name

No output schema declared.

No examples provided.

create_crop_marks Create Crop Marks (トンボ) ~309

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. 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. Note: Illustrator will be activated (brought to foreground) during execution.

Input Output Examples

Name	Type	Req	Description
artboard_index	integer	—	Target artboard index (0-based). Defaults to the currently active artboard. Ignored when use_selection is true.
locale	string	—	User locale (e.g. "ja", "ja-JP", "en-US", "de-DE"). Used to auto-detect crop mark style when style is "auto". Japanese locales (ja*) → Japanese marks, others → Western marks. If omitted, falls back t…
style	string	—	Crop mark style. "japanese" = double-line marks with 3mm bleed indication (日本式トンボ). "western" = single-line marks (西洋式トンボ). "auto" = detect from locale parameter or Illustrator locale.
use_selection	boolean	—	If true, create crop marks for the currently selected object(s) instead of the artboard. The artboard will NOT be modified. If false (default), creates marks for the artboard and expands it to fit.

No output schema declared.

No examples provided.

create_document Create Document ~87

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

Input Output Examples

Name	Type	Req	Description
color_mode	string	—	Color mode (default: rgb)
height	number	—	Document height in points (default: A4 height 841.89pt)
width	number	—	Document width in points (default: A4 width 595.28pt)

No output schema declared.

No examples provided.

create_ellipse Create Ellipse ~178

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

Input Output Examples

Name	Type	Req	Description
coordinate_system	string	—	Coordinate system. Auto-detected from document by default (CMYK/print → document, RGB/web → artboard-web). artboard-web: origin at active artboard top-left, Y-down. document: Illustrator native coord…
fill	—	—	Fill color
height	number	yes	Height
layer_name	string	—	Target layer name
name	string	—	Object name
stroke	object	—	Stroke settings
width	number	yes	Width
x	number	yes	Bounding box top-left X coordinate
y	number	yes	Bounding box top-left Y coordinate

No output schema declared.

No examples provided.

create_gradient Create Gradient ~117

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

Input Output Examples

Name	Type	Req	Description
angle	number	—	Gradient angle (for linear). Note: may not take effect due to a long-standing Illustrator bug (since 2008).
apply_to_uuids	array	—	UUIDs of objects to apply this gradient as fill
name	string	yes	Gradient name
stops	array	yes	Gradient stops (minimum 2)
type	string	—	—

No output schema declared.

No examples provided.

create_line Create Line ~176

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

Input Output Examples

Name	Type	Req	Description
coordinate_system	string	—	Coordinate system. Auto-detected from document by default (CMYK/print → document, RGB/web → artboard-web). artboard-web: origin at active artboard top-left, Y-down. document: Illustrator native coord…
layer_name	string	—	Target layer name
name	string	—	Object name
stroke	object	—	Stroke settings
x1	number	yes	Start point X coordinate
x2	number	yes	End point X coordinate
y1	number	yes	Start point Y coordinate
y2	number	yes	End point Y coordinate

No output schema declared.

No examples provided.

create_path Create Path ~159

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

Input Output Examples

Name	Type	Req	Description
anchors	array	yes	Array of anchor points
closed	boolean	—	Whether to close the path
coordinate_system	string	—	Coordinate system. Auto-detected from document by default (CMYK/print → document, RGB/web → artboard-web). artboard-web: origin at active artboard top-left, Y-down. document: Illustrator native coord…
fill	—	—	Fill color
layer_name	string	—	Target layer name
name	string	—	Object name
stroke	object	—	Stroke settings

No output schema declared.

No examples provided.

create_path_text Create Path Text ~120

Create a text frame that flows along a path. Note: Illustrator will be activated (brought to foreground) during execution.

Input Output Examples

Name	Type	Req	Description
contents	string	yes	Text contents
font_name	string	—	Font name (partial match, e.g. "Arial"). Use list_fonts to find exact PostScript names.
font_size	number	—	Font size (pt)
layer_name	string	—	Target layer name
name	string	—	Object name
path_uuid	string	yes	UUID of the path to place text along

No output schema declared.

No examples provided.

create_rectangle Create Rectangle ~183

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

Input Output Examples

Name	Type	Req	Description
coordinate_system	string	—	Coordinate system. Auto-detected from document by default (CMYK/print → document, RGB/web → artboard-web). artboard-web: origin at active artboard top-left, Y-down. document: Illustrator native coord…
corner_radius	number	—	Corner radius
fill	—	—	Fill color
height	number	yes	Height
layer_name	string	—	Target layer name
name	string	—	Object name
stroke	object	—	Stroke settings
width	number	yes	Width
x	number	yes	Top-left X coordinate
y	number	yes	Top-left Y coordinate

No output schema declared.

No examples provided.

create_text_frame Create Text Frame ~248

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

Input Output Examples

Name	Type	Req	Description
contents	string	yes	Text contents. Use \n for line breaks (automatically converted to CR for Illustrator).
coordinate_system	string	—	Coordinate system. Auto-detected from document by default (CMYK/print → document, RGB/web → artboard-web). artboard-web: origin at active artboard top-left, Y-down. document: Illustrator native coord…
fill	—	—	Text color
font_name	string	—	Font name (partial match, e.g. "Arial", "Helvetica"). Use list_fonts to find exact PostScript names.
font_size	number	—	Font size (pt)
height	number	—	Area text height
kind	string	—	Text frame type (point or area)
layer_name	string	—	Target layer name
name	string	—	Object name
width	number	—	Area text width
x	number	yes	X coordinate
y	number	yes	Y coordinate

No output schema declared.

No examples provided.

duplicate_objects Duplicate Objects ~146

Duplicate one or more objects, optionally offsetting the copies. Note: Illustrator will be activated (brought to foreground) during execution.

Input Output Examples

Name	Type	Req	Description
coordinate_system	string	—	Coordinate system. Auto-detected from document by default (CMYK/print → document, RGB/web → artboard-web). artboard-web: origin at active artboard top-left, Y-down. document: Illustrator native coord…
offset	object	—	Offset for duplicated objects
target_layer	string	—	Layer name to place duplicates in
uuids	array	yes	UUIDs of objects to duplicate

No output schema declared.

No examples provided.

export Export ~175

Export objects, groups, artboards, or selection. For PNG/JPG, the exported image is returned as base64 in the response — you can view it directly without reading the file from disk. Note: Illustrator will be activated (brought to foreground) during execution.

Input Output Examples

Name	Type	Req	Description
format	string	yes	Export format
output_path	string	—	Output file path. If omitted, auto-generates in the same directory as the document (or ~/Desktop for unsaved documents)
raster_options	object	—	Raster export options
scale	number	—	Scale factor
svg_options	object	—	SVG export options
target	string	yes	UUID, "artboard:<index>", or "selection". When exporting a UUID target as PNG/JPG, a temporary document is created internally (selection state may change).

No output schema declared.

No examples provided.

export_pdf Export PDF ~106

Export print-ready PDF. Note: Illustrator will be activated (brought to foreground) during execution. The exported PDF should be verified by a human before final submission.

Input Output Examples

Name	Type	Req	Description
options	object	—	PDF export options
output_path	string	—	Output file path. If omitted, auto-generates in the same directory as the document (or ~/Desktop for unsaved documents)
preset	string	—	PDF preset name (e.g. "[PDF/X-4:2008]")

No output schema declared.

No examples provided.

extract_design_tokens Extract Design Tokens ~74

Extract colors, typography, and spacing from the document as design tokens in CSS custom properties, JSON, or Tailwind format

Input Output Examples

Name	Type	Req	Description
format	string	—	Output format
output_path	string	—	File path to save the output (e.g. "/path/to/tokens.json"). If omitted, returns text only.

No output schema declared.

No examples provided.

find_objects Find Objects ~246

Search for objects by specified criteria

Input Output Examples

Name	Type	Req	Description
artboard_index	integer	—	Artboard index (0-based integer)
coordinate_system	string	—	Coordinate system. Auto-detected from document by default (CMYK/print → document, RGB/web → artboard-web). artboard-web: origin at active artboard top-left, Y-down. document: Illustrator native coord…
fill_color	object	—	Search by fill color. Tolerance defaults to 5 per channel (0-255 for RGB, 0-100 for CMYK). Set tolerance: 0 for exact match.
font_name	string	—	Font name (partial match)
font_size	object	—	Font size range
layer_name	string	—	Layer name
name	string	—	Object name (partial match)
stroke_color	object	—	Search by stroke color. Tolerance defaults to 5 per channel (0-255 for RGB, 0-100 for CMYK). Set tolerance: 0 for exact match.
type	string	—	Object type

No output schema declared.

No examples provided.

get_artboards Get Artboards ~105

Get all artboard information

Input Output Examples

Name	Type	Req	Description
coordinate_system	string	—	Coordinate system. Auto-detected from document by default (CMYK/print → document, RGB/web → artboard-web). artboard-web: origin at active artboard top-left, Y-down. document: Illustrator native coord…
index	integer	—	Get a specific artboard by index (0-based integer)

No output schema declared.

No examples provided.

get_colors Get Colors ~70

Get all color information used in the document

Input Output Examples

Name	Type	Req	Description
include_diagnostics	boolean	—	Include print diagnostics: gradient color space validation, ink coverage per color, color model mismatch warnings
include_swatches	boolean	—	Include swatch list
include_used_colors	boolean	—	Include used color collection

No output schema declared.

No examples provided.

get_document_info Get Document Info ~85

Get document metadata

Input Output Examples

Name	Type	Req	Description
coordinate_system	string	—	Coordinate system. Auto-detected from document by default (CMYK/print → document, RGB/web → artboard-web). artboard-web: origin at active artboard top-left, Y-down. document: Illustrator native coord…

No output schema declared.

No examples provided.

get_document_structure Get Document Structure ~125

Get tree structure of layers, groups, and objects

Input Output Examples

Name	Type	Req	Description
artboard_index	number	—	Filter by artboard index (0-based integer)
coordinate_system	string	—	Coordinate system. Auto-detected from document by default (CMYK/print → document, RGB/web → artboard-web). artboard-web: origin at active artboard top-left, Y-down. document: Illustrator native coord…
depth	number	—	Maximum traversal depth (unlimited if omitted)

No output schema declared.

No examples provided.

get_effects Get Effects ~112

Get effect and appearance information

Input Output Examples

Name	Type	Req	Description
coordinate_system	string	—	Coordinate system. Auto-detected from document by default (CMYK/print → document, RGB/web → artboard-web). artboard-web: origin at active artboard top-left, Y-down. document: Illustrator native coord…
selection_only	boolean	—	Selected objects only
target	string	—	Filter by UUID for a specific object

No output schema declared.

No examples provided.

get_groups Get Groups ~119

Get structure of groups, clipping masks, and compound paths

Input Output Examples

Name	Type	Req	Description
coordinate_system	string	—	Coordinate system. Auto-detected from document by default (CMYK/print → document, RGB/web → artboard-web). artboard-web: origin at active artboard top-left, Y-down. document: Illustrator native coord…
depth	number	—	Maximum traversal depth
layer_name	string	—	Filter by layer name (all layers if omitted)

No output schema declared.

No examples provided.

get_guidelines Get Guidelines ~85

Get guide information

Input Output Examples

Name	Type	Req	Description
coordinate_system	string	—	Coordinate system. Auto-detected from document by default (CMYK/print → document, RGB/web → artboard-web). artboard-web: origin at active artboard top-left, Y-down. document: Illustrator native coord…

No output schema declared.

No examples provided.

get_images Get Images ~115

Get embedded and linked image information

Input Output Examples

Name	Type	Req	Description
coordinate_system	string	—	Coordinate system. Auto-detected from document by default (CMYK/print → document, RGB/web → artboard-web). artboard-web: origin at active artboard top-left, Y-down. document: Illustrator native coord…
include_print_info	boolean	—	Include print diagnostics: color space mismatch flag, scale factor (%). Only available for embedded raster images.

No output schema declared.

No examples provided.

get_layers Get Layers ~113

Get layer structure as a tree

Input Output Examples

Name	Type	Req	Description
coordinate_system	string	—	Coordinate system. Auto-detected from document by default (CMYK/print → document, RGB/web → artboard-web). artboard-web: origin at active artboard top-left, Y-down. document: Illustrator native coord…
include_items	boolean	—	Include items within each layer
include_sublayers	boolean	—	Include sublayers

No output schema declared.

No examples provided.

get_overprint_info Get Overprint Info ~25

Get overprint settings with K100/rich black detection and intent classification

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

get_path_items Get Path Items ~145

Get path and shape data. Note: fill/stroke do not include per-attribute opacity; use the item-level opacity field for transparency.

Input Output Examples

Name	Type	Req	Description
coordinate_system	string	—	Coordinate system. Auto-detected from document by default (CMYK/print → document, RGB/web → artboard-web). artboard-web: origin at active artboard top-left, Y-down. document: Illustrator native coord…
include_points	boolean	—	Include anchor point details
layer_name	string	—	Filter by layer name
selection_only	boolean	—	Get selected paths only

No output schema declared.

No examples provided.

get_selection Get Selection ~89

Get detailed information about the currently selected objects

Input Output Examples

Name	Type	Req	Description
coordinate_system	string	—	Coordinate system. Auto-detected from document by default (CMYK/print → document, RGB/web → artboard-web). artboard-web: origin at active artboard top-left, Y-down. document: Illustrator native coord…

No output schema declared.

No examples provided.

get_separation_info Get Separation Info ~27

Get color separation information: CMYK process plates and spot color plates with usage counts

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

get_symbols Get Symbols ~86

Get symbol definitions and instances

Input Output Examples

Name	Type	Req	Description
coordinate_system	string	—	Coordinate system. Auto-detected from document by default (CMYK/print → document, RGB/web → artboard-web). artboard-web: origin at active artboard top-left, Y-down. document: Illustrator native coord…

No output schema declared.

No examples provided.

get_text_frame_detail Get Text Frame Detail ~171

Get detailed text frame attributes including per-character runs (font, tracking, akiLeft/akiRight, tsume, proportionalMetrics), kerning pairs with manual kerning values (1/1000 em), and paragraph attributes. Returns cssHints for web/CSS reproduction. Note: paragraph leading/autoLeading may return 0 in some ExtendScript versions due to missing API support.

Input Output Examples

Name	Type	Req	Description
coordinate_system	string	—	Coordinate system. Auto-detected from document by default (CMYK/print → document, RGB/web → artboard-web). artboard-web: origin at active artboard top-left, Y-down. document: Illustrator native coord…
uuid	string	yes	UUID of the target text frame

No output schema declared.

No examples provided.

group_objects Group Objects ~132

Group multiple objects into a single group. The first UUID in the array becomes the bottommost item, the last becomes the topmost. Note: Illustrator will be activated (brought to foreground) during execution.

Input Output Examples

Name	Type	Req	Description
clipped	boolean	—	Create as clipping group. The last UUID becomes the clip path (topmost). Example: [content-uuid, mask-uuid] — mask-uuid clips content-uuid.
name	string	—	Name for the new group
uuids	array	yes	UUIDs of objects to group. Order matters: first=bottom, last=top in layer panel.

No output schema declared.

No examples provided.

import_svg_as_editable Import SVG as Editable ~349

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. Note: Illustrator will be activated (brought to foreground) during execution.

Input Output Examples

Name	Type	Req	Description
coordinate_system	string	—	Coordinate system. Auto-detected from document by default (CMYK/print → document, RGB/web → artboard-web). artboard-web: origin at active artboard top-left, Y-down. document: Illustrator native coord…
file_path	string	yes	Absolute path to the .svg or .svgz file
fit_to_artboard	boolean	—	Scale and center the imported content to fit the active artboard (default: false).
group	boolean	—	Wrap imported items in a single GroupItem (default: true). Set false to keep items flat in the target layer.
layer_name	string	—	Target layer name in the active document. Created if missing.
name	string	—	Name to assign to the root group (only when group=true and multiple items are imported).
padding	number	—	Padding in points from the artboard edges when fit_to_artboard is true.
x	number	—	X position of the imported content (top-left of bounding box). Ignored when fit_to_artboard is true.
y	number	—	Y position of the imported content (top-left of bounding box). Ignored when fit_to_artboard is true.

No output schema declared.

No examples provided.

list_fonts List Fonts ~54

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

Input Output Examples

Name	Type	Req	Description
filter	string	—	Filter by family or name (case-insensitive partial match)
limit	integer	—	Max fonts to return (default 100)

No output schema declared.

No examples provided.

list_graphic_styles List Graphic Styles ~19

List all graphic styles in the active document.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

list_text_frames List Text Frames ~243

List text frames with summary-level information. Supports reading-order sort, pagination, and a lightweight contents-only mode.

Input Output Examples

Name	Type	Req	Description
artboard_index	integer	—	Filter by artboard index (0-based integer)
contents_only	boolean	—	When true, return only uuid, contents, and artboardIndex (no position/font/style info). Useful for text proofreading.
coordinate_system	string	—	Coordinate system. Auto-detected from document by default (CMYK/print → document, RGB/web → artboard-web). artboard-web: origin at active artboard top-left, Y-down. document: Illustrator native coord…
layer_name	string	—	Filter by layer name
limit	integer	—	Maximum number of items to return (for pagination). Applied after sort.
offset	integer	—	Number of items to skip (for pagination). Applied after sort.
sort	string	—	Sort order. "reading-order" sorts by artboardIndex asc → y asc → x asc (rows within ~5pt tolerance are treated as the same line)

No output schema declared.

No examples provided.

list_text_styles List Text Styles ~20

List all character and paragraph styles in the active document.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

manage_artboards Manage Artboards ~160

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

Input Output Examples

Name	Type	Req	Description
action	string	yes	Action to perform
index	integer	—	Target artboard index (0-based). Required for remove/resize/rename/fit_to_art. Note: the last remaining artboard cannot be removed.
layout	string	—	Artboard layout for rearrange
name	string	—	New name for rename action
rect	object	—	Position and size for add/resize (document coordinates)
rows_or_cols	integer	—	Number of rows or columns for rearrange
spacing	number	—	Spacing in points for rearrange

No output schema declared.

No examples provided.

manage_datasets Manage Variables & Datasets ~161

List variables/datasets, apply or create datasets, bind variables to objects, import CSV/XML. CSV headers are auto-bound to objects with matching names. Note: Illustrator will be activated (brought to foreground) during execution.

Input Output Examples

Name	Type	Req	Description
action	string	yes	Action to perform
dataset_name	string	—	Dataset name (for apply_dataset, create_dataset)
dataset_name_prefix	string	—	Prefix for auto-generated dataset names (for import_csv). If omitted, first column value is used.
file_path	string	—	File path (XML for import/export, CSV for import_csv)
object_name	string	—	Object name to bind variable to (for bind_variable)
variable_name	string	—	Variable name (for bind_variable)

No output schema declared.

No examples provided.

manage_layers Manage Layers ~101

Add, rename, show/hide, lock/unlock, reorder, or delete layers

Input Output Examples

Name	Type	Req	Description
above	string	—	For add: create above this layer name
action	string	yes	Layer operation to perform
layer_name	string	—	Target layer name (for add: new layer name)
new_name	string	—	New name (required for rename action)
position	integer	—	Target position for reorder (0 = topmost)

No output schema declared.

No examples provided.

manage_linked_images Manage Linked Images ~102

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.

Input Output Examples

Name	Type	Req	Description
action	string	yes	Action to perform
new_path	string	—	New file path (required for relink)
uuid	string	yes	UUID of the placed (linked) image

No output schema declared.

No examples provided.

manage_swatches Manage Swatches ~70

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

Input Output Examples

Name	Type	Req	Description
action	string	yes	Action to perform
color	—	—	Color for add/update (required for add)
name	string	yes	Swatch name

No output schema declared.

No examples provided.

modify_object Modify Object ~124

Modify properties of an existing object. Note: Illustrator will be activated (brought to foreground) during execution.

Input Output Examples

Name	Type	Req	Description
coordinate_system	string	—	Coordinate system. Auto-detected from document by default (CMYK/print → document, RGB/web → artboard-web). artboard-web: origin at active artboard top-left, Y-down. document: Illustrator native coord…
properties	object	yes	Properties to modify
uuid	string	yes	UUID of the target object

No output schema declared.

No examples provided.

On this page

Handy links

Scoring key

80+ high trust
60–79 medium
below 60 low

How we score

Score history · last 30 days

27 Jul 3 Aug