Using IconVectors with Cursor

Cursor can start the IconVectors MCP sidecar as a local stdio server. Once connected, Cursor can inspect or modify the currently open icon document through the real desktop editor.

Current public setup note: the example paths below use the Windows 1.40 release. The macOS MCP package is being prepared.

1. Start IconVectors

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

2. Create Cursor's MCP configuration

Use one of these files:

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

{
  "mcpServers": {
    "iconvectors": {
      "type": "stdio",
      "command": "C:\\Program Files\\Axialis\\IconVectors\\IconVectorsMcp.exe",
      "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.

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. Cursor users will typically want cursor-implementation-instructions.md, iconvectors-mcp-command-reference.md, and cursor-agent-instructions.template.md.