unicon

Unicon exposes an MCP server to integrate the Unicon CLI into automated workflows and IDEs. The MCP server lets Claude/Cursor (and other tools) interact with Unicon to search icons, fetch individual icons, and bundle icon sets within your application or design process. Tools exposed by the MCP server include search_icons, get_icon, get_multiple_icons, and get_starter_pack, enabling programmatic access to icon data in React components, SVGs, JSON metadata, or bundles suitable for batch exports. This enables deeper automation, such as generating component libraries or design tokens from the icon catalog, and piping results directly into your project or CI pipeline. To use it, run the MCP server as configured (via npx with the server package) and send requests to the endpoint described in the MCP docs to perform searches, retrieve icons, or assemble icon bundles for your UI.

Prerequisites:

• Node.js (LTS) and npm installed on your machine
• Basic familiarity with running CLI tools

Install the MCP server for Unicon by invoking the MCP package via npx (no persistent install required):

1. Ensure you have Node.js and npm installed. Check versions:

node -v
npm -v

2. Run the MCP server (this uses npx to fetch the package on demand):

npx -y @webrenew/unicon-mcp-server

3. If you prefer a persistent server, you can install the package globally and run it directly (optional):

npm install -g @webrenew/unicon-mcp-server
unicon-mcp-server

4. Verify the MCP endpoint is reachable as documented in the MCP docs (the default endpoint is typically available at a local URL provided by the server).

Tips and caveats:

• The MCP server is designed for Claude Desktop / Cursor workflows and for cloud IDE integrations; ensure your environment can reach the MCP endpoint (consider firewall or proxy settings).
• If you encounter permission or network issues with npx, try a local install of the MCP server package and run it from your PATH.
• The available tools include search_icons, get_icon, get_multiple_icons, and get_starter_pack; use them to build icon-centric components or design assets programmatically.
• When bundling icons, you can request formats like react, svg, json, or vue depending on your frontend stack.
• Environment variables are typically not required for basic usage, but advanced deployments may define API_BASE_URL or AUTH tokens if the MCP server endorses them in your environment.