Using IconVectors with Cursor

Cursor can start the IconVectors MCP helper as a local stdio server on Windows, macOS, and Linux. Once connected, Cursor can inspect or modify the currently open icon document through the real desktop editor.

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

Use one of these files:

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

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