ArtCraftMCP

Drive your ArtCraft desktop apps with the OpenCode AI agent — over MCP.

New here? Install in under a minute: double-click install-opencode-config.bat, then run opencode mcp list. Every app installed on your machine should show green (17 here: 16 ArtCraft + blender). Entries for apps you don't have installed show failed: system cannot find the path specified — install the app or delete its block. Details in troubleshooting.

OpenCode is an AI coding agent. ArtCraft apps (WordCraft, VectorCraft, SolidCraft…) each ship a headless CLI that can act as a Model Context Protocol (MCP) server. This repo wires them together: one portable opencode.json covering all 19 suite apps as OpenCode tools, plus a one-click installer that discovers which ones exist on your machine and merges only those into your personal config.

Install — from template to your machine:

flowchart TB
    TPL["opencode.json\nall 19 suite apps, 1-tab\n'.' roots, no usernames"]
    BAT["install-opencode-config.bat"]
    PS1["merge-opencode-config.ps1\ninstall present exes, skip missing\nkeep blender + models, .bak first"]
    GLB["global opencode.json\ninstalled servers merged\n16 of 19 on this machine"]
    TPL --> PS1
    BAT --> PS1
    PS1 --> GLB

Control — from agent to apps to files:

flowchart LR
    You(["You"]) --> OC["OpenCode agent"]
    OC -- "stdio" --> AUTO
    OC -- "stdio" --> SHORT
    OC -- "stdio" --> ALLOW
    OC -- "stdio" --> MAIL
    OC -- "stdio" --> BARE
    AUTO["automation roots\nword vector photo deck\npdf effect sound\ncad design fig = guessed"] --> Files
    SHORT["short roots\ntexture material"] --> Files
    ALLOW["allow-path\nsolidcraft"] --> Files
    MAIL["files\nmailcraft --files"] --> Files
    BARE["bare mcp\ngrid film light\ncraft-anything ani"] --> Files
    Files["project files\n. = launch folder"] -- "tool results" --> OC

Verify — what the list tells you:

flowchart LR
    L["opencode mcp list"] --> OK["connected\nserver is up"]
    L --> MISS["failed: cannot find path\napp not installed"]
    L --> FLAG["failed: unknown option\nwrong flags for that CLI"]

In short: OpenCode finds your apps — not the other way around. Each entry in opencode.json tells OpenCode which executable to launch and which folders it may touch.

All JSON in this repo uses 1-tab indentation as standard — including everything the merger writes.

1. Double-click install-opencode-config.bat.
2. It backs up your current global config (opencode.json.<date>.bak), discovers which suite exes exist (16 of 19 on this machine), merges those in, and restarts OpenCode.
3. Run opencode mcp list — every installed app should be green:

✓ anicraft       connected
✓ blender        connected
✓ craftanything  connected
✓ deckcraft      connected
✓ effectcraft    connected
✓ filmcraft      connected
✓ gridcraft      connected
✓ lightcraft      connected
✓ mailcraft       connected
✓ materialcraft   connected
✓ pdfcraft       connected
✓ photocraft     connected
✓ solidcraft     connected
✓ soundcraft     connected
✓ texturecraft   connected
✓ vectorcraft    connected
✓ wordcraft      connected

Your existing setup is safe: the merger keeps entries it doesn't know about (like blender) and your model / small_model choices. It only adds or refreshes ArtCraft servers whose exe is actually installed — the rest are reported as skipped and left untouched. Servers for apps you never installed show ✗ failed: system cannot find the path specified; either install the app or delete its block from your copy.

Copy opencode.json into your project folder (where you launch opencode from). Project config overrides global where they overlap.

powershell -NoProfile -ExecutionPolicy Bypass -File merge-opencode-config.ps1 -Repo opencode.json -GlobalPath "%USERPROFILE%\.config\opencode\opencode.json"
opencode mcp list

