Using IconVectors with Cursor

Editing icons by hand-feeding SVG markup to an AI chat means the model never sees what is actually on your canvas. Wire Cursor to the IconVectors MCP helper and Cursor reads and edits the document open in the real desktop editor instead — it launches the helper as a local stdio server on Windows, macOS, and Linux, then drives the live document through it.

1. Start IconVectors

Windows

& 'C:\Program Files\Axialis\IconVectors\IconVectors.exe'

macOS

open -a /Applications/IconVectors.app

Linux

/usr/bin/IconVectors

2. Create Cursor's MCP configuration

Register the helper as a stdio server so Cursor launches IconVectorsMcp itself and talks to it over standard input/output. Put the config in either of these files (project-local first, then global):

• .cursor/mcp.json
• ~/.cursor/mcp.json

Windows example

{
  "mcpServers": {
    "iconvectors": {
      "type": "stdio",
      "command": "C:\\Program Files\\Axialis\\IconVectors\\IconVectorsMcp.exe",
      "args": ["--port", "61337"]
    }
  }
}

macOS example

{
  "mcpServers": {
    "iconvectors": {
      "type": "stdio",
      "command": "/Applications/IconVectors.app/Contents/MacOS/IconVectorsMcp",
      "args": ["--port", "61337"]
    }
  }
}

Linux example

{
  "mcpServers": {
    "iconvectors": {
      "type": "stdio",
      "command": "/usr/bin/IconVectorsMcp",
      "args": ["--port", "61337"]
    }
  }
}

If direct launch is problematic on Windows, wrap the command so it changes to C:\Program Files\Axialis\IconVectors before starting IconVectorsMcp.exe. On macOS, update the path if the app bundle is installed outside /Applications. On Linux packaged installs, /usr/bin/IconVectorsMcp is the expected path.

3. Verify the connection

With IconVectors open and the config saved, restart Cursor so it picks up the server, then send these prompts in order — the first two confirm the bridge is live, the third proves Cursor can edit and export the open document:

• Use the IconVectors MCP server to call app_ping and confirm the editor is connected.
• Use IconVectors to call app_getInfo and summarize the current document state.
• Create a new 32x32 document named test icon, draw a blue circle, and export it as SVG.

Helper files

Use Help -> Open MCP Files Folder to open the installed helper bundle. Windows helper files are usually under %APPDATA%\Axialis\IconVectors\MCP. macOS helper files are usually under ~/Library/Application Support/Axialis/IconVectors/MCP. Linux helper files are usually under ~/.local/share/Axialis/IconVectors/MCP. Cursor users will typically want cursor-implementation-instructions.md, iconvectors-mcp-command-reference.md, and cursor-agent-instructions.template.md.