Unicon MCP Skill | Agent Skills

Unicon MCP

Use the Unicon MCP server to search and generate icon components through AI assistants like Claude Desktop and Cursor.

Quick Start

Claude Desktop

Open ~/Library/Application Support/Claude/claude_desktop_config.json
Add:

{
  "mcpServers": {
    "unicon": {
      "command": "npx",
      "args": ["-y", "@webrenew/unicon-mcp-server"]
    }
  }
}

Fully quit and restart Claude Desktop.

Cursor

Open Settings > MCP Servers
Add the same JSON config shown above
Restart Cursor

Verify Installation

Claude Desktop: look for the plug icon, ensure unicon appears
Cursor: run claude mcp list if using Claude Code

Common Prompts

"Search for dashboard icons in Lucide"
"Get React component for lucide:arrow-right"
"Generate Vue components for social media icons"
"List available icon libraries"

Available Tools

search_icons

Search through 19,000+ icons with optional filters.

Parameters | Parameter | Required | Description | |-----------|----------|-------------| | query | Yes | Search term | | source | No | Filter by library | | category | No | Filter by category | | limit | No | Max results (default: 20) | | includeCode | No | Return code with results | | strokeWidth | No | Stroke width when includeCode=true | | normalizeStrokes | No | Normalize stroke widths, skipping fill icons |

get_icon

Return code for a single icon in a requested format.

Parameters | Parameter | Required | Description | |-----------|----------|-------------| | iconId | Yes | Icon ID (e.g., "lucide:home") | | format | No | svg, react, vue, svelte, json | | size | No | Icon size in pixels | | strokeWidth | No | Stroke width | | normalizeStrokes | No | Normalize stroke widths, skipping fill icons |

get_multiple_icons

Fetch up to 50 icons at once in a shared format.

Parameters | Parameter | Required | Description | |-----------|----------|-------------| | iconIds | Yes | Array of icon IDs | | format | No | Output format | | size | No | Icon size in pixels | | strokeWidth | No | Stroke width | | normalizeStrokes | No | Normalize stroke widths, skipping fill icons |

get_starter_pack

Get curated icon packs for common use cases.

Parameters | Parameter | Required | Description | |-----------|----------|-------------| | packId | Yes | Pack identifier | | format | No | Output format | | size | No | Icon size in pixels | | strokeWidth | No | Stroke width | | normalizeStrokes | No | Normalize stroke widths, skipping fill icons |

Resources

The MCP server exposes these resources:

| URI | Description | |-----|-------------| | unicon://sources | Library metadata (names, icon counts) | | unicon://categories | Available category list | | unicon://stats | Overall icon statistics | | unicon://starter_packs | Curated icon packs (shadcn-ui, dashboard, etc.) | | unicon://instructions | Detailed usage guide with examples |

Troubleshooting

Server not appearing

Fully quit the app (Cmd+Q on macOS)
Verify config JSON syntax is valid
Restart the application
Check for error logs

Slow first start

The first npx run downloads the package. Subsequent runs use cache.

Icons not found

Run search_icons with your query to verify the icon ID exists. Format is source:name (e.g., lucide:home).

Connection errors

Ensure you have Node.js 18+ installed
Check internet connectivity
Try running manually: npx @webrenew/unicon-mcp-server

Agent Skills: Unicon MCP

Install this agent skill to your local

Skill Files