Affinity MCP Server
Enables AI assistants to control the Affinity creative suite on macOS through natural language, allowing for automated design tasks, UI interaction, and file operations. It leverages AppleScript and System Events to bridge AI commands with professional creative software.
Caution. Specific findings reduced this grade. They are listed on the page. Grades reflect the full trust pyramid: code, verification depth, and reputation. New projects cap at C until adoption is earned.
How we verified
Verified is a snapshot. Live keeps it current, and builds your track record.
⚡ Connect GitHub → continuous verification on every pushwhy connect →Who stands behind it
sekharmalla
Source: Glama
Claim it to get a verified publisher badge, a free copy of our full audit findings, and direct contact for any high-priority issues we find. Or connect your repo for our deepest verification, Live Monitored: read-only, revoke anytime. What we access →
Install from
The grade above is for the source repository. Registries can serve a different version, so we mark the ones we were not able to read.
These names and descriptions are the publisher's own, read from the source code. We print them as written. Our assessment is the findings above, not this list.
affinity_statusCheck if Affinity is running and get current state (open documents, windows)
affinity_launchLaunch Affinity app if not already running
affinity_open_fileOpen a file in Affinity (image, .af, .psd, .svg, etc.)
affinity_new_documentCreate a new document. fromLastPreset=true skips the dialog.
affinity_click_menuClick a menu item. Path: ['File','Export','Export…'] for nested menus.
affinity_get_menusList all items in a top-level menu (File, Edit, Pixel, etc.)
affinity_get_submenuList items in a submenu (e.g., File > Export)
affinity_saveSave the current document (Cmd+S) or Save As
affinity_exportExport current document via File > Export > Export…
affinity_keystrokeSend a keystroke to Affinity with optional modifiers
affinity_key_codeSend a key code (Escape=53, Return=36, Delete=51, Tab=48, Left=123, Right=124, Down=125, Up=126)
affinity_type_textType text into Affinity (for text fields, dialogs, the text tool, etc.)
affinity_get_uiInspect the frontmost Affinity window — buttons, text fields, dialogs, etc.
affinity_click_uiClick a UI element in the front window by description or title
affinity_select_toolSelect a drawing/editing tool via keyboard shortcut
affinity_mouse_actionClick or drag at screen coordinates. For drag, provide endX and endY.
affinity_screenshotTake a screenshot of the Affinity window
affinity_close_documentClose the current document
affinity_document_opsDocument operations: flatten, flip, rotate, clip/unclip canvas
affinity_add_layerAdd a new layer (pixel, mask, adjustment, live filter, fill, pattern)
affinity_undo_redoUndo or redo actions
affinity_filtersList available filters under Pixel > Filters submenu
affinity_run_macroImport and run an .afmacro file
Tool annotations
No tools have read-only/destructive annotations
Add readOnlyHint or destructiveHint annotations to every tool so hosts can warn users before invoking.
All four hints declared on every tool
23/23 tools missing one or more hints — affinity_status (missing: readOnlyHint, destructiveHint, idempotentHint, openWorldHint); affinity_launch (missing: readOnlyHint, destructiveHint, idempotentHint, openWorldHint); affinity_open_file (missing: readOnlyHint, destructiveHint, idempotentHint, openWorldHint), +20 more. OpenAI's directory rejects tools where any of the four hints are missing or non-boolean.
For every tool, set all four hints (readOnlyHint, destructiveHint, idempotentHint, openWorldHint) to explicit true/false values that match the handler’s actual behaviour.
Descriptions match behaviour
5 tools describe read intent but their handlers mutate — affinity_status (line 66: execSync("pgrep -f 'Affinity Affinity Store'", {); affinity_get_menus (line 25: execSync(`osascript -e '${script.replace(/'/g, "'\"'\"'")}'`, {); affinity_get_submenu (line 25: execSync(`osascript -e '${script.replace(/'/g, "'\"'\"'")}'`, {)
Rename the tool, rewrite the description, or move the side-effect into a separate clearly-named tool.
Tool inputs are validated
19/23 tool handlers declare input schemas (83%)
Declare an inputSchema with zod/joi/yup on every tool definition.
Tool handlers catch errors
21/23 tool handlers wrap calls in try/catch (91%)
Wrap each tool handler body in try/catch and return a structured error response.
Tests exist
No test files found
Add tests that exercise each declared tool.
Tool description accuracy
4 tools have description/behavior mismatches: affinity_status: description implies read-only but handler writes/deletes/executes; affinity_get_menus: description implies read-only but handler writes/deletes/executes; affinity_get_submenu: description implies read-only but handler writes/deletes/executes
Update tool descriptions to accurately reflect all capabilities — especially write, delete, or execute operations.
Claim the listing to review these findings one by one and send us a correction where you disagree, straight to the team. Claiming also means we tell you when the grade moves, and reach you first if we find anything urgent.
[](https://m8ven.ai/mcp/sekharmalla/affinity-mcp-server)?variant=verified from the URL.Vetting this one by hand? Tool Check is an MCP that scores other MCPs. Add it once and ask Claude, ChatGPT, or any MCP client to grade a server, surface CVEs, check the publisher, and suggest safer alternatives — before you install.
https://m8ven.ai/api/mcp/tool-check