• OpenCode installed and on PATH. Check with opencode --version in a fresh terminal. If it works there but not in your editor, restart the editor so it picks up the new PATH.
• ArtCraft apps installed under C:\Program Files\<App>\. The template covers all 19 suite apps; on this machine CADCraft, DesignCraft and FigCraft aren't installed, so the installer skips those three entries. AniCraft ships inside the suite folder (C:\Program Files\ArtCraft\AniCraft\) rather than in its own C:\Program Files\AniCraft\ — the installer looks in both and rewrites the path to whichever exists.
• Windows. Your global config lives at %USERPROFILE%\.config\opencode\opencode.json.

Every ArtCraft CLI exposes mcp, but each one guards file access with different flags. Using the wrong flag is the #1 cause of ✗ failed lines — 16 entries below were verified against that exe's real mcp --help output plus a spawn probe; the last 3 use the most common flag family as a best guess (those apps aren't installed here) and are marked accordingly.

If you install one of those three, confirm its flags first with "C:\Program Files\<App>\<cli>.exe" mcp --help and correct the template if they differ — then re-run the installer. (solvecraft-cli.exe exists on disk but prints "deprecated, use solidcraft-cli", so it has no entry.)

Two layout notes for AniCraft: its CLI lives in the suite folder (C:\Program Files\ArtCraft\AniCraft\anicraft-cli.exe), not in a C:\Program Files\AniCraft\ of its own, and the installer rewrites the entry to whichever of the two paths it finds. Its server also takes an optional document argument — mcp opens an empty one, mcp --sample opens the bundled sample, mcp scene.anicraft opens yours — so the template stays on the bare mcp.

Almost everything official lives under @storytold (the ArtCraft org, getartcraft.com) — each app has its own repo with releases, docs and an issue tracker. The exceptions are SolidCraft, a community app by Tangency Labs, and MailCraft, a community app (ZIDAN44/mailcraft). This config repo itself is xevilmaxx/ArtCraftMCP.

Also useful: storytold/artcraft (the AI studio) and storytold/craft-launcher (the app launcher). Found a wrong flag or a new app release that changed the CLI? Open an issue in the app's repo above, or in this repo.

Each headless server is sandboxed: with no root flag it can't read or write your project files (symptom: SolidCraft saves landing in Temp\solidcraft-mcp-… with "Save to Downloads is blocked"). The template grants access with ".":

• Portable — no C:\Users\<You> inside, works for every user and checkout.
• Follows you — "." means "wherever you launched OpenCode".
• Recursive — subfolders like .\projects\designs\part1.sc are covered.
• Repeatable — most CLIs accept the flag more than once for several folders.

Need wider access? Replace "." with an absolute folder on the servers you want to widen. Prefer the smallest scope that works.

AniCraft is the exception. Its mcp server has no root flags at all — there is no sandbox to widen. It reads and writes the paths the agent names, with your own permissions, so scope it by asking for work inside a project folder. The engine's own guard is the confirm: true that destructive commands demand before they replace a file.

opencode
opencode mcp list
opencode run "Export the current VectorCraft canvas to SVG"
opencode run --quiet "Parse input vectors from build/out.svg and feed coordinates to the cutting engine RPC on localhost:9000"

Headless, without MCP:

"C:\Program Files\WordCraft\wordcraft-cli.exe" run --file doc.docx --cmd "caret.docEnd" --save out.docx --print

powershell -NoProfile -Command "Get-NetTCPConnection -LocalPort 28894 | Select-Object OwningProcess"
taskkill /F /PID <that-number>
opencode mcp list

• OpenCode config & precedence (~/.config/opencode/opencode.json, project opencode.json, OPENCODE_CONFIG overrides) — opencode.ai/docs/config
• MCP servers (type: local + command, optional cwd / environment / timeout) — opencode.ai/docs/mcp-servers
• The --allow-path-everywhere claim from an earlier AI troubleshooting thread is wrong — 16 of the 19 matrix entries were verified exe-by-exe (the other 3 use the most common flag family as a guess), and opencode mcp list reports every installed server connected.