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

move_to_layer Move to Layer ~77

Move one or more objects to a different layer. Note: Illustrator will be activated (brought to foreground) during execution.

Input Output Examples

Name	Type	Req	Description
position	string	—	beginning = front of layer, end = back of layer
target_layer	string	yes	Target layer name
uuids	array	yes	UUIDs of objects to move

No output schema declared.

No examples provided.

open_document Open Document ~77

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

Input Output Examples

Name	Type	Req	Description
color_space	string	—	Force color space conversion on open. Omit to keep original.
path	string	yes	Absolute file path to open (.ai, .eps, .pdf, .svg, etc.)

No output schema declared.

No examples provided.

place_color_chips Place Color Chips ~182

Extract all unique colors from the document and place color chip swatches with labels outside the artboard

Input Output Examples

Name	Type	Req	Description
artboard_index	integer	—	Target artboard (default: active artboard)
chip_size	number	—	Chip size in points (default: 30)
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_info	boolean	—	Include color value labels next to chips
layer_name	string	—	Layer name for color chips
position	string	—	Place chips to the right or below the artboard

No output schema declared.

No examples provided.

place_image Place Image ~228

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: 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…
embed	boolean	—	Embed the image instead of linking (default: false)
file_path	string	yes	Absolute path to the image file
layer_name	string	—	Target layer name
name	string	—	Object name
x	number	—	X position
y	number	—	Y position

No output schema declared.

No examples provided.

place_style_guide Place Style Guide ~152

Place a visual style guide (color chips, font samples, spacing indicators) outside the artboard

Input Output Examples

Name	Type	Req	Description
artboard_index	integer	—	Target artboard (default: active artboard)
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	—	Layer name for the style guide
position	string	—	Place style guide to the right or below the artboard

No output schema declared.

No examples provided.

place_symbol Place Symbol ~187

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

Input Output Examples

Name	Type	Req	Description
action	string	yes	place = new instance, replace = swap symbol definition
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…
symbol_name	string	yes	Symbol name to place or new symbol name for replace
uuid	string	—	UUID of existing symbol item (for replace action)
x	number	—	X position (for place action)
y	number	—	Y position (for place action)

No output schema declared.

No examples provided.

preflight_check Preflight Check ~190

Run pre-press quality checks. Note: This check is not exhaustive — it 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.

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…
min_dpi	integer	—	Minimum acceptable DPI for images (default: 300)
target_pdf_profile	string	—	Target PDF/X profile for compliance checks. x1a: no transparency/RGB, fonts embedded. x4: allows transparency, recommends ICC profile.

No output schema declared.

No examples provided.

replace_color Replace Color ~140

Find and replace colors across the document or within a specific layer. Limitations: SpotColor and GrayColor matching not supported. Cross-colorspace matching (e.g. RGB→CMYK) not possible — from_color and to_color must use the same color type as the target objects.

Input Output Examples

Name	Type	Req	Description
from_color	—	yes	Color to find (required)
scope	string	—	Layer name to limit replacement scope (default: entire document)
target	string	—	Which color attributes to replace
to_color	—	yes	Replacement color (required)
tolerance	number	—	Color matching tolerance per channel (0 = exact match, 100 = match any)

No output schema declared.

No examples provided.

resize_for_variation Resize for Variation ~195

Create size variations from a source artboard. Duplicates all objects and scales/repositions them proportionally to fit target sizes. Limitations: no text reflow, effects/strokes scale with objects but may need manual adjustment, proportional placement only (not smart layout).

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…
scale_mode	string	—	How to scale objects: proportional (fit within, maintain aspect), fit_width, or fit_height
source_artboard_index	integer	yes	Source artboard index to duplicate from (0-based)
target_sizes	array	yes	Target sizes for variations

No output schema declared.

No examples provided.

save_document Save Document ~82

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

Input Output Examples

Name	Type	Req	Description
mode	string	—	save = overwrite, save_as = save to new path
path	string	—	File path for save_as mode. If omitted, auto-generates in the same directory as the document (or ~/Desktop for unsaved documents)

No output schema declared.

No examples provided.

select_objects Select Objects ~57

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

Input Output Examples

Name	Type	Req	Description
uuids	array	yes	Array of object UUIDs to select. Pass empty array [] to deselect all.

No output schema declared.

No examples provided.

set_illustrator_version Set Illustrator Version ~117

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).

Input Output Examples

Name	Type	Req	Description
clear	boolean	—	Reset to default behavior (connect to any running Illustrator).
version	string	—	Illustrator version year (e.g. "2024", "2025").

No output schema declared.

No examples provided.

set_workflow Set Workflow ~134

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).

Input Output Examples

Name	Type	Req	Description
clear	boolean	—	Reset session to default behavior (auto-detect from document).
coordinate_system	string	—	Explicit coordinate system override. If provided with workflow, overrides the workflow-derived default.
workflow	string	—	The workflow type. Determines the default coordinate system.

No output schema declared.

No examples provided.

set_z_order Set Z-Order ~54

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

Input Output Examples

Name	Type	Req	Description
command	string	yes	Stacking order command
uuid	string	yes	UUID of the object

No output schema declared.

No examples provided.

undo Undo / Redo ~54

Undo or redo actions in Illustrator. Note: Illustrator will be activated (brought to foreground) during execution.

Input Output Examples

Name	Type	Req	Description
action	string	—	—
count	integer	—	Number of times to undo/redo (max 20)

No output schema declared.

No examples provided.

ungroup_objects Ungroup Objects ~51

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

Input Output Examples

Name	Type	Req	Description
uuid	string	yes	UUID of the group to ungroup

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